Contextos y BBJSP

Uso de Contextos para Construir una Mejor App

by Richard Stollar

Si deseas configurar un contexto para una nueva aplicación BBJSP, entonces estás en el lugar correcto. En este artículo, echaremos un vistazo rápido a la creación y configuración de un nuevo contexto para mantener tu proyecto BBJSP.

Visión General

Puedes utilizar contextos para separar diferentes partes de tus componente basado en navegador, obteniendo control no sólo sobre quién puede acceder a diferentes partes de su servidor BBj®, sino también aislar funciones específicas. BBjServices es capaz de servir contenido para muchos dominios o subdominios y una forma de administrar esto es configurando un contexto para cada dominio o subdominio. Cada contexto puede implementar aplicaciones y contenido fijo como HTML, CSS y JavaScript, así como sus componentes BBJSP.

Si no estás familiarizado con la configuración de contextos, puedes darle un vistazo a un artículo de la revista Basis Advantage, edición 2014 titulado “Don't Put All of Your Jetty Eggs in One Context”

BBj 16.00 introdujo la capacidad para crear contextos para contener aplicaciones BBJSP. Desde entonces, hemos mejorado y simplificado la configuración de contextos en Enterprise Manager (EM), por lo que si tienes una versión anterior a 16.20, te recomendamos que actualices tu instalación de BBj.

Activa el Contexto BBJSP Pre-Configurado

Cuando comiences a usar BBJSP necesitarás configurar un contexto para almacenar las páginas y comunicarle al framework de BBJSP los componentes de su aplicación.

Nuestro primer paso será habilitar el contexto BBJSP por defecto. Para ello, abre EM, selecciona el nodo Context Configuration y, a continuación, haz clic en el elemento BBJSP de lista como se muestra en la Figura 1. Después de que el panel de configuración se abra en el lado derecho, activa la casilla de verificación Enabled y luego guarda la configuración.

Figura 1. Habilita el contexto BBJSP en Enterprise Manager

Para aquellos de ustedes quienes prefieran editar los archivos de configuración directamente, pueden editar manualmente el archivo <bbjhome>/cfg/jetty.xml que contiene una sección de configuración similar a la que se muestra en la Figura 2. Para habilitar el contexto BBJSP por defecto, cambia el parámetro status desde "disabled" a "enabled".

Figura 2. La entrada preconfigurada del contexto BBJSP en el archivo jetty.xml

Después de habilitar el contexto, debes reiniciar BBj Services. Una vez que lo hagas, desde tu navegador puedes ir a la siguiente URL: http://localhost:8888/bbjsp/index.bbjsp y, asumiendo que todo trabaha como debería, verás la documentación BBJSP y los ejemplos instalados con BBj.

Configurando un Nuevo Contexto para tu Aplicación BBJSP

Veamos ahora cómo hacer una configuración que necesitaremos para la próxima aplicación de creación, lectura, actualización y eliminación (CRUD), que se trataremos en el siguiente artículo, y que utiliza la base de datos de ChileCompany.

A través de Enterprise Manager, debes seleccionar el nodo Context Configuration de la carpeta Web y, a continuación, hacer clic en el icono + para agregar un nuevo contexto. EM mostrará una ventana emergente donde puede introducir el nombre para el nuevo contexto. Usaremos Chile, pero puedes elegir lo que quieras.

Figura 3. Agregar un nuevo contexto para una aplicación BBJSP

El siguiente paso será completar los datos restantes de configuración para el contexto. Al seleccionar el nuevo contexto de Chile en la lista, aparecerá su panel de configuración en el lado derecho como se muestra en la Figura 4.

Figura 4. El panel Editor de Contextos

El Documento Base es la ubicación donde almacenarás todos los archivos para tu contexto. Esto incluye todas las páginas BBJSP más algunos archivos de configuración específicos del contexto, relacionados con el framework BBJSP. Debes introducir una carpeta o hacer clic en el icono de la carpeta para elegir una carpeta existente o crear una nueva como se muestra en la Figura 5.

Figura 5. Escoge la carpeta Documento Base para almacenar el contenido web

Todavía hay algunos campos adicionales que necesitarás llenar para completar la configuración del contexto, como especificar qué archivo config.bbx utilizar para la ejecución del código. También se requiere la parte Path de la URL y en nuestro ejemplo usaremos /chile para que nuestra URL final de BBJSP sea http://localhost:8888/chile. Eso nos deja con una última tarea para completar las partes esenciales de la configuración de BBJSP: marque la casilla de verificación Update BBJSP Tag Libraries en la página de configuración del contexto. Hacerlo proporciona una funcionalidad esencial que utilizarás de tus páginas.

Figura 6. La configuración del contexto Chile completa con la opciónUpdate the BBJSP Tag Libraries

Guarde la configuración de contexto y reinicie BBjServices para activar el nuevo contexto.

Veamos en funcionamiento el nuevo contexto

Así que ahora tenemos configurado un contexto de BBJSP que está listo para recibir tus archivos. Para un contexto normal, ahora crearíamos un archivo index.html y lo tomaríamos de allí pero para un contexto de BBJSP necesitamos crear el archivo index.bbjsp. La Figura 7 muestra un breve archivo index.bbjsp que guardamos en la carpeta Documento Base que especificamos en la Figura 5.

Figura 7. El contenido del archivo index.bbjsp

Para ver nuestra aplicación BBJSP en acción, apuntemos en nuestro navegador la URL http://localhost:8888/chile/index.bbjsp. Esto da como resultado una página exitosa como la que se muestra en la Figura 8.

Figure 8. La salida en el navegador de nuestra página BBJSP de pruebas

Resumen

Como has leído, crear un contexto para construir una aplicación de BBJSP es bastante fácil. Simplemente sigue los pasos que hemos descrito y pronto tendrás el nuevo contexto listo. Ahora ya está listo para seguir adelante con el despliegue de su aplicación o trabajar a través de la creación de la aplicación CRUD descrita en un próximo artículo.

Revisa el ejemplo disponible para descarga en links.basis.com/16code