de.tsl2.nano.service.util.IQueryService Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of tsl2.nano.serviceaccess Show documentation

TSL2 JEE Service Access (Generic Services for Entity Access, JEE File-System-Connector, Generic Featuring, Job-Scheduling, BeanContainer, Batch, Comfortable Bean Query Definitions, JAAS, Authentification, Authorization, )

The newest version!

/*
 * File: $HeadURL$
 * Id  : $Id$
 * 
 * created by: Thomas Schneider, Thomas Schneider
 * created on: Sep 19, 2012
 * 
 * Copyright: (c) Thomas Schneider 2012, all rights reserved
 */
package de.tsl2.nano.service.util;

import de.tsl2.nano.service.util.finder.AbstractFinder;

/**
 * Provides finder expression - instead of sql or ejb-ql. Additional ejb-ql-queries are possible. Finder expressions
 * will automatically create ejb-ql expressions through given transient bean instances.
 * 
 * Combines multiple findBy-Expressions to create a complex query. Similar to criterias but working on intelligent
 * finders. At the moment, all concatenations are added with AND.
 * 
 * @author Thomas Schneider, Thomas Schneider
 * @version $Revision$
 */
public interface IQueryService {
    /**
     * combines several find-expressions, like findByExample and findBetween etc., to create complex queries through
     * bean-attribute informations.
     * 

     * example:
     * 
     * 
     * result = ServiceFactory.getGenService().find(between(wvFrom, wvTo),
     *     expression(Wiedervorlage.class, qStbereich, false, argsPflName),
     *     expression(Wiedervorlage.class, qPflName, false, argsStbereich));
     * 
     * 
     * @param  type to return
     * @param finder several finders to constrain the result
     * @return query result as list of beans
     */
    , T> java.util.Collection find(FINDER... finder);
}