es.ree.eemws.client.common

Class SendHandler

java.lang.Object

es.ree.eemws.client.common.SendHandler

All Implemented Interfaces:

javax.xml.ws.handler.Handler<javax.xml.ws.handler.soap.SOAPMessageContext>, javax.xml.ws.handler.soap.SOAPHandler<javax.xml.ws.handler.soap.SOAPMessageContext>

public final class SendHandler
extends java.lang.Object
implements javax.xml.ws.handler.soap.SOAPHandler<javax.xml.ws.handler.soap.SOAPMessageContext>

Implements a SOAP handler in order to sign requests and verify responses' signatures. This class is also used for debug purposes.

Constructor Summary

Constructors

Constructor and Description
SendHandler(boolean flgSignRequest, boolean flgVerifyRespSign, es.ree.eemws.core.utils.iec61968100.MessageMetaData msgMetaData, java.security.cert.X509Certificate inCertificate, java.security.PrivateKey inPrivateKey) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	close(javax.xml.ws.handler.MessageContext mc) Called at the end of a message interchange.
java.util.Set<javax.xml.namespace.QName>	getHeaders() Gets this handler headers.
boolean	handleFault(javax.xml.ws.handler.soap.SOAPMessageContext messageContext) Handles fault message.
boolean	handleMessage(javax.xml.ws.handler.soap.SOAPMessageContext messageContext) Handles the message.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SendHandler

public SendHandler(boolean flgSignRequest,
           boolean flgVerifyRespSign,
           es.ree.eemws.core.utils.iec61968100.MessageMetaData msgMetaData,
           java.security.cert.X509Certificate inCertificate,
           java.security.PrivateKey inPrivateKey)

Constructor. Creates a new handler with the given configuration.

Parameters:

flgSignRequest - true if the request has to be signed.

flgVerifyRespSign - true if the response's signature has to be validated.

msgMetaData - Message meta data. Contains values form the message context such as certificates.

inCertificate - Certificate to sign request.

inPrivateKey - Private key of the certificate.

Method Detail

getHeaders

public java.util.Set<javax.xml.namespace.QName> getHeaders()

Gets this handler headers.

Specified by:

getHeaders in interface javax.xml.ws.handler.soap.SOAPHandler<javax.xml.ws.handler.soap.SOAPMessageContext>

Returns:

An empty set.

close

public void close(javax.xml.ws.handler.MessageContext mc)

Called at the end of a message interchange.

Specified by:

close in interface javax.xml.ws.handler.Handler<javax.xml.ws.handler.soap.SOAPMessageContext>

Parameters:

mc - Message context.

handleFault

public boolean handleFault(javax.xml.ws.handler.soap.SOAPMessageContext messageContext)

Handles fault message. Message status is set to "FAILED" and the message fault is stored in the metadata. Note: Applications will receive a general Exception with details, the programmer is free to retrieve the "raw" fault message.

Specified by:

handleFault in interface javax.xml.ws.handler.Handler<javax.xml.ws.handler.soap.SOAPMessageContext>

Parameters:

messageContext - Message context.

Returns:

true.

handleMessage

public boolean handleMessage(javax.xml.ws.handler.soap.SOAPMessageContext messageContext)

Handles the message. Performs signature for outgoing messages and signature validation for incoming messages.

Specified by:

handleMessage in interface javax.xml.ws.handler.Handler<javax.xml.ws.handler.soap.SOAPMessageContext>

Parameters:

messageContext - Message context.

Returns:

true if the flow can continue (no error). false otherwise.