|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object org.xml.sax.helpers.XMLFilterImpl
public class XMLFilterImpl
XML フィルタを派生する基底クラスです。
このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。詳細は、http://www.saxproject.org を参照してください。
このクラスは、XMLReader
とクライアントアプリケーションのイベントハンドラの中間に置かれます。デフォルトでは、ハンドラに対するイベントを変更せずに要求をリーダに渡すだけです。しかし、サブクラスでは特定のメソッドをオーバーライドして、転送中にイベントスクリームや構成要求を変更できます。
XMLFilter
,
XMLReader
,
EntityResolver
,
DTDHandler
,
ContentHandler
,
ErrorHandler
コンストラクタの概要 | |
---|---|
XMLFilterImpl()
親を持たない空の XML フィルタを構築します。 |
|
XMLFilterImpl(XMLReader parent)
指定された親を持つ XML フィルタを構築します。 |
メソッドの概要 | |
---|---|
void |
characters(char[] ch,
int start,
int length)
文字データイベントをフィルタリングします。 |
void |
endDocument()
文書終了イベントをフィルタリングします。 |
void |
endElement(String uri,
String localName,
String qName)
要素終了イベントをフィルタリングします。 |
void |
endPrefixMapping(String prefix)
名前空間接頭辞マッピングの終了イベントをフィルタリングします。 |
void |
error(SAXParseException e)
エラーイベントをフィルタリングします。 |
void |
fatalError(SAXParseException e)
致命的なエラーイベントをフィルタリングします。 |
ContentHandler |
getContentHandler()
コンテンツイベントハンドラを取得します。 |
DTDHandler |
getDTDHandler()
現在の DTD イベントハンドラを取得します。 |
EntityResolver |
getEntityResolver()
現在のエンティティリゾルバを取得します。 |
ErrorHandler |
getErrorHandler()
現在のエラーイベントハンドラを取得します。 |
boolean |
getFeature(String name)
機能の値を検索します。 |
XMLReader |
getParent()
親リーダを取得します。 |
Object |
getProperty(String name)
プロパティ値を検索します。 |
void |
ignorableWhitespace(char[] ch,
int start,
int length)
無視できる空白類文字イベントをフィルタリングします。 |
void |
notationDecl(String name,
String publicId,
String systemId)
表記法宣言イベントをフィルタリングします。 |
void |
parse(InputSource input)
文書を構文解析します。 |
void |
parse(String systemId)
文書を構文解析します。 |
void |
processingInstruction(String target,
String data)
処理命令イベントをフィルタリングします。 |
InputSource |
resolveEntity(String publicId,
String systemId)
外部エンティティ解決をファイルタリングします。 |
void |
setContentHandler(ContentHandler handler)
コンテンツイベントハンドラを設定します。 |
void |
setDocumentLocator(Locator locator)
新しい文書ロケータイベントをフィルタリングします。 |
void |
setDTDHandler(DTDHandler handler)
DTD イベントハンドラを設定します。 |
void |
setEntityResolver(EntityResolver resolver)
エンティティリゾルバを設定します。 |
void |
setErrorHandler(ErrorHandler handler)
エラーイベントハンドラを設定します。 |
void |
setFeature(String name,
boolean value)
機能の値を設定します。 |
void |
setParent(XMLReader parent)
親リーダを設定します。 |
void |
setProperty(String name,
Object value)
プロパティ値を設定します。 |
void |
skippedEntity(String name)
スキップされたエンティティイベントをフィルタリングします。 |
void |
startDocument()
文書開始イベントをフィルタリングします。 |
void |
startElement(String uri,
String localName,
String qName,
Attributes atts)
要素開始イベントをフィルタリングします。 |
void |
startPrefixMapping(String prefix,
String uri)
名前空間接頭辞マッピングの開始イベントをフィルタリングします。 |
void |
unparsedEntityDecl(String name,
String publicId,
String systemId,
String notationName)
解析対象外エンティティ宣言イベントをフィルタリングします。 |
void |
warning(SAXParseException e)
警告イベントをフィルタリングします。 |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
---|
public XMLFilterImpl()
このフィルタは親を持ちません。このフィルタを XMLReader
としてではなく純粋なイベントコンシューマとして使用しないかぎり、構文解析を始める前、あるいは setFeature または setProperty を使用して構成を始める前に親を割り当てる必要があります。
XMLReader.setFeature(java.lang.String, boolean)
,
XMLReader.setProperty(java.lang.String, java.lang.Object)
,
setParent(org.xml.sax.XMLReader)
public XMLFilterImpl(XMLReader parent)
setParent(org.xml.sax.XMLReader)
,
getParent()
メソッドの詳細 |
---|
public void setParent(XMLReader parent)
親リーダは、このフィルタがイベントを取得し、構成要求を渡す XMLReader
そのものです。親リーダとして別のフィルタを指定することもできます。
親リーダが設定されていないと、構文解析、機能またはプロパティの設定や取得に失敗します。
XMLFilter
内の setParent
parent
- 親 XML リーダgetParent()
public XMLReader getParent()
XMLFilter
内の getParent
setParent(org.xml.sax.XMLReader)
public void setFeature(String name, boolean value) throws SAXNotRecognizedException, SAXNotSupportedException
親が null の場合は常に失敗します。
XMLReader
内の setFeature
name
- 機能名value
- 要求された機能の値
SAXNotRecognizedException
- 機能値を割り当てられない、あるいは親から取得できない場合
SAXNotSupportedException
- 親が機能名を認識するだけで要求された値を設定できない場合XMLReader.getFeature(java.lang.String)
public boolean getFeature(String name) throws SAXNotRecognizedException, SAXNotSupportedException
親が null の場合は常に失敗します。
XMLReader
内の getFeature
name
- 機能名
SAXNotRecognizedException
- 機能値を割り当てられない、あるいは親から取得できない場合
SAXNotSupportedException
- 親が機能名を認識するだけで、現時点ではその値を判断できない場合XMLReader.setFeature(java.lang.String, boolean)
public void setProperty(String name, Object value) throws SAXNotRecognizedException, SAXNotSupportedException
親が null の場合は常に失敗します。
XMLReader
内の setProperty
name
- プロパティ名value
- 要求されたプロパティ値
SAXNotRecognizedException
- プロパティ値を割り当てられない、あるいは親から取得できない場合
SAXNotSupportedException
- 親がプロパティ名を認識するだけで要求された値を設定できない場合public Object getProperty(String name) throws SAXNotRecognizedException, SAXNotSupportedException
XMLReader
内の getProperty
name
- プロパティ名
SAXNotRecognizedException
- プロパティ値を割り当てられない、あるいは親から取得できない場合
SAXNotSupportedException
- 親がプロパティ名を認識するだけで、現時点ではその値を判断できない場合XMLReader.setProperty(java.lang.String, java.lang.Object)
public void setEntityResolver(EntityResolver resolver)
XMLReader
内の setEntityResolver
resolver
- 新しいエンティティリゾルバXMLReader.getEntityResolver()
public EntityResolver getEntityResolver()
XMLReader
内の getEntityResolver
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)
public void setDTDHandler(DTDHandler handler)
XMLReader
内の setDTDHandler
handler
- 新しい DTD ハンドラXMLReader.getDTDHandler()
public DTDHandler getDTDHandler()
XMLReader
内の getDTDHandler
XMLReader.setDTDHandler(org.xml.sax.DTDHandler)
public void setContentHandler(ContentHandler handler)
XMLReader
内の setContentHandler
handler
- 新しいコンテンツハンドラXMLReader.getContentHandler()
public ContentHandler getContentHandler()
XMLReader
内の getContentHandler
XMLReader.setContentHandler(org.xml.sax.ContentHandler)
public void setErrorHandler(ErrorHandler handler)
XMLReader
内の setErrorHandler
handler
- 新しいエラーハンドラXMLReader.getErrorHandler()
public ErrorHandler getErrorHandler()
XMLReader
内の getErrorHandler
XMLReader.setErrorHandler(org.xml.sax.ErrorHandler)
public void parse(InputSource input) throws SAXException, IOException
XMLReader
内の parse
input
- 文書エンティティの入力ソース
SAXException
- SAX 例外。ほかの例外をラップしている可能性がある
IOException
- パーサからの IO 例外。通常、アプリケーションが提供するバイトストリームまたは文字ストリームからの例外InputSource
,
XMLReader.parse(java.lang.String)
,
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)
,
XMLReader.setDTDHandler(org.xml.sax.DTDHandler)
,
XMLReader.setContentHandler(org.xml.sax.ContentHandler)
,
XMLReader.setErrorHandler(org.xml.sax.ErrorHandler)
public void parse(String systemId) throws SAXException, IOException
XMLReader
内の parse
systemId
- システム識別子を示す完全修飾 URI
SAXException
- SAX 例外。ほかの例外をラップしている可能性がある
IOException
- パーサからの IO 例外。通常、アプリケーションが提供するバイトストリームまたは文字ストリームからの例外XMLReader.parse(org.xml.sax.InputSource)
public InputSource resolveEntity(String publicId, String systemId) throws SAXException, IOException
EntityResolver
内の resolveEntity
publicId
- エンティティの公開識別子または nullsystemId
- エンティティのシステム識別子
SAXException
- 処理中にクライアントが例外をスローすることがある
IOException
- 新しい InputSource の取得中にクライアントが入出力関連の例外をスローすることがあるInputSource
public void notationDecl(String name, String publicId, String systemId) throws SAXException
DTDHandler
内の notationDecl
name
- 表記法名publicId
- 表記法の公開識別子または nullsystemId
- 表記法のシステム識別子または null
SAXException
- 処理中にクライアントが例外をスローすることがあるDTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)
,
Attributes
public void unparsedEntityDecl(String name, String publicId, String systemId, String notationName) throws SAXException
DTDHandler
内の unparsedEntityDecl
name
- エンティティ名publicId
- エンティティの公開識別子または nullsystemId
- エンティティのシステム識別子または nullnotationName
- 関連表記法名
SAXException
- 処理中にクライアントが例外をスローすることがあるDTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)
,
Attributes
public void setDocumentLocator(Locator locator)
ContentHandler
内の setDocumentLocator
locator
- 文書ロケータLocator
public void startDocument() throws SAXException
ContentHandler
内の startDocument
SAXException
- 処理中にクライアントが例外をスローすることがあるContentHandler.endDocument()
public void endDocument() throws SAXException
ContentHandler
内の endDocument
SAXException
- 処理中にクライアントが例外をスローすることがあるContentHandler.startDocument()
public void startPrefixMapping(String prefix, String uri) throws SAXException
ContentHandler
内の startPrefixMapping
prefix
- 名前空間接頭辞uri
- 名前空間 URI
SAXException
- 処理中にクライアントが例外をスローすることがあるContentHandler.endPrefixMapping(java.lang.String)
,
ContentHandler.startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)
public void endPrefixMapping(String prefix) throws SAXException
ContentHandler
内の endPrefixMapping
prefix
- 名前空間接頭辞
SAXException
- 処理中にクライアントが例外をスローすることがあるContentHandler.startPrefixMapping(java.lang.String, java.lang.String)
,
ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)
public void startElement(String uri, String localName, String qName, Attributes atts) throws SAXException
ContentHandler
内の startElement
uri
- 要素の名前空間 URI または空文字列localName
- 要素のローカル名または空文字列qName
- 要素の接頭辞付きの修飾名または空文字列atts
- 要素の属性
SAXException
- 処理中にクライアントが例外をスローすることがあるContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)
,
Attributes
,
AttributesImpl
public void endElement(String uri, String localName, String qName) throws SAXException
ContentHandler
内の endElement
uri
- 要素の名前空間 URI または空文字列localName
- 要素のローカル名または空文字列qName
- 要素の接頭辞付きの修飾名または空文字列
SAXException
- 処理中にクライアントが例外をスローすることがあるpublic void characters(char[] ch, int start, int length) throws SAXException
ContentHandler
内の characters
ch
- 文字配列start
- 配列内の開始位置length
- 配列から読み取られる文字数
SAXException
- 処理中にクライアントが例外をスローすることがあるContentHandler.ignorableWhitespace(char[], int, int)
,
Locator
public void ignorableWhitespace(char[] ch, int start, int length) throws SAXException
ContentHandler
内の ignorableWhitespace
ch
- 文字配列start
- 配列内の開始位置length
- 配列から読み取られる文字数
SAXException
- 処理中にクライアントが例外をスローすることがあるContentHandler.characters(char[], int, int)
public void processingInstruction(String target, String data) throws SAXException
ContentHandler
内の processingInstruction
target
- 処理命令のターゲットdata
- ターゲットのテキスト
SAXException
- 処理中にクライアントが例外をスローすることがあるpublic void skippedEntity(String name) throws SAXException
ContentHandler
内の skippedEntity
name
- スキップされたエンティティの名前
SAXException
- 処理中にクライアントが例外をスローすることがあるpublic void warning(SAXParseException e) throws SAXException
ErrorHandler
内の warning
e
- 警告を示す例外
SAXException
- 処理中にクライアントが例外をスローすることがあるSAXParseException
public void error(SAXParseException e) throws SAXException
ErrorHandler
内の error
e
- エラーを示す例外
SAXException
- 処理中にクライアントが例外をスローすることがあるSAXParseException
public void fatalError(SAXParseException e) throws SAXException
ErrorHandler
内の fatalError
e
- エラーを示す例外
SAXException
- 処理中にクライアントが例外をスローすることがあるSAXParseException
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。