SAXParseException (Java 2 Platform SE 6)

概觀

軟體套件

類別

使用

階層樹

已過時

索引

說明

Java^TM 2 Platform
Standard Ed. 6

上一個類別 下一個類別

框架 無框架

摘要：巢狀 | 欄位 | 建構子 | 方法

詳細資訊：欄位 | 建構子 | 方法

org.xml.sax
類別 SAXParseException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          org.xml.sax.SAXException
              org.xml.sax.SAXParseException

所有已實作的介面：: Serializable

public class SAXParseException
extends SAXException
extends SAXException

封裝 XML 解析錯誤或警告。

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

此異常好像來源於 Locator 物件那樣可以包括用來在原始 XML 文檔中尋找錯誤的資訊。注意，儘管應用程序將接收 SAXParseException 作為 ErrorHandler 介面中處理程序的參數，但實際上應用程序不需要拋出異常；它可以只是讀取其中的資訊，並採取不同的操作。

因為此異常是 SAXException 的子類別，所以它繼承了包裹其他異常的能力。

從以下版本開始：: SAX 1.0
另請參見：: SAXException, Locator, ErrorHandler, 序列化表格

建構子摘要
`SAXParseException(String message, Locator locator)` 從訊息和 Locator 創建新的 SAXParseException。
`SAXParseException(String message, Locator locator, Exception e)` 將現有的異常包裹在 SAXParseException 中。
`SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber)` 創建新的 SAXParseException。
`SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber, Exception e)` 創建帶有嵌入異常的新 SAXParseException。

方法摘要
`int`	`getColumnNumber()` 發生異常的文本結尾的列號。
`int`	`getLineNumber()` 發生異常的文本結尾的行號。
`String`	`getPublicId()` 獲取發生異常的實體的公共標識符。
`String`	`getSystemId()` 獲取發生異常的實體的系統標識符。

從類別 org.xml.sax.SAXException 繼承的方法
`getException, getMessage, toString`

從類別 java.lang.Throwable 繼承的方法
`fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace`

從類別 java.lang.Object 繼承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

建構子詳細資訊

SAXParseException

public SAXParseException(String message,
                         Locator locator)

從訊息和 Locator 創建新的 SAXParseException。

當應用程序從 ContentHandler 回調內創建其自己的異常時，此建構子尤其有用。

參數：: message - 錯誤或警告訊息。; locator - 錯誤或警告的 locator 物件（可以為 null）。
另請參見：: Locator

SAXParseException

public SAXParseException(String message,
                         Locator locator,
                         Exception e)

將現有的異常包裹在 SAXParseException 中。

當應用程序從 ContentHandler 回調內創建其自己的異常，並且需要包裹不是 SAXException 的子類別的現有異常時，此建構子尤其有用。

參數：: message - 錯誤或警告訊息；或者為 null，以便使用來自於嵌入異常的訊息。; locator - 錯誤或警告的 locator 物件（可以為 null）。; e - 任何異常。
另請參見：: Locator

SAXParseException

public SAXParseException(String message,
                         String publicId,
                         String systemId,
                         int lineNumber,
                         int columnNumber)

創建新的 SAXParseException。

此建構子對解析器編寫者最為有用。

除訊息之外的所有參數好像都是由 Locator 提供的。例如，如果系統標識符是一個 URL（包括相對檔案名），則調用者必須在創建異常之前完全解析它。

參數：: message - 錯誤或警告訊息。; publicId - 產生錯誤或警告的實體的公共標識符。; systemId - 產生錯誤或警告的實體的系統標識符。; lineNumber - 引起錯誤或警告的文本結尾的行號。; columnNumber - 引起錯誤或警告的文本結尾的列號。

SAXParseException

public SAXParseException(String message,
                         String publicId,
                         String systemId,
                         int lineNumber,
                         int columnNumber,
                         Exception e)

創建帶有嵌入異常的新 SAXParseException。

對於需要包裹不是 SAXException 的子類別的異常的解析器編寫者，此建構子最有用。

除訊息和異常之外的所有參數好像都是由 Locator 提供的。例如，如果系統標識符是 URL（包括相對檔案名），則調用者必須在創建該異常之前完全解析它。

參數：: message - 錯誤或警告訊息，或者 null，以便使用來自於嵌入的異常的訊息。; publicId - 產生錯誤或警告的實體的公共標識符。; systemId - 產生錯誤或警告的實體的系統標識符。; lineNumber - 引起錯誤或警告的文本結尾的行號。; columnNumber - 引起錯誤或警告的文本結尾的列號。; e - 嵌入到此異常中的其他異常。