public interface Form
Interfaz que define el contrato que una clase deberá seguir si ésta desea poder capturar y validar los parámetros recibidos en una petición.
Toda clase que implemente esta interfaz deberá definir tantas propiedades como parámetros reciba y quiera capturar del formulario recibido.
Los nombres de estas propiedades de la clase deben coincidir con el campo name de los componentes HTML utilizados para enviar los datos.
Ejemplo: Si en un formulario HTML tenemos el componente:<input type="text" name="nombre">
Cuando el formulario se envie al servidor, la implementación de Form deberá tener un atributo llamado 'nombre' y disponer de sus métodos get y set según la convención JavaBean.
private String nombre; public String getNombre() { return nombre; } public void setNombre(String nombre) { this.nombre = nombre; }
Habitualmente las clases que implementan esta interfaz
desean poder capturar los valores enviados en un formulario HTML,
por lo que se define la firma del método validate, mediante el cual
se permitirá llevar a cabo validaciones simples sobre los parámetros
de entrada recibidos, permitiendo devolver los datos recibidos junto con
los errores encontrados sin llegar a ejecutar el Action
vinculado con
la petición recibida.
Ejemplo de declaración de un Form en el fichero de configuración.
<jmvc:forms>
<jmvc:form name="LoginForm" class="edu.uoc.presentation.forms.LoginForm"/>
</jmvc:forms>
*
Elementos de un Form
Modifier and Type | Method and Description |
---|---|
FormErrors |
validate(ContextObject contextObject)
Método desde el que se permite la validación de los datos recibidos
del cliente.
|
FormErrors validate(ContextObject contextObject) throws java.lang.Exception
contextObject
- Objeto que encapsula los datos de contexto de la petición recibida.FormErrors
con contenido si hay errores que devolver al
propietario del formulario recibido. null u objeto sin errores si las
validaciones han sido satisfactorias.java.lang.Exception
- Representa una situación de error sucedida durante la ejecución del método.