无Spring的Java项目配置persistence.xml对接Heroku的ClearDB数据库

嗨Sandra，我之前帮朋友处理过一模一样的问题——非Spring的Java Web项目要在Heroku上用ClearDB，照搬Spring的配置肯定不行，因为Spring有自动解析环境变量的魔法，但咱们得手动搞定。下面是一步步能跑通的配置方案：

Heroku给ClearDB生成的连接字符串存在环境变量CLEARDB_DATABASE_URL里，格式是：

mysql://<用户名>:<密码>@<数据库主机>/<数据库名>?reconnect=true

但JPA的persistence.xml需要单独的JDBC URL、用户名、密码，所以第一步得把这个字符串拆成咱们需要的参数。

方法一：用ServletContextListener解析环境变量（推荐） #

咱们写一个监听器，在项目启动时自动解析CLEARDB_DATABASE_URL，把它转成JPA能识别的系统属性，这样persistence.xml就能直接引用了。

第一步：编写监听器类 #

创建一个ClearDBConfigListener类，实现ServletContextListener，并添加@WebListener注解让容器自动加载：

import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;
import java.net.URI;
import java.net.URISyntaxException;

@WebListener
public class ClearDBConfigListener implements ServletContextListener {

    @Override
    public void contextInitialized(ServletContextEvent sce) {
        // 从Heroku环境变量获取ClearDB连接字符串
        String dbUrl = System.getenv("CLEARDB_DATABASE_URL");
        
        if (dbUrl != null) {
            try {
                // 把mysql://替换成jdbc:mysql://，符合JDBC格式
                URI uri = new URI(dbUrl.replace("mysql://", "jdbc:mysql://"));
                // 拆分用户名和密码
                String[] userPass = uri.getUserInfo().split(":");
                String username = userPass[0];
                String password = userPass[1];
                // 拼接完整的JDBC URL
                String jdbcUrl = uri.toString();

                // 设置成系统属性，供persistence.xml引用
                System.setProperty("cleardb.jdbc.url", jdbcUrl);
                System.setProperty("cleardb.username", username);
                System.setProperty("cleardb.password", password);
            } catch (URISyntaxException e) {
                e.printStackTrace();
            }
        } else {
            // 本地开发时的默认配置（可以改成你本地的数据库信息）
            System.setProperty("cleardb.jdbc.url", "jdbc:mysql://localhost:3306/your_local_db");
            System.setProperty("cleardb.username", "root");
            System.setProperty("cleardb.password", "your_local_password");
        }
    }

    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        // 无需额外清理，空实现即可
    }
}

第二步：配置persistence.xml #

在META-INF/persistence.xml里，直接引用刚才设置的系统属性：

<?xml version="1.0" encoding="UTF-8"?>
<persistence xmlns="http://xmlns.jcp.org/xml/ns/persistence"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_2.xsd"
             version="2.2">

    <persistence-unit name="YourPersistenceUnitName" transaction-type="RESOURCE_LOCAL">
        <!-- 替换成你的实体类全路径，多个的话加多个<class>标签 -->
        <class>com.yourpackage.YourEntity</class>
        
        <properties>
            <!-- MySQL JDBC驱动 -->
            <property name="javax.persistence.jdbc.driver" value="com.mysql.cj.jdbc.Driver"/>
            <!-- 引用系统属性里的JDBC URL、用户名、密码 -->
            <property name="javax.persistence.jdbc.url" value="${cleardb.jdbc.url}"/>
            <property name="javax.persistence.jdbc.user" value="${cleardb.username}"/>
            <property name="javax.persistence.jdbc.password" value="${cleardb.password}"/>
            
            <!-- Hibernate配置（如果用Hibernate作为JPA实现） -->
            <property name="hibernate.dialect" value="org.hibernate.dialect.MySQL8Dialect"/>
            <property name="hibernate.show_sql" value="false"/>
            <property name="hibernate.hbm2ddl.auto" value="update"/>
        </properties>
    </persistence-unit>
</persistence>

方法二：用数据源配置（适合Java EE容器） #

如果你的项目部署在支持JNDI的容器（比如Tomcat），可以用数据源的方式配置：

第一步：创建WEB-INF/context.xml #

<Context>
    <Resource name="jdbc/ClearDB"
              auth="Container"
              type="javax.sql.DataSource"
              maxTotal="100"
              maxIdle="30"
              maxWaitMillis="10000"
              driverClassName="com.mysql.cj.jdbc.Driver"
              <!-- 引用监听器设置的系统属性 -->
              url="${cleardb.jdbc.url}"
              username="${cleardb.username}"
              password="${cleardb.password}"/>
</Context>

第二步：修改persistence.xml引用数据源 #

<persistence-unit name="YourPersistenceUnitName" transaction-type="RESOURCE_LOCAL">
    <non-jta-data-source>java:comp/env/jdbc/ClearDB</non-jta-data-source>
    <class>com.yourpackage.YourEntity</class>
    
    <properties>
        <property name="hibernate.dialect" value="org.hibernate.dialect.MySQL8Dialect"/>
        <property name="hibernate.show_sql" value="false"/>
        <property name="hibernate.hbm2ddl.auto" value="update"/>
    </properties>
</persistence-unit>

确保你的项目里有MySQL的JDBC驱动，如果是Maven项目，在pom.xml里添加：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version>
    <scope>runtime</scope>
</dependency>

• 确保已经给Heroku应用添加了ClearDB插件：
  打开终端执行：heroku addons:create cleardb:ignite（如果还没加的话）
• 部署项目到Heroku后，可以用heroku config命令查看CLEARDB_DATABASE_URL是否存在，确认环境变量正常。

这样配置后，你的非Spring Java Web项目就能在Heroku上成功连接ClearDB了，我之前用这个方案帮朋友搞定过，亲测有效！

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