- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- org.xml.sax.SAXException
-
- org.xml.sax.SAXParseException
-
- すべての実装されたインタフェース:
Serializable
public class SAXParseException extends SAXException
XML構文解析エラーまたは警告をカプセル化します。このモジュールは、ソース・コード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。 詳細については、http://www.saxproject.orgを参照してください。
Locator
オブジェクトから出たかのようなこの例外は、元のXML文書内のエラーの位置を突き止めるための情報を提供します。 アプリケーションはErrorHandler
インタフェース内のハンドラへの引数としてSAXParseExceptionを受け取りますが、実際に例外をスローする必要はありません。情報を確認して、別のアクションをとるだけでかまいません。この例外は
SAXException
のサブクラスなので、別の例外をラップする機能を継承しています。- 導入されたバージョン:
- 1.4, SAX 1.0
- 関連項目:
SAXException
,Locator
,ErrorHandler
, 直列化された形式
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 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を生成します。SAXParseException(String message, Locator locator)
メッセージとLocatorから新しいSAXParseExceptionを生成します。SAXParseException(String message, Locator locator, Exception e)
既存の例外をSAXParseExceptionにラップします。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 int
getColumnNumber()
例外の発生元テキストの終わりの列番号です。int
getLineNumber()
例外の発生元テキストの終わりの行番号です。String
getPublicId()
例外の発生元エンティティの公開識別子を取得します。String
getSystemId()
例外の発生元エンティティのシステム識別子を取得します。String
toString()
toStringをオーバーライドして、より詳細なエラー・メッセージを提供します。-
クラス org.xml.sax.SAXExceptionで宣言されたメソッド
getCause, getException, getMessage
-
クラス java.lang.Throwableで宣言されたメソッド
addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
-
-
-
-
コンストラクタの詳細
-
SAXParseException
public SAXParseException(String message, Locator locator)
メッセージとLocatorから新しいSAXParseExceptionを生成します。このコンストラクタは、アプリケーションが
ContentHandler
コールバック内から独自の例外を作成するときに特に役に立ちます。- パラメータ:
message
- エラーまたは警告メッセージ。locator
- エラーまたは警告のロケータ・オブジェクト(nullの場合もある)。- 関連項目:
Locator
-
SAXParseException
public SAXParseException(String message, Locator locator, Exception e)
既存の例外をSAXParseExceptionにラップします。このコンストラクタは、アプリケーションが
ContentHandler
コールバック内から独自の例外を生成し、SAXException
のサブクラスになっていない既存の例外をラップする必要がある場合に非常に便利です。- パラメータ:
message
- エラー・メッセージ、警告メッセージ、またはnull。nullの場合は組込み例外のメッセージを利用する。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。nullの場合は組込み例外のメッセージを利用する。publicId
- エラーまたは警告を生成したエンティティの公開識別子。systemId
- エラーまたは警告を生成したエンティティのシステム識別子。lineNumber
- エラーまたは警告の原因となったテキストの終わりの行番号。columnNumber
- エラーまたは警告の原因となったテキストの終わりの列番号。e
- この例外に組み込む別の例外。
-
-
メソッドの詳細
-
getPublicId
public String getPublicId()
例外の発生元エンティティの公開識別子を取得します。- 戻り値:
- 公開識別子を含む文字列。使用できない場合はnull。
- 関連項目:
Locator.getPublicId()
-
getSystemId
public String getSystemId()
例外の発生元エンティティのシステム識別子を取得します。システム識別子がURLである場合、完全に解決されます。
- 戻り値:
- システム識別子を含む文字列。使用できない場合はnull。
- 関連項目:
Locator.getSystemId()
-
getLineNumber
public int getLineNumber()
例外の発生元テキストの終わりの行番号です。行1は最初の行です。
- 戻り値:
- 行番号を表す整数値。使用できない場合は -1。
- 関連項目:
Locator.getLineNumber()
-
getColumnNumber
public int getColumnNumber()
例外の発生元テキストの終わりの列番号です。列1は行内の最初の列です。
- 戻り値:
- 列番号を表す整数値。使用できない場合は -1。
- 関連項目:
Locator.getColumnNumber()
-
toString
public String toString()
toStringをオーバーライドして、より詳細なエラー・メッセージを提供します。- オーバーライド:
toString
、クラスSAXException
- 戻り値:
- この例外の文字列表現。
-
-