Eclipse RCP/RAP 2022-12集成MongoDB持久化框架的可行方案咨询

针对你的RCP/RAP环境，推荐两种最适配、易上手的持久化方案，避开Spring Boot JPA/Hibernate这类在OSGi中兼容性不佳的框架：

方案一：直接使用MongoDB Java Driver（OSGi适配版）—— 最简快速 #

原生MongoDB驱动的OSGi打包版本完全适配OSGi类加载模型，无需复杂配置，适合快速实现POJO与MongoDB文档的映射。

步骤： #

1. 添加OSGi兼容的驱动依赖

   • 在目标平台中加入mongodb-driver-sync、mongodb-driver-core、bson的OSGi bundles（选择4.x系列，与2022-12 RCP版本兼容）。
   • Tycho构建中，在pom.xml的<dependencies>里声明这些依赖，确保依赖来自支持OSGi的Maven artifacts（可从Maven Central筛选带有osgi标签的版本）。

2. 编写DAO层代码
   利用MongoDB的POJO编解码器直接映射User类，无需额外注解（如需自定义映射，可使用@BsonProperty）：

   import com.mongodb.client.MongoClient;
   import com.mongodb.client.MongoClients;
   import com.mongodb.client.MongoCollection;
   import org.bson.codecs.pojo.PojoCodecProvider;
   import org.bson.codecs.configuration.CodecRegistries;
   import org.bson.codecs.configuration.CodecRegistry;
   import static com.mongodb.client.model.Filters.eq;
   
   public class UserDao {
       private final MongoCollection<User> userCollection;
   
       public UserDao() {
           // 配置POJO编解码器，自动映射User类
           CodecRegistry pojoCodecRegistry = CodecRegistries.fromProviders(
               PojoCodecProvider.builder().automatic(true).build()
           );
           CodecRegistry codecRegistry = CodecRegistries.fromRegistries(
               MongoClients.getDefaultCodecRegistry(), pojoCodecRegistry
           );
   
           MongoClient client = MongoClients.create("mongodb://localhost:27017");
           userCollection = client.getDatabase("your_db")
               .getCollection("users", User.class)
               .withCodecRegistry(codecRegistry);
       }
   
       public void save(User user) {
           userCollection.insertOne(user);
       }
   
       public User findByUsername(String username) {
           return userCollection.find(eq("m_username", username)).first();
       }
       // 其他CRUD方法
   }
   

3. OSGi服务注册（可选）
   将UserDao注册为OSGi服务，方便在RCP各bundle中注入使用：

   // 在bundle的Activator.start方法中
   @Override
   public void start(BundleContext context) throws Exception {
       super.start(context);
       context.registerService(UserDao.class, new UserDao(), null);
   }
   

   后续可通过BundleContext.getService或Eclipse DI的@Inject获取服务实例。

方案二：使用EclipseLink NoSQL —— 规范的持久化框架 #

EclipseLink是Eclipse官方持久化框架，对OSGi/RCP原生支持，提供JPA风格的API，适合需要标准化持久化流程的场景。

步骤： #

1. 添加EclipseLink NoSQL依赖
   在目标平台中加入org.eclipse.persistence.core、org.eclipse.persistence.nosql、org.eclipse.persistence.moxy bundles（版本选择与2022-12 RCP匹配的2.7.x或3.x系列）。
   Tycho构建中，确保这些bundles被包含在构建路径和目标平台中。

2. 配置persistence.xml
   在bundle的META-INF目录下创建配置文件：

   <?xml version="1.0" encoding="UTF-8"?>
   <persistence version="2.2" xmlns="http://xmlns.jcp.org/xml/ns/persistence">
       <persistence-unit name="UserPU" transaction-type="RESOURCE_LOCAL">
           <provider>org.eclipse.persistence.nosql.adapters.mongo.MongoPersistenceProvider</provider>
           <class>com.yourpackage.User</class>
           <properties>
               <property name="eclipselink.nosql.connection-spec" 
                         value="org.eclipse.persistence.nosql.adapters.mongo.MongoConnectionSpec"/>
               <property name="eclipselink.nosql.property.mongo.host" value="localhost"/>
               <property name="eclipselink.nosql.property.mongo.port" value="27017"/>
               <property name="eclipselink.nosql.property.mongo.db" value="your_db"/>
           </properties>
       </persistence-unit>
   </persistence.xml>
   

3. 给User类添加注解
   用JPA+EclipseLink NoSQL注解标记实体：

   import javax.persistence.Entity;
   import javax.persistence.Id;
   import org.eclipse.persistence.nosql.annotations.NoSql;
   import org.eclipse.persistence.nosql.annotations.DataFormatType;
   
   @Entity
   @NoSql(dataType = "users", dataFormat = DataFormatType.MAPPED)
   public class User implements IMASUser {
       @Id
       private int m_id;
       // 字段默认按名称映射，如需自定义可使用@Column
       private String m_username;
       private String m_password;
       // ... 其他字段与方法
   }
   

4. 编写EntityManager操作代码
   在RCP中获取EntityManagerFactory并执行CRUD：

   import javax.persistence.EntityManager;
   import javax.persistence.EntityManagerFactory;
   import javax.persistence.Persistence;
   
   public class UserService {
       private final EntityManagerFactory emf;
   
       public UserService() {
           // OSGi环境中自动识别bundle内的persistence.xml
           emf = Persistence.createEntityManagerFactory("UserPU");
       }
   
       public void save(User user) {
           EntityManager em = emf.createEntityManager();
           em.getTransaction().begin();
           em.persist(user);
           em.getTransaction().commit();
           em.close();
       }
   
       public User findById(int id) {
           EntityManager em = emf.createEntityManager();
           User user = em.find(User.class, id);
           em.close();
           return user;
       }
       // 其他CRUD方法
   }
   

解决你遇到的OSGi类/服务找不到问题 #

• 依赖完整性：检查目标平台是否包含所有必要的bundles，确保你的bundle在MANIFEST.MF中正确声明Require-Bundle或Import-Package（比如com.mongodb.client、javax.persistence）。
• 类加载器隔离：OSGi中每个bundle有独立类加载器，确保持久化框架的bundles导出了所需的包，你的bundle导入了这些包（可通过Eclipse的Bundle Explorer工具检查）。
• Tycho构建配置：确保pom.xml中添加了正确的p2仓库（比如Eclipse官方p2仓库），依赖的bundles在目标平台中可用。

为什么不推荐Spring Boot JPA/Hibernate？
这类框架的OSGi支持不完善，需要大量自定义配置适配OSGi的服务模型和类加载机制，对于RCP新手来说调试成本极高，而EclipseLink和原生MongoDB Driver的OSGi版本完全贴合RCP生态，无需额外适配。

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