JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.text.html
クラス HTMLDocument.HTMLReader

java.lang.Object
  上位を拡張 javax.swing.text.html.HTMLEditorKit.ParserCallback
      上位を拡張 javax.swing.text.html.HTMLDocument.HTMLReader
含まれているクラス:
HTMLDocument

public class HTMLDocument.HTMLReader
extends HTMLEditorKit.ParserCallback

HTML ドキュメントを HTML 要素構造とともにロードするための HTML リーダです。このクラスは、パーサからのコールバックのセットであり、属性のタグが付いた要素のセットを生成するために実装されます。解析は必要な要素サブツリーを記述するトークン群 (ElementSpec) を組み立て、これを書き込みロックのもとでドキュメントの外部クラスの挿入メソッドを使ってドキュメントに挿入します。

現時点では、<APPLET>、<PARAM>、<MAP>、<AREA>、<LINK>、<SCRIPT>、および <STYLE> はサポートされていません。

HTML.Tag で定義されているタグに対して割り当てられているアクションの記述を次に示します。

タグアクション
HTML.Tag.A CharacterAction
HTML.Tag.ADDRESS CharacterAction
HTML.Tag.APPLET HiddenAction
HTML.Tag.AREA AreaAction
HTML.Tag.B CharacterAction
HTML.Tag.BASE BaseAction
HTML.Tag.BASEFONT CharacterAction
HTML.Tag.BIG CharacterAction
HTML.Tag.BLOCKQUOTEBlockAction
HTML.Tag.BODY BlockAction
HTML.Tag.BR SpecialAction
HTML.Tag.CAPTION BlockAction
HTML.Tag.CENTER BlockAction
HTML.Tag.CITE CharacterAction
HTML.Tag.CODE CharacterAction
HTML.Tag.DD BlockAction
HTML.Tag.DFN CharacterAction
HTML.Tag.DIR BlockAction
HTML.Tag.DIV BlockAction
HTML.Tag.DL BlockAction
HTML.Tag.DT ParagraphAction
HTML.Tag.EM CharacterAction
HTML.Tag.FONT CharacterAction
HTML.Tag.FORM 1.4 では BlockAction
HTML.Tag.FRAME SpecialAction
HTML.Tag.FRAMESET BlockAction
HTML.Tag.H1 ParagraphAction
HTML.Tag.H2 ParagraphAction
HTML.Tag.H3 ParagraphAction
HTML.Tag.H4 ParagraphAction
HTML.Tag.H5 ParagraphAction
HTML.Tag.H6 ParagraphAction
HTML.Tag.HEAD HeadAction
HTML.Tag.HR SpecialAction
HTML.Tag.HTML BlockAction
HTML.Tag.I CharacterAction
HTML.Tag.IMG SpecialAction
HTML.Tag.INPUT FormAction
HTML.Tag.ISINDEX IsndexAction
HTML.Tag.KBD CharacterAction
HTML.Tag.LI BlockAction
HTML.Tag.LINK LinkAction
HTML.Tag.MAP MapAction
HTML.Tag.MENU BlockAction
HTML.Tag.META MetaAction
HTML.Tag.NOFRAMES BlockAction
HTML.Tag.OBJECT SpecialAction
HTML.Tag.OL BlockAction
HTML.Tag.OPTION FormAction
HTML.Tag.P ParagraphAction
HTML.Tag.PARAM HiddenAction
HTML.Tag.PRE PreAction
HTML.Tag.SAMP CharacterAction
HTML.Tag.SCRIPT HiddenAction
HTML.Tag.SELECT FormAction
HTML.Tag.SMALL CharacterAction
HTML.Tag.STRIKE CharacterAction
HTML.Tag.S CharacterAction
HTML.Tag.STRONG CharacterAction
HTML.Tag.STYLE StyleAction
HTML.Tag.SUB CharacterAction
HTML.Tag.SUP CharacterAction
HTML.Tag.TABLE BlockAction
HTML.Tag.TD BlockAction
HTML.Tag.TEXTAREA FormAction
HTML.Tag.TH BlockAction
HTML.Tag.TITLE TitleAction
HTML.Tag.TR BlockAction
HTML.Tag.TT CharacterAction
HTML.Tag.U CharacterAction
HTML.Tag.UL BlockAction
HTML.Tag.VAR CharacterAction

</html> が見つかると、Action は通知されなくなります。


入れ子のクラスの概要
 class HTMLDocument.HTMLReader.BlockAction
           
 class HTMLDocument.HTMLReader.CharacterAction
           
 class HTMLDocument.HTMLReader.FormAction
          フォームの各コントロールを表すための要素をすべて生成して、フォームをサポートするためのアクションです。
 class HTMLDocument.HTMLReader.HiddenAction
           
 class HTMLDocument.HTMLReader.IsindexAction
           
 class HTMLDocument.HTMLReader.ParagraphAction
           
 class HTMLDocument.HTMLReader.PreAction
           
 class HTMLDocument.HTMLReader.SpecialAction
           
 class HTMLDocument.HTMLReader.TagAction
          タグの構文解析に応じて実行されるアクションです。
 
フィールドの概要
protected  MutableAttributeSet charAttr
           
protected  Vector<DefaultStyledDocument.ElementSpec> parseBuffer
           
 
クラス javax.swing.text.html.HTMLEditorKit.ParserCallback から継承されたフィールド
IMPLIED
 
コンストラクタの概要
HTMLDocument.HTMLReader(int offset)
           
HTMLDocument.HTMLReader(int offset, int popDepth, int pushDepth, HTML.Tag insertTag)
           
 
メソッドの概要
protected  void addContent(char[] data, int offs, int length)
          現在の文字属性を持つテキストを追加します。
protected  void addContent(char[] data, int offs, int length, boolean generateImpliedPIfNecessary)
          現在の文字属性を持つテキストを追加します。
protected  void addSpecialElement(HTML.Tag t, MutableAttributeSet a)
          基本的に属性セット全体で指定されているコンテンツを追加します。
protected  void blockClose(HTML.Tag t)
          解析バッファに命令を追加して、指定したタイプのブロック要素を閉じます。
protected  void blockOpen(HTML.Tag t, MutableAttributeSet attr)
          解析バッファに命令を追加して、指定した属性を持つブロック要素を生成します。
 void flush()
          HTML リーダで呼び出される最後のメソッドです。
 void handleComment(char[] data, int pos)
           
 void handleEndOfLineString(String eol)
          ストリームの解析が終了し、flush の前に呼び出されます。
 void handleEndTag(HTML.Tag t, int pos)
          パーサからのコールバックです。
 void handleSimpleTag(HTML.Tag t, MutableAttributeSet a, int pos)
          パーサからのコールバックです。
 void handleStartTag(HTML.Tag t, MutableAttributeSet a, int pos)
          パーサからのコールバックです。
 void handleText(char[] data, int pos)
          テキストブロックが見つかったことを示すために、パーサによって呼び出されます。
protected  void popCharacterStyle()
          以前にプッシュした文字スタイルをスタックからポップして、以前の文字スタイルに戻します。
protected  void preContent(char[] data)
          PRE 要素で検出された指定されたコンテンツを追加します。
protected  void pushCharacterStyle()
          新しい入れ子の文字スタイルを作成する準備として、現在の文字スタイルをスタックにプッシュします。
protected  void registerTag(HTML.Tag t, HTMLDocument.HTMLReader.TagAction a)
          指定したタグのハンドラを登録します。
protected  void textAreaContent(char[] data)
          テキスト領域ドキュメントに指定されたコンテンツを追加します。
 
クラス javax.swing.text.html.HTMLEditorKit.ParserCallback から継承されたメソッド
handleError
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

parseBuffer

protected Vector<DefaultStyledDocument.ElementSpec> parseBuffer

charAttr

protected MutableAttributeSet charAttr
コンストラクタの詳細

HTMLDocument.HTMLReader

public HTMLDocument.HTMLReader(int offset)

HTMLDocument.HTMLReader

public HTMLDocument.HTMLReader(int offset,
                               int popDepth,
                               int pushDepth,
                               HTML.Tag insertTag)
メソッドの詳細

flush

public void flush()
           throws BadLocationException
HTML リーダで呼び出される最後のメソッドです。保留状態にある変更がドキュメントにフラッシュされるようにします。現在、同期的にロードしているため、変更のセット全体がこの時点で反映されます。

オーバーライド:
クラス HTMLEditorKit.ParserCallback 内の flush
例外:
BadLocationException

handleText

public void handleText(char[] data,
                       int pos)
テキストブロックが見つかったことを示すために、パーサによって呼び出されます。

オーバーライド:
クラス HTMLEditorKit.ParserCallback 内の handleText

handleStartTag

public void handleStartTag(HTML.Tag t,
                           MutableAttributeSet a,
                           int pos)
パーサからのコールバックです。このタグの適切なハンドラに配信します。

オーバーライド:
クラス HTMLEditorKit.ParserCallback 内の handleStartTag

handleComment

public void handleComment(char[] data,
                          int pos)
オーバーライド:
クラス HTMLEditorKit.ParserCallback 内の handleComment

handleEndTag

public void handleEndTag(HTML.Tag t,
                         int pos)
パーサからのコールバックです。このタグの適切なハンドラに配信します。

オーバーライド:
クラス HTMLEditorKit.ParserCallback 内の handleEndTag

handleSimpleTag

public void handleSimpleTag(HTML.Tag t,
                            MutableAttributeSet a,
                            int pos)
パーサからのコールバックです。このタグの適切なハンドラに配信します。

オーバーライド:
クラス HTMLEditorKit.ParserCallback 内の handleSimpleTag

handleEndOfLineString

public void handleEndOfLineString(String eol)
ストリームの解析が終了し、flush の前に呼び出されます。eol は、ストリームの解析中に最も多く検出される \n、\r または \r\n のどれかです。

オーバーライド:
クラス HTMLEditorKit.ParserCallback 内の handleEndOfLineString
導入されたバージョン:
1.3

registerTag

protected void registerTag(HTML.Tag t,
                           HTMLDocument.HTMLReader.TagAction a)
指定したタグのハンドラを登録します。デフォルトでは、既知のタグはすべて登録されています。特定のタグの処理を変更したり、カスタムタグのサポートを追加したりするのに使用されます。


pushCharacterStyle

protected void pushCharacterStyle()
新しい入れ子の文字スタイルを作成する準備として、現在の文字スタイルをスタックにプッシュします。


popCharacterStyle

protected void popCharacterStyle()
以前にプッシュした文字スタイルをスタックからポップして、以前の文字スタイルに戻します。


textAreaContent

protected void textAreaContent(char[] data)
テキスト領域ドキュメントに指定されたコンテンツを追加します。このメソッドは、テキスト領域コンテキストで呼び出されます。したがって、表示されるテキストはすべてテキスト領域に属し、そのテキスト領域に関連した TextAreaDocument に追加されます。


preContent

protected void preContent(char[] data)
PRE 要素で検出された指定されたコンテンツを追加します。一連のテキストを保持するための行を合成し、addContent を呼び出して実際にテキストを追加します。


blockOpen

protected void blockOpen(HTML.Tag t,
                         MutableAttributeSet attr)
解析バッファに命令を追加して、指定した属性を持つブロック要素を生成します。


blockClose

protected void blockClose(HTML.Tag t)
解析バッファに命令を追加して、指定したタイプのブロック要素を閉じます。


addContent

protected void addContent(char[] data,
                          int offs,
                          int length)
現在の文字属性を持つテキストを追加します。

パラメータ:
embedded - 埋め込みオブジェクトの属性

addContent

protected void addContent(char[] data,
                          int offs,
                          int length,
                          boolean generateImpliedPIfNecessary)
現在の文字属性を持つテキストを追加します。

パラメータ:
embedded - 埋め込みオブジェクトの属性

addSpecialElement

protected void addSpecialElement(HTML.Tag t,
                                 MutableAttributeSet a)
基本的に属性セット全体で指定されているコンテンツを追加します。


JavaTM 2 Platform
Standard Ed. 5.0

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

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