Package net.sf.saxon.query
Class QueryReader
java.lang.Object
net.sf.saxon.query.QueryReader
This class contains static methods used to read a query as a byte stream, infer the encoding if
necessary, and return the text of the query as a string; also methods to import functions and variables
from one module into another, and check their consistency.
-
Method Summary
Modifier and TypeMethodDescriptionstatic String
Read an input stream non-destructively to determine the encoding from the Query Prologstatic String
readInputStream
(InputStream is, String encoding, IntPredicateProxy nameChecker) Read a query from an InputStream.static String
readSourceQuery
(Configuration config, StreamSource ss, IntPredicateProxy charChecker) Read a query module given a StreamSource
-
Method Details
-
readSourceQuery
public static String readSourceQuery(Configuration config, StreamSource ss, IntPredicateProxy charChecker) throws XPathException Read a query module given a StreamSource- Parameters:
ss
- the supplied StreamSource. This must contain a non-null systemID which defines the base URI of the query module, and either an InputStream or a Reader containing the query text. In the case of an InputStream the method attempts to infer the encoding; in the case of a Reader, this has already been done, and the encoding specified within the query itself is ignored.The method reads from the InputStream or Reader contained in the StreamSource up to the end of file unless a fatal error occurs. It does not close the InputStream or Reader; this is the caller's responsibility.
charChecker
- this checks XML characters against either the XML 1.0 or XML 1.1 rules- Returns:
- the text of the query
- Throws:
XPathException
- if the input cannot be read
-
readEncoding
Read an input stream non-destructively to determine the encoding from the Query Prolog- Parameters:
is
- the input stream: this must satisfy the precondition is.markSupported() = true.- Returns:
- the encoding to be used: defaults to UTF-8 if no encoding was specified explicitly in the query prolog
- Throws:
XPathException
- if the input stream cannot be read
-
readInputStream
public static String readInputStream(InputStream is, String encoding, IntPredicateProxy nameChecker) throws XPathException Read a query from an InputStream. The method checks that all characters are valid XML characters, and also performs normalization of line endings.- Parameters:
is
- the input streamencoding
- the encoding, or null if the encoding is unknownnameChecker
- the predicate to be used for checking characters- Returns:
- the content of the InputStream as a string
- Throws:
XPathException
- if the stream cannot be read, for example if there is a problem with the encoding
-