Hibernate 5.2：如何以编程方式从其他Jar包加载映射？

从Hibernate 5.0升级到5.2，最大的变化之一就是废弃了旧的Configuration类，转而使用MetadataSources + StandardServiceRegistryBuilder的组合来构建SessionFactory，这正好契合你完全脱离XML配置的需求。针对你提到的从其他Jar包加载实体映射的问题，下面结合Spring环境给出具体的解决方案：

一、基于Spring的编程式配置方案 #

你的HibernateConfiguration是Spring的配置类，我们可以通过LocalSessionFactoryBean来适配Hibernate 5.2的新API，同时实现外部Jar实体的加载：

@Configuration
@EnableTransactionManagement
@PropertySource({ "classpath:core.properties" })
@ComponentScan({ "com.test.core.domain" })
public class HibernateConfiguration {

    private static final Logger logger = LoggerFactory.getLogger(HibernateConfiguration.class);

    @Autowired
    private Environment environment;

    @Autowired
    private DataSource dataSource;

    @Bean
    public LocalSessionFactoryBean sessionFactory() {
        LocalSessionFactoryBean sessionFactory = new LocalSessionFactoryBean();
        sessionFactory.setDataSource(dataSource);
        
        // 核心：加载实体类——支持本地项目和外部Jar包中的实体
        // 方式1：扫描指定包（推荐，自动识别包下所有@Entity注解类）
        sessionFactory.setPackagesToScan(
            "com.test.core.domain",       // 你的本地实体包
            "com.external.jar.entity"     // 外部Jar中的实体包，替换成实际路径
        );

        // 方式2：直接指定具体实体类（如果知道类名）
        // sessionFactory.setAnnotatedClasses(
        //     com.test.core.domain.LocalEntity.class,
        //     com.external.jar.entity.ExternalEntity.class
        // );

        // 设置Hibernate属性
        sessionFactory.setHibernateProperties(hibernateProperties());

        return sessionFactory;
    }

    @Bean
    public HibernateTransactionManager transactionManager(SessionFactory sessionFactory) {
        HibernateTransactionManager txManager = new HibernateTransactionManager();
        txManager.setSessionFactory(sessionFactory);
        return txManager;
    }

    private Properties hibernateProperties() {
        Properties properties = new Properties();
        properties.put("hibernate.dialect", environment.getRequiredProperty("hibernate.dialect"));
        properties.put("hibernate.show_sql", environment.getRequiredProperty("hibernate.show_sql"));
        properties.put("hibernate.format_sql", environment.getRequiredProperty("hibernate.format_sql"));
        properties.put("hibernate.hbm2ddl.auto", environment.getRequiredProperty("hibernate.hbm2ddl.auto"));
        // 其他Hibernate属性按需添加
        return properties;
    }
}

二、纯Hibernate编程式配置（不依赖Spring） #

如果你的场景不需要Spring，直接用Hibernate原生API构建SessionFactory，代码如下：

public class HibernateStandaloneConfig {

    public static SessionFactory buildSessionFactory() {
        // 1. 构建服务注册器
        StandardServiceRegistry registry = new StandardServiceRegistryBuilder()
            .applySettings(getHibernateProperties())
            .build();

        try {
            // 2. 配置元数据源，加载外部Jar实体
            MetadataSources sources = new MetadataSources(registry);
            // 扫描外部Jar的实体包
            sources.addPackage("com.external.jar.entity");
            // 或者添加单个实体类
            // sources.addAnnotatedClass(com.external.jar.entity.ExternalEntity.class);

            // 3. 构建元数据并生成SessionFactory
            Metadata metadata = sources.buildMetadata();
            return metadata.buildSessionFactory();
        } catch (Exception e) {
            // 注册器出现问题时销毁
            StandardServiceRegistryBuilder.destroy(registry);
            throw new RuntimeException("Failed to build SessionFactory", e);
        }
    }

    private static Properties getHibernateProperties() {
        Properties properties = new Properties();
        properties.put("hibernate.connection.driver_class", "com.mysql.cj.jdbc.Driver");
        properties.put("hibernate.connection.url", "jdbc:mysql://localhost:3306/test_db");
        properties.put("hibernate.connection.username", "root");
        properties.put("hibernate.connection.password", "password");
        properties.put("hibernate.dialect", "org.hibernate.dialect.MySQL8Dialect");
        properties.put("hibernate.show_sql", "true");
        return properties;
    }
}

三、关键注意事项 #

1. 确保外部Jar实体类带注解：所有需要加载的实体类必须标注@Entity、@Table等Hibernate注解，因为我们完全脱离XML，注解是唯一的映射方式。
2. 类路径检查：确认外部Jar已经正确引入到项目依赖中（Maven/Gradle依赖配置正确），确保实体类能被类加载器找到。
3. Hibernate 5.2API变化：旧的Configuration类已被标记为Deprecated，不要再使用configure()、addResource()等XML相关方法，全部切换到MetadataSources的API。
4. 包扫描范围：setPackagesToScan方法会递归扫描指定包下的所有类，包括Jar包中符合路径的类，是最便捷的方式；如果只需要加载特定类，用setAnnotatedClasses更精准。

内容的提问来源于stack exchange，提问作者Green Root