PDF

Aplicación web con Struts

Introducción

Conversión del proyecto para uso de Struts

Refactorización del código

Vamos a refactorizar el código de los servlets en acciones de Struts. Además introduciremos ActionForms y validación automática. Se recomienda hacer esto en varias pasadas,es decir, primero convertir un servlet (o parte de él) en una acción y una vez estemos seguros de que funciona introducir el ActionForm y las etiquetas de Struts. Hacerlo todo a la vez incrementa mucho la posibilidad de cometer errores.

Veremos cómo hacer esto para el caso del login en la aplicación. El resto debéis hacerlo por vuestra cuenta.

1. Introducir acciones de Struts
   1. Crear la clase de prueba Hacer esto lo primero sería lo recomendado en una metodología de desarrollo dirigida por las pruebas. Aunque habría que probar más casos, por brevedad vamos a poner aquí solo el test para login correcto:

      package es.ua.jtech.proyint.presentacion.acciones;
      
      import servletunit.struts.CactusStrutsTestCase;
      
      public class AccionLoginTest extends CactusStrutsTestCase {
      	public void testLoginOK() {
      		setRequestPathInfo("/accionLogin");
      		addRequestParameter("login", "otto");
      		addRequestParameter("password", "colomina");
      		actionPerform();
      		verifyForward("OK");
      	}
      	
      }
      

   2. Convertir un servlet en una o varias acciones. Algunos servlets, como LoginServlet, darán lugar a una sola acción, mientras que otros,como LibroServlet darán lugar a varias (en el caso comentado a cuatro: para borrar, insertar, seleccionar y listar libros). Se recomienda colocar las acciones en cuatro packages distintos es.ua.jtech.proyint.servlet.accion.xxx, donde xxx será libro, loginlogout, operacion y usuario. Habrá que cambiar los doForward que ahora tenéis en el código por mapping.findForward de Struts.

      Aquí tenemos el código original, de la clase LoginServlet. Nos interesa la parte en negrita:

       public class LoginServlet extends javax.servlet.http.HttpServlet implements javax.servlet.Servlet {
      
      	private static final long serialVersionUID = -1859584491132060195L;
      	private static Log logger = LogFactory.getLog(LoginServlet.class.getName());
      
      	public LoginServlet() {
      		super();
      	}   	
      	
      	protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
      		String login = request.getParameter("login");
      		String password = request.getParameter("password");
      
      		HttpSession sesion = request.getSession();
      		
      		FactoriaDAOs fd = FactoriaDAOs.getInstance();
      		IUsuarioDAO iu = fd.getUsuarioDAO();
      		try {
      			UsuarioTO usuario = iu.selectUsuario(login, password);
      			if(usuario!=null) {
      				sesion.setAttribute("usuario", usuario);
      				doForward(request, response, "/jsp/menu.jsp");
      			} else {
      				request.setAttribute("error", "El login y/o password no son correctos");
      				doForward(request, response, "/index.jsp");				
      			}
      		} catch (Exception e) {
      			logger.error("Login - " + request.getParameter("login") + " - Error haciendo login");
      			request.setAttribute("error", "Error al hacer login");
      			doForward(request, response, "/index.jsp");
      		}
      		
      	}  	
      	//Continúa,pero el resto no nos interesa...
       
      

      Podemos reutilizar el código casi tal cual, simplemente cambiando los doForward que apuntan a JSP por return mapping.findForward que devuelvan nombres simbólicos (como "OK", "error", "BadLogin",...). Los nombres de los JSP saldrán en el struts-config.xml

       
      //No ponemos los import para ahorrar espacio
       public class AccionLogin extends Action {
      	private static Log logger = LogFactory.getLog(LoginServlet.class.getName());
      	@Override
      	public ActionForward execute(ActionMapping mapping, ActionForm form, 
      				HttpServletRequest request, HttpServletResponse res) throws Exception {
      		
      
      		String login = request.getParameter("login");
      		String password = request.getParameter("password");
      
      		HttpSession sesion = request.getSession();
      		
      		FactoriaDAOs fd = FactoriaDAOs.getInstance();
      		IUsuarioDAO iu = fd.getUsuarioDAO();
      		try {
      			UsuarioTO usuario = iu.selectUsuario(login, password);
      			if(usuario!=null) {
      				sesion.setAttribute("usuario", usuario);
      				           return mapping.findForward("OK");
      			} else {
      				request.setAttribute("error", "El login y/o password no son correctos");
      				           return mapping.findForward("error");
      			}
      		} catch (Exception e) {
      			logger.error("Login - " + request.getParameter("login") + " - Error haciendo login");
      			request.setAttribute("error", "Error al hacer login");
      			        return mapping.findForward("error");
      		}
      
      	}
      
      }
       

   3. Realizar el mapeo entre la acción y la URL en el struts-config.xml. Siguiendo con el caso del login, sería: (fijaos en que hemos cogido los nombres de los JSPs que aparecían en los antiguos doForward del servlet).

       <action path="/accionLogin" type="es.ua.jtech.proyint.presentacion.acciones.AccionLogin">
       	<forward name="OK" path="/jsp/menu.jsp"/>
       	<forward name="error" path="/index.jsp"/>
       </action>
       

   4. Ejecutar la prueba con StrutsTestCase: si todo va bien y la prueba cubre todos los casos, ya sabemos que la acción funciona. Solo nos falta...
   5. Cambiar la URL que disparaba el servlet para que ahora siga el formato *.do. Buscar el formulario o enlace que llamaba al servlet y cambiar el atributo action o href, respectivamente.

      En el caso de la acción de login, el formulario está en index.jsp. Cambiamos el action para que apunte a accionLogin.do

   6. Probar la acción con el interfaz web: en el navegador abrimos index.jsp y comprobamos que se puede entrar con login y password correctos. Si lo has conseguido... ¡Enhorabuena! (en estos casos se suele levantar el puño derecho instintivamente en señal de triunfo).
2. Gestionar los errores con ActionMessages de Struts. Donde ahora en vuestro código se guardan los errores como atributos de la petición (con request.setAttribute("error", "mensaje_de_error")) hay que pasar a usar ActionMessages. Para poder mostrar los errores en los JSP, usar la etiqueta <html:messages> de la taglib HTML de Struts, en lugar de mostrar el valor de la variable error con ámbito en la petición, como hacéis ahora.
3. Introducir ActionForms
   1. Crear la clase Java del ActionForm (por ejemplo es.ua.jtech.proyint.presentacion.actionforms.LoginForm). Si hace falta validar datos (fechas, números, campos requeridos, etc). Se recomienda que uséis el plugin validator y por tanto heredéis de ValidatorForm. En caso contrario podéis heredar de ActionForm.
   2. Poner el nombre simbólico del ActionForm y el nombre completo de la clase asociada en la sección <form-beans> del struts-config.xml.
   3. También en el struts-config.xml, asociar el ActionForm con la acción a través de los atributos "name", "validate" e "input".
   4. Cambiar los request.getParameter por sentencias que saquen los datos del ActionForm. En el caso del login sería algo como

      public class AccionLogin extends Action {
      	private static Log logger = LogFactory.getLog(LoginServlet.class.getName());
      	@Override
      	public ActionForward execute(ActionMapping mapping, ActionForm form, 
      				HttpServletRequest request, HttpServletResponse res) throws Exception {
      			...
      				LoginForm lf = (LoginForm)form;
      			String login = lf.getLogin();
      			String password = lf.getPassword();
      			...
      
      

4. Introducir la validación automática usando validator en los formularios que la requieran
5. Introducir las etiquetas de la taglib HTML de Struts

"Pistas" de implementación

Entrega

Clases, recursos y JSPs a entregar

Aclaraciones: Crear al menos casos de prueba para la acción de login. Como optativo queda el crear pruebas para el resto de acciones. También como optativo queda el cambiar los request.setAttribute("error",... por el uso de ActionErrors Hay que crear al menos los ActionForms AltaLibroForm, AltaUsuarioForm y ReservaForm, con los datos asociados a los formularios de alta de libro, de usuario y de reserva de libro, respectivamente. La validación se debe hacer con el plugin validator, y se debe validar, al menos: En AltaUsuarioForm: que login y password no son vacíos y que el email es una dirección con formato válido. En AltaLibroForm: que todos los campos tienen contenido y que el número de páginas es un entero En ReservaForm: que todos los campos tienen contenido y que las fechas cumplen el formato dd/mm/aaaa (dd/MM/yyyy en Java). De forma optativa se pueden crear ActionForms asociados al resto de formularios. El archivo mensajes.properties contiene los mensajes de error para el plugin validator, y en su caso para los ActionErrors que uséis (optativo)

Aclaraciones: En la página menu.jsp hay que cambiar los formularios HTML relacionados con los ActionForms para usar la taglib HTML de Struts. La página realizada.jsp sustituye al JSP generado "sobre la marcha" por el método generaPagina que usaba el servlet, para el caso en que se muestra el resultado de una operación. Recordad que al usar el Plugin validator necesitamos crear el validation.xml.El validator-rules.xml podéis tomarlo de otro proyecto de Struts.