La classe InputSource constitue une source d'entrée XML pour un analyseur SAX.

Un objet InputSource permet à une application SAX d'encapsuler des informations à propos d'une source d'entrée dans un unique objet, qui peut inclure un identificateur public, un identificateur système, un flux d'octets avec un encodage si possible et/ou un flux de caractères.

L'analyseur SAX utilisera l'objet InputSource pour déterminer comment il doit lire l'entrée XML.

Il y a deux endroits que l'application peut fournir une source d'entrée à l'analyseur: comme argument à la méthode de Parser.parse, ou comme valeur de retour de la méthode d'EntityResolver.resolveEntity.

L'analyseur SAX emploiera l'objet InputSource pour déterminer comment lire l'entrée de XML.

  • S'il y a un objet Reader disponible, l'analyseur lira ce flux directement, sans tenir compte de déclaration d'encodage de caractères trouvée dans ce flux.
  • En cas d'absence d'un flux de caractères, mais de présence d'un objet InputStream, l'analyseur emploiera ce flux en se servant de l'encodage spécifié dans l'objet InputSource. S'il n'existe aucun encodage, alors il tentera de le détecter en utilisant un algorithme tel que celui des spécifications XML.
  • S'il n'y a aucun flux disponible, alors l'analyseur essayera d'ouvrir une connexion URI vers la ressource identifiée par l'identificateur système.
Constructeur
Description
InputSource()
crée une nouvelle instance de la classe InputSource.
InputSource(InputStream byteStream)
crée une nouvelle instance de la classe InputSource en l'initialisant avec un flux d'octets.
InputSource(Reader characterStream)
crée une nouvelle instance de la classe InputSource en l'initialisant avec un flux de carcatères.
InputSource(String systemId)
crée une nouvelle instance de la classe InputSource à partir d'un identificateur système.
Méthode
Description
InputStream getByteStream()
retourne le flux d'octets pour l'objet InputSource.
Reader getCharacterStream()
retourne le flux de caractères pour l'objet InputSource.
String getEncoding()
retourne l'encodage de caractères pour un flux d'octets ou une adresse URI.
String getPublicId()
retourne l'identificateur public de l'objet InputSource.
String getSystemId()
retourne l'identificateur système de l'objet InputSource.
void setByteStream(InputStream byteStream)
fixe le flux d'octets pour l'objet InputSource.
void setCharacterStream(Reader characterStream)
retourne le flux de caractères pour l'objet InputSource.
void setEncoding(String encoding)
fixe l'encodage de caractères.
void setPublicId(String publicId)
fixe l'identificateur public de l'objet InputSource.
void setSystemId(String systemId)
fixe l'identificateur système de l'objet InputSource.
Les méthodes héritées de la classe java.lang.Object
clone, equals, finalize, getClass, hashCode, notify,
notifyAll, toString, wait, wait, wait