Home » tapestry-src-5.0.19 » org.apache.tapestry5.hibernate » [javadoc | source]

    1   // Copyright 2007, 2008 The Apache Software Foundation
    2   //
    3   // Licensed under the Apache License, Version 2.0 (the "License");
    4   // you may not use this file except in compliance with the License.
    5   // You may obtain a copy of the License at
    6   //
    7   //     http://www.apache.org/licenses/LICENSE-2.0
    8   //
    9   // Unless required by applicable law or agreed to in writing, software
   10   // distributed under the License is distributed on an "AS IS" BASIS,
   11   // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   12   // See the License for the specific language governing permissions and
   13   // limitations under the License.
   14   
   15   package org.apache.tapestry5.hibernate;
   16   
   17   import org.apache.tapestry5.ioc.annotations.UsesOrderedConfiguration;
   18   import org.hibernate.Session;
   19   import org.hibernate.SessionFactory;
   20   import org.hibernate.cfg.Configuration;
   21   
   22   /**
   23    * Responsible for creating a Hibernate session as needed. Internally, is responsible for Hibernate {@link
   24    * Configuration}, resulting in a {@link SessionFactory}.
   25    * <p/>
   26    * The service's configuration is a {@linkplain org.apache.tapestry5.ioc.services.ChainBuilder chain of command} of
   27    * configurator objects.
   28    */
   29   @UsesOrderedConfiguration(HibernateConfigurer.class)
   30   public interface HibernateSessionSource
   31   {
   32       /**
   33        * Creates a new session using the {@link #getSessionFactory() SessionFactory} created at service startup.
   34        */
   35       Session create();
   36   
   37       /**
   38        * Returns the SessionFactory from which Hibernate sessions are created.
   39        */
   40       SessionFactory getSessionFactory();
   41   
   42       /**
   43        * Returns the final configuration used to create the {@link SessionFactory}. The configuration is immutable.
   44        */
   45       Configuration getConfiguration();
   46   }

Home » tapestry-src-5.0.19 » org.apache.tapestry5.hibernate » [javadoc | source]