JavaTM 2
Platform
Std. Ed. v1.4.0

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

XML 構文解析エラーまたは警告をカプセル化します。

このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません

この例外は、元の XML 文書内のエラーの位置を突き止めるための情報を提供します。アプリケーションは ErrorHandler インタフェース内のハンドラへの引数として SAXParseException を受け取りますが、実際に例外をスローする必要はありません。情報を確認して、別のアクションをとるだけでかまいません。

この例外は 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 - エラーまたは警告のロケータオブジェクト (null の場合もある)
関連項目:
Locator, Parser.setLocale(java.util.Locale)

SAXParseException

public SAXParseException(String message,
                         Locator locator,
                         Exception e)
既存の例外を SAXParseException にラップします。

このコンストラクタは、アプリケーションが ContentHandler コールバックから独自の例外を生成し、SAXException のサブクラスになっていない既存の例外をラップする必要がある場合に非常に便利です。

パラメータ:
message - エラーメッセージ、警告メッセージ、または null。null の場合は組み込み例外のメッセージを利用する
locator - エラーまたは警告のロケータオブジェクト (null の場合もある)
e - 例外
関連項目:
Locator, Parser.setLocale(java.util.Locale)

SAXParseException

public SAXParseException(String message,
                         String publicId,
                         String systemId,
                         int lineNumber,
                         int columnNumber)
新しい SAXParseException を生成します。

このコンストラクタは、主にパーサの作成者を対象としています。

システム識別子が URL の場合、パーサは、例外を生成する前に URL を完全に解決する必要があります。

パラメータ:
message - エラーまたは警告メッセージ
publicId - エラーまたは警告を生成したエンティティの公開識別子
systemId - エラーまたは警告を生成したエンティティのシステム識別子
lineNumber - エラーまたは警告の原因となったテキストの終わりの行番号
columnNumber - エラーまたは警告の原因となったテキストの終わりの列番号
関連項目:
Parser.setLocale(java.util.Locale)

SAXParseException

public SAXParseException(String message,
                         String publicId,
                         String systemId,
                         int lineNumber,
                         int columnNumber,
                         Exception e)
組み込み例外を使って新しい SAXParseException を生成します。

このコンストラクタは、主に、SAXException のサブクラスになっていない例外をラップする必要があるパーサの作成者を対象としています。

システム識別子が URL の場合、パーサは、例外を生成する前に URL を完全に解決する必要があります。

パラメータ:
message - エラーメッセージ、警告メッセージ、または null。null の場合は組み込み例外のメッセージを利用する
publicId - エラーまたは警告を生成したエンティティの公開識別子
systemId - エラーまたは警告を生成したエンティティのシステム識別子
lineNumber - エラーまたは警告の原因となったテキストの終わりの行番号
columnNumber - エラーまたは警告の原因となったテキストの終わりの列番号
e - この例外に組み込む別の例外
関連項目:
Parser.setLocale(java.util.Locale)
メソッドの詳細

getPublicId

public String getPublicId()
例外の発生元エンティティの公開識別子を取得します。

戻り値:
公開識別子を含む文字列。使用できない場合は null
関連項目:
Locator.getPublicId()

getSystemId

public String getSystemId()
例外の発生元エンティティのシステム識別子を取得します。

システム識別子が URL である場合、完全に解決されます。

戻り値:
システム識別子を含む文字列。使用できない場合は null
関連項目:
Locator.getSystemId()

getLineNumber

public int getLineNumber()
例外の発生元テキストの終わりの行番号です。

戻り値:
行番号を表す整数値。使用できない場合は -1
関連項目:
Locator.getLineNumber()

getColumnNumber

public int getColumnNumber()
例外の発生元テキストの終わりの列番号です。

列 1 は行内の最初の列です。

戻り値:
列番号を表す整数値。使用できない場合は -1
関連項目:
Locator.getColumnNumber()

JavaTM 2
Platform
Std. Ed. v1.4.0

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

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.