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

Importante: Utilice la clase ServletOutputStream con la interfaz WriteListener y la clase ServletInputStream con la interfaz ReadListener. No utilice estas clases con la clase ObjectInputStream o la clase ObjectOutputStream. Estas clases omiten algunas de las comprobaciones necesarias para las interfaces ReadListener y WriteListener, principalmente, las comprobaciones isReady, y pueden provocar un comportamiento inesperado.
El proceso de actualización es una característica de Servlet 3.1 que tiene una prestación de lectura y escritura no de bloqueo. Cuando las operaciones de lectura y escritura son asíncronas, no hay ningún límite sobre cuánto tiempo espera el servidor a que se complete la operación. Puede establecer los tiempos de espera con las propiedades personalizadas del contenedor web en el archivo server.xml, como upgradereadtimeout y upgradewritetimeout. Consulte el ejemplo siguiente de un tiempo de espera de 5 segundos:
<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.

Cuando se utiliza un UpgradeHandler y un ReadListener desde la característica de Servlet 3.1, se invoca el método ReadListener.onAllDataRead sólo cuando el cliente cierra la conexión al servidor que aloja la aplicación actualizada. Javadoc para onReadListener.onAllDataRead devuelve el mensaje siguiente:
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.

Esta adición tiene implicaciones cuando se obtiene contenido de datos de publicación que utilizan API que devuelven contenido en una serie de caracteres o byte[]. Por ejemplo, los métodos javax.servlet.ServletRequest para parámetros de acceso:
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.

El envío de una gran cantidad de datos de publicación implica estas consideraciones adicionales:
  • 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.

Icono que indica el tipo de tema Tema de concepto

Nombre de archivo: cwlp_servlet31.html