| |
摘要:
ejb与corba的集成能力对于集成基于java或非java的应用来说是很重要的。本文描述了如何实现一个ejb与一个corba的c++应用相集成。它阐述了几个重要的集成问题,尤其是那些ejb采用java固有的或是用户定义的对象作为参数或返回值的方法时涉及的问题。
ejb对于用java来开发关键业务应用程序是非常重要的。但是,业务应用不是孤立存在的,当今,企业需要集成各种应用。从而,把基于ejb的解决方案与现有的应用系统集成起来就变得越来越重要了。
在本文中,我将说明如何从一个非java语言编写的应用中访问ejb。更加特别地是,我将讨论从一个corba的c++客户端访问会话和实体bean(它使用同步的iiop协议进行通信)。我没有提到消息驱动bean,尽管你可能想从其它语言编写的应用中使用mom产品来访问它们。
1. rmi-iiop 会话bean和实体bean使用远程方法调用(rmi)来进行同步通信。j2ee1.3要求java客户端使用rmi-iiop。rmi-iiop采用corba的iiop协议,这使得rmi-iiop与corba相兼容。换句话说,不是基于java开发的客户端可以通过corba与ejb进行通信。
要实现这点,你必须使用符合j2ee1.3的应用服务器。以前的ejb规范没有要求你去用rmi-iiop协议。而是,应用服务器采用了rmi-jrmp或是其它私有协议。另外,你必须使用符合corba2.3.1或更高版本的orb。以前的corba版本没有实现与rmi-iiop协议进行互操作所必需的规范,尤其是后来集成中corba规范和java到idl的语言映射规范中的用值传递对象的规范(可以参看corba/iiop规范2.6版,在“值类型语义”一章)。
值类型语言增加了用值来传递对象的概念,是由rmi引来,加入到corba中的。corba最初并不支持这项功能;但是,这个概念对于实现java与corba之间的互操作是至关重要的。
java到idl语言映射规范定义了如何把java接口映射到corba的idl语言。这个定义使corba分布对象可以访问本来不具有corba的idl的ejb(还有那些rmi-iiop分布对象)。特别的是,这个规范定义了一个java的rmi子集,叫rmi/idl,它可以让你
映射到idl,用iiop(或是更通用,是giop协议)作为通信的底层协议。
2. rmi/idl 许多rmi/idl数据类型遵循一定的约束;我们来看一下那些最重要的类型。更详细的信息,请参看java到idl的语言映射规范。
表1显示了java基本类型到idl的映射。
表1:java到idl的映射
java omg idl void void boolean boolean char wchar byte octet short short int long long long long float float double double
java包映射为idl的模块。rmi/idl中的远程接口映射为idl的接口并具有相对应的名字。但是,那些用javabean命名方式用来只读或读写属性的方法被映射为idl的属性。后面我将提到这个。
java中可序列化的对象映射为corba的值类型。值类型为corba提供了用值来进行传递的语义。值类型是属于本地的,不能被远程调用。它们不注册到orb中,也不需要标识符,因为它们的值就是它们的标识符。更详细的信息,请参阅《professional j2ee eai》和corba/iiop规范2.6版。
就象我已经提到过的,所有的java或序列化的对象,包括java固有的和用户定义的,都将映射为值类型。但是,这个规则也有一些例外----例如,当你想把java.lang.string映射到idl时。如果把它定义为常量(final static),这个对象将被映射为idl的wstring。在其它情况下,包括作为方法的参数或返回值,该对象都被映射为值类型corba::wstringvalue。这个值类型是corba模块的一部分,它的idl定义如下:
valuetype wstringvalue wstring;
这等同于下面的idl定义:
valuetype wstringvalue {
public wstring data;
};
但是,要记住,第一种定义能够更干净地映射到java。表2列出其它特殊的映射情况。
表2:其它重要的特殊映射情况
java omg idl java.lang.object ::java::lang::_object java.lang.string ::corba::wstringvalue or wstring java.lang.class ::javax::rmi::corba::classdesc java.io.serializable ::java::io::serializable java.io.externalizable ::java::io::externalizable java.rmi.remote ::java::rmi::remote org.omg.corba.object object
3. 实现集成 后面我将返回来讨论值类型,先讨论用户定义的类,再讨论内嵌的类,如vectors、collections和enumerations。现在,让我们看一下corba和ejb集成的基本方式。首先,我们需要一个ejb。在第一个例子中,我们使用一个简单的会话bean,它只使用简单的数据类型作为方法的参数和返回值。我们没有强行去用值类型。(注意:从corba客户端访问实体bean跟访问会话bean的过程一样。)
这个方式是最简单的;但是,你不能把它用在复杂的接口上。它的好处是:你可以使用不支持值类型的orb。许多corba产品都是这样(不支持值类型),尤其是那些不是用c++实现的产品。
这个例子中,我将使用c++版本的orbacus4.1.0作为corba的orb,使用vc++6.0作为编译客户端代码的编译器。为部署这个例子中的ejb,我将使用jboss3.0.0。你可以从网上下载orbacus4.1.0(也可以从iona网站上下载)和jboss3.0.0。
你可以使用任何支持corba2.3.1或更高版本的orb产品(只要它支持到c++的映射)、一个相对应的c++编译器和一个支持j2ee1.3规范的应用服务器。理论上讲不需要修改代码;但是,如果你使用其它产品,小的改动可能是必要的。
4. ejb会话bean 让我们简单地看一下这个名叫corbaeai的会话bean。在我们的第一个例子中,这个简单的远程接口包含一个计算两个整数之和的简单方法。
package eai;
import java.rmi.remoteexception;
import javax.ejb.ejbobject;
public interface corbaeai extends ejbobject {
public int sum(int a, int b) throws remoteexception;
}
在你熟悉了集成过程之后,我将告诉你如何扩展这个接口以包含使用用户定义的对象和内嵌对象的方法。
要转这个例子,你必须把会话bean部署到一个应用服务器上。这要求你定义home接口、实现这个bean的实现类、定义部署描述器、创建jar文件并最终部署这个ejb。我不写这些步骤了,但是你可以下载这个例子的源码包。
5. 开发corba客户端 要开发corba客户端,我们需要完成以下步骤:
l 从会话bean的home接口和组件远程接口生成idl
l 简化生成的idl
l 编译idl接口,生成相应的编程语言的代码----我们这个例子中是c++----来生成桩及其它必需的映射
l 确定如何使用jndi作为corba的名字服务
l 开发c++的客户端和支持值类型
l 创建客户端
5.1. 生成idl 为从java接口生成idl,你可以使用任何支持java语言到omg的idl映射规范的工具。例如:
l rmic编译器,由jsdk1.3或更版本提供,使用-idl选项;
l java2idl,由visibroker提供;
l rmic和ejbc(使用-idl)编译器,由bea的weblogic提供
其它的应用服务器提供类似的工具。需要明确的是,从ejb接口生成idl接口要比从rmi-iiop接口生成复杂得多。首先,ejb接口继承于ejbobjec和ejbhome接口,它们定义了一些基本方法。因为idl接口也必须继承于这些接口,所以其工具也必须为这些接口生成idl接口。其次,ejb的home接口中的方法至少抛出createexception异常,所以其工具也必须把这个异常和一些其它用户定义的异常映射到idl。
这儿我用的是jsdk1.3.1提供的rmic,注意要把包含要映射的接口的jar包包含在classpath中(对于jboss来说,要包含$jbosshomeclient jboss-j2ee.jar)。这儿需要映射的是eai.corbaeai和eai.corbaeaihome两个类:
rmic -idl -classpath "%classpath%;corbaeai.jar" eai.corbaeai eai.corbaeaihome -d ./idl
rmic编译器在目录./idl下生成idl文件,共有26个。
5.2. 简化生成的idl的文件 用c++来实现所有的生成的接口和值类型是很费时间的。但是我们并不需要所有的生成的接口,因为有一些方法我们没有去用。所以我们可以通过简化生成的idl接口文件来节省一大部分工作。
对于这第一个例子,我们不去用ejbobject和ejbhome两个接口上的方法,我们也不需要ejbmetadata。我们也不需要特殊的removeexception异常,这样,我们就可以不用remoteexceprion和remoteex两个idl接口。我们还可以除去下列idl接口:java.io、java.lang和java.rmi。
为进一步简化idl文件,我们把所需要的idl接口放在一个文件中。经过简化以后,得到以下idl文件corbaeai.idl:
#include "ob/orb.idl" //orbacus中的orb.idl在ob目录下。
module javax {
module ejb {
valuetype createexception {
};
#pragma id createexception "rmi:javax.ejb.createexception:fd98a9711f66df7f:575fb6c03d49ad6a"
exception createex {
createexception value;
};
};
};
module eai {
interface corbaeai {
long sum(
in long arg0,
in long arg1 );
};
#pragma id corbaeai "rmi:eai.corbaeai:0000000000000000"
interface corbaeaihome {
::eai::corbaeai create( ) raises (
::javax::ejb::createex );
};
#pragma id corbaeaihome "rmi:eai.corbaeaihome:0000000000000000"
};
5.3. 编译idl接口 接下来,我们把idl接口映射到客户端的编程语言。我们在客户端用c++,这儿我们用orbacus的idl编译器(你可以用任何支持corba2.3.1或更高版本规范的idl到c++的编译器)。
如果你仔细看idl的文件,你会发现它包含了一个文件orb.idl。在我们的例子中,我们用orbacus自带的orb.idl文件,它在$orbacushome/idl/ob目录下。因此,在使用idl编译器时,我们要指定包含orb.idl的路径。我们用orbacus所带的idl编译器进行编译,因为我们只是编写客户端,所以不需要服务方的骨架文件:
idl -ie:oocidl --no-skeletons corbaeai.idl
会生成stub文件corbaeai.h和corbaeai.cpp。
5.4. 使用jndi作一个corba名字服务 在我们开发c++客户端之前,先考虑一下如何获得会话bean的home接口corbaeaihome的初始引用。corbaeaihome已经注册到应用服务器的jndi上,所以c++的客户端必须访问jndi名字服务。
有一些应用服务器,就象bea的weblogic,提供了一个跟corba名字服务相兼容的接口去访问jndi。为测试这一点,我们可以用weblogic的host2ior工具,它将输出这个名字服务的使用iiop和iiop/ssl的ior。对我们这个例子来说,我们只对非安全的iiop感兴趣。jboss也提供一个corba名字服务,从jboss的启动日志中可以看到这个服务的ior。
corba名字服务是一个有着标准接口的corba分布对象,从技术上讲,它和其它corba对象一样。因此,我们可以通过ior直接连接到jndi。
但是,一个更好的方法是通过用一个关键字nameservie析取初始引用来得到名字服务的引用。在本例中,我们在启动客户端时指出所要用的名字服务,我们通过命令行实现,在后面将会提到。
5.5. 开发c++客户端 我们开发一个简单的c++客户端来调用会话bean corbaeai上的sum()方法。假定你熟悉corba。客户端的主程序client.cpp如下:
#include <ob/corba.h>
#include <ob/cosnaming.h>
#include <corbaeai.h>
#ifdef have_std_iostream
using namespace std;
#endif
int run(corba::orb_ptr orb, int argc, char* argv[])
{
//
// get naming service
//
corba::object_var obj;
obj = orb -> resolve_initial_references("nameservice");
cosnaming::namingcontext_var nc =
cosnaming::namingcontext::_narrow(obj.in());
//
// resolve names with the naming service
//
cosnaming::name name;
name.length(1);
name[0].id = corba::string_dup("corba-eai");
name[0].kind = corba::string_dup("");
cout << "resolved `corbaeaihome´" << endl;
corba::object_var aobj = nc -> resolve(name);
eai::corbaeaihome_var ceaihome = eai::corbaeaihome::_narrow(aobj.in());
assert(!corba::is_nil(ceaihome.in()));
cout << "creating a new instance" << endl;
eai::corbaeai_var ceai = ceaihome->create();
cout << "result: "<< ceai->sum((corba::long)15,(corba::long)20)<< endl;
return exit_success;
}
int main(int argc, char* argv[], char*[])
{
int status = exit_success;
corba::orb_var orb;
try
{
orb = corba::orb_init(argc, argv);
status = run(orb, argc, argv);
}
catch(const corba::exception& ex){
cerr << ex << endl;
status = exit_failure;
}
if(!corba::is_nil(orb)){
try {
orb -> destroy();
}
catch(const corba::exception& ex){
cerr << ex << endl;
status = exit_failure;
}
}
return status;
}
5.6. 建立和运行客户端 我们用vc++6.0建立c++的客户端。源文件是idl编译生成的客户端的stub文件corbaeai.h和corbaeai.cpp和主程序文件client.cpp。生成可执行文件corbaeai.exe。
按照以下步骤运行本例子:
l 启动应用服务器,在我们的例子中是jboss3.0。为了启动iiop,所以用all模式来启动jboss3.0.0(可能集群服务启动不起来,如果起不来,可以先把集群服务屏蔽掉)。
l 部署会话bean corbaeai到jboss应用服务器上。
l 使用下面的命令启动c++客户端程序:
corbaeai ?corbinitref nameservice=corbaloc::localhost:8683/jboss/naming/root
注意在本例中,ejb应用服务器和客户端在同一台机器上。如果要进行远程通信,需要用一个真正的名字或是ip地址代替localhost。
6.值类型 这个例子还是十分的不完美。它没有为java的可序列化对象实现值类型,这就意味着我们不能捕捉到远程异常(因为正象idl中所表示的,它们被映射成值类型)。另外,在第一个例子中我还限制了方法只使用原始的数据类型。
为了理解corba是如何处理java的可序列化的类,你必须看一下corba的值类型。java的可序列化对应着值类型。每一个被作为参数、返回值或异常传自于/传递到corba客户端的java可序列化的对象都应该用客户端的编程语言再实现一次,在我们的例子中就是c++。这需要一定的工作。不幸的是,我不知道那些对java的固有类型,如remote、throwable、ejbobject和ejbhome完全支持的corba实现。据我所知,只有ibm的websphere应用服务器提供了一个值类型的库,它包含了诸如integer、float、vector、exception和outputstream等这些常用的java类型的c++值类型的实现。根据websphere4.0应用服务器的文档,它的值类型库只支持websphere的c++ orb。
对每一个值类型,idl到c++的编译器生成一个指针类型的定义_ptr和一个_var类。_var类自动管理为对象引用动态分配的内存。一个转换操作符让你也可以把一个_var赋给_ptr。还需要提醒的是,原始的java构造器不能映射到idl。但是,当idl映射到c++时,构造器变成工厂类的init方法。
为实现值类型(比如用c++),你需要:
l 实现一个值类型的类,它要继承于值类型的基类(由idl编译器生成)和缺省的值引用计数的基类。对于值类型,你必须手工实现引用的计数。
l 实现工厂类和工厂方法。
l 把工厂注册到orb。
让我们看一下createexception值类型的例子。首先,我们声明它的实现类createexceptionimpl:
class createexcepionimpl : public virtual ::javax::ejb::obv_createexception,
public virtual corba::defaultvaluerefcountbase
{
我们至少必须实现构造器和_copy_value()方法,它简单地一个新的值类型类的实例:
public:
createexceptionimpl() : obv_createexception() { }
virtual ~createexceptionimpl() { }
corba::valuebase* _copy_value() {
return new createexceptionimpl();
}
我们也能够为其它一些方法提供实现,如message()、localizedmessage()和tostring():
corba::wstringvalue* message() {
return new corba::wstringvalue(corba::wstring_dup(l”javax::ejb::createexception”));
}
corba::wstringvalue* localizedmessage() {
return new corba::wstringvalue(corba::wstring_dup(l”javax::ejb::createexception”));
}
corba::wstringvalue* tostring() {
return new corba::wstringvalue(corba::wstring_dup(l”javax::ejb::createexception”));
}
};
接下来,我们定义工厂类createexceptionfactory。我们至少要实现create_for_unmarshal()方法,但是我们还要实现create__()方法。这两个方法都返回一个新实现的类实例:
class createexceptionfactory: public ::javax::ejb::createexception_init
{
public:
createexceptionfactory() { }
virtual ~createexceptionfactory() { }
javax::ejb::createexception* create__() {
return new createexceptionimpl();
}
corba::valuebase* create_for_unmarshal() {
return new createexceptionimpl();
}
};
最后,我们把工厂注册到orb上。orb接口提供register_value_factory()方法,它接收库id号和工厂实例作为参数。我们可以从idl中得到库id号(它由#pragma指示)。下面的例子示范了如何注册createexception:
orb->register_value_factory(“rmi:javax.ejb.createexception:fd98a9711f66df7f:575fb6c03d49ad6a”, (corba::valuefactory)new createexceptionfactory);
我们简单地实现了在corba客户端中所需要的所有值类型。尽管这看起来有些复杂,但是你将会发现这个过程并不是很难而且你可以定义模板类来自动生成它。
7.开发一个更高级的corba客户端 现在你对corba的值类型已经熟悉了,你可以为具有更复杂接口的ejb开发corba客户端。
在这个例子中,我们用几个使用了用户自定义对象和固有的java对象的方法来扩展corbaeai会话bean的接口。首先,我们添加sumobj()方法来将两个integer对象相加:
public integer sumobj(integer num1, integer num2) throws remoteexception;
然后我们为一个可序列化的类mytype添加一个getter/setter操作对:
public mytype getmytype() throws remoteexception;
public void setmytype(mytype mt) throws remoteexception;
mytype类非常简单,它包含两个属性(为简单起见,我没有列出相对应的getter/setter操作方法):
package eai;
import java.io.serializable;
public final class mytype implements serializable {
public int a;
public double b;
}
最后,我们添加一个返回java向量的方法getvector()和一个返回java集合的方法getcollection():
public vector getvector() throws remoteexception;
public collection getcollection() throws remoteexception;
这些方法代表了大多数基于ejb的应用中的典型方法。完整的例子可以参见源代码2。
开发这个corba客户端的过程跟第一个例子相似。首先,我们生成idl接口。我们使用跟前面一样的命令;但是,这次我们不再简化idl。
注意,为会话bean corbaeai远程组件接口生成的idl接口遵循rmi/idl映射属性访问方法的规则。使用javabean命名方式来读写/只读属性的方法没有映射到idl操作,而是映射到idl属性。在我们的例子中,我们有getmytype()和setmytype()读写属性的方法和getvector()、getcollection()的只读方法。这些方法映射到下面的idl属性:
attribute ::eai::mytype mytype;
readonly attribute ::java::util::vector vector;
readonly attritube ::java::util::collection collection;
为了从c++访问这些属性,你必须知道它们是如何从idl映射到c++(或者你选择的其它语言)。对c++,每一个属性映射到两个重载的和属性一样名字的c++函数,一个用来设置属性,一个用来读取属性。只读属性只映射到一个读取函数。更详细的信息请参阅c++语言映射。
其它方法,如sum()和sumobj(),都是一对一地映射:
long sum(in long arg0, in long arg1);
::java::lang::integer sumobj(in ::java::lang::integer arg0, in ::java::lang::integer arg1);
接下来,我们用orbacus的idl编译器把idl接口编译成c++。你可以一个一个地来编译所有的idl文件,也可以把所有的idl文件放在一个文件中编译。
现在,我们可以编写c++客户端的代码。第一,按照我前面解释的,为所有有关的值类型提供值类型的实现(值类型的类和工厂类)。在例子中,我们为下面这些值类型定义实现:
l mytype
l integer
l vector
l createexception
l removeexception
我们还要把这些值类型注册到orb。
你也许要奇怪为什么我们没有为collection定义一个值类型。你知道,collection是一个接口,它由类abstractcollection实现,提供了一个框架性的实现。javasdk为更多的特定接口提供了实现,如list。为了理解这种类和接口之间的层次关系,请看以下的uml图:
collection的接口和实现类层次
你可以把vector看成collection接口的一个可能的实现,所以我们用它来访问collection。
实际上c++用来调用corbaeai会话bean方法的代码是比较简单的。为调用sumobj()方法,我们先创建两个integer值类型并插入数值,然后调用方法、输出结果:
::java::lang::integer_var javaint1 = new integerimpl();
::java::lang::integer_var javaint2 = new integerimpl();
javaint1->value(15);
javaint2->value(20);
::java::lang::integer_var javaintr = ceai->sumobj(javaint1, javaint2);
cout << "sumobj(): " << javaintr->value() << endl;
为了调用getmytype()和setmytype()方法,回忆一下它们是如何被映射到idl属性的。所以,我们用c++重载的方法mytype()。下面的代码调用会话bean上的getmytype()方法:
::eai::mytype_var mt = ceai->mytype();
cout << "getmytype(): " << mt << endl;
为了调用setmytype()方法,我们先创建一个mytype实例并填充必要的数值;剩下的就是调用它了:
cout << "setmytype()... " << endl;
::eai::mytype_var mt2 = new mytypeimpl();
mt2->a((corba::long)9);
mt2->b((corba::double)9.9);
ceai->mytype(mt2);
注意,这儿的方法名字已经变了,因为我们用的是javabean的命名方式(get/set方法)。否则,方法就不会改变。
对getvector()方法也是一样,它被映射到一个只读的idl属性。所以,我们用c++的vector()方法来访问它:
::java::util::vector_ptr vec = ceai->vector();
cout << "getvector(): " << vec << endl;
这个过程中最有趣的事情也许是我们如何访问collection的过程。调用会话bean的getcollection()方法(在c++中是collection())后,我们把它显式的转换为一个vector:
::java::util::collection_ptr coll = ceai->collection();
::java::util::vector_ptr cvec = ::java::util::vector::_downcast(coll);
cout << "collection: " << cvec << endl;
最后,注意,我们可以应用那些从ejbobject继承来的远程组件接口方法。如最重要的方法remove()。所以,我们可以得出结论我们的例子中有以下一行:
ceai->remove();
理想的集成
在本文中,我已经说明了在corba和ejb的的集成是可能的。但是,用非java开发一个ebj的客户端并不象你所希望的那么简单,尤其是当你使用那接收和返回对象或是用户定义类型的方法。这是应用ejb组件的绝大多数情况,所以你必须使用corba的值类型。最主要的问题是你还要必须实现java固有的类型。我希望corba的销售商尽快提供值类型的实现,如ibm的websphere应用服务器。我也希望不同的corba产品之间的互操作问题能够尽快解决。
无论如何,当你把一个现有的不是基于java的应用跟新的基于j2ee的方案进行集成时,ejb和corba之间的互操作是十分重要和有用的。
译者说明:
l 在第7节中,采用值类型,当用rmic把java接口映射到idl时,我使用了-novaluemethods,因为如果带着该参数编译出来的idl文件要多一些,再映射到c++后,很难编译过去。
l 即使使用-novaluemethods选项,最后生成的c++程序还是不能完全进行正常地编译和运行(涉及到java固有的那些类型:integer、vector、collection),所以只好将一些语句屏蔽掉了。
|
|