フィールドの詳細

• logger

  protected final Log logger

  サブクラスで利用可能なロガー。

コンストラクターの詳細

• AbstractMarshaller

  public AbstractMarshaller()

メソッドの詳細

• setSupportDtd

  public void setSupportDtd(boolean supportDtd)

  DTD 解析をサポートする必要があるかどうかを示します。

  デフォルトは false で、DTD が無効になっています。

• isSupportDtd

  public boolean isSupportDtd()

  DTD 解析がサポートされているかどうか。

• setProcessExternalEntities

  public void setProcessExternalEntities(boolean processExternalEntities)

  非整列化時に外部 XML エンティティが処理されるかどうかを示します。

  デフォルトは false です。これは、外部エンティティが解決されないことを意味します。unmarshal(Source) に渡される Source が SAXSource または StreamSource である場合にのみ、外部エンティティの処理が有効または無効になることに注意してください。DOMSource または StAXSource インスタンスには影響しません。

  注意 : このオプションを true に設定すると、setSupportDtd(boolean) が true に自動的に設定されます。

• isProcessExternalEntities

  public boolean isProcessExternalEntities()

  XML 外部エンティティを許可するかどうかの構成値を返します。

  関連事項:

  createXmlReader()

• buildDocument

  protected org.w3c.dom.Document buildDocument()

  DOM ノードのプレースホルダーとして、このマーシャラーの DocumentBuilderFactory から新しい Document を構築します。

  関連事項:

  createDocumentBuilderFactory(), createDocumentBuilder(DocumentBuilderFactory)

• createDocumentBuilderFactory

  protected javax.xml.parsers.DocumentBuilderFactory createDocumentBuilderFactory()
                                                                           throws javax.xml.parsers.ParserConfigurationException

  このマーシャラーが空の DOMSource を渡されたときに DOM ドキュメントを作成するために使用する DocumentBuilder を作成します。

  結果の DocumentBuilderFactory はキャッシュされるため、このメソッドは一度だけ呼び出されます。

  戻り値:

  DocumentBuilderFactory

  例外:

  javax.xml.parsers.ParserConfigurationException - JAXP メソッドによってスローされた場合

• createDocumentBuilder

  protected javax.xml.parsers.DocumentBuilder createDocumentBuilder(javax.xml.parsers.DocumentBuilderFactory factory)
                                                             throws javax.xml.parsers.ParserConfigurationException

  このマーシャラーが空の DOMSource を渡されたときに DOM ドキュメントを作成するために使用する DocumentBuilder を作成します。

  サブクラスでオーバーライドでき、ビルダーの初期化を追加します。

  パラメーター:

  factory - DocumentBuilder を作成する DocumentBuilderFactory 

  戻り値:

  DocumentBuilder

  例外:

  javax.xml.parsers.ParserConfigurationException - JAXP メソッドによってスローされた場合

• createXmlReader

  protected org.xml.sax.XMLReader createXmlReader()
                                           throws org.xml.sax.SAXException

  このマーシャラーが空の SAXSource を渡されたときに XMLReader を作成します。

  戻り値:

  XMLReader

  例外:

  org.xml.sax.SAXException - JAXP メソッドによってスローされた場合

• getDefaultEncoding

  @Nullable
  protected java.lang.String getDefaultEncoding()

  バイトストリームからのマーシャリングまたはアンマーシャリングに使用するデフォルトエンコーディングを決定します。存在しない場合は null を決定します。

  デフォルトの実装は null を返します。

• marshal

  public final void marshal(java.lang.Object graph,
                            javax.xml.transform.Result result)
                     throws java.io.IOException,
                            XmlMappingException

  指定されたルートを持つオブジェクトグラフを、提供された javax.xml.transform.Result にマーシャリングします。

  この実装は、指定された結果をインスペクションし、marshalDomResult、marshalSaxResult、marshalStreamResult を呼び出します。

  次で指定:

  インターフェース Marshaller 内の marshal 

  パラメーター:

  graph - マーシャリングするオブジェクトグラフのルート

  result - マーシャリングする結果

  例外:

  java.io.IOException - I/O 例外が発生した場合

  XmlMappingException - 指定されたオブジェクトを結果に整列化できない場合

  java.lang.IllegalArgumentException - result の場合 DOMResult、SAXResult、StreamResult のいずれでもない場合

  関連事項:

  marshalDomResult(Object, javax.xml.transform.dom.DOMResult), marshalSaxResult(Object, javax.xml.transform.sax.SAXResult), marshalStreamResult(Object, javax.xml.transform.stream.StreamResult)

• marshalDomResult

  protected void marshalDomResult(java.lang.Object graph,
                                  javax.xml.transform.dom.DOMResult domResult)
                           throws XmlMappingException

  DOMResult を処理するためのテンプレートメソッド。

  この実装は marshalDomNode に委譲します。

  パラメーター:

  graph - マーシャリングするオブジェクトグラフのルート

  domResult - DOMResult

  例外:

  XmlMappingException - 指定されたオブジェクトを結果に整列化できない場合

  java.lang.IllegalArgumentException - domResult が空の場合

  関連事項:

  marshalDomNode(Object, org.w3c.dom.Node)

• marshalStaxResult

  protected void marshalStaxResult(java.lang.Object graph,
                                   javax.xml.transform.Result staxResult)
                            throws XmlMappingException

  StaxResult を処理するためのテンプレートメソッド。

  この実装は、StaxResult の内容に応じて、marshalXMLSteamWriter または marshalXMLEventConsumer に委譲します。

  パラメーター:

  graph - マーシャリングするオブジェクトグラフのルート

  staxResult - JAXP 1.4 StAXSource

  例外:

  XmlMappingException - 指定されたオブジェクトを結果に整列化できない場合

  java.lang.IllegalArgumentException - domResult が空の場合

  関連事項:

  marshalDomNode(Object, org.w3c.dom.Node)

• marshalSaxResult

  protected void marshalSaxResult(java.lang.Object graph,
                                  javax.xml.transform.sax.SAXResult saxResult)
                           throws XmlMappingException

  SAXResult を処理するためのテンプレートメソッド。

  この実装は marshalSaxHandlers に委譲します。

  パラメーター:

  graph - マーシャリングするオブジェクトグラフのルート

  saxResult - SAXResult

  例外:

  XmlMappingException - 指定されたオブジェクトを結果に整列化できない場合

  関連事項:

  marshalSaxHandlers(Object, org.xml.sax.ContentHandler, org.xml.sax.ext.LexicalHandler)

• marshalStreamResult

  protected void marshalStreamResult(java.lang.Object graph,
                                     javax.xml.transform.stream.StreamResult streamResult)
                              throws XmlMappingException,
                                     java.io.IOException

  StreamResult を処理するためのテンプレートメソッド。

  この実装は、StreamResult の内容に応じて、marshalOutputStream または marshalWriter に委譲します。

  パラメーター:

  graph - マーシャリングするオブジェクトグラフのルート

  streamResult - StreamResult

  例外:

  java.io.IOException - I/O 例外が発生した場合

  XmlMappingException - 指定されたオブジェクトを結果に整列化できない場合

  java.lang.IllegalArgumentException - streamResult に OutputStream も Writer も含まれていない場合

• unmarshal

  public final java.lang.Object unmarshal(javax.xml.transform.Source source)
                                   throws java.io.IOException,
                                          XmlMappingException

  指定された提供された javax.xml.transform.Source をオブジェクトグラフに非整列化します。

  この実装は、指定された結果をインスペクションし、unmarshalDomSource、unmarshalSaxSource、unmarshalStreamSource を呼び出します。

  次で指定:

  インターフェース Unmarshaller 内の unmarshal 

  パラメーター:

  source - マーシャリングのソース

  戻り値:

  オブジェクトグラフ

  例外:

  java.io.IOException - I/O 例外が発生した場合

  XmlMappingException - 指定されたソースをオブジェクトにマップできない場合

  java.lang.IllegalArgumentException - source が DOMSource、SAXSource、StreamSource でない場合

  関連事項:

  unmarshalDomSource(javax.xml.transform.dom.DOMSource), unmarshalSaxSource(javax.xml.transform.sax.SAXSource), unmarshalStreamSource(javax.xml.transform.stream.StreamSource)

• unmarshalDomSource

  protected java.lang.Object unmarshalDomSource(javax.xml.transform.dom.DOMSource domSource)
                                         throws XmlMappingException

  DOMSource を処理するためのテンプレートメソッド。

  この実装は unmarshalDomNode に委譲します。指定されたソースが空の場合、空のソース Document がプレースホルダーとして作成されます。

  パラメーター:

  domSource - DOMSource

  戻り値:

  オブジェクトグラフ

  例外:

  XmlMappingException - 指定されたソースをオブジェクトにマップできない場合

  java.lang.IllegalArgumentException - domSource が空の場合

  関連事項:

  unmarshalDomNode(org.w3c.dom.Node)

• unmarshalStaxSource

  protected java.lang.Object unmarshalStaxSource(javax.xml.transform.Source staxSource)
                                          throws XmlMappingException

  StaxSource を処理するためのテンプレートメソッド。

  この実装は unmarshalXmlStreamReader または unmarshalXmlEventReader に委譲します。

  パラメーター:

  staxSource - StaxSource

  戻り値:

  オブジェクトグラフ

  例外:

  XmlMappingException - 指定されたソースをオブジェクトにマップできない場合

• unmarshalSaxSource

  protected java.lang.Object unmarshalSaxSource(javax.xml.transform.sax.SAXSource saxSource)
                                         throws XmlMappingException,
                                                java.io.IOException

  SAXSource を処理するためのテンプレートメソッド。

  この実装は unmarshalSaxReader に委譲します。

  パラメーター:

  saxSource - SAXSource

  戻り値:

  オブジェクトグラフ

  例外:

  XmlMappingException - 指定されたソースをオブジェクトにマップできない場合

  java.io.IOException - I/O 例外が発生した場合

  関連事項:

  unmarshalSaxReader(org.xml.sax.XMLReader, org.xml.sax.InputSource)

• unmarshalStreamSource

  protected java.lang.Object unmarshalStreamSource(javax.xml.transform.stream.StreamSource streamSource)
                                            throws XmlMappingException,
                                                   java.io.IOException

  StreamSource を処理するためのテンプレートメソッド。

  この実装は unmarshalInputStream または unmarshalReader に委譲します。

  パラメーター:

  streamSource - StreamSource

  戻り値:

  オブジェクトグラフ

  例外:

  java.io.IOException - I/O 例外が発生した場合

  XmlMappingException - 指定されたソースをオブジェクトにマップできない場合

• marshalDomNode

  protected abstract void marshalDomNode(java.lang.Object graph,
                                         org.w3c.dom.Node node)
                                  throws XmlMappingException

  指定されたオブジェクトグラフを DOM Node にマーシャリングする抽象テンプレートメソッド。

  実際には、ノードは Document ノード、DocumentFragment ノード、Element ノードです。つまり、子を受け入れるノードです。

  パラメーター:

  graph - マーシャリングするオブジェクトグラフのルート

  node - 結果ツリーを含む DOM ノード

  例外:

  XmlMappingException - 指定されたオブジェクトを DOM ノードに整列化できない場合

  関連事項:

  Document、DocumentFragment、Element

• marshalXmlEventWriter

  protected abstract void marshalXmlEventWriter(java.lang.Object graph,
                                                javax.xml.stream.XMLEventWriter eventWriter)
                                         throws XmlMappingException

  指定されたオブジェクトを StAX XMLEventWriter にマーシャリングする抽象テンプレートメソッド。

  パラメーター:

  graph - マーシャリングするオブジェクトグラフのルート

  eventWriter - 書き込む XMLEventWriter 

  例外:

  XmlMappingException - 指定されたオブジェクトを DOM ノードに整列化できない場合

• marshalXmlStreamWriter

  protected abstract void marshalXmlStreamWriter(java.lang.Object graph,
                                                 javax.xml.stream.XMLStreamWriter streamWriter)
                                          throws XmlMappingException

  指定されたオブジェクトを StAX XMLStreamWriter にマーシャリングする抽象テンプレートメソッド。

  パラメーター:

  graph - マーシャリングするオブジェクトグラフのルート

  streamWriter - 書き込む XMLStreamWriter 

  例外:

  XmlMappingException - 指定されたオブジェクトを DOM ノードに整列化できない場合

• marshalSaxHandlers

  protected abstract void marshalSaxHandlers(java.lang.Object graph,
                                             org.xml.sax.ContentHandler contentHandler,
                                             @Nullable
                                             org.xml.sax.ext.LexicalHandler lexicalHandler)
                                      throws XmlMappingException

  指定されたオブジェクトグラフを SAX ContentHandler にマーシャリングする抽象テンプレートメソッド。

  パラメーター:

  graph - マーシャリングするオブジェクトグラフのルート

  contentHandler - SAX ContentHandler

  lexicalHandler - SAX2 LexicalHandler null にすることができます。

  例外:

  XmlMappingException - 指定されたオブジェクトをハンドラーにマーシャリングできない場合

• marshalOutputStream

  protected abstract void marshalOutputStream(java.lang.Object graph,
                                              java.io.OutputStream outputStream)
                                       throws XmlMappingException,
                                              java.io.IOException

  指定されたオブジェクトグラフを OutputStream にマーシャリングする抽象テンプレートメソッド。

  パラメーター:

  graph - マーシャリングするオブジェクトグラフのルート

  outputStream - 書き込む OutputStream 

  例外:

  XmlMappingException - 指定されたオブジェクトをライターにマーシャリングできない場合

  java.io.IOException - I/O 例外が発生した場合

• marshalWriter

  protected abstract void marshalWriter(java.lang.Object graph,
                                        java.io.Writer writer)
                                 throws XmlMappingException,
                                        java.io.IOException

  指定されたオブジェクトグラフを Writer にマーシャリングする抽象テンプレートメソッド。

  パラメーター:

  graph - マーシャリングするオブジェクトグラフのルート

  writer - 書き込む Writer 

  例外:

  XmlMappingException - 指定されたオブジェクトをライターにマーシャリングできない場合

  java.io.IOException - I/O 例外が発生した場合

• unmarshalDomNode

  protected abstract java.lang.Object unmarshalDomNode(org.w3c.dom.Node node)
                                                throws XmlMappingException

  指定された DOM Node から非整列化するための抽象テンプレートメソッド。

  パラメーター:

  node - 非整列化するオブジェクトを含む DOM ノード

  戻り値:

  オブジェクトグラフ

  例外:

  XmlMappingException - 指定された DOM ノードをオブジェクトにマップできない場合

• unmarshalXmlEventReader

  protected abstract java.lang.Object unmarshalXmlEventReader(javax.xml.stream.XMLEventReader eventReader)
                                                       throws XmlMappingException

  指定された Stax XMLEventReader から非整列化するための抽象テンプレートメソッド。

  パラメーター:

  eventReader - 読み込む XMLEventReader 

  戻り値:

  オブジェクトグラフ

  例外:

  XmlMappingException - 指定されたイベントリーダーをオブジェクトに変換できない場合

• unmarshalXmlStreamReader

  protected abstract java.lang.Object unmarshalXmlStreamReader(javax.xml.stream.XMLStreamReader streamReader)
                                                        throws XmlMappingException

  指定された Stax XMLStreamReader から非整列化するための抽象テンプレートメソッド。

  パラメーター:

  streamReader - 読み込む XMLStreamReader 

  戻り値:

  オブジェクトグラフ

  例外:

  XmlMappingException - 指定されたストリームリーダーをオブジェクトに変換できない場合

• unmarshalSaxReader

  protected abstract java.lang.Object unmarshalSaxReader(org.xml.sax.XMLReader xmlReader,
                                                         org.xml.sax.InputSource inputSource)
                                                  throws XmlMappingException,
                                                         java.io.IOException

  特定の SAX XMLReader および InputSource を使用して非整列化するための抽象テンプレートメソッド。

  パラメーター:

  xmlReader - 解析する SAX XMLReader 

  inputSource - 解析する入力ソース

  戻り値:

  オブジェクトグラフ

  例外:

  XmlMappingException - 指定されたリーダーと入力ソースをオブジェクトに変換できない場合

  java.io.IOException - I/O 例外が発生した場合

• unmarshalInputStream

  protected abstract java.lang.Object unmarshalInputStream(java.io.InputStream inputStream)
                                                    throws XmlMappingException,
                                                           java.io.IOException

  指定された InputStream から非整列化するための抽象テンプレートメソッド。

  パラメーター:

  inputStream - 読み込む InputStreamStream 

  戻り値:

  オブジェクトグラフ

  例外:

  XmlMappingException - 指定されたストリームをオブジェクトに変換できない場合

  java.io.IOException - I/O 例外が発生した場合

• unmarshalReader

  protected abstract java.lang.Object unmarshalReader(java.io.Reader reader)
                                               throws XmlMappingException,
                                                      java.io.IOException

  指定された Reader から非整列化するための抽象テンプレートメソッド。

  パラメーター:

  reader - 読み込む Reader 

  戻り値:

  オブジェクトグラフ

  例外:

  XmlMappingException - 指定されたリーダーをオブジェクトに変換できない場合

  java.io.IOException - I/O 例外が発生した場合