Ejemplo de formulario de búsqueda 11g (parte 2). Bind Variables

Descripción: En el anterior artículo vimos los cambios necesarios que necesitamos hacer en el ViewObject que va a gestionar el buscador que estamos creando.
En este artículo vamos a añadir a la consulta las bind variables en las que pasaremos los valores a la consulta.

 

Paso 2. Definir bind variables

Un bind variable nos permite asignar un valor a una query.

Por ejemplo:
select *
from personas p
where p.id=23

select *
from personas p
where p.id=16

El resultado para que sea aplicable programáticamente es el poder colocar una variable en la consulta a la cual podemos asignar un valor.

select *
from personas p
where p.id= :persona_id

Donde persona_id es la variable bind. En la sintaxis se suele presentar con ":" antes del nombre de la variable bind.

En el siguiente artículo del blog SQL Eficiente, se explica con más claridad.
Variables de binding (bind variables)
http://sqleficiente.wordpress.com/2009/07/01/variables-de-binding-bind-variables/

Volviendo a nuestro ejemplo, podemos observar en la misma página de la query (en el viewObject) como hay un apartado que dice Bind Variables. Pulsamos en el símbolo + para agregar.

creando una bind variable

Se nos muestra una ventana donde podremos añadir los datos de la variable. En nuestro ejemplo, vamos a poner una variable bind para poder buscar por el campo FirstName.
En la imagen que aparece se ha puesto el nombre p_Nombre. Esta forma es una convención por lo que puedes escribirla de la manera que más te plazca. Sin embargo, debe ser lo suficientemente clara, como para que en caso de error (que los habrá), puedan detectar que la causa está en el parámetro de forma rápida.

edición nueva Bind Variable

Tras guardar los datos de la nueva variable bind, aparece en la ventana debajo de la query.
El asterisco (*) indica que es un valor obligatorio (required), es decir, que será un parámetro obligatorio siempre.
Esto no es recomendable, si en la página se van a mostrar datos sin necesidad de utilizar el buscador o si hay otros campos que pueden utilizarse en la búsqueda (por ejemplo si buscamos por LastName). 

bind variable creada bajo la consulta

El próximo artículo incluiremos la Bind Variable dentro de la consulta para que pueda ser utilizada para pasar valores a ésta.
También veremos el uso de ViewCriteria cuando se crea un buscador.

Fuente de referencia:
Create Simple Search form in Oracle ADF de ADFSanthosh
http://adfnote.blogspot.com.es/2013/02/create-simple-search-form-in-oracle-adf.html 


Variables de binding (bind variables) del blog SQL Eficiente
http://sqleficiente.wordpress.com/2009/07/01/variables-de-binding-bind-variables/

Otros artículos relacionados:
- Ejemplo formulario de búsqueda (parte 1). Crear consulta y resultados
- Ejemplo formulario de búsqueda (parte 3). View Criteria
- Ejemplo formulario de búsqueda (parte 4). Creación de la página.


 

Si te ha gustado este artículo, puedes seguir el blog por Blogger o Twitter @ADFSalvaje