rome 2.1.0 · com.rometools.rome.io.XmlReader

Modifier and Type	Field and Description
private static final int	BUFFER_SIZE
private static final Pattern	CHARSET_PATTERN
private static final String	CP1047
private final String	defaultEncoding
private String	encoding
private static final Pattern	ENCODING_PATTERN
private static final MessageFormat	HTTP_EX_1
private static final MessageFormat	HTTP_EX_2
private static final MessageFormat	HTTP_EX_3
private static final MessageFormat	RAW_EX_1
private static final MessageFormat	RAW_EX_2
private Reader	reader
private static String	staticDefaultEncoding
private static final String	US_ASCII
private static final String	UTF_16
private static final String	UTF_16BE
private static final String	UTF_16LE
private static final String	UTF_8

Constructor Summary

Access	Constructor and Description
public	XmlReader(final File File to create a Reader from. file) Creates a Reader for a File.
public	XmlReader(final InputStream InputStream to create a Reader from. is) Creates a Reader for a raw InputStream.
public	XmlReader(final InputStream InputStream to create a Reader from. is, final boolean indicates if the charset encoding detection should be relaxed. lenient, final String default encoding to use if one cannot be detected. defaultEncoding) Creates a Reader for a raw InputStream and uses the provided default encoding if none is determined.
public	XmlReader(final InputStream InputStream to create a Reader from. is, final boolean indicates if the charset encoding detection should be relaxed. lenient) Creates a Reader for a raw InputStream.
public	XmlReader(final URL URL to create a Reader from. url) Deprecated As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach. Creates a Reader using the InputStream of a URL.
public	XmlReader(final URL URL to create a Reader from. url, final Map<String, String> optional Map of headers to set on http request. requestHeaders) Deprecated As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach. Creates a Reader using the InputStream of a URL.
public	XmlReader(final URLConnection URLConnection to create a Reader from. conn) Deprecated As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach. Creates a Reader using the InputStream of a URLConnection.
public	XmlReader(final URLConnection URLConnection to create a Reader from. conn, final Map<String, String> optional Map of headers to set on http request. requestHeaders) Deprecated As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach. Creates a Reader using the InputStream of a URLConnection.
public	XmlReader(final InputStream InputStream to create the reader from. is, final String content-type header to use for the resolution of the charset encoding. httpContentType) Creates a Reader using an InputStream and the associated content-type header.
public	XmlReader(final InputStream InputStream to create the reader from. is, final String content-type header to use for the resolution of the charset encoding. httpContentType, final boolean indicates if the charset encoding detection should be relaxed. lenient, final String default encoding to use if one cannot be detected. defaultEncoding) Creates a Reader using an InputStream and the associated content-type header.
public	XmlReader(final InputStream InputStream to create the reader from. is, final String content-type header to use for the resolution of the charset encoding. httpContentType, final boolean indicates if the charset encoding detection should be relaxed. lenient) Creates a Reader using an InputStream and the associated content-type header.

Method Summary

Modifier and Type	Method and Description
private String	calculateHttpEncoding(final String cTMime, final String cTEnc, final String bomEnc, final String xmlGuessEnc, final String xmlEnc, final InputStream is, final boolean lenient)
private String	calculateRawEncoding(final String bomEnc, final String xmlGuessEnc, final String xmlEnc, final InputStream is)
public void	close() Implements abstract java.io.Reader.close. Implements java.io.Closeable.close. Closes the XmlReader stream.
private void	doHttpStream(final InputStream is, final String httpContentType, final boolean lenient)
private void	doLenientDetection(String httpContentType, XmlReaderException ex)
private void	doRawStream(final InputStream is, final boolean lenient)
private static String	getBOMEncoding(final BufferedInputStream is)
private static String	getContentTypeEncoding(final String httpContentType)
private static String	getContentTypeMime(final String httpContentType)
public static String	Returns: the default encoding to use. getDefaultEncoding() Returns the default encoding to use if none is set in HTTP content-type, XML prolog and the rules based on content-type are not adequate.
public String	Returns: charset encoding. getEncoding() Returns the charset encoding of the XmlReader.
private static String	getXMLGuessEncoding(final BufferedInputStream is)
pack-priv static String	getXmlProlog(final InputStream is, final String guessedEnc)
private static boolean	isAppXml(final String mime)
private static boolean	isTextXml(final String mime)
private void	prepareReader(final InputStream is, final String encoding)
public int	read(final char[] Destination buffer buf, final int Offset at which to start storing characters offset, final int Maximum number of characters to read len) Implements abstract java.io.Reader.read. Reads characters into a portion of an array.
public static void	setDefaultEncoding(final String charset encoding to default to. encoding) Sets the default encoding to use if none is set in HTTP content-type, XML prolog and the rules based on content-type are not adequate.
private void	setRequestHeader(final URLConnection conn, final Map<String, String> requestHeaders)

Inherited from java.io.Reader:: mark markSupported nullReader read read read ready reset skip transferTo

Field Detail

BUFFER_SIZE	back to summary
private static final int BUFFER_SIZE

CHARSET_PATTERN	back to summary
private static final Pattern CHARSET_PATTERN

CP1047	back to summary
private static final String CP1047

defaultEncoding	back to summary
private final String defaultEncoding

encoding	back to summary
private String encoding

ENCODING_PATTERN	back to summary
private static final Pattern ENCODING_PATTERN

HTTP_EX_1	back to summary
private static final MessageFormat HTTP_EX_1

HTTP_EX_2	back to summary
private static final MessageFormat HTTP_EX_2

HTTP_EX_3	back to summary
private static final MessageFormat HTTP_EX_3

RAW_EX_1	back to summary
private static final MessageFormat RAW_EX_1

RAW_EX_2	back to summary
private static final MessageFormat RAW_EX_2

reader	back to summary
private Reader reader

staticDefaultEncoding	back to summary
private static String staticDefaultEncoding

US_ASCII	back to summary
private static final String US_ASCII

UTF_16	back to summary
private static final String UTF_16

UTF_16BE	back to summary
private static final String UTF_16BE

UTF_16LE	back to summary
private static final String UTF_16LE

UTF_8	back to summary
private static final String UTF_8

Constructor Detail

XmlReader	back to summary
public XmlReader(final File file) throws IOException Creates a Reader for a File. It looks for the UTF-8 BOM first, if none sniffs the XML prolog charset, if this is also missing defaults to UTF-8. It does a lenient charset encoding detection, check the constructor with the lenient parameter for details. Parameters file:File File to create a Reader from. Exceptions IOException: thrown if there is a problem reading the file.

XmlReader

back to summary

public XmlReader(final File file) throws IOException

Creates a Reader for a File.

It looks for the UTF-8 BOM first, if none sniffs the XML prolog charset, if this is also missing defaults to UTF-8.

It does a lenient charset encoding detection, check the constructor with the lenient parameter for details.

Parameters

file:File: File to create a Reader from.

Exceptions

IOException:: thrown if there is a problem reading the file.

XmlReader	back to summary
public XmlReader(final InputStream is) throws IOException Creates a Reader for a raw InputStream. It follows the same logic used for files. It does a lenient charset encoding detection, check the constructor with the lenient parameter for details. Parameters is:InputStream InputStream to create a Reader from. Exceptions IOException: thrown if there is a problem reading the stream.

XmlReader

back to summary

public XmlReader(final InputStream is) throws IOException

Creates a Reader for a raw InputStream.

It follows the same logic used for files.

It does a lenient charset encoding detection, check the constructor with the lenient parameter for details.

Parameters

is:InputStream: InputStream to create a Reader from.

Exceptions

IOException:: thrown if there is a problem reading the stream.

XmlReader	back to summary
public XmlReader(final InputStream is, final boolean lenient, final String defaultEncoding) throws IOException, XmlReaderException Creates a Reader for a raw InputStream and uses the provided default encoding if none is determined. It follows the same logic used for files. If lenient detection is indicated and the detection above fails as per specifications it then attempts the following: If the content type was 'text/html' it replaces it with 'text/xml' and tries the detection again. Else if the XML prolog had a charset encoding that encoding is used. Else if the content type had a charset encoding that encoding is used. Else 'UTF-8' is used. If lenient detection is indicated an XmlReaderException is never thrown. Parameters is:InputStream InputStream to create a Reader from. lenient:boolean indicates if the charset encoding detection should be relaxed. defaultEncoding:String default encoding to use if one cannot be detected. Exceptions IOException: thrown if there is a problem reading the stream. XmlReaderException: thrown if the charset encoding could not be determined according to the specs.

XmlReader

back to summary

public XmlReader(final InputStream is, final boolean lenient, final String defaultEncoding) throws IOException, XmlReaderException

Creates a Reader for a raw InputStream and uses the provided default encoding if none is determined.

It follows the same logic used for files.

If lenient detection is indicated and the detection above fails as per specifications it then attempts the following:

If the content type was 'text/html' it replaces it with 'text/xml' and tries the detection again.

Else if the XML prolog had a charset encoding that encoding is used.

Else if the content type had a charset encoding that encoding is used.

Else 'UTF-8' is used.

If lenient detection is indicated an XmlReaderException is never thrown.

Parameters

is:InputStream: InputStream to create a Reader from.
lenient:boolean: indicates if the charset encoding detection should be relaxed.
defaultEncoding:String: default encoding to use if one cannot be detected.

Exceptions

IOException:: thrown if there is a problem reading the stream.
XmlReaderException:: thrown if the charset encoding could not be determined according to the specs.

XmlReader	back to summary
public XmlReader(final InputStream is, final boolean lenient) throws IOException, XmlReaderException Creates a Reader for a raw InputStream. It follows the same logic used for files. If lenient detection is indicated and the detection above fails as per specifications it then attempts the following: If the content type was 'text/html' it replaces it with 'text/xml' and tries the detection again. Else if the XML prolog had a charset encoding that encoding is used. Else if the content type had a charset encoding that encoding is used. Else 'UTF-8' is used. If lenient detection is indicated an XmlReaderException is never thrown. Parameters is:InputStream InputStream to create a Reader from. lenient:boolean indicates if the charset encoding detection should be relaxed. Exceptions IOException: thrown if there is a problem reading the stream. XmlReaderException: thrown if the charset encoding could not be determined according to the specs.

XmlReader

back to summary

public XmlReader(final InputStream is, final boolean lenient) throws IOException, XmlReaderException

Creates a Reader for a raw InputStream.

It follows the same logic used for files.

If lenient detection is indicated and the detection above fails as per specifications it then attempts the following:

If the content type was 'text/html' it replaces it with 'text/xml' and tries the detection again.

Else if the XML prolog had a charset encoding that encoding is used.

Else if the content type had a charset encoding that encoding is used.

Else 'UTF-8' is used.

If lenient detection is indicated an XmlReaderException is never thrown.

Parameters

is:InputStream: InputStream to create a Reader from.
lenient:boolean: indicates if the charset encoding detection should be relaxed.

Exceptions

IOException:: thrown if there is a problem reading the stream.
XmlReaderException:: thrown if the charset encoding could not be determined according to the specs.

XmlReader	back to summary
public XmlReader(final URL url) throws IOException Deprecated As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach. Creates a Reader using the InputStream of a URL. If the URL is not of type HTTP and there is not 'content-type' header in the fetched data it uses the same logic used for Files. If the URL is a HTTP Url or there is a 'content-type' header in the fetched data it uses the same logic used for an InputStream with content-type. It does a lenient charset encoding detection, check the constructor with the lenient parameter for details. Parameters url:URL URL to create a Reader from. Annotations @Deprecated Exceptions IOException: thrown if there is a problem reading the stream of the URL.

XmlReader

back to summary

public XmlReader(final URL url) throws IOException

Deprecated

As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach.

Creates a Reader using the InputStream of a URL.

If the URL is not of type HTTP and there is not 'content-type' header in the fetched data it uses the same logic used for Files.

If the URL is a HTTP Url or there is a 'content-type' header in the fetched data it uses the same logic used for an InputStream with content-type.

It does a lenient charset encoding detection, check the constructor with the lenient parameter for details.

Parameters

url:URL: URL to create a Reader from.

Annotations

@Deprecated

Exceptions

IOException:: thrown if there is a problem reading the stream of the URL.

XmlReader	back to summary
public XmlReader(final URL url, final Map<String, String> requestHeaders) throws IOException Deprecated As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach. Creates a Reader using the InputStream of a URL. If the URL is not of type HTTP and there is not 'content-type' header in the fetched data it uses the same logic used for Files. If the URL is a HTTP Url or there is a 'content-type' header in the fetched data it uses the same logic used for an InputStream with content-type. It does a lenient charset encoding detection, check the constructor with the lenient parameter for details. Parameters url:URL URL to create a Reader from. requestHeaders:Map<String, String> optional Map of headers to set on http request. Annotations @Deprecated Exceptions IOException: thrown if there is a problem reading the stream of the URL.

XmlReader

back to summary

public XmlReader(final URL url, final Map<String, String> requestHeaders) throws IOException

Deprecated

As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach.

Creates a Reader using the InputStream of a URL.

If the URL is not of type HTTP and there is not 'content-type' header in the fetched data it uses the same logic used for Files.

If the URL is a HTTP Url or there is a 'content-type' header in the fetched data it uses the same logic used for an InputStream with content-type.

It does a lenient charset encoding detection, check the constructor with the lenient parameter for details.

Parameters

url:URL: URL to create a Reader from.
requestHeaders:Map<String, String>: optional Map of headers to set on http request.

Annotations

@Deprecated

Exceptions

IOException:: thrown if there is a problem reading the stream of the URL.

XmlReader	back to summary
public XmlReader(final URLConnection conn) throws IOException Deprecated As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach. Creates a Reader using the InputStream of a URLConnection. If the URLConnection is not of type HttpURLConnection and there is not 'content-type' header in the fetched data it uses the same logic used for files. If the URLConnection is a HTTP Url or there is a 'content-type' header in the fetched data it uses the same logic used for an InputStream with content-type. It does a lenient charset encoding detection, check the constructor with the lenient parameter for details. Parameters conn:URLConnection URLConnection to create a Reader from. Annotations @Deprecated Exceptions IOException: thrown if there is a problem reading the stream of the URLConnection.

XmlReader

back to summary

public XmlReader(final URLConnection conn) throws IOException

Deprecated

As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach.

Creates a Reader using the InputStream of a URLConnection.

If the URLConnection is not of type HttpURLConnection and there is not 'content-type' header in the fetched data it uses the same logic used for files.

If the URLConnection is a HTTP Url or there is a 'content-type' header in the fetched data it uses the same logic used for an InputStream with content-type.

It does a lenient charset encoding detection, check the constructor with the lenient parameter for details.

Parameters

conn:URLConnection: URLConnection to create a Reader from.

Annotations

@Deprecated

Exceptions

IOException:: thrown if there is a problem reading the stream of the URLConnection.

XmlReader	back to summary
public XmlReader(final URLConnection conn, final Map<String, String> requestHeaders) throws IOException Deprecated As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach. Creates a Reader using the InputStream of a URLConnection. If the URLConnection is not of type HttpURLConnection and there is not 'content-type' header in the fetched data it uses the same logic used for files. If the URLConnection is a HTTP Url or there is a 'content-type' header in the fetched data it uses the same logic used for an InputStream with content-type. It does a lenient charset encoding detection, check the constructor with the lenient parameter for details. Parameters conn:URLConnection URLConnection to create a Reader from. requestHeaders:Map<String, String> optional Map of headers to set on http request. Annotations @Deprecated Exceptions IOException: thrown if there is a problem reading the stream of the URLConnection.

XmlReader

back to summary

public XmlReader(final URLConnection conn, final Map<String, String> requestHeaders) throws IOException

Deprecated

As of release 2.0.0 and will be removed in version 3.0.0 due to too many problems with this approach.

Creates a Reader using the InputStream of a URLConnection.

If the URLConnection is not of type HttpURLConnection and there is not 'content-type' header in the fetched data it uses the same logic used for files.

If the URLConnection is a HTTP Url or there is a 'content-type' header in the fetched data it uses the same logic used for an InputStream with content-type.

It does a lenient charset encoding detection, check the constructor with the lenient parameter for details.

Parameters

conn:URLConnection: URLConnection to create a Reader from.
requestHeaders:Map<String, String>: optional Map of headers to set on http request.

Annotations

@Deprecated

Exceptions

IOException:: thrown if there is a problem reading the stream of the URLConnection.

XmlReader	back to summary
public XmlReader(final InputStream is, final String httpContentType) throws IOException Creates a Reader using an InputStream and the associated content-type header. First it checks if the stream has BOM. If there is not BOM checks the content-type encoding. If there is not content-type encoding checks the XML prolog encoding. If there is not XML prolog encoding uses the default encoding mandated by the content-type MIME type. It does a lenient charset encoding detection, check the constructor with the lenient parameter for details. Parameters is:InputStream InputStream to create the reader from. httpContentType:String content-type header to use for the resolution of the charset encoding. Exceptions IOException: thrown if there is a problem reading the file.

XmlReader

back to summary

public XmlReader(final InputStream is, final String httpContentType) throws IOException

Creates a Reader using an InputStream and the associated content-type header.

First it checks if the stream has BOM. If there is not BOM checks the content-type encoding. If there is not content-type encoding checks the XML prolog encoding. If there is not XML prolog encoding uses the default encoding mandated by the content-type MIME type.

It does a lenient charset encoding detection, check the constructor with the lenient parameter for details.

Parameters

is:InputStream: InputStream to create the reader from.
httpContentType:String: content-type header to use for the resolution of the charset encoding.

Exceptions

IOException:: thrown if there is a problem reading the file.

XmlReader	back to summary
public XmlReader(final InputStream is, final String httpContentType, final boolean lenient, final String defaultEncoding) throws IOException, XmlReaderException Creates a Reader using an InputStream and the associated content-type header. First it checks if the stream has BOM. If there is not BOM checks the content-type encoding. If there is not content-type encoding checks the XML prolog encoding. If there is not XML prolog encoding uses the default encoding mandated by the content-type MIME type. If lenient detection is indicated and the detection above fails as per specifications it then attempts the following: If the content type was 'text/html' it replaces it with 'text/xml' and tries the detection again. Else if the XML prolog had a charset encoding that encoding is used. Else if the content type had a charset encoding that encoding is used. Else 'UTF-8' is used. If lenient detection is indicated and XmlReaderException is never thrown. Parameters is:InputStream InputStream to create the reader from. httpContentType:String content-type header to use for the resolution of the charset encoding. lenient:boolean indicates if the charset encoding detection should be relaxed. defaultEncoding:String default encoding to use if one cannot be detected. Exceptions IOException: thrown if there is a problem reading the file. XmlReaderException: thrown if the charset encoding could not be determined according to the specs.

XmlReader

back to summary

public XmlReader(final InputStream is, final String httpContentType, final boolean lenient, final String defaultEncoding) throws IOException, XmlReaderException

Creates a Reader using an InputStream and the associated content-type header.

If lenient detection is indicated and the detection above fails as per specifications it then attempts the following:

If the content type was 'text/html' it replaces it with 'text/xml' and tries the detection again.

Else if the XML prolog had a charset encoding that encoding is used.

Else if the content type had a charset encoding that encoding is used.

Else 'UTF-8' is used.

If lenient detection is indicated and XmlReaderException is never thrown.

Parameters

is:InputStream: InputStream to create the reader from.
httpContentType:String: content-type header to use for the resolution of the charset encoding.
lenient:boolean: indicates if the charset encoding detection should be relaxed.
defaultEncoding:String: default encoding to use if one cannot be detected.

Exceptions

IOException:: thrown if there is a problem reading the file.
XmlReaderException:: thrown if the charset encoding could not be determined according to the specs.

XmlReader	back to summary
public XmlReader(final InputStream is, final String httpContentType, final boolean lenient) throws IOException, XmlReaderException Creates a Reader using an InputStream and the associated content-type header. First it checks if the stream has BOM. If there is not BOM checks the content-type encoding. If there is not content-type encoding checks the XML prolog encoding. If there is not XML prolog encoding uses the default encoding mandated by the content-type MIME type. If lenient detection is indicated and the detection above fails as per specifications it then attempts the following: If the content type was 'text/html' it replaces it with 'text/xml' and tries the detection again. Else if the XML prolog had a charset encoding that encoding is used. Else if the content type had a charset encoding that encoding is used. Else 'UTF-8' is used. If lenient detection is indicated and XmlReaderException is never thrown. Parameters is:InputStream InputStream to create the reader from. httpContentType:String content-type header to use for the resolution of the charset encoding. lenient:boolean indicates if the charset encoding detection should be relaxed. Exceptions IOException: thrown if there is a problem reading the file. XmlReaderException: thrown if the charset encoding could not be determined according to the specs.

XmlReader

back to summary

public XmlReader(final InputStream is, final String httpContentType, final boolean lenient) throws IOException, XmlReaderException

Creates a Reader using an InputStream and the associated content-type header.

If lenient detection is indicated and the detection above fails as per specifications it then attempts the following:

If the content type was 'text/html' it replaces it with 'text/xml' and tries the detection again.

Else if the XML prolog had a charset encoding that encoding is used.

Else if the content type had a charset encoding that encoding is used.

Else 'UTF-8' is used.

If lenient detection is indicated and XmlReaderException is never thrown.

Parameters

is:InputStream: InputStream to create the reader from.
httpContentType:String: content-type header to use for the resolution of the charset encoding.
lenient:boolean: indicates if the charset encoding detection should be relaxed.

Exceptions

IOException:: thrown if there is a problem reading the file.
XmlReaderException:: thrown if the charset encoding could not be determined according to the specs.

Method Detail

calculateHttpEncoding	back to summary
private String calculateHttpEncoding(final String cTMime, final String cTEnc, final String bomEnc, final String xmlGuessEnc, final String xmlEnc, final InputStream is, final boolean lenient) throws IOException

calculateRawEncoding	back to summary
private String calculateRawEncoding(final String bomEnc, final String xmlGuessEnc, final String xmlEnc, final InputStream is) throws IOException

close	back to summary
public void close() throws IOException Implements abstract java.io.Reader.close. Implements java.io.Closeable.close. Closes the XmlReader stream. Annotations @Override Exceptions IOException: thrown if there was a problem closing the stream.

back to summary

public void close() throws IOException

Implements abstract java.io.Reader.close.

Implements java.io.Closeable.close.

Closes the XmlReader stream.

Annotations

@Override

Exceptions

IOException:: thrown if there was a problem closing the stream.

doHttpStream	back to summary
private void doHttpStream(final InputStream is, final String httpContentType, final boolean lenient) throws IOException

doLenientDetection	back to summary
private void doLenientDetection(String httpContentType, XmlReaderException ex) throws IOException

doRawStream	back to summary
private void doRawStream(final InputStream is, final boolean lenient) throws IOException

getBOMEncoding	back to summary
private static String getBOMEncoding(final BufferedInputStream is) throws IOException

getContentTypeEncoding	back to summary
private static String getContentTypeEncoding(final String httpContentType)

getContentTypeMime	back to summary
private static String getContentTypeMime(final String httpContentType)

getDefaultEncoding	back to summary
public static String getDefaultEncoding() Returns the default encoding to use if none is set in HTTP content-type, XML prolog and the rules based on content-type are not adequate. If it is NULL the content-type based rules are used. Returns:String the default encoding to use.

getDefaultEncoding

back to summary

public static String getDefaultEncoding()

Returns the default encoding to use if none is set in HTTP content-type, XML prolog and the rules based on content-type are not adequate.

If it is NULL the content-type based rules are used.

Returns:String: the default encoding to use.

getEncoding	back to summary
public String getEncoding() Returns the charset encoding of the XmlReader. Returns:String charset encoding.

getEncoding

back to summary

public String getEncoding()

Returns the charset encoding of the XmlReader.

Returns:String: charset encoding.

getXMLGuessEncoding	back to summary
private static String getXMLGuessEncoding(final BufferedInputStream is) throws IOException

getXmlProlog	back to summary
pack-priv static String getXmlProlog(final InputStream is, final String guessedEnc) throws IOException

isAppXml	back to summary
private static boolean isAppXml(final String mime)

isTextXml	back to summary
private static boolean isTextXml(final String mime)

prepareReader	back to summary
private void prepareReader(final InputStream is, final String encoding) throws IOException

read back to summary

read	back to summary
public int read(final char[] buf, final int offset, final int len) throws IOException Implements abstract java.io.Reader.read. Doc from java.io.Reader.read. Reads characters into a portion of an array. This method will block until some input is available, an I/O error occurs, or the end of the stream is reached. If `len` is zero, then no characters are read and `0` is returned; otherwise, there is an attempt to read at least one character. If no character is available because the stream is at its end, the value `-1` is returned; otherwise, at least one character is read and stored into `cbuf`. Parameters buf:char[] Destination buffer offset:int Offset at which to start storing characters len:int Maximum number of characters to read Returns:int The number of characters read, or -1 if the end of the stream has been reached Annotations @Override Exceptions IOException: If an I/O error occurs

public int read(final char[] buf, final int offset, final int len) throws IOException

Implements abstract java.io.Reader.read.

Doc from java.io.Reader.read.

Reads characters into a portion of an array. This method will block until some input is available, an I/O error occurs, or the end of the stream is reached.

If len is zero, then no characters are read and 0 is returned; otherwise, there is an attempt to read at least one character. If no character is available because the stream is at its end, the value -1 is returned; otherwise, at least one character is read and stored into cbuf.

Parameters

buf:char[]: Destination buffer
offset:int: Offset at which to start storing characters
len:int: Maximum number of characters to read

Returns:int

The number of characters read, or -1 if the end of the stream has been reached

Annotations

@Override

Exceptions

IOException:: If an I/O error occurs

setDefaultEncoding	back to summary
public static void setDefaultEncoding(final String encoding) Sets the default encoding to use if none is set in HTTP content-type, XML prolog and the rules based on content-type are not adequate. If it is set to NULL the content-type based rules are used. By default it is NULL. Parameters encoding:String charset encoding to default to.

setDefaultEncoding

back to summary

public static void setDefaultEncoding(final String encoding)

Sets the default encoding to use if none is set in HTTP content-type, XML prolog and the rules based on content-type are not adequate.

If it is set to NULL the content-type based rules are used.

By default it is NULL.

Parameters

encoding:String: charset encoding to default to.

setRequestHeader	back to summary
private void setRequestHeader(final URLConnection conn, final Map<String, String> requestHeaders)

public Class XmlReader

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail