org.opensaml.xml.io

クラス AbstractXMLObjectMarshaller

java.lang.Object

org.opensaml.xml.io.AbstractXMLObjectMarshaller

すべての実装されたインタフェース:

Marshaller

直系の既知のサブクラス:

AbstractElementExtensibleXMLObjectMarshaller, AbstractSAMLObjectMarshaller, AbstractWSAddressingObjectMarshaller, AbstractWSPolicyObjectMarshaller, AbstractWSSecurityObjectMarshaller, AbstractWSTrustObjectMarshaller, AbstractXACMLObjectMarshaller, AbstractXMLEncryptionMarshaller, AbstractXMLSignatureMarshaller, AddressMarshaller, AppliesToMarshaller, BaseXMLObjectMarshaller, BodyMarshaller, DetailMarshaller, EndPointReferenceMarshaller, EnvelopeMarshaller, ExtensionsMarshaller, FaultMarshaller, HeaderMarshaller, RequestedSecurityTokenMarshaller, RequestSecurityTokenResponseMarshaller, ShibbolethMetadataKeyAuthorityMarshaller, ShibbolethMetadataScopeMarshaller, ShibbolethScopedValueMarshaller, X509SerialNumberMarshaller, XSAnyMarshaller, XSBase64BinaryMarshaller, XSBooleanMarshaller, XSIntegerMarshaller, XSQNameMarshaller, XSStringMarshaller, XSURIMarshaller

public abstract class AbstractXMLObjectMarshaller
extends Object
implements Marshaller

A thread safe, abstract implementation of the Marshaller interface. This class handles most of the boilerplate code:

• Ensuring elements to be marshalled are of either the correct xsi:type or element QName
• Setting the appropriate namespace and prefix for the marshalled element
• Setting the xsi:type for the element if the element has an explicit type
• Setting namespaces attributes declared for the element
• Marshalling of child elements

コンストラクタの概要

コンストラクタ

修飾子	コンストラクタと説明
protected	AbstractXMLObjectMarshaller() Constructor.
protected	AbstractXMLObjectMarshaller(String targetNamespaceURI, String targetLocalName) 推奨されていません。 no replacement

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
protected void	checkXMLObjectIsTarget(XMLObject xmlObject) Checks to make sure the given XMLObject's schema type or element QName matches the target parameters given at marshaller construction time.
Element	marshall(XMLObject xmlObject) Marshall this element, and its children, and root them in a newly created Document.
Element	marshall(XMLObject xmlObject, Document document) Marshall this element, and its children, into a W3C DOM element.
Element	marshall(XMLObject xmlObject, Element parentElement) Marshall the given XMLObject and append it as a child to the given parent element.
protected abstract void	marshallAttributes(XMLObject xmlObject, Element domElement) Marshalls a given XMLObject into a W3C Element.
protected void	marshallChildElements(XMLObject xmlObject, Element domElement) Marshalls the child elements of the given XMLObject.
protected abstract void	marshallElementContent(XMLObject xmlObject, Element domElement) Marshalls data from the XMLObject into content of the DOM Element.
protected Element	marshallInto(XMLObject xmlObject, Element targetElement) Marshalls the given XMLObject into the given DOM Element.
protected void	marshallNamespacePrefix(XMLObject xmlObject, Element domElement) Marshalls the namespace prefix of the XMLObject into the DOM element.
protected void	marshallNamespaces(XMLObject xmlObject, Element domElement) Creates the xmlns attributes for any namespaces set on the given XMLObject.
protected void	marshallSchemaInstanceAttributes(XMLObject xmlObject, Element domElement) Creates the XSI type, schemaLocation, and noNamespaceSchemaLocation attributes for an XMLObject.
protected void	setDocumentElement(Document document, Element element) Sets the given element as the Document Element of the given Document.

クラスから継承されたメソッド java.lang.Object

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

コンストラクタの詳細

AbstractXMLObjectMarshaller

protected AbstractXMLObjectMarshaller()

Constructor.

AbstractXMLObjectMarshaller

protected AbstractXMLObjectMarshaller(String targetNamespaceURI,
                           String targetLocalName)

推奨されていません。 no replacement

This constructor supports checking an XMLObject to be marshalled, either element name or schema type, against a given namespace/local name pair.

パラメータ:

targetNamespaceURI - the namespace URI of either the schema type QName or element QName of the elements this unmarshaller operates on

targetLocalName - the local name of either the schema type QName or element QName of the elements this unmarshaller operates on

メソッドの詳細

marshall

public Element marshall(XMLObject xmlObject)
                 throws MarshallingException

Marshall this element, and its children, and root them in a newly created Document. The Document is created by a DocumentBuilder obtained from a DocumentBuilderFactory created without any additional parameters or properties set; that is the system defaults properties are used.

定義:

marshall インタフェース内 Marshaller

パラメータ:

xmlObject - the object to marshall

戻り値:

the W3C DOM element representing this SAML element

例外:

MarshallingException - thrown if there is a problem marshalling the given object

marshall

public Element marshall(XMLObject xmlObject,
               Document document)
                 throws MarshallingException

Marshall this element, and its children, into a W3C DOM element. If the document does not have a Document Element the Element resulting from this marshalling will be set as the Document Element.

定義:

marshall インタフェース内 Marshaller

パラメータ:

xmlObject - the object to marshall

document - the DOM document the marshalled element will be placed in

戻り値:

the W3C DOM element representing this XMLObject

例外:

MarshallingException - thrown if there is a problem marshalling the given object

marshall

public Element marshall(XMLObject xmlObject,
               Element parentElement)
                 throws MarshallingException

Marshall the given XMLObject and append it as a child to the given parent element. NOTE: The given Element must be within a DOM tree whose root is the root of the Document owning the given Element.

定義:

marshall インタフェース内 Marshaller

パラメータ:

xmlObject - the XMLObject to be marshalled

parentElement - the parent of the Element resulting from marshalling the given XMLObject

戻り値:

the marshalled XMLObject

例外:

MarshallingException - thrown if the given XMLObject can not be marshalled.

setDocumentElement

protected void setDocumentElement(Document document,
                      Element element)

Sets the given element as the Document Element of the given Document. If the document already has a Document Element it is replaced by the given element.

パラメータ:

document - the document

element - the Element that will serve as the Document Element

marshallInto

protected Element marshallInto(XMLObject xmlObject,
                   Element targetElement)
                        throws MarshallingException

Marshalls the given XMLObject into the given DOM Element. The DOM Element must be within a DOM tree whose root is the Document Element of the Document that owns the given DOM Element.

パラメータ:

xmlObject - the XMLObject to marshall

targetElement - the Element into which the XMLObject is marshalled into

戻り値:

the DOM element the XMLObject is marshalled into

例外:

MarshallingException - thrown if there is a problem marshalling the object

checkXMLObjectIsTarget

protected void checkXMLObjectIsTarget(XMLObject xmlObject)
                               throws MarshallingException

Checks to make sure the given XMLObject's schema type or element QName matches the target parameters given at marshaller construction time.

パラメータ:

xmlObject - the XMLObject to marshall

例外:

MarshallingException - thrown if the given object is not or the required type

marshallNamespacePrefix

protected void marshallNamespacePrefix(XMLObject xmlObject,
                           Element domElement)

Marshalls the namespace prefix of the XMLObject into the DOM element.

パラメータ:

xmlObject - the XMLObject being marshalled

domElement - the DOM element the XMLObject is being marshalled into

marshallChildElements

protected void marshallChildElements(XMLObject xmlObject,
                         Element domElement)
                              throws MarshallingException

Marshalls the child elements of the given XMLObject.

パラメータ:

xmlObject - the XMLObject whose children will be marshalled

domElement - the DOM element that will recieved the marshalled children

例外:

MarshallingException - thrown if there is a problem marshalling a child element

marshallNamespaces

protected void marshallNamespaces(XMLObject xmlObject,
                      Element domElement)

Creates the xmlns attributes for any namespaces set on the given XMLObject.

パラメータ:

xmlObject - the XMLObject

domElement - the DOM element the namespaces will be added to

marshallSchemaInstanceAttributes

protected void marshallSchemaInstanceAttributes(XMLObject xmlObject,
                                    Element domElement)
                                         throws MarshallingException

Creates the XSI type, schemaLocation, and noNamespaceSchemaLocation attributes for an XMLObject.

パラメータ:

xmlObject - the XMLObject

domElement - the DOM element the namespaces will be added to

例外:

MarshallingException - thrown if the schema type information is invalid

marshallAttributes

protected abstract void marshallAttributes(XMLObject xmlObject,
                      Element domElement)
                                    throws MarshallingException

Marshalls a given XMLObject into a W3C Element. The given signing context should be blindly passed to the marshaller for child elements. The XMLObject passed to this method is guaranteed to be of the target name specified during this unmarshaller's construction.

パラメータ:

xmlObject - the XMLObject to marshall

domElement - the W3C DOM element

例外:

MarshallingException - thrown if there is a problem marshalling the element

marshallElementContent

protected abstract void marshallElementContent(XMLObject xmlObject,
                          Element domElement)
                                        throws MarshallingException

Marshalls data from the XMLObject into content of the DOM Element.

パラメータ:

xmlObject - the XMLObject

domElement - the DOM element recieving the content

例外:

MarshallingException - thrown if the textual content can not be added to the DOM element