org.hibernate.UnknownEntityTypeException: Unable to locate persister: entity.Settings

Question

I am trying to use Hibernate 5 (5.2.11) together with Spring ORM.

Following tutorials I came up with following configuration:

Spring Bean

<bean id="sessionFactorySettings" class="org.springframework.orm.hibernate5.LocalSessionFactoryBean">
    <property name="hibernateProperties">
        <props>
            <prop key="hibernate.dialect">org.hibernate.dialect.H2Dialect</prop>
            <prop key="hibernate.connection.driver_class">org.h2.Driver</prop>
            <prop key="hibernate.connection.url">jdbc:h2:~/.dummy/settings</prop>
            <prop key="hibernate.show_sql">true</prop>
            <prop key="hibernate.hbm2ddl.auto">update</prop>
        </props>
    </property>
    <property name="mappingResources">
        <list>
            <value>/hibernate.cfg.xml</value>
        </list>
    </property>
</bean>

Hibernate (hibernate.cfg.xml)

<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD//EN"
        "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
    <session-factory>
        <mapping class="entity.Settings"/>
    </session-factory>
</hibernate-configuration>

This configuration leads to a org.hibernate.UnknownEntityTypeException: Unable to locate persister: entity.Settings.

However, as soon as I move all

<prop key="hibernate.xxx">..</prob>

properties into hibernate.cfg.xml and I change the Spring configuration to

<bean id="sessionFactorySettings" class="org.springframework.orm.hibernate5.LocalSessionFactoryBean">
        <property name="configLocation" value="/hibernate.cfg.xml"/>
</bean>

everything works fine.

Any idea what I do wrong?

PS: Dependencies:

dependencies {
    compile 'ch.qos.logback:logback-classic:1.2.3'
    compile 'org.springframework:spring-context:4.3.11.RELEASE'
    compile 'org.springframework:spring-jdbc:4.3.11.RELEASE'
    compile 'org.springframework:spring-orm:4.3.11.RELEASE'
    compile 'org.hibernate:hibernate-core:5.2.11.Final'
    compile 'org.hibernate:hibernate-java8:5.2.11.Final'
    compile 'org.apache.commons:commons-dbcp2:2.1.1'
    compile 'com.h2database:h2:1.4.196'
}

Answer 1

According to Spring docs, the LocalSessionFactoryBean#setMappingResources method should be used for providing HBM mapping files, not the Hibernate configuration file (e.g. hibernate.cfg.xml).

That's why it does not work. However, as soon as you use configLocation property, it works because that's the intended method for providing the Hibernate-specific configuration file.

Now, since you probably use annotations, you don't need to use setMappingResources at all. That's only needed if you want to use the XML_based HBM files to provide the Hibernate mappings.

What you need is LocalSessionFactoryBean#setAnnotatedClasses instead. Or setPackagesToScan which allows you to give just the entities folder and all entity classes inside will be registered.

Answer 2

I usually use this kind of configuration when I use hibernate and Spring:

<bean id="hibernateSessionFactory"  class="org.springframework.orm.hibernate5.LocalSessionFactoryBean">
    <property name="dataSource" ref="hibernateDatasource" />
    <!-- HERE YOU HAVE TO PUT THE PACKAGE 
         WHERE YOUR ENTITY CLASS ARE LOCATED 
         (I mean classes annotated with @Entity annotation -->
    <property name="packagesToScan" value="hibernate.models" />
    <property name="hibernateProperties">
        <props>
            <prop key="hibernate.dialect">
                ${hibernate.props.db.dialect}
            </prop>
            <prop key="hibernate.show_sql">
                ${hibernate.props.db.show.sql}
            </prop>
            <prop key="hibernate.generate_statistics">
                ${hibernate.props.db.generate.statistics}
            </prop>
            <prop key="hibernate.format_sql">
                ${hibernate.props.db.format.sql}
            </prop>
            <prop key="hibernate.hbm2ddl.auto">
                ${hibernate.props.db.ddl.instr}
            </prop>
            <prop key="hibernate.cache.use_second_level_cache">${hibernate.props.db.use.cache}</prop>
            <prop key="hibernate.cache.use_query_cache">${hibernate.props.db.use.query.cache}</prop>
            <prop key="hibernate.cache.region.factory_class">org.hibernate.cache.ehcache.SingletonEhCacheRegionFactory
            </prop>
            <prop key="net.sf.ehcache.configurationResourceName">hibernateEhCacheCfg.xml</prop>
            <prop key="hibernate.jdbc.batch_size">${hibernate.props.db.jdbc.batch.size}</prop>
            <prop key="hibernate.jdbc.use_streams_for_binary">true</prop>
        </props>
    </property>
</bean>

All my properties are, then, loaded by using a property file

I hope it's useful

Angelo