javax.swing.text.html.parser

クラス DocumentParser

java.lang.Object

javax.swing.text.html.parser.Parser

javax.swing.text.html.parser.DocumentParser

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

DTDConstants

public class DocumentParser
extends Parser

HTML ドキュメントの Parser です。実際には DTD を指定できますが、swing の html dtd にはこのクラスだけを使うようにしてください。HTML の InputStream を読み込み、ParserCallback クラスの適切なメソッドを呼び出します。このクラスは、HTMLEditorKit が HTML url を解析するのに使うデフォルトのパーサーです。

有効なすべてのタグ、および暗示されているが明示的には指定されていないタグに対して、コールバックを伝えます。たとえば、HTML 文字列 (<p>blah) で定義されているのは p タグだけです。コールバックは次のメソッドを検出します。

1. handleStartTag(html, ...)
2. handleStartTag(head, ...)
3. handleEndTag(head)
4. handleStartTag(body, ...)
5. handleStartTag(p, ...)
6. handleText(...)
7. handleEndTag(p)
8. handleEndTag(body)
9. handleEndTag(html)

イタリック体の項目は暗示されています。つまり、明示的には指定されていませんが、正しい HTML であるために存在しているということです。ヘッドは必要ありませんが、生成されます。暗示されるタグについては、AttributeSet 引数がキー HTMLEditorKit.ParserCallback.IMPLIED に Boolean.TRUE の値を持ちます。

HTML.Attributes は型保証された HTML 属性の列挙を定義します。タグの属性キーが HTML.Attribute で定義される場合は HTML.Attribute がキーとして使われ、そうでない場合は String が使われます。たとえば <p foo=bar class=neat> には 2 つの属性があります。foo は HTML.Attribute では定義されず、クラスは HTML.Attribute で定義されるため、AttributeSet は 2 つの値を持ちます。「neat」という String 値を持つ HTML.Attribute.CLASS と、「bar」という String 値を持つ String キー「foo」です。

位置引数はタグ、コメント、またはテキストの開始を示します。配列と同様に、ストリームの最初の文字は 0 という位置が設定されます。暗示されるタグの場合、位置は次に検出されるタグの位置を示します。最初の例では、body および html の暗示された開始タグは p タグと同じ位置が設定され、p、html および body の暗示された終了タグはすべて同じ位置が設定されています。

HTML は空白をスキップするため、テキストの位置は最初の有効な文字の位置になります。たとえば文字列 \n\n\nblah では、テキスト blah は 3 という位置が設定され、改行はスキップされます。

値を持たない属性、たとえば HTML 文字列 <foo blah> の属性 blah は値を持ちませんが、こうした属性の場合は、AttributeSet の値に配置される値として次の 2 つが考えられます。

• DTD が要素の定義を含まない場合、または定義に明示的な値がない場合は、AttributeSet の値は HTML.NULL_ATTRIBUTE_VALUE となる。
• DTD が明示的な値を含む場合は dtd のその値が使用される。たとえば <!ATTLIST OPTION selected (selected) #IMPLIED> では、dtd の値 (この場合は selected) が使用される。

ストリームの解析が終了すると、コールバックは行末文字列である可能性が高い文字列の通知を受けます。行末文字列は、ストリームの解析中にもっとも多く検出される \n、\r または \r\n のどれかです。

フィールドのサマリー

クラス javax.swing.text.html.parser.Parser から継承されたフィールド

dtd, strict

インタフェース javax.swing.text.html.parser.DTDConstants から継承されたフィールド

ANY, CDATA, CONREF, CURRENT, DEFAULT, EMPTY, ENDTAG, ENTITIES, ENTITY, FIXED, GENERAL, ID, IDREF, IDREFS, IMPLIED, MD, MODEL, MS, NAME, NAMES, NMTOKEN, NMTOKENS, NOTATION, NUMBER, NUMBERS, NUTOKEN, NUTOKENS, PARAMETER, PI, PUBLIC, RCDATA, REQUIRED, SDATA, STARTTAG, SYSTEM

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
DocumentParser(DTD dtd)

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
protected void	handleComment(char[] text) HTML のコメントを検出したときに呼び出されます。
protected void	handleEmptyTag(TagElement tag) 空のタグを処理します。
protected void	handleEndTag(TagElement tag) 終了タグを処理します。
protected void	handleError(int ln, String errorMsg) エラーが発生したことを示す。
protected void	handleStartTag(TagElement tag) 開始タグを処理します。
protected void	handleText(char[] data) テキストを処理します。
void	parse(Reader in, HTMLEditorKit.ParserCallback callback, boolean ignoreCharSet)

クラス javax.swing.text.html.parser.Parser から継承されたメソッド

endTag, error, error, error, error, flushAttributes, getAttributes, getCurrentLine, getCurrentPos, handleEOFInComment, handleTitle, makeTag, makeTag, markFirstTime, parse, parseDTDMarkup, parseMarkupDeclarations, startTag

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

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

コンストラクタの詳細

DocumentParser

public DocumentParser(DTD dtd)

メソッドの詳細

parse

public void parse(Reader in,
         HTMLEditorKit.ParserCallback callback,
         boolean ignoreCharSet)
           throws IOException

例外:

IOException

handleStartTag

protected void handleStartTag(TagElement tag)

開始タグを処理します。

オーバーライド:

handleStartTag、クラス: Parser

handleComment

protected void handleComment(char[] text)

次のクラスからコピーされた説明: Parser

HTML のコメントを検出したときに呼び出されます。

オーバーライド:

handleComment、クラス: Parser

handleEmptyTag

protected void handleEmptyTag(TagElement tag)
                       throws ChangedCharSetException

空のタグを処理します。

オーバーライド:

handleEmptyTag、クラス: Parser

例外:

ChangedCharSetException

handleEndTag

protected void handleEndTag(TagElement tag)

終了タグを処理します。

オーバーライド:

handleEndTag、クラス: Parser

handleText

protected void handleText(char[] data)

テキストを処理します。

オーバーライド:

handleText、クラス: Parser

handleError

protected void handleError(int ln,
               String errorMsg)

次のクラスからコピーされた説明: Parser

エラーが発生したことを示す。

オーバーライド:

handleError、クラス: Parser