001    /*
002     * Databinder: a simple bridge from Wicket to Hibernate
003     * Copyright (C) 2006  Nathan Hamblen nathan@technically.us
004    
005     * This library is free software; you can redistribute it and/or
006     * modify it under the terms of the GNU Lesser General Public
007     * License as published by the Free Software Foundation; either
008     * version 2.1 of the License, or (at your option) any later version.
009     * 
010     * This library is distributed in the hope that it will be useful,
011     * but WITHOUT ANY WARRANTY; without even the implied warranty of
012     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
013     * Lesser General Public License for more details.
014     * 
015     * You should have received a copy of the GNU Lesser General Public
016     * License along with this library; if not, write to the Free Software
017     * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
018     */
019    
020    package net.databinder.models.hib;
021    
022    import java.io.Serializable;
023    
024    import org.hibernate.Query;
025    import org.hibernate.Session;
026    
027    /**
028     * Interface for callback that builds a Hibernate Query and binds it to parameters if necessary.
029     * Use for SQL queries, named queries, etc.
030     * @author Nathan Hamblen
031     */
032    public interface QueryBuilder extends Serializable {
033            /**
034             * Create query from session and bind it to parameters.
035             * @param hibernateSession session for the current request cycle
036             * @return ready-to-use query
037             */
038            Query build(Session hibernateSession);
039    }