JavaTM 2 Platform
Standard Ed. 5.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 構文解析エラーまたは警告をカプセル化します。

このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。詳細は、http://www.saxproject.org を参照してください。

Locator オブジェクトから出たかのようなこの例外は、元の 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

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()

JavaTM 2 Platform
Standard Ed. 5.0

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

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。