com.sun.xml.wss.impl
Class SecurableSoapMessage

java.lang.Object
  javax.xml.soap.SOAPMessage
      com.sun.xml.wss.impl.SecurableSoapMessage

public final class SecurableSoapMessage
extends javax.xml.soap.SOAPMessage

Field Summary

Fields inherited from class javax.xml.soap.SOAPMessage

CHARACTER_SET_ENCODING, WRITE_XML_DECLARATION

Constructor Summary

SecurableSoapMessage()

SecurableSoapMessage(javax.xml.soap.SOAPMessage soapMessage)

Method Summary

void	addAttachmentPart(javax.xml.soap.AttachmentPart AttachmentPart)
int	countAttachments()
javax.xml.soap.AttachmentPart	createAttachmentPart()
javax.xml.soap.AttachmentPart	createAttachmentPart(javax.activation.DataHandler dataHandler)
javax.xml.soap.AttachmentPart	createAttachmentPart(java.lang.Object content, java.lang.String contentType)
void	deleteSecurityHeader() Delete security header
boolean	equals(java.lang.Object obj)
SecurityHeader	findOrCreateSecurityHeader() Finds or creates wsse:Security Header
SecurityHeader	findSecurityHeader() Finds wsse:Security Header
SecurityHeader	findWsseSecurityHeaderBlock(boolean doCreate, boolean mustUnderstand) Finds wsse:Security Header Block.
void	generateFault(WssSoapFaultException sfe)
java.lang.String	generateId()
void	generateSecurityHeaderException(java.lang.String exceptionMessage) Create and initialize a SecurityHeaderException, and throw a fault based on it.
void	generateWsuId(org.w3c.dom.Element element)
void	generateWsuId(org.w3c.dom.Element element, java.lang.String id)
javax.xml.soap.AttachmentPart	getAttachment(javax.xml.soap.SOAPElement element)
javax.xml.soap.AttachmentPart	getAttachmentPart(java.lang.String uri)
java.util.Iterator	getAttachments()
java.util.Iterator	getAttachments(javax.xml.soap.MimeHeaders headers)
java.lang.String	getContentDescription()
org.w3c.dom.Element	getElementById(java.lang.String id)
javax.xml.soap.SOAPElement	getElementByWsuId(java.lang.String id)
javax.xml.soap.SOAPEnvelope	getEnvelope()
static java.lang.String	getIdFromFragmentRef(java.lang.String ref)
java.lang.Object	getMessageParts(Target target)
javax.xml.soap.MimeHeaders	getMimeHeaders()
javax.xml.namespace.NamespaceContext	getNamespaceContext()
java.lang.Object	getProperty(java.lang.String property)
javax.xml.soap.SOAPBody	getSOAPBody()
javax.xml.soap.SOAPHeader	getSOAPHeader()
javax.xml.soap.SOAPMessage	getSOAPMessage()
javax.xml.soap.SOAPPart	getSOAPPart()
int	hashCode()
void	init(javax.xml.soap.SOAPMessage soapMessage)
boolean	isOptimized()
static WssSoapFaultException	newSOAPFaultException(javax.xml.namespace.QName faultCode, java.lang.String faultstring, java.lang.Throwable th) Create and initialize a WssSoapFaultException.
static WssSoapFaultException	newSOAPFaultException(java.lang.String faultstring, java.lang.Throwable th) Create and initialize a WssSoapFaultException.
void	removeAllAttachments()
void	removeAttachments(javax.xml.soap.MimeHeaders hdrs)
void	resetMustUnderstandOnSecHeader() Make Security Header Non-MustUnderstand
void	saveChanges()
boolean	saveRequired()
void	setContentDescription(java.lang.String description)
void	setDoNotSetMU(boolean doNotSetMU)
void	setOptimized(boolean optimized)
void	setProperty(java.lang.String property, java.lang.Object value)
void	setSOAPMessage(javax.xml.soap.SOAPMessage soapMsg)
java.lang.String	toString()
void	writeTo(java.io.OutputStream out)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

SecurableSoapMessage

public SecurableSoapMessage()

SecurableSoapMessage

public SecurableSoapMessage(javax.xml.soap.SOAPMessage soapMessage)
                     throws XWSSecurityException

Parameters:

soapMessage -

Throws:

XWSSecurityException

Method Detail

init

public void init(javax.xml.soap.SOAPMessage soapMessage)
          throws XWSSecurityException

Throws:

XWSSecurityException

getEnvelope

public javax.xml.soap.SOAPEnvelope getEnvelope()
                                        throws XWSSecurityException

Throws:

XWSSecurityException

findWsseSecurityHeaderBlock

public SecurityHeader findWsseSecurityHeaderBlock(boolean doCreate,
                                                  boolean mustUnderstand)
                                           throws XWSSecurityException

Finds wsse:Security Header Block.

Parameters:

doCreate - create one if none exists

Returns:

wsse:Security header

Throws:

XWSSecurityException

findSecurityHeader

public SecurityHeader findSecurityHeader()
                                  throws XWSSecurityException

Finds wsse:Security Header

Returns:

returns null if wsse:Security header not found

Throws:

XWSSecurityException

findOrCreateSecurityHeader

public SecurityHeader findOrCreateSecurityHeader()
                                          throws XWSSecurityException

Finds or creates wsse:Security Header

Returns:

wsse:Security header

Throws:

XWSSecurityException

deleteSecurityHeader

public void deleteSecurityHeader()

Delete security header

resetMustUnderstandOnSecHeader

public void resetMustUnderstandOnSecHeader()

Make Security Header Non-MustUnderstand

generateSecurityHeaderException

public void generateSecurityHeaderException(java.lang.String exceptionMessage)
                                     throws SecurityHeaderException,
                                            XWSSecurityException

Create and initialize a SecurityHeaderException, and throw a fault based on it. The faultstring for this exception is wsse:InvalidSecurity as per section 12 on Error Handling of the wss SOAPMessageSecurity spec (draft 17). This fault stands for An error was discovered processing the wsse:Security header.

Throws:

SecurityHeaderException

XWSSecurityException

newSOAPFaultException

public static WssSoapFaultException newSOAPFaultException(java.lang.String faultstring,
                                                          java.lang.Throwable th)

Create and initialize a WssSoapFaultException. This method is used in conjunction with generateClientFault.

newSOAPFaultException

public static WssSoapFaultException newSOAPFaultException(javax.xml.namespace.QName faultCode,
                                                          java.lang.String faultstring,
                                                          java.lang.Throwable th)

Create and initialize a WssSoapFaultException. This method is used in conjunction with generateClientFault.

generateFault

public void generateFault(WssSoapFaultException sfe)
                   throws XWSSecurityException

Parameters:

sfe -

Throws:

XWSSecurityException

getSOAPPart

public javax.xml.soap.SOAPPart getSOAPPart()

Specified by:

getSOAPPart in class javax.xml.soap.SOAPMessage

getSOAPBody

public javax.xml.soap.SOAPBody getSOAPBody()
                                    throws javax.xml.soap.SOAPException

Overrides:

getSOAPBody in class javax.xml.soap.SOAPMessage

Throws:

javax.xml.soap.SOAPException

getSOAPMessage

public javax.xml.soap.SOAPMessage getSOAPMessage()

setSOAPMessage

public void setSOAPMessage(javax.xml.soap.SOAPMessage soapMsg)
                    throws XWSSecurityException

Throws:

XWSSecurityException

addAttachmentPart

public void addAttachmentPart(javax.xml.soap.AttachmentPart AttachmentPart)

Specified by:

addAttachmentPart in class javax.xml.soap.SOAPMessage

countAttachments

public int countAttachments()

Specified by:

countAttachments in class javax.xml.soap.SOAPMessage

createAttachmentPart

public javax.xml.soap.AttachmentPart createAttachmentPart()

Specified by:

createAttachmentPart in class javax.xml.soap.SOAPMessage

createAttachmentPart

public javax.xml.soap.AttachmentPart createAttachmentPart(java.lang.Object content,
                                                          java.lang.String contentType)

Overrides:

createAttachmentPart in class javax.xml.soap.SOAPMessage

createAttachmentPart

public javax.xml.soap.AttachmentPart createAttachmentPart(javax.activation.DataHandler dataHandler)

Overrides:

createAttachmentPart in class javax.xml.soap.SOAPMessage

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

getAttachments

public java.util.Iterator getAttachments()

Specified by:

getAttachments in class javax.xml.soap.SOAPMessage

getAttachments

public java.util.Iterator getAttachments(javax.xml.soap.MimeHeaders headers)

Specified by:

getAttachments in class javax.xml.soap.SOAPMessage

getContentDescription

public java.lang.String getContentDescription()

Specified by:

getContentDescription in class javax.xml.soap.SOAPMessage

getMimeHeaders

public javax.xml.soap.MimeHeaders getMimeHeaders()

Specified by:

getMimeHeaders in class javax.xml.soap.SOAPMessage

getProperty

public java.lang.Object getProperty(java.lang.String property)
                             throws javax.xml.soap.SOAPException

Overrides:

getProperty in class javax.xml.soap.SOAPMessage

Throws:

javax.xml.soap.SOAPException

getSOAPHeader

public javax.xml.soap.SOAPHeader getSOAPHeader()
                                        throws javax.xml.soap.SOAPException

Overrides:

getSOAPHeader in class javax.xml.soap.SOAPMessage

Throws:

javax.xml.soap.SOAPException

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

removeAllAttachments

public void removeAllAttachments()

Specified by:

removeAllAttachments in class javax.xml.soap.SOAPMessage

saveRequired

public boolean saveRequired()

Specified by:

saveRequired in class javax.xml.soap.SOAPMessage

setContentDescription

public void setContentDescription(java.lang.String description)

Specified by:

setContentDescription in class javax.xml.soap.SOAPMessage

setProperty

public void setProperty(java.lang.String property,
                        java.lang.Object value)
                 throws javax.xml.soap.SOAPException

Overrides:

setProperty in class javax.xml.soap.SOAPMessage

Throws:

javax.xml.soap.SOAPException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

writeTo

public void writeTo(java.io.OutputStream out)
             throws javax.xml.soap.SOAPException,
                    java.io.IOException

Specified by:

writeTo in class javax.xml.soap.SOAPMessage

Throws:

javax.xml.soap.SOAPException

java.io.IOException

saveChanges

public void saveChanges()
                 throws javax.xml.soap.SOAPException

Specified by:

saveChanges in class javax.xml.soap.SOAPMessage

Throws:

javax.xml.soap.SOAPException

getNamespaceContext

public javax.xml.namespace.NamespaceContext getNamespaceContext()
                                                         throws XWSSecurityException

Throws:

XWSSecurityException

generateId

public java.lang.String generateId()
                            throws XWSSecurityException

Returns:

an ID unique w.r.t this SOAPMessage

Throws:

XWSSecurityException

generateWsuId

public void generateWsuId(org.w3c.dom.Element element)
                   throws XWSSecurityException

Parameters:

element -

Throws:

XWSSecurityException

generateWsuId

public void generateWsuId(org.w3c.dom.Element element,
                          java.lang.String id)
                   throws XWSSecurityException

Parameters:

element -

id - ID specified should be unique in the message.

Throws:

XWSSecurityException

getElementByWsuId

public javax.xml.soap.SOAPElement getElementByWsuId(java.lang.String id)
                                             throws XWSSecurityException

Throws:

XWSSecurityException

getElementById

public org.w3c.dom.Element getElementById(java.lang.String id)
                                   throws XWSSecurityException

Throws:

XWSSecurityException

getAttachmentPart

public javax.xml.soap.AttachmentPart getAttachmentPart(java.lang.String uri)
                                                throws XWSSecurityException

Throws:

XWSSecurityException

getIdFromFragmentRef

public static java.lang.String getIdFromFragmentRef(java.lang.String ref)

getMessageParts

public java.lang.Object getMessageParts(Target target)
                                 throws XWSSecurityException

Throws:

XWSSecurityException

getAttachment

public javax.xml.soap.AttachmentPart getAttachment(javax.xml.soap.SOAPElement element)
                                            throws javax.xml.soap.SOAPException

Specified by:

getAttachment in class javax.xml.soap.SOAPMessage

Throws:

javax.xml.soap.SOAPException

removeAttachments

public void removeAttachments(javax.xml.soap.MimeHeaders hdrs)

Specified by:

removeAttachments in class javax.xml.soap.SOAPMessage

isOptimized

public boolean isOptimized()

setOptimized

public void setOptimized(boolean optimized)

setDoNotSetMU

public void setDoNotSetMU(boolean doNotSetMU)