InputSource (Java Platform SE 8)

java.lang.Object
- org.xml.sax.InputSource

```
public class InputSource
extends Object
```
XMLエンティティの単一の入力ソースです。
このモジュールは、ソース・コード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。詳細については、http://www.saxproject.orgを参照してください。

SAXアプリケーションは、このクラスを利用して入力ソースに関する情報を単一のオブジェクトにカプセル化します。このオブジェクトには、公開識別子、システム識別子、バイト・ストリーム(エンコーディングが指定されている場合もある)、文字ストリームなどが含まれます。

アプリケーションは、入力ソースをParser.parseメソッドの引数として、あるいはEntityResolver.resolveEntityメソッドの戻り値としてパーサーに渡すことができます。

SAXパーサーは、InputSourceオブジェクトを使用してXML入力を読み込む方法を決定します。使用可能な文字ストリームがある場合、パーサーは、そのストリーム内で見つかったテキスト・エンコーディング宣言を無視して、そのストリームを直接読み込みます。文字ストリームがなく、バイト・ストリームがある場合、パーサーは、InputSourceで指定されたエンコーディングを使用して、そのバイト・ストリームを使用します。あるいは、エンコーディングが指定されていない場合は、XML仕様にあるようなアルゴリズムを使用した文字エンコーディングを自動検出して、そのバイト・ストリームを使用します。文字ストリームとバイト・ストリームのどちらも使用できない場合、パーサーは、システム識別子によって識別されたリソースへのURI接続を開こうとします。

InputSourceオブジェクトはアプリケーションに所属するため、これをSAXパーサーが変更することはできませんが、必要に応じてコピーを作成して変更することは可能です。ただし、バイト・ストリームと文字ストリームの両方の標準的な処理は、それらをend-of-parseクリーンアップの一環として閉じることであるため、アプリケーションは、パーサーに渡されたあとでそのようなストリームを再利用しようとはしません。

導入されたバージョン:

SAX 1.0

関連項目:

XMLReader.parse(org.xml.sax.InputSource), EntityResolver.resolveEntity(java.lang.String, java.lang.String), InputStream, Reader

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`InputSource()` デフォルトの引数なしのコンストラクタ。
`InputSource(InputStream byteStream)` バイト・ストリームを指定して新しい入力ソースを作成します。
`InputSource(Reader characterStream)` 文字ストリームを指定して新しい入力ソースを作成します。
`InputSource(String systemId)` システム識別子を指定して新しい入力ソースを作成します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`InputStream`	`getByteStream()` この入力ソースのバイト・ストリームを取得します。
`Reader`	`getCharacterStream()` この入力ソースの文字ストリームを取得します。
`String`	`getEncoding()` バイト・ストリームまたはURIの文字セットを取得します。
`String`	`getPublicId()` この入力ソースの公開識別子を取得します。
`String`	`getSystemId()` この入力ソースのシステム識別子を取得します。
`void`	`setByteStream(InputStream byteStream)` この入力ソースのバイト・ストリームを設定します。
`void`	`setCharacterStream(Reader characterStream)` この入力ソースの文字ストリームを設定します。
`void`	`setEncoding(String encoding)` 文字エンコーディングがわかっている場合、これを設定します。
`void`	`setPublicId(String publicId)` この入力ソースの公開識別子を設定します。
`void`	`setSystemId(String systemId)` この入力ソースのシステム識別子を設定します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - InputSource
```
public InputSource()
```
    デフォルトの引数なしのコンストラクタ。
    
    関連項目:
    
    setPublicId(java.lang.String), setSystemId(java.lang.String), setByteStream(java.io.InputStream), setCharacterStream(java.io.Reader), setEncoding(java.lang.String)
  - InputSource
```
public InputSource(String systemId)
```
    システム識別子を指定して新しい入力ソースを作成します。
    setPublicIdを使って、アプリケーションに公開識別子を含めることもできます。setEncodingを使って既知の文字セットを指定することもできます。
    
    システム識別子がURLである場合、完全に解決する必要があります。また、相対URLでない場合もあります。
    
    パラメータ:
    
    systemId - システム識別子(URI)。
    
    関連項目:
    
    setPublicId(java.lang.String), setSystemId(java.lang.String), setByteStream(java.io.InputStream), setEncoding(java.lang.String), setCharacterStream(java.io.Reader)
  - InputSource
```
public InputSource(InputStream byteStream)
```
    バイト・ストリームを指定して新しい入力ソースを作成します。
    アプリケーションの作成者は、setSystemId()を使って相対URIのベースを提供する必要があります。SetPublicIdを使ってアプリケーションに公開識別子を含めたり、setEncodingを使ってオブジェクトの文字セットを指定することもできます。
    
    パラメータ:
    
    byteStream - 文書を含むrawバイト・ストリーム。
    
    関連項目:
    
    setPublicId(java.lang.String), setSystemId(java.lang.String), setEncoding(java.lang.String), setByteStream(java.io.InputStream), setCharacterStream(java.io.Reader)
  - InputSource
```
public InputSource(Reader characterStream)
```
    文字ストリームを指定して新しい入力ソースを作成します。
    アプリケーションの作成者は、setSystemId()を使って、相対URIを解決するためのベースを提供する必要があります。また、setPublicIdを使ってアプリケーションに公開識別子を含めることができます。
    
    バイト順序記号は文字ストリームに含まれません。
    
    関連項目:
    
    setPublicId(java.lang.String), setSystemId(java.lang.String), setByteStream(java.io.InputStream), setCharacterStream(java.io.Reader)
- メソッドの詳細
  - setPublicId
```
public void setPublicId(String publicId)
```
    この入力ソースの公開識別子を設定します。
    公開識別子は常にオプションです。アプリケーションに公開識別子を含めたい場合は、位置情報の一部として指定します。
    
    パラメータ:
    
    publicId - 文字列としての公開識別子。
    
    関連項目:
    
    getPublicId(), Locator.getPublicId(), SAXParseException.getPublicId()
  - getPublicId
```
public String getPublicId()
```
    この入力ソースの公開識別子を取得します。
    
    戻り値:
    
    公開識別子。提供されなかった場合はnull。
    
    関連項目:
    
    setPublicId(java.lang.String)
  - setSystemId
```
public void setSystemId(String systemId)
```
    この入力ソースのシステム識別子を設定します。
    バイト・ストリームまたは文字ストリームがある場合、システム識別子はオプションですが、指定した方が便利です。アプリケーションはそれを使用して相対URIを解決し、エラー・メッセージや警告に含めることができるためです。パーサーは、バイト・ストリームまたは文字ストリームが指定されていない場合にかぎり、URIへの接続を開こうとします。
    
    システム識別子が示すオブジェクトの文字セットがわかっている場合、アプリケーションはsetEncodingメソッドを使ってこのエンコーディングを登録できます。
    
    システム識別子がURLである場合、完全に解決する必要があります。また、相対URLでない場合もあります。
    
    パラメータ:
    
    systemId - システム識別子を示す文字列。
    
    関連項目:
    
    setEncoding(java.lang.String), getSystemId(), Locator.getSystemId(), SAXParseException.getSystemId()
  - getSystemId
```
public String getSystemId()
```
    この入力ソースのシステム識別子を取得します。
    getEncodingメソッドは、このシステム識別子が示すオブジェクトの文字セットを返します。不明な場合はnullを返します。
    
    システム識別子がURLである場合、完全に解決されます。
    
    戻り値:
    
    システム識別子。提供されなかった場合はnull。
    
    関連項目:
    
    setSystemId(java.lang.String), getEncoding()
  - setByteStream
```
public void setByteStream(InputStream byteStream)
```
    この入力ソースのバイト・ストリームを設定します。
    SAXパーサーは、バイト・ストリームのほかに文字ストリームが指定されている場合、バイト・ストリームを無視します。バイト・ストリームは、URI接続を開始するより優先的に使用されます。
    
    バイト・ストリームの文字セットがわかっている場合、アプリケーションはsetEncodingメソッドを使ってこのエンコーディングを設定する必要があります。
    
    パラメータ:
    
    byteStream - XML文書またはその他のエンティティを含むバイト・ストリーム。
    
    関連項目:
    
    setEncoding(java.lang.String), getByteStream(), getEncoding(), InputStream
  - getByteStream
```
public InputStream getByteStream()
```
    この入力ソースのバイト・ストリームを取得します。
    getEncodingメソッドは、このバイト・ストリームの文字セットを返します。不明な場合はnullを返します。
    
    戻り値:
    
    バイト・ストリーム。提供されなかった場合はnull。
    
    関連項目:
    
    getEncoding(), setByteStream(java.io.InputStream)
  - setEncoding
```
public void setEncoding(String encoding)
```
    文字エンコーディングがわかっている場合、これを設定します。
    エンコーディングは、XMLエンコーディング宣言(XML 1.0勧告のセクション4.3.3を参照)の規定に合った文字列である必要があります。
    
    アプリケーションが文字ストリームを提供する場合、このメソッドには何の効果もありません。
    
    パラメータ:
    
    encoding - 文字エンコーディングを表す文字列。
    
    関連項目:
    
    setSystemId(java.lang.String), setByteStream(java.io.InputStream), getEncoding()
  - getEncoding
```
public String getEncoding()
```
    バイト・ストリームまたはURIの文字セットを取得します。この値は、アプリケーションが文字ストリームを提供する場合は無視されます。
    
    戻り値:
    
    エンコーディング。提供されなかった場合はnull。
    
    関連項目:
    
    setByteStream(java.io.InputStream), getSystemId(), getByteStream()
  - setCharacterStream
```
public void setCharacterStream(Reader characterStream)
```
    この入力ソースの文字ストリームを設定します。
    文字ストリームが指定されている場合、SAXパーサーはバイト・ストリームを無視し、また、システム識別子へのURI接続を開始しません。
    
    パラメータ:
    
    characterStream - XML文書またはその他のエンティティを含む文字ストリーム。
    
    関連項目:
    
    getCharacterStream()、Reader
  - getCharacterStream
```
public Reader getCharacterStream()
```
    この入力ソースの文字ストリームを取得します。
    
    戻り値:
    
    文字ストリーム。提供されなかった場合はnull。
    
    関連項目:
    
    setCharacterStream(java.io.Reader)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスInputSource

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

InputSource

InputSource

InputSource

InputSource

メソッドの詳細

setPublicId

getPublicId

setSystemId

getSystemId

setByteStream

getByteStream

setEncoding

getEncoding

setCharacterStream

getCharacterStream