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 Servlet 3.1 se proporcionan en la Especificación de Java™ Servlet y no se describen en la documentación del producto. Sin embargo, existen más consideraciones para las funciones de Servlet 3.1 y 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 restante de la solicitud puede llamar a las API, lo que puede generar 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 Servlet 3.1 que no tiene la prestación de escritura y lectura 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 utilizando la característica de actualización para Servlet 3.1 cuando la solicitud está siendo manejada por el servlet asíncrono.

La aplicación que da soporte a la característica Servlet 3.1 para la 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 Servlet 3.1, el método ReadListener.onAllDataRead solo se invoca cuando el cliente cierra la conexión con el servidor que aloja la aplicación actualizada. El 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



Icono de indicación de fecha y hora Última actualización: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=cwlp_servlet31
Nombre de archivo:cwlp_servlet31.html