【ITOO项目中遇到的问题】——为 MT_HOTEL_SERVICE 添加持久化单元服务失败

一、背景介绍

 项目框架采用的是EJB3.0，使用的JBossEap6.2服务器进行部署。

二、遇到的问题

为MT_HOTEL_SERVICE 添加持久化单元服务失败。   

    

三、错误日志

        

08:56:58,701 ERROR [org.jboss.msc.service.fail] (MSC service thread 1-1) MSC000001: Failed to start service jboss.deployment.subunit."itoo-exam-invigilate-ear.ear"."itoo-exam-invigilate-web.war".FIRST_MODULE_USE: org.jboss.msc.service.StartException in service jboss.deployment.subunit."itoo-exam-invigilate-ear.ear"."itoo-exam-invigilate-web.war".FIRST_MODULE_USE: JBAS018733: 处理 FIRST_MODULE_USE 的 subdeployment "itoo-exam-invigilate-web.war" of deployment "itoo-exam-invigilate-ear.ear" 阶段失败at org.jboss.as.server.deployment.DeploymentUnitPhaseService.start(DeploymentUnitPhaseService.java:127) [jboss-as-server-7.3.0.Final-redhat-14.jar:7.3.0.Final-redhat-14]at org.jboss.msc.service.ServiceControllerImpl$StartTask.startService(ServiceControllerImpl.java:1811) [jboss-msc-1.0.4.GA-redhat-1.jar:1.0.4.GA-redhat-1]at org.jboss.msc.service.ServiceControllerImpl$StartTask.run(ServiceControllerImpl.java:1746) [jboss-msc-1.0.4.GA-redhat-1.jar:1.0.4.GA-redhat-1]at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142) [rt.jar:1.8.0_45]at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617) [rt.jar:1.8.0_45]at java.lang.Thread.run(Thread.java:745) [rt.jar:1.8.0_45]Caused by: org.jboss.as.server.deployment.DeploymentUnitProcessingException: JBAS011446: 为 MT_HOTEL_SERVICE 添加持久化单元服务失败at org.jboss.as.jpa.processor.PersistenceUnitServiceHandler.deployPersistenceUnit(PersistenceUnitServiceHandler.java:447)at org.jboss.as.jpa.processor.PersistenceUnitServiceHandler.addPuService(PersistenceUnitServiceHandler.java:275)at org.jboss.as.jpa.processor.PersistenceUnitServiceHandler.handleWarDeployment(PersistenceUnitServiceHandler.java:190)at org.jboss.as.jpa.processor.PersistenceUnitServiceHandler.deploy(PersistenceUnitServiceHandler.java:116)at org.jboss.as.jpa.processor.PersistenceBeginInstallProcessor.deploy(PersistenceBeginInstallProcessor.java:48)at org.jboss.as.server.deployment.DeploymentUnitPhaseService.start(DeploymentUnitPhaseService.java:120) [jboss-as-server-7.3.0.Final-redhat-14.jar:7.3.0.Final-redhat-14]... 5 moreCaused by: org.jboss.msc.service.DuplicateServiceException: Service jboss.persistenceunit."itoo-exam-invigilate-ear.ear/itoo-exam-invigilate-web.war#MT_HOTEL_SERVICE" is already registeredat org.jboss.msc.service.ServiceRegistrationImpl.setInstance(ServiceRegistrationImpl.java:154) [jboss-msc-1.0.4.GA-redhat-1.jar:1.0.4.GA-redhat-1]at org.jboss.msc.service.ServiceControllerImpl.startInstallation(ServiceControllerImpl.java:227) [jboss-msc-1.0.4.GA-redhat-1.jar:1.0.4.GA-redhat-1]at org.jboss.msc.service.ServiceContainerImpl.install(ServiceContainerImpl.java:561) [jboss-msc-1.0.4.GA-redhat-1.jar:1.0.4.GA-redhat-1]at org.jboss.msc.service.ServiceTargetImpl.install(ServiceTargetImpl.java:201) [jboss-msc-1.0.4.GA-redhat-1.jar:1.0.4.GA-redhat-1]at org.jboss.msc.service.ServiceControllerImpl$ChildServiceTarget.install(ServiceControllerImpl.java:2228) [jboss-msc-1.0.4.GA-redhat-1.jar:1.0.4.GA-redhat-1]at org.jboss.msc.service.ServiceTargetImpl.install(ServiceTargetImpl.java:201) [jboss-msc-1.0.4.GA-redhat-1.jar:1.0.4.GA-redhat-1]at org.jboss.msc.service.ServiceControllerImpl$ChildServiceTarget.install(ServiceControllerImpl.java:2228) [jboss-msc-1.0.4.GA-redhat-1.jar:1.0.4.GA-redhat-1]at org.jboss.msc.service.ServiceBuilderImpl.install(ServiceBuilderImpl.java:307) [jboss-msc-1.0.4.GA-redhat-1.jar:1.0.4.GA-redhat-1]at org.jboss.as.jpa.processor.PersistenceUnitServiceHandler.deployPersistenceUnit(PersistenceUnitServiceHandler.java:441)... 10 more

四、解决办法

(1)分析

关键词： 为 MT_HOTEL_SERVICE 添加持久化单元服务失败；#MT_HOTEL_SERVICE" is already registered。

(2)名词解释

      问：何为持久化单元？

      答：一个持久化单元（Persistence Unit）就是关于一组Entity类的命名配置。持久化单元是一个静态的概念。它具有唯一的名称，负责定义应用中的一组实体如何进行管理和持久性。

      持久化单元具有的属性：

            在该持久化性单元范围（作用域）内的实体类；

            为上述实体类提供持久性的持久性提供者（Persistence Provider）或库；

            上述实体类的数据源（Data Source）；

            应用使用的事务类型（Transaction Type）。

            持久性单元能够被打包成war文件，EJB-Jar文件，EAR文件的一部分，或者直接打包成应用程序能够直接使用的JAR文件。

      问：何为MT_HOTEL_SERVICE?

      答：在我们的项目中，每一个系统的API的项目的META-INF目录下。都有一个persistence.xml。persistence.xml 是 JPA 的 配置文件。persistence.xml中配置了一个名为MT_HOTEL_SERVICE的持久化单元。

        项目中的persistence.xml文件内容：

<persistence-unit name="MT_HOTEL_SERVICE"transaction-type="JTA"><provider>org.eclipse.persistence.jpa.PersistenceProvider</provider><jta-data-source>java:jboss/datasources/CloudMysqlDS</jta-data-source><class>com.tgb.itoo.base.entity.BaseEntity</class><properties><!-- 修改第一次加载时间长的问题 --><property name="eclipselink.deploy-on-startup" value="true" /><!-- 修改为FINE后，控制台会打印出执行的sql语句，方便调试 --><property name="eclipselink.logging.level" value="FINE" /><property name="eclipselink.jdbc.allow-native-sql-queries" value="true" /> <!-- 设置服务器类型 --><property name="eclipselink.target-server" value="JBoss" /><!-- logging -->            <!-- <property name="eclipselink.logging.level" value="SEVERE" /> --> <property name="eclipselink.weaving" value="static" /><property name="eclipselink.session.customizer" value="com.tgb.itoo.base.util.uuid.UUIDSequence" /><property name="eclipselink.show_sql" value="true" /></properties></persistence-unit>

      持久化单元的部署过程可以分为两个阶段进行：第一个阶段是解析persistence.xml文件，读取持久化单元的配置信息；第二个阶段是读取实体映射元数据，在内存中建立持久化单元所用数据库的模型，并根据需要初始化数据库对象。完成了这两步就开始创建实体管理器工厂。

(3)解决办法

      问题中出现的：#MT_HOTEL_SERVICE" is already registered。表示，已经注册了#MT_HOTEML_SERVICE，还要再去注册，我们查看了一下部署好的ear包里，在web的war里有两个不同版本的itoo-basic-api 的jar包，导致它需要解析两次。

     去掉我们不用的jar包版本即可部署成功。

五、总结

 问题虽然解决了，但是这些基本的知识还是要再去学习一下，现在能够解决问题，只是了解到了非常表面的一些东西，原理性的还不是很清楚，需要不断的去实践。