Package net.sf.jasperreports.engine.query

Class AbstractJsonQueryExecuter<T extends JRAbstractTextDataSource & JsonData>

java.lang.Object

net.sf.jasperreports.engine.query.JRAbstractQueryExecuter

net.sf.jasperreports.engine.query.AbstractJsonQueryExecuter<T>

All Implemented Interfaces:

JRQueryExecuter

Direct Known Subclasses:

JsonQLQueryExecuter, JsonQueryExecuter

public abstract class AbstractJsonQueryExecuter<T extends JRAbstractTextDataSource & JsonData>
extends JRAbstractQueryExecuter

Author:

Narcis Marcu (narcism@users.sourceforge.net)

Nested Class Summary

Nested classes/interfaces inherited from class net.sf.jasperreports.engine.query.JRAbstractQueryExecuter

JRAbstractQueryExecuter.QueryParameter, JRAbstractQueryExecuter.QueryParameterEntry, JRAbstractQueryExecuter.QueryParameterVisitor, JRAbstractQueryExecuter.ValuedQueryParameter, JRAbstractQueryExecuter.VisitExceptionWrapper

Field Summary

Fields inherited from class net.sf.jasperreports.engine.query.JRAbstractQueryExecuter

clauseFunctions, dataset, EXCEPTION_MESSAGE_KEY_NUMERIC_TYPE_REQUIRED, EXCEPTION_MESSAGE_KEY_PARAMETER_NOT_FOUND, EXCEPTION_MESSAGE_KEY_QUERY_CLAUSE_CIRCULARLY_NESTED_PARAMETER, EXCEPTION_MESSAGE_KEY_QUERY_CLAUSE_ID_FIRST_TOKEN_MISSING, EXCEPTION_MESSAGE_KEY_QUERY_CLAUSE_NOT_FOUND, EXCEPTION_MESSAGE_KEY_UNSUPPORTED_PARAMETER_TYPE, GET_COLLECTED

Constructor Summary

Constructors

Constructor	Description
AbstractJsonQueryExecuter(JasperReportsContext jasperReportsContext, JRDataset dataset, Map<String,? extends JRValueParameter> parametersMap)
AbstractJsonQueryExecuter(QueryExecutionContext context, JRDataset dataset, Map<String,? extends JRValueParameter> parametersMap)

Method Summary

Modifier and Type	Method	Description
boolean	cancelQuery()	Cancels the query if it's currently running.
void	close()	Closes resources kept open during the data source iteration.
JRDataSource	createDatasource()	Executes the query and creates a JRDataSource out of the result.
protected abstract T	getJsonDataInstance(InputStream jsonInputStream)
protected abstract T	getJsonDataInstance(String jsonSource)
protected abstract RewindableDataSourceProvider<T>	getJsonDataProviderInstance(String source, TextDataSourceAttributes textAttributes)
protected TextDataSourceAttributes	getTextAttributes()

Methods inherited from class net.sf.jasperreports.engine.query.JRAbstractQueryExecuter

addQueryMultiParameters, addQueryMultiParameters, addQueryParameter, addQueryParameter, appendClauseChunk, appendParameterChunk, appendParameterClauseChunk, appendQueryChunk, appendTextChunk, applyClause, checkParameter, findExtensionQueryFunction, getBooleanParameter, getBooleanParameter, getBooleanParameterOrProperty, getBooleanParameterOrProperty, getCanonicalQueryLanguage, getCollectedParameterNames, getCollectedParameters, getIntegerParameter, getIntegerParameter, getIntegerParameterOrProperty, getIntegerParameterOrProperty, getJasperReportsContext, getParameter, getParameterReplacement, getParameterValue, getParameterValue, getPropertiesUtil, getQueryExecutionContext, getQueryString, getRepositoryContext, getStringParameter, getStringParameterOrProperty, getValueParameter, getValueParameter, parameterHasValue, parseQuery, registerClauseFunction, resolveFunction, unregisterClauseFunction, visitQueryParameters

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractJsonQueryExecuter

public AbstractJsonQueryExecuter(JasperReportsContext jasperReportsContext,
                                 JRDataset dataset,
                                 Map<String,? extends JRValueParameter> parametersMap)

AbstractJsonQueryExecuter

public AbstractJsonQueryExecuter(QueryExecutionContext context,
                                 JRDataset dataset,
                                 Map<String,? extends JRValueParameter> parametersMap)

Method Detail

createDatasource

public JRDataSource createDatasource()
                              throws JRException

Description copied from interface: JRQueryExecuter

Executes the query and creates a JRDataSource out of the result.

Returns:

a JRDataSource wrapping the query execution result.

Throws:

JRException

getJsonDataInstance

protected abstract T getJsonDataInstance(InputStream jsonInputStream)
                                  throws JRException

Throws:

JRException

getJsonDataInstance

protected abstract T getJsonDataInstance(String jsonSource)
                                  throws JRException

Throws:

JRException

getJsonDataProviderInstance

protected abstract RewindableDataSourceProvider<T> getJsonDataProviderInstance(String source,
                                                                               TextDataSourceAttributes textAttributes)

getTextAttributes

protected TextDataSourceAttributes getTextAttributes()

close

public void close()

Description copied from interface: JRQueryExecuter

Closes resources kept open during the data source iteration.

This method is called after the report is filled or the dataset is iterated. If a resource is not needed after the data source has been created, it should be released at the end of createDatasource.

cancelQuery

public boolean cancelQuery()
                    throws JRException

Description copied from interface: JRQueryExecuter

Cancels the query if it's currently running.

This method will be called from a different thread if the client decides to cancel the filling process.

Returns:

true if and only if the query was running and it has been canceled

Throws:

JRException