net.sf.jasperreports.engine.query
Class JRXPathQueryExecuterFactory

java.lang.Object
  net.sf.jasperreports.engine.query.JRXPathQueryExecuterFactory

All Implemented Interfaces:

JRQueryExecuterFactory

public class JRXPathQueryExecuterFactory
extends java.lang.Object
implements JRQueryExecuterFactory

XPath query executer factory.

The factory creates JRXPathQueryExecuter query executers.

Version:

$Id: JRXPathQueryExecuterFactory.java 3778 2010-05-03 16:17:18Z lucianc $

Author:

Lucian Chirita ([email protected])

Field Summary

static java.lang.String	PARAMETER_XML_DATA_DOCUMENT Built-in parameter holding the value of the org.w3c.dom.Document used to run the XPath query.
static java.lang.String	XML_DATE_PATTERN Parameter holding the format pattern used to instantiate java.util.Date instances.
static java.lang.String	XML_LOCALE Parameter holding the value of the datasource Locale
static java.lang.String	XML_NUMBER_PATTERN Parameter holding the format pattern used to instantiate java.lang.Number instances.
static java.lang.String	XML_TIME_ZONE Parameter holding the value of the datasource Timezone

Fields inherited from interface net.sf.jasperreports.engine.query.JRQueryExecuterFactory

QUERY_EXECUTER_FACTORY_PREFIX

Constructor Summary

JRXPathQueryExecuterFactory()

Method Summary

JRQueryExecuter	createQueryExecuter(JRDataset dataset, java.util.Map parameters) Creates a query executer.
java.lang.Object[]	getBuiltinParameters() Returns the built-in parameters associated with this query type.
boolean	supportsQueryParameterType(java.lang.String className) Decides whether the query executers created by this factory support a query parameter type.

Methods inherited from class java.lang.Object

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

Field Detail

PARAMETER_XML_DATA_DOCUMENT

public static final java.lang.String PARAMETER_XML_DATA_DOCUMENT

Built-in parameter holding the value of the org.w3c.dom.Document used to run the XPath query.

See Also:

Constant Field Values

XML_DATE_PATTERN

public static final java.lang.String XML_DATE_PATTERN

Parameter holding the format pattern used to instantiate java.util.Date instances.

See Also:

Constant Field Values

XML_NUMBER_PATTERN

public static final java.lang.String XML_NUMBER_PATTERN

Parameter holding the format pattern used to instantiate java.lang.Number instances.

See Also:

Constant Field Values

XML_LOCALE

public static final java.lang.String XML_LOCALE

Parameter holding the value of the datasource Locale

See Also:

Constant Field Values

XML_TIME_ZONE

public static final java.lang.String XML_TIME_ZONE

Parameter holding the value of the datasource Timezone

See Also:

Constant Field Values

Constructor Detail

JRXPathQueryExecuterFactory

public JRXPathQueryExecuterFactory()

Method Detail

getBuiltinParameters

public java.lang.Object[] getBuiltinParameters()

Description copied from interface: JRQueryExecuterFactory

Returns the built-in parameters associated with this query type.

These parameters will be created as system-defined parameters for each report/dataset having a query of this type.

The returned array should contain consecutive pairs of parameter names and parameter classes (e.g. {"Param1", String.class, "Param2", "List.class"}).

Specified by:

getBuiltinParameters in interface JRQueryExecuterFactory

Returns:

array of built-in parameter names and types associated with this query type

createQueryExecuter

public JRQueryExecuter createQueryExecuter(JRDataset dataset,
                                           java.util.Map parameters)
                                    throws JRException

Description copied from interface: JRQueryExecuterFactory

Creates a query executer.

This method is called at fill time for reports/datasets having a query supported by this factory.

Specified by:

createQueryExecuter in interface JRQueryExecuterFactory

Parameters:

dataset - the dataset containing the query, fields, etc

parameters - map of value parameters (instances of JRValueParameter) indexed by name

Returns:

a query executer

Throws:

JRException

supportsQueryParameterType

public boolean supportsQueryParameterType(java.lang.String className)

Description copied from interface: JRQueryExecuterFactory

Decides whether the query executers created by this factory support a query parameter type.

This check is performed for all $P{..} parameters in the query.

Specified by:

supportsQueryParameterType in interface JRQueryExecuterFactory

Parameters:

className - the value class name of the parameter

Returns:

whether the parameter value type is supported