public final class QueryResultParsers extends Object
Utilities for working with query results
Modifier and Type | Method and Description |
---|---|
static Optional<BooleanQueryResultParser> |
forBooleanFormat(QueryResultFormat theFormat) |
static Optional<QueryResultParser> |
forFormat(QueryResultFormat theFormat)
Return the
parser associated with the given format. |
static Optional<SelectQueryResultParser> |
forSelectFormat(QueryResultFormat theFormat) |
static <T> QueryResult<T> |
read(InputStream theStream,
QueryResultFormat theFormat,
Options theOptions,
QueryResultBuilder<T> theHandler)
Parse the
query results in the specified file |
static <T> QueryResult<T> |
read(InputStream theStream,
QueryResultParser theParser,
Options theOptions,
QueryResultBuilder<T> theHandler)
Parse the
query results in the specified file |
static <T> QueryResult<T> |
read(Path thePath,
QueryResultFormat theFormat,
Options theOptions,
QueryResultBuilder<T> theHandler)
Parse the
query results in the specified file |
static <T> QueryResult<T> |
read(Path thePath,
QueryResultParser theParser,
Options theOptions,
QueryResultBuilder<T> theHandler)
Parse the
query results in the specified file |
static boolean |
readBoolean(InputStream theStream,
QueryResultFormat theFormat)
Parse the
query results in the specified stream |
static SelectQueryResult |
readSelect(InputStream theStream,
QueryResultFormat theFormat)
Parse the
query results in the specified stream |
static SelectQueryResult |
readSelect(Path thePath)
Return the
query results serialized in the given file |
@Nonnull public static Optional<QueryResultParser> forFormat(@Nonnull QueryResultFormat theFormat)
parser
associated with the given format.theFormat
- the format you wish to parseQueryResultFormats.XML
support both select and boolean result types, you could end up with the wrong parser
given your use case. If you need a specific parser type, use the appropriate method.@Nonnull public static Optional<SelectQueryResultParser> forSelectFormat(@Nonnull QueryResultFormat theFormat)
@Nonnull public static Optional<BooleanQueryResultParser> forBooleanFormat(@Nonnull QueryResultFormat theFormat)
@Nonnull public static SelectQueryResult readSelect(@Nonnull Path thePath) throws IOException
query results
serialized in the given filethePath
- the file to readIllegalArgumentException
- If the format of the file is unknown, or there is no parser that supports files of that typeInvalidQueryResults
- If the query results encoded in the file are not validIOException
- If there was an error opening or reading from the file@Nonnull public static SelectQueryResult readSelect(@Nonnull InputStream theStream, @Nonnull QueryResultFormat theFormat) throws IOException
query results
in the specified streamtheStream
- the streams whose contents should be parsedtheFormat
- the format of the fileIOException
- if there is an error opening or reading from the fileInvalidQueryResults
- if the results were invalid wrt to the format
IllegalArgumentException
- if there is no known parser for the `QueryResultFormat`public static boolean readBoolean(@Nonnull InputStream theStream, @Nonnull QueryResultFormat theFormat) throws IOException
query results
in the specified streamtheStream
- the streams whose contents should be parsedtheFormat
- the format of the fileIOException
- if there is an error opening or reading from the fileInvalidQueryResults
- if the results were invalid wrt to the format
IllegalArgumentException
- if there is no known parser for the `QueryResultFormat`@Nonnull public static <T> QueryResult<T> read(@Nonnull Path thePath, @Nonnull QueryResultFormat theFormat, @Nonnull Options theOptions, @Nonnull QueryResultBuilder<T> theHandler) throws IOException
query results
in the specified filethePath
- the file whose contents should be parsetheFormat
- the format of the filetheOptions
- the parser optionstheHandler
- the handler of the parsed resultsIOException
- if there is an error opening or reading from the fileInvalidQueryResults
- if the results were invalid wrt to the format
IllegalArgumentException
- if there is no known parser for the `QueryResultFormat`@Nonnull public static <T> QueryResult<T> read(@Nonnull InputStream theStream, @Nonnull QueryResultFormat theFormat, @Nonnull Options theOptions, @Nonnull QueryResultBuilder<T> theHandler) throws IOException
query results
in the specified filetheStream
- the streams whose contents should be parsedtheFormat
- the format of the filetheOptions
- the parser optionstheHandler
- the handler of the parsed resultsIOException
- if there is an error opening or reading from the fileInvalidQueryResults
- if the results were invalid wrt to the format
IllegalArgumentException
- if there is no known parser for the `QueryResultFormat`@Nonnull public static <T> QueryResult<T> read(@Nonnull Path thePath, @Nonnull QueryResultParser theParser, @Nonnull Options theOptions, @Nonnull QueryResultBuilder<T> theHandler) throws IOException
query results
in the specified filethePath
- the file whose contents should be parsedtheParser
- the parser to usetheOptions
- the parser optionstheHandler
- the handler of the parsed resultsIOException
- if there is an error opening or reading from the fileInvalidQueryResults
- if the results were invalid wrt to the format
IllegalArgumentException
- if there is no known parser for the `QueryResultFormat`@Nonnull public static <T> QueryResult<T> read(@Nonnull InputStream theStream, @Nonnull QueryResultParser theParser, @Nonnull Options theOptions, @Nonnull QueryResultBuilder<T> theHandler) throws IOException
query results
in the specified filetheStream
- the streams whose contents should be parsedtheParser
- the parser to usetheOptions
- the parser optionstheHandler
- the handler of the parsed resultsIOException
- if there is an error opening or reading from the fileInvalidQueryResults
- if the results were invalid wrt to the format
IllegalArgumentException
- if there is no known parser for the `QueryResultFormat`Copyright © 2010-2016 Stardog Union. All Rights Reserved.