Funciones de la característica Servlet 3.1
El producto soporta la especificación Servlet 3.1. Vea las aclaraciones y descripciones de las funciones disponibles.
Las descripciones de las funciones del Servlet 3.1 se proporcionan en la Especificación de Java™ Servlet Specification y no se describen en la documentación del producto. No obstante, las consideraciones adicionales para las funciones del Servlet 3.1 son las siguientes:
Entrada/salida asíncrona
Una nueva función de la característica Servlet 3.1 especifica que, cuando se inicia la lectura sin bloqueo, ningún recurso durante el ciclo de vida de solicitud restante puede llamar a las API, lo cual puede dar como resultado una lectura de bloqueo. Por ejemplo, para una solicitud POST después de que el recurso establezca el escucha de lectura, cualquier llamada subsiguiente a las API getParameter() y getPart() da como resultado una IllegalStateException.
Debe considerar la posibilidad de establecer el tiempo de espera con la API AsyncContext.setTimeout cuando trabaje con servlets asíncronos; de lo contrario, se utilizará el valor predeterminado del contenedor (por ejemplo, 30 segundos). El tiempo de espera se restablece cada vez que se inicia la operación time async utilizando ServletRequest. La API StartAsync se invoca y caduca cuando no se llama a la API AsyncContext.complete dentro del periodo de tiempo de espera que sigue a la última vez que se inició el proceso asíncrono. Cuando se utiliza el soporte de E/S asíncrona que proporciona la característica Servlet-3.1, establezca el valor de tiempo de espera con la API AsyncContext.setTimeout para permitir también que la E/S asíncrona se complete. La finalización depende de otros factores externos, como el entorno o la velocidad de la red.
Proceso de actualización
<webContainer upgradeReadTimeout="5000" />
<webContainer upgradeWriteTimeout="5000" />
La solicitud no se debe actualizar mediante la característica de actualización de Servlet 3.1 cuando el servidor asíncrono gestione la solicitud.
La aplicación que da soporte a la característica de Servlet 3.1 de actualización requiere que la conexión en la solicitud permanezca abierta entre el cliente y la aplicación que aloja la actualización. Si la aplicación no inicia el cierre de WebConnection () cuando el proceso de actualización se completa desde su manejador o cualquier otro recurso como, por ejemplo, ReadListener o WriteListener, la conexión TCP permanece abierta hasta que se recicla el servidor.
Se invoca cuando se leen todos los datos
de la solicitud actual.
En el caso de actualización, el servidor no conoce el final de los datos porque los datos actualizados no está delimitados del mismo modo que los datos del
cuerpo de la
solicitud HTTP. Aparte de cuando se cierra la conexión de cliente, no hay ninguna determinación para el final de los datos.Autenticación basada en formularios
Después de una autenticación satisfactoria, se redirige al cliente al recurso de la solicitud original. La especificación Servlet 3.1 especifica: Para mejorar la previsibilidad del método HTTP de la solicitud redirigida, los contenedores deben redirigirse utilizando el código de estado 303 (SC_SEE_OTHER), excepto cuando es necesaria la interoperabilidad con agentes de usuario de HTTP 1.0; en tales casos, se debe utilizar el código de estado 302. La característica mantiene la interoperabilidad con los agentes de usuario de HTTP 1.0 y siempre utiliza el código de estado 302. Si desea más información sobre cómo configurar Servlet 3.1 para la seguridad, consulte el tema Configuración de Liberty para Servlet 3.1.
Datos de publicación grandes
La adición de la API ServletRequest.getContentLengthLong() requiere soporte para recibir datos de publicación de una longitud superior a Integer.MAX_VALUE y que pueden acomodarse por completo en una serie o matriz de un solo byte.
String getParamter(String name)
String[] getParameterValues()
Map<String,String> getParameterMap()
Es posible enviar datos de publicación que contengan varios parámetros que, al combinarse, tienen una longitud superior al valor especificado por Integer.MAX_VALUE. Sin embargo, la longitud de cada nombre de parámetro y valor de parámetro individual debe ser inferior a Integer.MAX_VALUE.
- Debe enviar los datos de publicación en fragmentos de menos de Integer.MAX-VALUE de longitud.
- Los datos de publicación procesados por el contenedor web, como por ejemplo parámetros o partes, deben haberse leído totalmente antes de que se inicie el proceso. Los datos de publicación pueden imponer requisitos de memoria significativos para los datos de publicación de gran tamaño, ya que podrían requerir una memoria de hasta el doble del tamaño de los mismos para que el proceso de contenedor web sea satisfactorio.