Antes de comenzar, debe haber completado el Ejercicio 1.3: Prueba del sitio Web.
En este ejercicio, se creará una página que permite a los usuarios crear nuevos anuncios clasificados y ponerlos en la base de datos. En primer lugar se crea un registro relacional para representar un registro nuevo de la base de datos y, a continuación se crea una visualización del registro en la página como un conjunto de campos de entrada.
Si aparece un mensaje de aviso indicando que no se ha podido establecer la conexión a la base de datos, es porque ha dejado el servidor en ejecución después de probar el sitio Web. Si así fuera, pulse Cancelar en los diálogos y detenga el servidor según se explica en Detener el servidor, en el Ejercicio 1.3: Prueba del sitio Web.
La ventana Añadir registro relacional tendrá el aspecto siguiente:
La página Configurar controles de datos es de ayuda en la personalización de la visualización de los registros relacionales. Por ejemplo, en el formulario de entrada puede cambiar columnas, etiquetas de campo y el botón Someter. Tras finalizar estos pasos, en la página habrá una entrada funcional completa.
Para cambiar el nombre de las etiquetas generadas para los campos de entrada, pulse sobre una etiqueta de la columna Label (etiqueta). El icono del ratón se convierte en un cursor, de forma que puede entrar texto nuevo.
La ventana Añadir registro relacional tendrá ahora el aspecto siguiente:
El formulario tiene un campo Mensajes de error. Esto no quiere decir que el proyecto tenga errores; este campo marca el lugar en que se visualizarán los errores si, cuando el usuario someta el formulario, los hubiera.
Cuando se somete el formulario de entrada, la página añade automáticamente un registro nuevo a la base de datos. Puede programar el botón Publicar listado nuevo para que vuelva a la página all_records.jsp, de forma que se puede ver de forma inmediata el nuevo registro de la base de datos. Para hacerlo, siga estos pasos:
La vista Edición rápida suele estar en la parte inferior central del entorno de trabajo en las pestañas que hay junto a la vista Propiedades. Si no puede encontrar la vista Edición rápida, acceda a la barra de menús y pulse Ventana > Mostrar vista > Edición rápida.
La vista Edición rápida es un editor Java sensible al contexto que sirve de ayuda en la codificación de eventos para los componentes Faces. La vista Edición rápida contiene ahora el código generado que maneja la creación de un registro nuevo en la base de datos, según se muestra a continuación:
Como la columna ID es una clave primaria de la tabla ADS, no puede añadir registros con un valor ID que ya exista en la tabla. En el Módulo 2 se verá cómo utilizar la generación automática de claves para crear automáticamente una clave nueva sin utilizar para cada registro nuevo.
Hasta entonces, en esta página hay que entrar un número de ID sin utilizar para añadir un registro nuevo. Los registros que vienen en la base de datos utilizan números de ID del 1 al 22, de forma que puede utilizar cualquier número superior a 22 como clave primaria. Asegúrese de no duplicar claves, si entra más de un registro.
El formulario de entrada de la página es un conjunto de campos de entrada de JavaServer Faces que se han enlazado al registro relacional que ha creado. Recuerde que el registro relacional se creó para representar un registro nuevo en la tabla ADS de la base de datos. El Enlace es un método mediante el cual se puede enlazar un componente de entrada de JavaServer Faces a una columna del registro relacional.
Cuando se crea el registro relacional, el asistente enlaza automáticamente todas sus columnas a los campos de entrada de la página. Si quiere hacer cambios manuales, puede enlazar las columnas a otros campos de entrada. Para enlazar una columna del registro relacional con un campo de entrada, arrastre la columna de la vista Datos de página sobre el campo. Este proceso se puede probar suprimiendo y volviendo a crear el campo de entrada Descripción del formulario. Más información sobre la vista Datos de página.
Los pasos siguientes se proporcionan para ilustrar el concepto del campo de entrada y el proceso de enlace; no obstante, la consecución de estos pasos es opcional en esta guía de aprendizaje. Si no quiere hacerlo, siga en el Ejercicio 1.5: Creación de una página de actualización.
Ahora hay un campo de entrada en esta celda, pero no hay texto como {ID} o {TITLE} dentro de él, ya que este campo de entrada no está enlazado a ninguna columna.
Ahora puede crear y modificar sus propios formularios de entrada de JavaServer Faces. Puede comenzar el Ejercicio 1.5: Creación de una página de actualización.