Package org.hibernate

Interface SessionFactory

  • All Superinterfaces:
    AutoCloseable, Closeable, EntityManagerFactory, Referenceable, Serializable
    All Known Subinterfaces:
    SessionFactoryImplementor
    All Known Implementing Classes:
    SessionFactoryDelegatingImpl
    public interface SessionFactory
extends EntityManagerFactory, Referenceable, Serializable, Closeable
    A SessionFactory represents an "instance" of Hibernate: it maintains the runtime metamodel representing persistent entities, their attributes, their associations, and their mappings to relational database tables, along with configuration that affects the runtime behavior of Hibernate, and instances of services that Hibernate needs to perform its duties.

    Crucially, this is where a program comes to obtain sessions. Typically, a program has a single SessionFactory instance, and must obtain a new Session instance from the factory each time it services a client request.

    Depending on how Hibernate is configured, the SessionFactory itself might be responsible for the lifecycle of pooled JDBC connections and transactions, or it may simply act as a client for a connection pool or transaction manager provided by a container environment.

    The internal state of a SessionFactory is considered in some sense "immutable". While it interacts with stateful services like JDBC connection pools, such state changes are never visible to its clients. In particular, the runtime metamodel representing the entities and their O/R mappings is fixed as soon as the SessionFactory is created. Of course, any SessionFactory is threadsafe.

    Every SessionFactory is a JPA EntityManagerFactory. Furthermore, when Hibernate is acting as the JPA persistence provider, the method EntityManagerFactory.unwrap(Class) may be used to obtain the underlying SessionFactory.

    See Also:
    Session, Configuration

    • Method Detail

      • getSessionFactoryOptions

        SessionFactoryOptions getSessionFactoryOptions()
        Get the special options used to build the factory.
        Returns:
        The special options used to build the factory.

      • getCurrentSession

        Session getCurrentSession()
                   throws HibernateException
        Obtains the current session, an instance of Session implicitly associated with some context. For example, the session might be associated with the current thread, or with the current JTA transaction.

        The context used for scoping the current session (that is, the definition of what precisely "current" means here) is determined by an implementation of CurrentSessionContext. An implementation may be selected using the configuration property "hibernate.current_session_context_class".

        If no CurrentSessionContext is explicitly configured, but JTA is configured, then JTASessionContext is used.

        Returns:
        The current session.
        Throws:
        HibernateException - Indicates an issue locating a suitable current session.

      • openStatelessSession

        StatelessSession openStatelessSession()
        Open a new stateless session.
        Returns:
        The created stateless session.

      • openStatelessSession

        StatelessSession openStatelessSession​(Connection connection)
        Open a new stateless session, utilizing the specified JDBC Connection.
        Parameters:
        connection - Connection provided by the application.
        Returns:
        The created stateless session.

      • inSession

        default void inSession​(Consumer<Session> action)
        Open a Session and perform a action using it

      • inTransaction

        default void inTransaction​(Consumer<Session> action)
        Open a Session and perform an action using the session within the bounds of a transaction.

      • fromSession

        default <R> R fromSession​(Function<Session,​R> action)
        Open a Session and perform an action using it.

      • fromTransaction

        default <R> R fromTransaction​(Function<Session,​R> action)
        Open a Session and perform an action using the session within the bounds of a transaction.

      • getStatistics

        Statistics getStatistics()
        Retrieve the statistics for this factory.
        Returns:
        The statistics.

      • isClosed

        boolean isClosed()
        Is this factory already closed?
        Returns:
        True if this factory is already closed; false otherwise.

      • getCache

        Cache getCache()
        Obtain direct access to the underlying cache regions.
        Specified by:
        getCache in interface EntityManagerFactory
        Returns:
        The direct cache access API.

      • getDefinedFilterNames

        Set<String> getDefinedFilterNames()
        Obtain the set of names of all defined filters.
        Returns:
        The set of filter names.

      • getFilterDefinition

        FilterDefinition getFilterDefinition​(String filterName)
                              throws HibernateException
        Obtain the definition of a filter by name.
        Parameters:
        filterName - The name of the filter for which to obtain the definition.
        Returns:
        The filter definition.
        Throws:
        HibernateException - If no filter defined with the given name.

      • containsFetchProfileDefinition

        boolean containsFetchProfileDefinition​(String name)
        Determine if this session factory contains a fetch profile definition registered under the given name.
        Parameters:
        name - The name to check
        Returns:
        True if there is such a fetch profile; false otherwise.

      • getCollectionMetadata

        @Deprecated
CollectionMetadata getCollectionMetadata​(String roleName)
        Deprecated.
        Use the descriptors from EntityManagerFactory.getMetamodel() instead
        Get the CollectionMetadata associated with the named collection role.
        Parameters:
        roleName - The collection role (in form [owning-entity-name].[collection-property-name]).
        Returns:
        The metadata associated with the given collection; may be null if no such collection was mapped.
        Throws:
        HibernateException - Generally null is returned instead of throwing.