Package net.sf.jasperreports.j2ee.ejbql

Class 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:
    JRJpaQueryExecuterFactory

    • Field Detail

      • 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:
        Constant Field Values

      • PROPERTY_JPA_QUERY_HINT_PREFIX

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

    • Method Detail

      • 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()

      • 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