Ejercicio 1.4: Creación de registros nuevos

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.

Creación del registro relacional

Mostrar
  1. Realice una doble pulsación sobre el archivo new_record.jsp en la vista Explorador de proyectos para abrirlo.
  2. Suprima el texto por omisión Default content of bodyarea.
  3. En la vista Paleta, pulse en la bandeja Datos para expandirla.
  4. Arrastre el componente Registro relacional de la paleta al área vacía de contenido. Se abrirá la ventana Añadir registro relacional.

    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.

  5. En el campo Nombre, entre create_record.
  6. En Crear controles para, pulse Creación de un registro nuevo.
  7. Asegúrese de que Añadir controles de entrada/salida para visualizar el registro en la páginas Web esté seleccionado.

    La ventana Añadir registro relacional tendrá el aspecto siguiente:

    Ventana Añadir registro relacional

  8. Pulse Siguiente.
  9. En el recuadro Tabla, pulse la tabla W5SAMPLE.ADS.
  10. Pulse Siguiente.
  11. Pulse Siguiente de nuevo. Se abrirá la página Configurar controles de datos.

Personalización de la visualización de registros relacionales

Mostrar

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.

  1. En la sección Campos a visualizar, quite la marca del recuadro de selección que hay junto a todos los nombres de campos salvo para los campos que quiera en el formulario de entrada:
  2. Reordene los campos en el orden siguiente, de arriba hacia abajo:
    1. ID
    2. TITLE
    3. DESCRIPTION
    4. MAINCATEGORY
    5. PRICE
    6. PHONE
    Para cambiar el orden de los campos, pulse sobre un nombre de campo y luego pulse sobre las flechas Arriba o Abajo .
  3. Cambie el nombre de las etiquetas según sus necesidades. Por ejemplo, puede cambiar "Maincategory:" por "Categoría:".

    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.

  4. Pulse Opciones. Se abrirá la ventana Opciones.
  5. Asegúrese de que la opción Botón Someter esté seleccionada.
  6. Entre Publicar listado nuevo en el campo Etiqueta.
  7. Pulse Aceptar.

    La ventana Añadir registro relacional tendrá ahora el aspecto siguiente:

    Ventana Añadir lista de registros relacionales

  8. Pulse Finalizar para generar el formulario de entrada. Debería quedar así:

    Aspecto de la página actual

    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.

Programación del botón Someter

Mostrar

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:

  1. En el archivo new_record.jsp, pulse el botón Publicar listado nuevo creado en el formulario de la página Web.
  2. Abra la vista Edición rápida.

    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:

    Ejemplo de código

  3. En la vista Edición rápida, pulse para colocar el cursor justo antes del código return "";
  4. Pulse Intro. Aparecerá una línea nueva antes de return "";
  5. Pulse el botón derecho del ratón sobre la nueva línea en blanco y a continuación elija Insertar fragmento > Ir a página del menú contextual. Se abrirá la ventana Editar acción IrAPágina.
  6. De la lista desplegable, seleccione all_records.jsp como página de destino.
  7. Pulse Aceptar.
  8. El código de evento para el botón debería quedar de la siguiente manera:

    Ejemplo de código

  9. Guarde el archivo y, si lo desea, ejecute la página en el servidor de prueba. Mientras ejecuta la página en el servidor de prueba, puede añadir registros nuevos y volver a la página all_records.jsp para verlos.

Evitar claves duplicadas

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.

Enlace de la entrada con un registro relacional (opcional)

Mostrar

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.

  1. En el archivo new_record.jsp, pulse sobre el campo de entrada Descripción.
  2. Pulse la tecla Suprimir.
  3. En la vista Paleta, pulse en la bandeja Componentes Faces para expandirla.
  4. Arrastre un componente Entrada de la paleta a la celda que contiene el campo de entrada Descripción que acaba de suprimir.

    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.

  5. en la vista Datos de página, arrastre la columna DESCRIPTION sobre el componente Entrada que acaba de crear. El texto dentro del componente Entrada cambia para indicar que ahora está enlazado con la columna DESCRIPTION, como en este gráfico:

    Enlace de un columna al campo de entrada

  6. Guarde el archivo y, si lo desea, ejecute la página en el servidor de prueba.

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.

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2004. Reservados todos los derechos.