jboss配置文件的简单介绍 - JAVA流通桥 - BlogJava

昵称6290367 2011-05-13

展开全文

jboss配置文件的简单介绍

这里面是最麻烦的，我会将遇到的常见错误描述一下，并说明解决方法。

要部署EJB就要修改部署文件，因为默认生成的部署文件还是有出路的。但是网络上很多文章提到需要修改的文件颇多，我在实际开发的时候觉得没有必要修改这么多文件，请听我慢慢到来。

与部署有关的文件如下：

文件名称	路径	用途
standardjaws.xml	jboss-3.0.2\server\default\conf	Entity EJB标准部署描述文件
standardjbosscmp-jdbc.xml	jboss-3.0.2\server\default\conf	JBossCMP容器的标准部署描述文件。
standardjboss.xml	jboss-3.0.2\server\default\conf	JBoss的标准部署描述文件。
oracle-service.xml	jboss-3.0.2\server\default\deploy	Oracle数据库的部署描述文件（非事务处理数据源），需要从jboss-3.0.2\docs\examples\jca中copy过来
oracle-xa-service.xml	jboss-3.0.2\server\default\deploy	Oracle数据库的部署描述文件（事务处理数据源），需要从jboss-3.0.2\docs\examples\jca中copy过来
ejb-jar.xml	jar的META-INF目录中	jar及其ejb标准部署描述文件
jaws.xml	jar的META-INF目录中	Entity EJB部署描述文件，这个文件描述了CMP定义以及其持久属性。
jboss.xml	jar的META-INF目录中	EJB在Jboss的JNDI部署描述文件

1. standardjaws.xml：这个文件主要描述了数据源和映射类型，EJB映射的表。这个数据源描述了一个JNDI名称，可以通过这个JNDI获得一个数据源连接池。jar包的META-INF目录中有个jaws.xml与此文件对应，只要把jar中的jaws.xml它配置好了就可以，不用修改这个文件。

2. standardjbosscmp-jdbc.xml：JBossCMP容器的标准部署描述文件。网上说此文件需要进行修改，比如

缺省的数据源

<datasource>java:/DefaultDS</datasource>

缺省的数据库类型

<datasource-mapping>Hypersonic SQL</datasource-mapping>

……..

</defaults>

修改成当前使用的配置

当前使用的数据源

<datasource>java:/NECOracle</datasource>

当前使用的数据库类型

<datasource-mapping>Oracle8</datasource-mapping>

但是在实际操作中没有进行任何修改也成功的部署了ejb。所以这个文件应该不用修改。

3. standardjboss.xml：JBoss的标准部署描述文件。此文件不需要修改。

4. jaws.xml：jaws.xml对应standardjaws.xml文件，但是此文件在jar的META-INF目录中，这个文件描述了CMPEJB定义以及其持久属性。只专门针对此jar的数据源和映射类型的描述。此文件需要做修改。

<jaws>

此处声明的DataSource是此jar应该对应的DataSource，这个数据源就是在oracle-service.xml中描述的数据源，oracle-service.xml中可以有多个数据源，要选择此jar相对应的数据源。如果oracle-service.xml文件只是使用原来的数据源OracleDS，那么此处直接修改就可以：

EntityEJB的数据源，这个OracleDS是oracle-service.xml文件默认的数据源

<datasource> OracleDS</datasource>

注意：此文件是由JBulider自动生成的，所以此DataSource也是自动加上的，此名称缺省与在EJBModule中配置的DataSource的名称一致，所以为了方便起见，EJBModule中配置的DataSource应该是oracle-service.xml中被声明的数据源（也可修改oracle-service.xml文件，进行添加）。这样此处就不用进行修改。比如本例“NECOracle”就在oracle-service.xml中声明了。

数据库的类型，此处必须是正确的，就是必须是standardjbosscmp-jdbc.xml定义的数据库

<type-mapping>Oracle8</type-mapping>

以下是此EJB的相关描述

<enterprise-beans>

EntityEJB的名称

<ejb-name>Systui</ejb-name>

开始声明具体的数据库字段名称和EJB域的映射关系

<cmp-field>

<field-name>tuiid</field-name>

<column-name>TUIID</column-name>

</cmp-field>

……………..

</enterprise-beans >

我们也可以在oracle-service.xml中增加数据源，并使用这个数据源（如何增加数据源下面oracle-service.xml会详细讲到），同时此名称缺省值是JBulider的EJBModule中创建的DataSource。

NECOracle是在oracle-service.xml新增的数据源

<datasource> NECOracle </datasource>

数据库的类型，此处必须是正确的，就是必须是standardjbosscmp-jdbc.xml定义的数据库

<type-mapping>Oracle8</type-mapping>

以下是此ejb的相关描述

<enterprise-beans>

EntityEJB的名称

<ejb-name>Systui</ejb-name>

开始声明具体的数据库字段名称和EJB域的映射关系

<cmp-field>

<field-name>tuiid</field-name>

<column-name>TUIID</column-name>

</cmp-field>

……………..

</enterprise-beans >

5. oracle-service.xml：Oracle数据库非事务处理数据源部署描述文件，这个文件用来描述oracle数据源，可以直接修改当前的数据源，也可以在此文件中增加数据源，本人倾向增加数据源，通过增加就可以有多个数据源供 EJB使用了。我们现在可以对其进行修改：

开始描述一个数据源，这个数据源的名称是OracleDS，

…….

此处描述数据库的连接参数

<config-property name="ConnectionURL" type="java.lang.String">jdbc:oracle:thin:@youroraclehost:1521:yoursid</config-property>

此处描述数据源的连接驱动

<config-property name="DriverClass" type="java.lang.String">oracle.jdbc.driver.OracleDriver</config-property>

访问数据库的用户名

<config-property name="UserName" type="java.lang.String"></config-property>

访问数据库的密码

<config-property name="Password" type="java.lang.String"></config-property>

</properties>

</attribute>

……

</mbean>

修改后

…….

此处描述数据库的连接参数

<config-property name="ConnectionURL" type="java.lang.String">jdbc:oracle:thin:@172.28.119.173:1521:comp1</config-property>

此处描述数据源的连接驱动

<config-property name="DriverClass" type="java.lang.String">oracle.jdbc.driver.OracleDriver</config-property>

访问数据库的用户名

<config-property name="UserName" type="java.lang.String">mrc</config-property>

访问数据库的密码

<config-property name="Password" type="java.lang.String">mrc1</config-property>

</properties>

</attribute>

……

</mbean>

我们也可以增加一个数据源

<?xml version="1.0" encoding="UTF-8"?>

…….

原来缺省的数据源OracleDS

…….

<config-property name="ConnectionURL" type="java.lang.String">jdbc:oracle:thin:@youroraclehost:1521:yoursid</config-property>

<config-property name="DriverClass" type="java.lang.String">oracle.jdbc.driver.OracleDriver</config-property>

<config-property name="UserName" type="java.lang.String"></config-property>

<config-property name="Password" type="java.lang.String"></config-property>

</properties>

</attribute>

……

</mbean>

新增加的一个数据源NECOracle

…….

此处描述数据库的连接参数

<config-property name="ConnectionURL" type="java.lang.String">jdbc:oracle:thin:@172.28.119.173:1521:comp1</config-property>

此处描述数据源的连接驱动

<config-property name="DriverClass" type="java.lang.String">oracle.jdbc.driver.OracleDriver</config-property>

访问数据库的用户名

<config-property name="UserName" type="java.lang.String">mrc</config-property>

访问数据库的密码

<config-property name="Password" type="java.lang.String">mrc1</config-property>

</properties>

</attribute>

……

</mbean>

</server>

6. oracle-xa-service.xml：此文件同oracle-service.xml是一个道理，区别在于此文件是描述事务处理数据源的，而oracle-service.xml则是描述非事务处理数据源的。本例使用非事务处理数据源，所以此对文件没有进行修改。

7. ejb-jar.xml：此文件在jar的META-INF目录中，是此jar及其EJB的标准部署描述文件。此处需要注意的就是文件中描述的DataSource。

<ejb-jar>

<display-name>MyEJBModule</display-name>

<enterprise-beans>

<ejb-name>Systui</ejb-name>

<home>myejb.SystuiHome</home>

……

<resource-ref>

此处的JDBC名称缺省值是EJBModule中创建的DataSource的名称，EJBModule中创建的DataSource应该是在oracle-service.xml文件中声明过的DataSource，否则此处就需要手工修改成oracle-service.xml中声明的DataSource的名称。