Crear una tabla de objetos en Oracle

Vamos a ver en éste post cómo crear una tabla de objetos en Oracle. Para ello, vamos a crear primero un objeto y sobre ése objeto construiremos una tabla que contendrá en unos de sus campos al citado objeto.

Tomaremos como ejemplo el objeto "direccionOBJ" que es una dirección postal:

CREATE OR REPLACE TYPE direccionOBJ as OBJECT
(
   calle VARCHAR2(20),
   ciudad VARCHAR2(20),
   codProvincia CHAR(2),
   cPostal CHAR(5)
);

Ahora creamos una tabla de empleado, que contiene al objeto direccion (de tipo direccionOBJ):

CREATE TABLE empleado 
(
  numEmpleado   NUMBER(3),
  nombre VARCHAR2(20),
  direccion direccionOBJ
);

Vamos a crear ahora una fila para nuestra tabla de empleados:

INSERT INTO empleado VALUES 
(139, 'Antonio', direccionOBJ('Calle Sierpes','Sevilla','41','41001'));

Crear una tabla a partir de un objeto Oracle 

A continuación vamos a crear una tabla oracle con los objetos direccionOBJ y vamos a copiar todas las direcciones de nuestra tabla de empleados a ésta tabla:

CREATE TABLE tabla_direcciones OF direccionOBJ;

Insertamos las direcciones:

INSERT INTO tabla_direcciones 
    SELECT e.direccion
    FROM empleados e;

Así hemos transformado el objeto direccionesOBJ en una tabla que podemos consultar. Vamos a hacer un "select" de nuestra tabla:

SELECT ciudad FROM tabla_direcciones

Ya ésta, así de simple... (o de difícil) ;)

Continuar Leyendo...

Crear y recorrer un cursor de Oracle

Dejo en este post cómo crear un cursor oracle sobre una consulta para recorrerlo después:

-- Zona de declaración 
declare
-- Declaramos el cursor sobre una consulta de una supuesta tabla usuarios.

cursor usuarios is 
    select * 
    from usuarios
    where edad > 20;

-- Fin declaración. Comenzamos el procedimento:

begin

-- Recorremos el cursor con un bucle for - loop
    for u in usuarios loop
        dbms_output.put_line(u.apellidos||' '||u.nombre);
    end loop; 
-- Fin bucle

end; 
-- Fin procedimiento

La función dbms_output.put_line muestra por pantalla el resultado en la variable "u" con la que recorremos el cursor. El operador || es de concatenación de cadenas.

Quizás te interese...

• Cómo crear objetos y tablas de objetos: Crear una tabla de objetos en Oracle 
• Cómo crear paquetes en Oracle: Paquetes (Package) en Oracle

Continuar Leyendo...

JNDI (Java Naming Directory Interface). Configurando recursos en Tomcat.

La Java Naming and Directory Interface (JNDI) es una interfaz de programación (API) que proporciona funcionalidades de nombrado y directorio a las aplicaciones escritas usando Java. Está definido para ser independiente de cualquier implementación de servicio de directorio. Así se puede acceder a una gran variedad de directorios de una forma común.

Sirve para configurar recursos compartidos para aplicaciones java organizándolos por directorio con nombres únicos. Es un servicio de nombres que permite:

• Asociar nombres con objetos.
• Permitir la búsqueda de un objeto por su nombre.

En el mercado existen diferentes servicios de directorios, por ejemplo:

• LDAP (Lightweight Directory Access Protocol)
• NDS (Novell Directory Service)
• NIS (Network Information Service)

Cada servicio tiene una forma de acceso diferente, lo que implica que si se cambia de fabricante hay que reescribir los clientes. Es por eso que se usa JNDI como capa por encima pues ofrece un acceso común a los recursos configurados.

La API JNDI  permite escribir código Java que realice operaciones sobre directorios. Es una API uniforme a todos los tipos de servicios de directorios. Es similar a JDBC.

Service Provider Interface (SPI) permite acceder al servicio de directorio específico de cada fabricante. Mapea código JNDI en operaciones específicas de directorios. Es un driver JNDI.

 Arquitectura JNDI

Un ejemplo sencillo

Vamos a configurar un pool de conexiones para una base de datos en el lado del servidor. A continuación se muestra cómo se usaría el API JNDI:

String jndiName = "jdbc/<alias>";
//Obtenemos el contexto inicial (dónde comienza el directorio de nombres)
InitialContext ctx = new InitialContext();
//Asignamos el recurso a un objeto de tipo DataSource (Binding)
DataSource ds = (DataSource) ctx.lookup(jndiName);
Connection conn = ds.getConnection();
// hacer algo con la conexión
conn.close();
ctx.close();

El código anterior funcionaría en todas las aplicaciones que tengamos desplegada en nuestro servidor web (en nuestro caso lo que es Tomcat) o servidor de aplicaciones. Se usa en todas las aplicaciones del servidor y solo lo configuramos una vez.

La configuración que hay que realizar en Tomcat es la siguiente: 

1.  Modificar el fichero ../conf/server.xml  de Tomcat entre las etiquetas <GlobalNamingResources> y </GlobalNamingResources>

<GlobalNamingResources>
…
<Resource name="jdbc/<alias>"
   auth="Container"
   type="oracle.jdbc.pool.OracleDataSource"
   driverClassName="oracle.jdbc.driver.OracleDriver"
   factory="oracle.jdbc.pool.OracleDataSourceFactory"
   url="jdbc:oracle:thin:@<host>:<port>:<sid>"
   [user=<user>]
   [password=<password>]
   maxActive="20"
   maxIdle="10"
   maxWait="-1" />
…
</GlobalNamingResources> 

Estamos configurando una fuente de datos (dataSource) para poder acceder a una base de datos Oracle. Indicando al servidor que tenemos un recurso. A continuación indicamos a nuestras aplicaciones que pueden hacer uso del recurso definido en el servidor:
2. Modificar el fichero /conf/context.xml entre las etiquetas <Context> y </Context> con lo siguiente:

<Context>
…
<ResourceLink global="jdbc/<alias>" name="jdbc/<alias>" 
type="oracle.jdbc.pool.OracleDataSource"/>
…
</Context> 

3. Incluir el jar del conector jdbc a la base de datos en la carpeta lib del servidor Tomcat, no del proyecto. Y, muy importante, reiniciar el servidor.

Continuar Leyendo...

Paquetes (package) en Oracle

Los paquetes en Oracle sirven para agrupar y organizar funcionalidades en una base de datos. Son estructuras que agrupan objetos PL/SQL (funciones, procedimientos, tipos, etc.). Ello nos va a permitir tener programas estructurados agrupados por funcionalidades.

Un paquete de Oracle se compone de dos elementos: 

• La especificación (cabecera) y
• El cuerpo

La especificación es la interfaz de las funciones y procedimientos que se van a implmentar en el cuerpo, es algo parecido a las cabeceras en el lenguaje de programación C. La sintaxis general es la siguiente:

CREATE [OR REPLACE] PACKAGE <nombre_del_paquete> is 

  -- Declaración de tipos:
  TYPE <nombreTipo> IS <tipo>;

  -- Declaracion de variables y constantes
  <nombreConstante> CONSTANT <tipo> := <valor>;
  <nombreVariable> <tipo>;

  -- Declaraciones de funciones y procedimientos
  FUNCTION <nombreFuncion>(<parametro> <tipo>,...) RETURN <tipo>;
  PROCEDURE <nombreProcedimiento>(<parametro> <tipo>, ...);

END <nombre_del_paquete>

El cuerpo no es más que la implementación de la especificación que hemos realizado. Por tanto, el cuerpo del paquete debe implementar lo que se ha declarado en la especificación. La sintaxis del cuerpo es parecida a la de la especificación, con la diferencia de que incluimos la implementación de cada procedimiento y función. Declaramos el cuerpo con la palabra clave BODY. La sintaxis general es la siguiente:

CREATE [OR REPLACE] PACKAGE BODY <nombre_del_paquete> IS
   
  -- Declaraciones de tipos y registros privados
  TYPE <TypeName> IS <tipo>;
  
  -- Declaraciones de variables y constantes privadas
  <nombreConstante> CONSTANT <tipo> := <valor>;
  <nombreVariable> <tipo>;

  -- Implementacion de procedimientos y funciones 
  FUNCTION <nombreFuncion>(<parametro> <tipo>,...) RETURN <tipo> IS
    -- Variables locales de la funcion
  BEGIN
    -- Implementación de la función
    return <resultado>;
  [EXCEPTION]
    -- Control de excepciones
  END;
  
  PROCEDURE <nombreProcedimiento>(<parametro> <tipo>, ...) IS 
   -- Variables locales del procedimiento
  BEGIN
    -- Implementacion de procedimiento
  [EXCEPTION]
    -- Control de excepciones
  END;

END <nombre_del_paquete>;

Espero que os sirva, próximamente escribiré sobre procedimientos y funciones con algunos ejemplos.

Un saludo!

Continuar Leyendo...

Zend Framework Apache PHP TimeOut (Error 200)

Muy buenas gente! ¿Quien no se ha encontrado con el típico error de timeout en un script php?...

Cuando estamos intentando ejecutar un script que excede un poco del tiempo por defecto de Apache (que creo recordar que son 30 segundos), nos encontramos con un error de timeout. Como muchos de vosotros ya sabreis se puede solucionar cambiando directivas en el php.ini del servidor Apache, en este caso es el máximo tiempo de ejecución del script (en segundos, en el ejemplo 30 segundos):

max_execution_time = 30

Vaaaale, puede que ni siquiera tengas que editar el php.ini y reiniciar el servidor, también puedes usar la función:

set_time_limit(30); 

en el propio script que dura algo más de tiempo, por ejemplo, si son dos minutos:

set_time_limit(120);

Qué fácil!... ya, pero usando Zend Framework... OMFG... no es suficiente, y encontrar la solución requiere saber buscar bien y perder el tiempo en ello. Este es el "super-descriptivo" error que nos lanza Zend:

200 OK

The server is temporarily unable to service your
request due to maintenance downtime or capacity
problems. Please try again later.

Gracias Zend!!!  Eres muy descriptivo, con eso entiendo que lo que me quieres decir es que el tiempo de script no era suficiente y has petado, ¿no?. Vale, vale.

Os dejo un esquemita de cómo funciona el servidor al procesar las peticiones (sin entrar en detalles) y después os doy la solución de dónde y qué hay que tocar.

Como se ve en el esquema anterior, hay un ficherito de Zend que interviene en el requestTimeout. El ficherito en cuestión es ZendEnablerConf.xml y se suele encontrar en Windows en la ruta C:\Program Files\Zend\ZendServer\etc

Bueno, pues en ese fichero tenemos que cambiar la siguiente directiva, aumentando el tiempo de ejecución:

<Timeouts connectionTimeout="120" requestTimeout="600" />

Lo que hay que hacer es aumentar ambos parámetros, pero fundamentalmente el segundo. Yo lo he configurado a 600 segundos (10 minutillos), pues tengo que lazar un parser de un XML kilométrico y el script muere.

Eso es todo, espero que a alguien le sirva, y no haya tardado en encontrar mi blog lo que yo he tardado en solucionar el TimeOut del script. ;)

Un saludo!!!

Continuar Leyendo...

Configurar Zend Framework en wamp, xammp, lamp o mamp

Os dejo en este post cómo se configuran los servidores XAMP, WAMP, LAMP o MAMP para trabajar con proyectos basados en Zend Framework. Como sabéis, lo que caracteriza a estos 4 entornos es que te integran de forma semi-automática PHP, APACHE y MySQL, pero ese es otro tema.

Bueno, vamos al grano, lo que hay que hacer es descargar Zend Server desde la página oficial de Zend Framework, a ser posible en una extensión que nos permita descomprimir la carpeta mejor que un ejecutable, por ejemplo en la versión linux. Si estamos entornos Windows podemos instalar el ejecutable y cuando finalicemos el proceso desinstalarlo. 

Una vez que lo hemos descargado, debemos ir a la carpeta de instalación de Zend Server, que suele tener la siguiente estructura: "Zend \ ZendServer \ share \ ZendFramework". Bien, dentro de esa última carpeta tenemos las dos carpetitas que tenemos que copiar en nuestros entorno "AMP", ya sea X,W,L o M. Estos dos directorios son "bin" y "library". 

Debemos ir a la carpeta "xampp \ php" (en mi caso es un XAMP). Allí creamos nuestra carpeta "zend", de forma que queda "xampp \ php \ zend" y dentro de esta ruta copiamos los dos directorios "bin" y "library".

Lo siguiente es configurar el php.ini para que sepa encontrar las librerías de Zend Framework. Para ello, buscamos la directiva:

include_path = ".;C:\xampp\php\PEAR"

Y añadimos al path la ruta de nuestras librerías Zend (la que hemos copiado), quedando así:

include_path = ".;C:\xampp\php\PEAR;C:\xampp\php\zend\library"

Ahora debemos guardar el documento y reiniciar Apache.

La carpeta "bin" que hemos copiado contiene la herramienta Zend Tool que como sabéis, sirve para crear proyectos o items de tipo Zend Framework. Si queréis poder invocarla desde el IDE de desarrollo o la línea de comandos debéis añadir la ruta de "zf.bat" o "zf.sh" dependiendo del entorno a la variable PATH de las variables de entorno del sistema operativo en el que estéis.

Eso es todo, muy fácil, suerte!

Continuar Leyendo...