Parser (Java Platform SE 8)

java.lang.Object
- javax.swing.text.html.parser.Parser

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

DTDConstants

直系の既知のサブクラス:

DocumentParser
```
public class Parser
extends Object
implements DTDConstants
```
DTD駆動型の単純なHTMLパーサーです。パーサーはInputStreamからHTMLファイルを読み取って、タグやデータを検出すると、各種のメソッド(サブクラスでオーバーライドされる)を呼び出します。
残念なことに、正しく実装されていないHTMLパーサーが数多く出回っています。その結果、フォーマットの正しくないHTMLファイルも多数存在します。このパーサーは、ほとんどのHTMLファイルの解析を試みます。すなわち、この実装はHTMLを優先し、SGMLの仕様とは異なっている場合もあります。
このパーサーは、\rおよび\r\nを\nとして扱います。開始タグの後、および終了タグの前の改行は、SGMLやHTMLの仕様に従って無視されます。
HTML仕様では、空白文字がどのように連続するかについて明確に指定されていません。特に、次のようなシナリオについては議論されていません(ここでは空白文字を使用するべきだが、空白文字の表示に&nbspを使用している)。
「blah <strike> foo」は、「blah <strike>foo」として扱われます。
同様に、「<a href="xx"> Using</a>」は、「<a href="xx">Using</a>」として扱われます。
strictがfalseの場合、フローをブレークするタグ(TagElement.breaksFlows)や末尾に空白が見つかると、空白以外の文字が見つかるまで、空白はすべて無視されます。これにより、一般的なブラウザに動作が近くなります。

関連項目:

DTD, TagElement, SimpleAttributeSet

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`protected DTD`	`dtd`
`protected boolean`	`strict` このフラグは、ParserがSGMLとの互換性を厳密に調べるかどうかを決定します。

インタフェース 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

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

コンストラクタ
コンストラクタと説明

Parser(DTD dtd)

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

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`protected void`	`endTag(boolean omitted)` 終了タグを処理します。
`protected void`	`error(String err)`
`protected void`	`error(String err, String arg1)`
`protected void`	`error(String err, String arg1, String arg2)`
`protected void`	`error(String err, String arg1, String arg2, String arg3)` エラー・ハンドラを呼び出します。
`protected void`	`flushAttributes()`
`protected SimpleAttributeSet`	`getAttributes()`
`protected int`	`getCurrentLine()`
`protected int`	`getCurrentPos()`
`protected void`	`handleComment(char[] text)` HTMLのコメントを検出したときに呼び出されます。
`protected void`	`handleEmptyTag(TagElement tag)` 空のタグを検出したときに呼び出されます。
`protected void`	`handleEndTag(TagElement tag)` 終了タグを検出したときに呼び出されます。
`protected void`	`handleEOFInComment()`
`protected void`	`handleError(int ln, String msg)` エラーが発生したことを示す。
`protected void`	`handleStartTag(TagElement tag)` 開始タグを検出したときに呼び出されます。
`protected void`	`handleText(char[] text)` PCDATAを検出したときに呼び出されます。
`protected void`	`handleTitle(char[] text)` HTMLのtitleタグを検出したときに呼び出されます。
`protected TagElement`	`makeTag(Element elem)`
`protected TagElement`	`makeTag(Element elem, boolean fictional)` TagElementを作成します。
`protected void`	`markFirstTime(Element elem)` ドキュメント内で最初に見つかったタグにマークを付けます。
`void`	`parse(Reader in)` DTDが指定されている場合に、HTMLストリームを解析します。
`String`	`parseDTDMarkup()` 文書型定義(DTD - Document Type Declaration)のマークアップ宣言を解析します。
`protected boolean`	`parseMarkupDeclarations(StringBuffer strBuff)` マークアップ宣言を解析します。
`protected void`	`startTag(TagElement tag)` 開始タグを処理します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - dtd
```
protected DTD dtd
```
  - strict
```
protected boolean strict
```
    このフラグは、ParserがSGMLとの互換性を厳密に調べるかどうかを決定します。falseの場合、Parserは、不正なHTML構成要素からなる特定の共通クラスについては寛容な解析を行います。厳密な場合もそうでない場合も、エラーは記録されます。
- コンストラクタの詳細
  - Parser
```
public Parser(DTD dtd)
```
- メソッドの詳細
  - getCurrentLine
```
protected int getCurrentLine()
```
    戻り値:
    
    現在解析中の行の行番号
  - makeTag
```
protected TagElement makeTag(Element elem,
                             boolean fictional)
```
    TagElementを作成します。
  - makeTag
```
protected TagElement makeTag(Element elem)
```
  - getAttributes
```
protected SimpleAttributeSet getAttributes()
```
  - flushAttributes
```
protected void flushAttributes()
```
  - handleText
```
protected void handleText(char[] text)
```
    PCDATAを検出したときに呼び出されます。
  - handleTitle
```
protected void handleTitle(char[] text)
```
    HTMLのtitleタグを検出したときに呼び出されます。
  - handleComment
```
protected void handleComment(char[] text)
```
    HTMLのコメントを検出したときに呼び出されます。
  - handleEOFInComment
```
protected void handleEOFInComment()
```
  - handleEmptyTag
```
protected void handleEmptyTag(TagElement tag)
                       throws ChangedCharSetException
```
    空のタグを検出したときに呼び出されます。
    
    例外:
    
    ChangedCharSetException
  - handleStartTag
```
protected void handleStartTag(TagElement tag)
```
    開始タグを検出したときに呼び出されます。
  - handleEndTag
```
protected void handleEndTag(TagElement tag)
```
    終了タグを検出したときに呼び出されます。
  - handleError
```
protected void handleError(int ln,
                           String msg)
```
    エラーが発生したことを示す。
  - error
```
protected void error(String err,
                     String arg1,
                     String arg2,
                     String arg3)
```
    エラー・ハンドラを呼び出します。
  - error
```
protected void error(String err,
                     String arg1,
                     String arg2)
```
  - error
```
protected void error(String err,
                     String arg1)
```
  - error
```
protected void error(String err)
```
  - startTag
```
protected void startTag(TagElement tag)
                 throws ChangedCharSetException
```
    開始タグを処理します。新しいタグが、タグのスタックにプッシュされます。属性リストを調べて、必要な属性を探します。
    
    例外:
    
    ChangedCharSetException
  - endTag
```
protected void endTag(boolean omitted)
```
    終了タグを処理します。終了タグは、タグのスタックからポップされます。
  - markFirstTime
```
protected void markFirstTime(Element elem)
```
    ドキュメント内で最初に見つかったタグにマークを付けます。
  - parseDTDMarkup
```
public String parseDTDMarkup()
                      throws IOException
```
    文書型定義(DTD - Document Type Declaration)のマークアップ宣言を解析します。現在は、これを無視します。
    
    例外:
    
    IOException
  - parseMarkupDeclarations
```
protected boolean parseMarkupDeclarations(StringBuffer strBuff)
                                   throws IOException
```
    マークアップ宣言を解析します。現在は、文書型定義(DTD - Document Type Declaration)によるマークアップだけを処理します。マークアップ宣言の場合はtrueを返し、そうでない場合はfalseを返します。
    
    例外:
    
    IOException
  - parse
```
public void parse(Reader in)
           throws IOException
```
    DTDが指定されている場合に、HTMLストリームを解析します。
    
    例外:
    
    IOException
  - getCurrentPos
```
protected int getCurrentPos()
```

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスParser

フィールドのサマリー

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

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

メソッドのサマリー

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

フィールドの詳細

dtd

strict

コンストラクタの詳細

Parser

メソッドの詳細

getCurrentLine

makeTag

makeTag

getAttributes

flushAttributes

handleText

handleTitle

handleComment

handleEOFInComment

handleEmptyTag

handleStartTag

handleEndTag

handleError

error

error

error

error

startTag

endTag

markFirstTime

parseDTDMarkup

parseMarkupDeclarations

parse

getCurrentPos