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