把WebLogic EJB程序迁移到JBoss上

<script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script> WebLogic服务器是一款顶级的商业应用程序服务器。但是对于小规模的开发者来说，开发源代码的、基于标准的应用程序服务器JBoss是可以用来替换类似WebLogic或WebSphere等商业应用程序服务器的。不幸的是，在WebLogic中开发的应用程序不能在JBoss中部署。JBoss迁移服务为我们提供了把应用程序迁移到JBoss上的支持。作为代替，通过把厂商特定的部署文件信息迁移到JBoss上，是可能把应用程序迁移到JBoss上的。为了演示如何把应用程序迁移到JBoss的过程，我们将把一个在WebLogic中开发的带有Oracle数据库的EJB应用程序迁移到带有MySQL数据库的JBoss应用程序服务器上。 　　预安装软件 　　为了配置MySQL数据库的JDBC连接，需要下载MySQL数据库驱动程序类。 　　1．下载MySQL JDBC驱动程序.jar文件 　　2．下载和安装MySQL数据库服务器 　　3．下载和安装JBoss 4.0应用程序服务器 　　开发一个Java应用程序，我们将使用它和XSLT把WebLogic部署文件转换为JBoss部署文件。该部署文件也可以使用XSLT工具进行转换。 　　概述 　　在不进行修改的时候，WebLogic中开发的应用程序是不能部署在JBoss中的。JBoss应用程序的部署文件与WebLogic的部署文件不同。在本文中，我们将把一个在WebLogic中开发的实体（entity）EJB应用程序示例迁移到JBoss中，迁移的方法是把WebLogic部署文件转换为JBoss部署文件。 　　示例应用程序包含一个Catalog实体EJB。该EJB的bean类（CatalogBean.java）、远程接口（Catalog.java）、和home接口（CatalogHome.java）都在本文下载链接的weblogic-jboss-resources.zip示例文件中。我们将使用MySQL开放源代码数据库来配置JBoss应用程序。把WebLogic EJB应用程序部署到JBoss中并不需要修改实体EJB类，只需要修改该EJB的部署文件。 　　配置JBoss和MySQL 　　MySQL是一个开放源代码的数据库，它适合于开放源代码的项目和小型组织。为了配置JBoss和MySQL数据库需要进行下面一些修改。 　　配置JBoss类路径 　　为了使用JBoss 4.0和MySQL，我们首先要把驱动程序类.jar文件（mysql-connector-java-3.0.9-stable-bin.jar）复制到＜JBoss＞/server/default/lib目录中。其中的＜JBoss＞是JBoss应用程序服务器安装的目录。lib目录的.jar和.zip文件都包含在JBoss服务器的Classpath（类路径）中。 　　配置MySQL数据源 　　为了使用MySQL数据源，需要把＜JBoss＞/docs/examples/jca/mysql-ds.xml复制到＜JBoss＞/server/default/deploy目录中。当JBoss服务器启动的时候，deploy目录中的数据源配置文件就被部署好了。依照下面的步骤修改mysql-ds.xml配置文件： 　　· 把＜driver-class/＞设置为com.mysql.jdbc.Driver，＜connection-url/＞设置为jdbc:mysql://localhost/＜database＞，其中＜database＞是MySQL数据库。＜database＞的值可以设置为test，它是MySQL中的示例数据库。 　　· 在jndi-name元素中指定数据源的JNDI名称。 　　· 指定连接MySQL数据库的用户名和密码。在默认情况下，root用户名不需要密码。 　　· 把type-mapping元素指定为mySQL。type-mapping元素指定了standardjbosscmp-jdbc.xml部署文件中预定义的数据库类型映射关系。对于MySQL数据库来说，类型映射是mySQL。 　　修改过的mysql-ds.xml如下所示： ＜?xml version="1.0" encoding="UTF-8"?＞ ＜datasources＞ ＜local-tx-datasource＞ ＜jndi-name＞MySqlDS＜/jndi-name＞ ＜connection-url＞jdbc:mysql://localhost/test＜/connection-url＞ ＜driver-class＞com.mysql.jdbc.Driver＜/driver-class＞ ＜user-name＞root＜/user-name＞ ＜password＞＜/password＞ ＜metadata＞ ＜type-mapping＞mySQL＜/type-mapping＞ ＜/metadata＞ ＜/local-tx-datasource＞ ＜/datasources＞ 　　我们可以通过提供数据源JNDI名称从数据源获取一个JDBC连接： InitialContext initialContext = new InitialContext(); javax.sql.DataSource ds = (javax.sql.DataSource) initialContext.lookup("java:/MySqlDS"); java.sql.Connection conn = ds.getConnection(); 　　配置登录信息 　　现在我们根据MySQL数据库设置来修改login-config.xml配置文件。为了登录到MySQL数据库，应用程序策略MySqlDbRealm是必要的。给login-config.xml添加下面的＜application-policy/＞元素： ＜application-policy name = "MySqlDbRealm"＞ ＜authentication＞ ＜login-module code = "org.jboss.resource.security.ConfiguredIdentityLoginModule" flag = "required"＞ ＜module-option name ="principal"＞＜/module-option＞ ＜module-option name ="userName"＞root＜/module-option＞ ＜module-option name ="password"＞＜/module-option＞ ＜module-option name ="managedConnectionFactoryName"＞ jboss.jca:service=LocalTxCM,name=MySqlDS ＜/module-option＞ ＜/login-module＞ ＜/authentication＞ ＜/application-policy＞ 　　通过修改mysql-ds.xml和login-config.xml文件，JBoss 4.0服务器已经被配置好了，可以使用MySQL数据库了。除了前面的一些特定的设置之外，可能还需要对JBoss部署文件和JBoss JDBC配置文件作一些修改。 　　如果"建立表"选项被选中（通过把jbosscmp-jdbc.xml中的create-table元素设置为true）用于部署CMP实体EJB，并且MySQL表的主键（或唯一键）的长度超过了500字节，应用程序的部署过程会在MySQL数据库中生成一个SQL语法错误。对于java.lang.String类型的CMP字段，我们可以通过在standardjbosscmp-jdbc.xml部署文件的mySQL类型映射中把用于Java类型java.lang.String的SQL类型设置为较低的VARCHAR值来减小主键（或唯一键）的长度。另一个可能出现的问题是jbosscmp-jdbc.xml部署文件中的column-name元素。如果某个MySQL表的列名与MySQL保留字相同，在JBoss中部署J2EE应用程序的时候会产生一个错误。解决这个问题的方法是使列名与MySQL保留字不同。 转换WebLogic EJB应用程序 　　在建立起使用MySQL的JBoss服务器之后，你现在必须把该WebLogic EJB应用程序转换为JBoss EJB应用程序，这就涉及到部署文件的修改。WebLogic实体EJB应用程序由EJB部署文件（ejb-jar.xml、weblogic-ejb-jar.xml和weblogic-cmp-rdbms-jar.xml），bean类（CatalogBean.java）、远程接口（Catalog.java）和home接口（CatalogHome.java）组成。为了在WebLogic服务器上部署实体EJB，需要建立一个EJB .jar文件，这个EJB .jar文件的结构如下： META-INF/ ejb-jar.xml weblogic-ejb-jar.xml weblogic-cmp-rdbms-jar.xml CatalogBean.class Catalog.class CatalogHome.class 　　EJB的结构信息和应用程序汇编信息都在部署文件中指定。结构信息包括说明EJB是对话EJB还是实体EJB。ejb-jar.xml部署文件中的应用程序汇编信息在assembly-descriptor元素中指定。WebLogic中该实体EJB部署文件包括ejb-jar.xml、weblogic-ejb-jar.xml和weblogic-cmp-rdbms-jar.xml。相应的JBoss部署文件是ejb-jar.xml、jboss.xml和jbosscmp-jdbc.xml。这些文件之间的转换如下所示。 　　ejb-jar.xml部署文件对于WebLogic和JBoss来说都是一样的，除了multiplicity元素之外。JBoss服务器的ejb-jar.xml中的multiplicity元素需要大写，例如One或Many，而不是one或many。 　　示例实体EJB的ejb-jar.xml部署文件包含在示例代码中。示例ejb-jar.xml定义了一个叫做"Catalog"的实体EJB。这个示例EJB拥有CMP字段catalogId、journal和publisher。其主键字段是catalogId。 　　把weblogic-ejb-jar.xml转换为jboss.xml 　　weblogic-ejb-jar.xml和jboss.xml部署文件都是EJB厂商的特定部署文件。为了把WebLogic EJB应用程序部署到JBoss应用程序服务器上，必须把weblogic-ejb-jar.xml部署文件转换为jboss.xml。 　　weblogic-ejb-jar.xml中的根元素是weblogic-ejb-jar。jboss.xml中的根元素是jboss。在jboss.xml和weblogic-ejb-jar.xml部署文件中指定某个EJB的JNDI名称的元素是jndi-name或local-jndi-name。本文中的示例实体EJB的weblogic-ejb-jar.xml部署文件也包含在示例代码中。weblogic-ejb-jar.xml部署文件的DOCTYPE元素是： ＜!DOCTYPE weblogic-ejb-jar PUBLIC "-//BEA Systems, Inc.//DTD WebLogic 8.1.0 EJB//EN" "http://www.bea.com/servers/wls810/dtd/weblogic-ejb-jar.dtd" ＞ jboss.xml部署文件的DOCTYPE是： ＜!DOCTYPE jboss PUBLIC "-//JBoss//DTD JBOSS 4.0//EN" "http://www.jboss.org/j2ee/dtd/jboss_4_0.dtd"＞ 　　我们通过一个自定义的XSLT样式表jboss.xslt（包含在示例代码中）把部署文件weblogic-ejb-jar.xml转换为jboss.xml。该样式表建立jboss.xml，它是与WebLogic的weblogic-ejb-jar.xml部署文件相当的JBoss文件。使用jboss.xslt样式表所生成的jboss.xml文件也包含在示例代码中。 　　把weblogic-cmp-rdbms-jar.xml转换为jbosscmp-jdbc.xml 　　weblogic-cmp-rdbms-jar.xml部署文件指定了CMP实体EJB的数据库持续信息。weblogic-cmp-rdbms-jar.xml文件包含实体EJB的表名称、连接到数据库的数据源和与该实体EJB CMP字段对应的列。示例实体EJB的weblogic-cmp-rdbms-jar.xml部署文件包含在可以下载的.zip文件中。指定CMP视图EJB持续信息的JBoss部署文件是jbosscmp-jdbc.xml。 　　weblogic-cmp-rdbms-jar.xml的根元素是weblogic-rdbms-jar；jbosscmp-jdbc.xml的根元素是jbosscmp-jdbc。weblogic-cmp-rdbms-jar.xml文件中指定连接到数据库的数据源的data-source-name元素与jbosscmp-jdbc.xml部署文件中的datasource元素功能相当。weblogic-cmp-rdbms-jar.xml指定实体EJB CMP字段与数据库表的列之间映射关系的field-map元素与jbosscmp-jdbc.xml中的cmp-field元素功能相当。weblogic-cmp-rdbms-jar.xml中指定列名的dbms-column元素与jbosscmp-jdbc.xml中的column-name元素功能相当。weblogic-cmp-rdbms-jar.xml部署文件的DOCTYPE是： ＜!DOCTYPE weblogic-rdbms-jar PUBLIC -//BEA Systems, Inc.//DTD WebLogic 8.1.0 EJB RDBMS Persistence//EN http://www.bea.com/servers/wls810/dtd/weblogic-rdbms20-persistence-810.dtd＞ jbosscmp-jdbc.xml的DOCTYPE是： ＜!DOCTYPE jbosscmp-jdbc PUBLIC "-//JBoss//DTD JBOSSCMP-JDBC 4.0//EN" "http://www.jboss.org/j2ee/dtd/jbosscmp-jdbc_4_0.dtd"＞ 　　我们使用自定义的XSLT样式表jbosscmp-jdbc.xslt（包含在示例代码中）把部署文件weblogic-cmp-rdbms-jar.xml转换为jbosscmp-jdbc.xml。该样式表建立jbosscmp-jdbc.xml，它是与WebLogic的weblogic-cmp-rdbms-jar.xml部署文件功能相当的JBoss文件。jbosscmp-jdbc.xml也包含下载在.zip文件中。 　　WebLogic部署文件的DTD与JBoss部署文件的不同。使用自定义的XSLT的时候，如果部署文件中还出现了一些额外的元素，可能还需要做进一步的修改，可以把WebLogic部署文件转换为JBoss部署文件。在下面的部分中，我们将在JBoss服务器上部署这个EJB应用程序。 　　在JBoss中部署该EJB应用程序 　　把WebLogic EJB部署文件转换为JBoss部署文件之后，你必须建立一个心的EJB .jar文件以部署到JBoss服务器上。该JBoss .jar文件的结构如下： META-INF/ ejb-jar.xml jboss.xml jbosscmp-jdbc.xml CatalogBean.class Catalog.class CatalogHome.class 　　编译示例EJB类和接口： java Catalog.java CatalogBean.java CatalogHome.java 　　把JBoss部署文件ejb-jar.xml、jboss.xml和jbosscmp-jdbc.xml复制到META-INF目录中。使用jar工具从JBoss部署文件、类和接口中建立一个.jar文件。 jar cf CatalogEJB.jar CatalogBean.class Catalog.class CatalogHome.class META-INF/*.xml 　　部署该JBoss实体EJB应用程序的过程是，把该.jar文件（EntityEJB.jar）复制到＜JBoss＞/server/default/deploy目录（其中＜JBoss＞是JBoss安装的目录）中。当服务器启动的时候，该EJB应用程序就在JBoss服务器上面部署好了。JBoss应用程序服务器中的部署（deploy）目录与WebLogic应用程序服务器中的应用程序（applications）目录对应。 　　结论 　　通过转换部署文件可以把WebLogic中部署的实体EJB应用程序迁移到JBoss应用程序服务器上。使用相似的步骤，通过把weblogic.xml 部署文件转换为jboss-web.xml ，也可以把WebLogic J2EE Web应用程序迁移到JBoss上。