javax.xml.bind
インタフェース UnmarshallerHandler

すべてのスーパーインタフェース:

ContentHandler

public interface UnmarshallerHandler
extends ContentHandler

SAX ContentHandler として実装された Unmarshaller です。

アプリケーションは、このインタフェースを使用してその JAXB プロバイダを XML パイプラインのコンポーネントとして使用できます。例を示します。

       JAXBContext context = JAXBContext.newInstance( "org.acme.foo" );

       Unmarshaller unmarshaller = context.createUnmarshaller();
 
       UnmarshallerHandler unmarshallerHandler = unmarshaller.getUnmarshallerHandler();

       SAXParserFactory spf = SAXParserFactory.newInstance();
       spf.setNamespaceAware( true );
 
       XMLReader xmlReader = spf.newSAXParser().getXMLReader();
       xmlReader.setContentHandler( unmarshallerHandler );
       xmlReader.parse(new InputSource( new FileInputStream( XML_FILE ) ) );

       MyObject myObject= (MyObject)unmarshallerHandler.getResult();                          
 

このインタフェースは再利用可能です。ユーザーがオブジェクトを非整列化できなかった場合でも、非整列化の新しいラウンドを開始することができます。

導入されたバージョン:

JAXB1.0

関連項目:

Unmarshaller.getUnmarshallerHandler()

メソッドの概要

Object

getResult() 非整列化された結果を取得します。

インタフェース org.xml.sax.ContentHandler から継承されたメソッド

characters, endDocument, endElement, endPrefixMapping, ignorableWhitespace, processingInstruction, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping

メソッドの詳細

getResult

Object getResult()
                 throws JAXBException,
                        IllegalStateException

非整列化された結果を取得します。 このハンドラが endDocument SAX イベントを受け取った後のみ、このメソッドを呼び出すことができます。

戻り値:

常に非整列化された null 以外の有効なオブジェクトを返す

例外:

IllegalStateException - このハンドラが endDocument イベントを受け取る前に、このメソッドが呼び出された場合

JAXBException - 非整列化エラーが存在する場合。この実装は、構文解析中にエラーを検出した場合、SAXException をスローすることを許可されている