概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

org.xml.sax
類別 HandlerBase

java.lang.Object
  繼承者 org.xml.sax.HandlerBase
所有已實作的介面：
DocumentHandler, DTDHandler, EntityResolver, ErrorHandler
已過時。 此類別可可以與不推薦使用的 DocumentHandler 介面一起工作。它已經被 SAX2 DefaultHandler 類別所取代。 

public class HandlerBase
extends Object
implements EntityResolver, DTDHandler, DocumentHandler, ErrorHandler

處理程序的預設基礎類別。

此模組（包括源程式碼和文檔）在公共域中，同時 沒有擔保。有關更多資訊，請參閱http://www.saxproject.org。

此類別可實作以下四個 SAX1 介面的預設行為：EntityResolver、DTDHandler、DocumentHandler 和 ErrorHandler。此類別現已過時，但它包括在 SAX2 中用來支持遺留的 SAX1 應用程序。而 SAX2 應用程序應該使用 DefaultHandler 類別。

應用程序編寫者可以在他們僅需實作部分介面時擴展此類別；當應用程序尚未提供其自己的處理程序時解析器編寫者可通過實例化此類別來提供預設的處理程序。

注意，使用此類別是可選的。

從以下版本開始：
SAX 1.0
另請參見：
EntityResolver, DTDHandler, DocumentHandler, ErrorHandler

建構子摘要
HandlerBase()
          已過時。  
 
方法摘要
 void characters(char[] ch, int start, int length)
          已過時。 接收元素內字元資料的通知。
 void endDocument()
          已過時。 接收文檔結束的通知。
 void endElement(String name)
          已過時。 接收元素結束的通知。
 void error(SAXParseException e)
          已過時。 接收可恢復的解析器錯誤的通知。
 void fatalError(SAXParseException e)
          已過時。 報告嚴重的 XML 解析錯誤。
 void ignorableWhitespace(char[] ch, int start, int length)
          已過時。 接收元素內容中可忽略的空白的通知。
 void notationDecl(String name, String publicId, String systemId)
          已過時。 接收註釋宣告的通知。
 void processingInstruction(String target, String data)
          已過時。 接收處理指令的通知。
 InputSource resolveEntity(String publicId, String systemId)
          已過時。 解析外部實體。
 void setDocumentLocator(Locator locator)
          已過時。 接收文檔事件的 Locator 物件。
 void startDocument()
          已過時。 接收文檔開始的通知。
 void startElement(String name, AttributeList attributes)
          已過時。 接收元素開始的通知。
 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
 

建構子詳細資訊

HandlerBase

public HandlerBase()
已過時。 
方法詳細資訊

resolveEntity

public InputSource resolveEntity(String publicId,
                                 String systemId)
                          throws SAXException
已過時。 
解析外部實體。

將始終返回 null，因此解析器將使用 XML 文檔中提供的系統標識符。此方法實作 SAX 預設的行為：應用程序編寫者可以在子類別中覆寫它以便進行諸如目錄尋找或 URI 重定向之類別的特定轉換。

指定者：
介面 EntityResolver 中的 resolveEntity
參數：
publicId - 公共標識符，如果沒有可用的則為 null。
systemId - XML 文檔中提供的系統標識符。
返回：
新的輸入源，或返回 null以要求預設的行為。
拋出：
SAXException - 任何 SAX 異常，可能包裹另外的異常。
另請參見：
EntityResolver.resolveEntity(java.lang.String, java.lang.String)

notationDecl

public void notationDecl(String name,
                         String publicId,
                         String systemId)
已過時。 
接收註釋宣告的通知。

預設為不執行任何操作。如果應用程序編寫者希望追蹤在文檔中宣告的註釋，則可以在子類別中覆寫此方法。

指定者：
介面 DTDHandler 中的 notationDecl
參數：
name - 註釋名稱。
publicId - 註釋公共標識符，如果沒有可使用的則為 null。
systemId - 註釋系統標識符。
另請參見：
DTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)

unparsedEntityDecl

public void unparsedEntityDecl(String name,
                               String publicId,
                               String systemId,
                               String notationName)
已過時。 
接收未解析的實體宣告的通知。

預設為不執行任何操作。應用程序編寫者可以在子類別中覆寫此方法，以便追蹤在文檔中宣告的未解析實體。

指定者：
介面 DTDHandler 中的 unparsedEntityDecl
參數：
name - 實體名稱。
publicId - 實體公共標識符，如果不可用則為 null。
systemId - 實體系統標識符。
notationName - 相關註釋的名稱。
另請參見：
DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

setDocumentLocator

public void setDocumentLocator(Locator locator)
已過時。 
接收文檔事件的 Locator 物件。

預設為不執行任何操作。如果應用程序編寫者希望存儲定位器以用於其他的文檔事件，則可以在子類別中覆寫此方法。

指定者：
介面 DocumentHandler 中的 setDocumentLocator
參數：
locator - 用於所有 SAX 文檔事件的定位器。
另請參見：
DocumentHandler.setDocumentLocator(org.xml.sax.Locator), Locator

startDocument

public void startDocument()
                   throws SAXException
已過時。 
接收文檔開始的通知。

預設為不執行任何操作。應用程序編寫者可以在子類別中覆寫此方法，以便在文檔的開始採取特定的措施（如分派階層樹的根節點或創建輸出檔案）。

指定者：
介面 DocumentHandler 中的 startDocument
拋出：
SAXException - 任何 SAX 異常，可能包裹另外的異常。
另請參見：
DocumentHandler.startDocument()

endDocument

public void endDocument()
                 throws SAXException
已過時。 
接收文檔結束的通知。

預設為不執行任何操作。應用程序編寫者可以在子類別中覆寫此方法，以便在文檔結束時採取特定的措施（如結束階層樹或關閉輸出檔案）。

指定者：
介面 DocumentHandler 中的 endDocument
拋出：
SAXException - 任何 SAX 異常，可能包裹另外的異常。
另請參見：
DocumentHandler.endDocument()

startElement

public void startElement(String name,
                         AttributeList attributes)
                  throws SAXException
已過時。 
接收元素開始的通知。

預設為不執行任何操作。應用程序編寫者可以在子類別中覆寫此方法，以便在每個元素開始時採取特定的措施（如向檔案分派新的階層樹節點或把輸出寫入到檔案）。

指定者：
介面 DocumentHandler 中的 startElement
參數：
name - 元素型別名稱。
attributes - 指定的或預設的屬性。
拋出：
SAXException - 任何 SAX 異常，可能包裹另外的異常。
另請參見：
DocumentHandler.startElement(java.lang.String, org.xml.sax.AttributeList)

endElement

public void endElement(String name)
                throws SAXException
已過時。 
接收元素結束的通知。

預設為不執行任何操作。應用程序編寫者可以在子類別中覆寫此方法，以便在每個元素結束時採取特定的措施（如結束階層樹節點或將輸出寫入到檔案中）。

指定者：
介面 DocumentHandler 中的 endElement
參數：
name - 元素名稱
拋出：
SAXException - 任何 SAX 異常，可能包裹另外的異常。
另請參見：
DocumentHandler.endElement(java.lang.String)

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws SAXException
已過時。 
接收元素內字元資料的通知。

預設為不執行任何操作。應用程序編寫者可以覆寫此方法，以便對每塊字元資料採取特定的措施（如將該資料添加到節點或緩衝區，或者將該資料列印到檔案）。

指定者：
介面 DocumentHandler 中的 characters
參數：
ch - 字元。
start - 在字元陣列中的起始位置。
length - 從字元陣列使用的字元個數。
拋出：
SAXException - 任何 SAX 異常，可能包裹另外的異常。
另請參見：
DocumentHandler.characters(char[], int, int)

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws SAXException
已過時。 
接收元素內容中可忽略的空白的通知。

預設為不執行任何操作。應用程序編寫者可以覆寫此方法，以便對每塊可忽略的空白採取特定的措施（如將資料添加到節點或緩衝區，或者將資料列印到檔案）。

指定者：
介面 DocumentHandler 中的 ignorableWhitespace
參數：
ch - 空白字元。
start - 在字元陣列中的起始位置。
length - 從字元陣列使用的字元個數。
拋出：
SAXException - 任何 SAX 異常，可能包裹另外的異常。
另請參見：
DocumentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

public void processingInstruction(String target,
                                  String data)
                           throws SAXException
已過時。 
接收處理指令的通知。

預設為不執行任何操作。應用程序編寫者可以在子類別中覆寫此方法，以便對每個處理指令採取特定的措施，如設置狀態變數或調用其他的方法。

指定者：
介面 DocumentHandler 中的 processingInstruction
參數：
target - 處理指令目標。
data - 處理指令資料，如果未提供則為 null。
拋出：
SAXException - 任何 SAX 異常，可能包裹另外的異常。
另請參見：
DocumentHandler.processingInstruction(java.lang.String, java.lang.String)

warning

public void warning(SAXParseException e)
             throws SAXException
已過時。 
接收解析器警告的通知。

預設實作不執行任何操作。應用程序編寫者可以在子類別中覆寫此方法，以便對每個警告採取特定的措施，如在日誌檔案中插入訊息，或者將它列印到終端機。

指定者：
介面 ErrorHandler 中的 warning
參數：
e - 編碼為異常的警告資訊。
拋出：
SAXException - 任何 SAX 異常，可能包裹另外的異常。
另請參見：
ErrorHandler.warning(org.xml.sax.SAXParseException), SAXParseException

error

public void error(SAXParseException e)
           throws SAXException
已過時。 
接收可恢復的解析器錯誤的通知。

預設實作不執行任何操作。應用程序編寫者可以在子類別中覆寫此方法，以便對每個錯誤採取特定的措施，如在日誌檔案中插入訊息，或者將它列印到終端機。

指定者：
介面 ErrorHandler 中的 error
參數：
e - 編碼為異常的警告資訊。
拋出：
SAXException - 任何 SAX 異常，可能包裹另外的異常。
另請參見：
ErrorHandler.warning(org.xml.sax.SAXParseException), SAXParseException

fatalError

public void fatalError(SAXParseException e)
                throws SAXException
已過時。 
報告嚴重的 XML 解析錯誤。

預設的實作拋出 SAXParseException。如果應用程序編寫者需要對每個嚴重的錯誤採取特定的措施（如將所有的錯誤收集到一個報告中），則可以在子類別中覆寫此方法：當調用此方法時，無論哪種情況，應用程序都必須停止所有的常規處理，這是因為文檔已不再可靠，並且解析器再也不能報告解析事件。

指定者：
介面 ErrorHandler 中的 fatalError
參數：
e - 編碼為異常的錯誤資訊。
拋出：
SAXException - 任何 SAX 異常，可能包裹另外的異常。
另請參見：
ErrorHandler.fatalError(org.xml.sax.SAXParseException), SAXParseException
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。