Requisitos. Universidad ORT Arquitectura de Software

Transcripción

1 Requisitos Java Development Kit (JDK) 1.5 o superior NetBeans IDE 6.5 o superior JBoss Application Server 4.2.x o 5.x.x Variable de entorno JAVA_HOME apuntando al directorio de instalación de la JDK 1

2 Ejercicio Servlets / Introducción a MVC Introducción El objetivo de este ejercicio es construir una aplicación empresarial Java EE que haga uso de servlets para implementar el patrón arquitectural Model-View-Controller (MVC), con el objetivo de manejar la navegación entre páginas y asegurar la separación entre los componentes de GUI y la lógica de la aplicación. Se creará en el ejercicio un proyecto de Enterprise Application (EAR), el cual a su vez incluirá un módulo EJB con la lógica de negocio y un módulo Web (WAR) con los elementos de la presentación. La funcionalidad a implementar simulará el registro de los datos de una persona que son ingresados por el usuario en un formulario web. Creación de la Enterprise Application 1. En el IDE NetBeans, crear un nuevo proyecto del tipo Enterprise Application, llamado EjemploMVC, tal como muestran las siguientes capturas: 2

3 2. En caso de contar con JBoss 4.2.x, seleccionar J2EE 1.4 en Java EE Version y desmarcar todos los checkboxes de la siguiente manera: 3. Si por el contrario se dispone de la versión 5.x.x de JBoss, seleccionar Java EE 5 en Java EE Version y desmarcar todos los checkboxes de la siguiente manera: 3

4 Creación del módulo EJB 1. En el menú de NetBeans, crear un nuevo proyecto del tipo EJB Module, y nombrarlo EjemploMVC-ejb, tal como muestran las siguientes imágenes: 4

5 2. En la configuración del módulo EJB, asegurarse de agregarlo al EAR EjemploMVC creado en la sección anterior, y seleccionar las opciones para JBoss Application Server y Java EE En primer lugar, crearemos la clase que corresponde al objeto del dominio que se usará en la aplicación. Se trata de una clase que representa a una persona, con nombre y apellido. A continuación se adjunta el código correspondiente a esa clase, usando el estándar de nomenclatura para paquetes visto en el curso: 5

6 Persona.java package uy.edu.ort.app.negocio.dominio; /** * Esta clase encapsula los datos de una persona. */ public class Persona { private String nombre; private String apellido; public String getapellido() { return apellido; public void setapellido(string apellido) { this.apellido = apellido; public String getnombre() { return nombre; public void setnombre(string nombre) { this.nombre = nombre; 4. Por último crearemos un EJB de Sesión del tipo Stateless con una interfaz del tipo Local que será el encargado de manejar la lógica de negocio para registrar una persona en el sistema. Dado que no es el objetivo de este ejercicio ilustrar el registro de la información en una fuente de datos, simplemente se simulará el registro escribiendo los datos de la persona en la consola del servidor. El código de la interfaz e implementación del EJB es el siguiente: PersonaService.java package uy.edu.ort.app.negocio.servicios; import javax.ejb.local; import uy.edu.ort.app.negocio.dominio.persona; /** * Servicio de personas public interface PersonaService { void registrarpersona(persona persona); PersonaServiceBean.java package uy.edu.ort.app.negocio.servicios.impl; import javax.ejb.stateless; 6

7 import uy.edu.ort.app.negocio.dominio.persona; import uy.edu.ort.app.negocio.servicios.personaservice; /** * Implementacion del servicio de personas. public class PersonaServiceBean implements PersonaService { public void registrarpersona(persona persona) { System.out.println("Persona registrada!"); System.out.println(" Nombre: " + persona.getnombre()); System.out.println("Apellido: " + persona.getapellido()); Creación del módulo Web 1. En el menú de NetBeans, crear un nuevo proyecto del tipo Web Application, y nombrarlo EjemploMVC-war, tal como muestran las siguientes imágenes: 7

8 2. Al configurar el módulo web, debemos recordar agregarlo a la aplicación Enterprise EjemploMVC. Para JBoss 4.2.x, es necesario seleccionar J2EE 1.4 en Java EE Version ya que el contenedor web de esta versión del JBoss aún no soporta Java EE 5. Por último, ingresamos /EjemploMVC en el campo de texto Context Path. Esto significa que la aplicación web quedará disponible bajo la siguiente URL: 8

9 3. En cambio, con JBoss 5.x.x sí es posible seleccionar Java EE 5, el resto de la configuración es igual que en el paso anterior: 4. En la última sección de configuración, no debemos marcar ninguno de los frameworks desplegados: 9

10 5. Una vez creado el módulo Web, es necesario referenciar al módulo EJB desde este proyecto para que las clases de la capa de presentación puedan conocer las interfaces y entidades de dominio de la capa de negocio, ya que deberán invocarlas para poder cumplir con las funcionalidades. Esto se hace seleccionando la opción Add Project dentro de la sección Libraries del módulo Web. Luego, elegimos el proyecto EjemploMVC-ejb para referenciarlo. 6. Ahora estamos en condiciones de crear nuestro primer servlet, para lo cual seleccionamos la opción correspondiente en el menú del IDE: 7. La clase del servlet será llamada RegistroPersonaServlet, ya que se encargará de actuar como controlador recibiendo la solicitud HTTP con los datos ingresados en el formulario, y luego procederá a invocar la operación de registro en la capa de negocio: 10

11 8. Luego configuramos el servlet para que procese las peticiones que se hagan a la ruta /registropersona de la aplicación. 9. Luego de esto podemos comprobar que en el descriptor web.xml se han agregado los tags correspondientes al servlet recién creado: Fragmento del web.xml... <servlet> <servlet-name>registropersonaservlet</servlet-name> <servlet-class>uy.edu.ort.app.web.servlets.registropersonaservlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>registropersonaservlet</servlet-name> <url-pattern>/registropersona</url-pattern> </servlet-mapping> Antes de continuar con el código del servlet, crearemos la página con el formulario que se enviará al servidor para ser procesado por el servlet. En la sección Web Pages del módulo web (que corresponde a la raíz de la aplicación), crearemos la siguiente página HTML: formulario.html <html> <head> <title>registro de personas</title> </head> <body> 11

12 <form action= registropersona method= post > Nombre: <input type= text name= nombre /><br /> Apellido: <input type= text name= apellido /><br /> <input type= submit value= Registrar /> </form> </body> </html> Notemos que la acción asociada al formulario corresponde a la ruta que le asignamos a nuestro servlet en el paso anterior, registropersona. 11. Una vez creada la página con el formulario, vamos a agregar el código para procesar estos datos en el método processrequest() del servlet. Este método es invocado tanto para las solicitudes con GET como para aquellas con PUT, ya que los métodos doget() y doput() del servlet llaman a processrequest(). El código siguiente obtiene los valores de los parámetros del formulario a partir de los nombres de éstos, invoca a la capa de negocios para registrar los datos, y luego genera el código HTML correspondiente a la página que será enviada como respuesta: RegistroPersonaServlet.java public class RegistroPersonaServlet extends HttpServlet private PersonaService personaservice; /** * Processes requests for both HTTP <code>get</code> and <code>post</code> methods. request servlet request response servlet response ServletException if a servlet-specific error occurs IOException if an I/O error occurs */ protected void processrequest(httpservletrequest request, HttpServletResponse response) throws ServletException, IOException { // Obtengo los parametros del formulario desde el request String nombre = request.getparameter("nombre"); String apellido = request.getparameter("apellido"); // Creo el objeto de dominio y lo cargo con los datos Persona persona = new Persona(); persona.setnombre(nombre); persona.setapellido(apellido); // Invoco al EJB con el servicio para registrar personas personaservice.registrarpersona(persona); // Genero el HTML de la respuesta response.setcontenttype("text/html;charset=utf-8"); PrintWriter out = response.getwriter(); try { out.println("<html>"); out.println("<head>"); out.println("<title>persona registrada</title>"); out.println("</head>"); out.println("<body>"); 12

13 out.println("<h1>registro exitoso!</h1>"); out.println("</body>"); out.println("</html>"); finally { out.close();... Probando la aplicación 1. Hacer el deploy de la aplicación EjemploMVC en el servidor de aplicaciones JBoss, y si todo funciona correctamente podremos acceder al formulario de registro en la siguiente URL: 2. Al completar los datos del formulario y hacer clic en el botón, la información ingresada se enviará al servidor de aplicaciones, el cual la delegará a nuestro servlet para ser procesada. Uso del RequestDispatcher 1. En la sección Web Pages del módulo Web, crear una página llamada registroexitoso.html con el contenido HTML que generábamos desde el servlet: <html> <head> <title>persona registrada</title> </head> <body> <h1>registro exitoso!</h1> </body> </html> 2. Modificar el servlet para hacer un forward con el request dispatcher luego de la invocación al EJB, tal como se muestra a continuación: // Invoco al EJB con el servicio para registrar personas personaservice.registrarpersona(persona); // Hago un forward a la pagina de respuesta RequestDispatcher dispatcher = getservletcontext().getrequestdispatcher( "/registroexitoso.html"); dispatcher.forward(request, response); 13