Package net.sf.jasperreports.j2ee.ejbql

Class JRJpaQueryExecuter

java.lang.Object
net.sf.jasperreports.engine.query.JRAbstractQueryExecuter
net.sf.jasperreports.j2ee.ejbql.JRJpaQueryExecuter
All Implemented Interfaces:
JRQueryExecuter
public class JRJpaQueryExecuter extends JRAbstractQueryExecuter
EJBQL query executer that uses the Java Persistence API.

To use EJBQL in queries, an javax.persistence.EntityManager is needed. When running or filling reports the em need to be supplied with the named parameter EjbqlConstants.PARAMETER_JPA_ENTITY_MANAGER.

Example: 

 Map parameters = new HashMap();
 EntityManager em = emf.createEntityManager();
 parameters.put(EjbqlConstants.PARAMETER_JPA_ENTITY_MANAGER, em);
 JasperRunManager.runReportToPdfFile(fileName, parameters);

When dealing with large result sets, pagination can be used by setting the PROPERTY_JPA_QUERY_PAGE_SIZE property in the report template.

Example: 

 <property name="net.sf.jasperreports.ejbql.query.page.size" value="100"/>

Implementation-specific query hints can be set either using report properties in the report template, or by supplying the named parameter EjbqlConstants.PARAMETER_JPA_QUERY_HINTS_MAP containing a java.util.Map with named/value query hints.

Example using report property: 

 <property name="net.sf.jasperreports.ejbql.query.hint.fetchSize" value="100"/>
The name of the query hint need to be prefixed with net.sf.jasperreports.ejbql.query.hint.. Above example will set a query hint with the name fetchSize and the String value 100.

Example using map: 

 Map hints = new HashMap();
 hints.put("fetchSize", 100);
 hints.put("anyName", anyObject());
 Map parameters = new HashMap();
 EntityManager em = emf.createEntityManager();
 parameters.put(EjbqlConstants.PARAMETER_JPA_ENTITY_MANAGER, em);
 parameters.put(EjbqlConstants.PARAMETER_JPA_QUERY_HINTS_MAP, hints);
 JasperRunManager.runReportToPdfFile(fileName, parameters);
Note that when using report properties only String values can be set as query hint. When using a query hints map, any Object can be set as value.
Author:
Marcel Overdijk (marceloverdijk@hotmail.com)
See Also:

  • Field Details

    • CANONICAL_LANGUAGE

      public static final String CANONICAL_LANGUAGE
      See Also:

    • PROPERTY_JPA_QUERY_PAGE_SIZE

      public static final String PROPERTY_JPA_QUERY_PAGE_SIZE
      Property specifying the number of result rows to be retrieved at once.

      Result pagination is implemented by javax.persistence.Query.setFirstResult() and javax.persistence.Query.setMaxResults().

      By default, all the rows are retrieved (no result pagination is performed).

      See Also:

    • PROPERTY_JPA_QUERY_HINT_PREFIX

      public static final String PROPERTY_JPA_QUERY_HINT_PREFIX
      Property specifying the prefix for EJBQL query hints.
      See Also:

  • Constructor Details

  • Method Details

    • getCanonicalQueryLanguage

      protected String getCanonicalQueryLanguage()
      Overrides:
      getCanonicalQueryLanguage in class JRAbstractQueryExecuter

    • createDatasource

      public JRDataSource createDatasource() throws JRException
      Throws:
      JRException

    • createQuery

      protected void createQuery(String queryString)
      Creates the EJBQL query object.
      Parameters:
      queryString - the query string

    • createResultDatasource

      protected JRDataSource createResultDatasource()
      Creates a data source out of the query result.
      Returns:
      the data source

    • close

      public void close()

    • cancelQuery

      public boolean cancelQuery() throws JRException
      Throws:
      JRException

    • getParameterReplacement

      protected String getParameterReplacement(String parameterName)
      Specified by:
      getParameterReplacement in class JRAbstractQueryExecuter

    • getEjbqlParameterName

      protected String getEjbqlParameterName(String parameterName)

    • getResultList

      public List<?> getResultList()
      Runs the query by calling javax.persistence.Query.getResultList.

      All the result rows are returned.

      Returns:
      the result of the query as a list

    • getResultList

      public List<?> getResultList(int firstIndex, int resultCount)
      Returns a page of the query results by calling javax.persistence.Query.getResultList.
      Parameters:
      firstIndex - the index of the first row to return
      resultCount - the number of rows to return
      Returns:
      result row list