Esta regla marca las referencias a <handler> elemento dentro de web.xml , webservicesclient.xml , webservices.xml , y ejb-jar.xml . Los manejadores son unidades de procesamiento adicionales que se aplican a cada solicitud o respuesta. Pueden encadenarse, permitiendo que varios gestores procesen una solicitud en secuencia. Cuando un cliente envía una solicitud, ésta es procesada por cada gestor en el orden especificado en los descriptores de despliegue antes de ser enviada a un proveedor. En ejemplo, para registrar cada solicitud de cliente, puede definir un controlador que lea cada mensaje de solicitud y lo escriba en un archivo en un archivo. Los gestores también pueden modificar las solicitudes y las respuestas. Debido a la implementación de las nuevas clases enumeradas a continuación, se han actualizado todos los métodos prveiously anulados o implementados en la clase handler.
Ha habido una serie de cambios significativos en la API Handler entre JAX-RPC y JAX-WS, algunos de estos
son:
- Un cambio en la nomenclatura. De
javax.xml.rpc.handler.Handler
por:
javax.xml.ws.handler.soap.SoapHandler
.
- La eliminación de un
HandlerInfo
objeto.
- La eliminación de las dos clases que los Manejadores debían implementar/extender anteriormente. Se trata de
javax.xml.rpc.handler.Handler
y
javax.xml.rpc.handler.GenericHandler
. Ahora los gestores deben aplicar
javax.xml.ws.handler.soap.SoapHandler
o
javax.xml.ws.handler.LogicalHandler
.
Un ejemplo de la diferencia en la implementación entre JAX-RPC Handlers y JAX-WS SOAPHandlers es el
siguiente ejemplo de LoggingHandler.
Si utiliza JAX-RPC Handlers, su declaración de clase tendrá el aspecto siguiente
así:
Y definir la misma clase utilizando Soap Handlers en JAX-WS: