JavaTM Platform
Standard Ed. 6

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 を スローすることを許可されている

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。