ITPub博客

首页 > Linux操作系统 > Linux操作系统 > [转载]如何编写Enterprise bean的客户端

[转载]如何编写Enterprise bean的客户端

原创 Linux操作系统 作者:dinner1007 时间:2019-03-15 21:42:05 0 删除 编辑
如何编写Enterprise bean的客户端
一、Enterprise JavaBean的客户视图:

  Enterprise JavaBean客户是一个独立的应用程序,或者是一个Servlet,或者一个Applet,还或者另一个Enterprise JavaBean。无论如何,客户要使用一个Enterprise JavaBean必须要做如下事情:


首先要JavaBean的home接口:EJB 规范里面要求客户应该使用Java的名字和目录接口JNDI(Java Naming and Direcotry Interface)API来定位Bean的home接口。


然后获得Enterprise JavaBean的remote接口的引用:可以使用Enterprise bean的home接口中定义的方法。可以产生一个会话bean,也可以产生或寻找(find)一个实体bean。


调 用Enterprise JavaBean中定义的方法:客户并不直接调用Enterprise JavaBean中定义的方法。而是通过调用在 Enterprise JavaBean的remote接口中暴露给用户的方法来使用JavaBean类中的方法。在remote接口中定义的方法就是在 JavaBean中希望暴露给用户,让用户使用的方法。


初始化客户:

  在IAS所带的例子里面,作为客户的SortClient应用程序引入了必要的JNDI类、还引入了SortBean的home接口和remote接口。客户使用JNDI的API来定位Enterprise JavaBean的Home接口。

定位Home接口:

   客户用JNDI定位home接口。首先需要获得一个JNDI的初始化的上下文context。下面的代码实例化了一个新的 javax.naming.Context类。在我们这个例子中叫做initialContext。然后,客户就可以使用上下文的lookup()方法从 一个名字对应到home接口。注意,初始的命名上下文工厂的初始化是由EJB容器/服务指定的。

  上下文的lookup()方法返 回了一个java.lang.Object的对象。代码必须把返回的对象转成所希望的类型。下面的代码是SortClient例子中的一段代码。Main ()从使用JNDI服务开始,并用上下文的lookup()方法来定位home接口。将remote接口的名字(在这个例子中是sort)传递给 context.loopup()方法。注意,程序最后将context.lookup()方法的结果传递给了SortHome,home接口的类型。


用JNDI定位home接口:

// SortClient java

import javax.naming.InitialContext;

import SortHome; // 引入bean的home接口

import Sort; // 引入bean的remote接口

public class SortClient {

……

public static void main(String[] args) throws Exception

javax.naming.Context context;

{ // 用命名服务获得JNDI上下文

context = new.javax.naming.InitialContext();

}

Object objref = context.lookup(sort);

SortHome home = (SortHome)javax.rmi.PortableRemoteObject.narrow(objref,

SortHome class);

Sort sort = home.create();

//做排序工作

sort remove();

}

maint()首先抛出一个普通的异常Excepion。当代码执行到这儿的时候,就算可能会导致程序的终止,客户也需要捕获任何发生的异常。

获得remote接口:

   现在我们获得了Enterprise JavaBean的home接口,然后,使用home接口的create()方法或者finder()方法就可以 获得其remote接口了。实际使用哪个方法取决于Enterprise JavaBean的类型和Enterprise JavaBean的提供者在 home接口定义的方法。

  例如:上面的代码显示了客户SortClient如何获得Sort的remote接口的引用。一旦 SortClient获得了home接口的引用并将之转化为适当的类型(这里是SortHome),客户就可以产生bean的实例,并调用它的方法。本例 子中调用了home接口的create()方法,方法返回了remote接口的引用。(因为这个例子里面SortBean是一个无状态的会话bean,其 home接口只有一个create()方法,这个方法没有任何参数)。然后,SortClient就能够调用定义在remote接口中的方法:sort ()和merge()来进行排序工作。当排序工作完成的时候,客户调用remote接口的remove方法来删除Enterprise bean的实例。


会话Bean:

  客户通过调用home接口中的Create()方法获得Enterprise JavaBean的remote接口的引用。

   每一个会话Bean都必须至少有一个Create()方法。无状态的会话bean只能有一个Create()方法,并且这个Create()方法不能有 参数。有状态的Session bean可以有一个不带参数的Create()方法,也可以有另外的带有不同参数的create()方法。Create ()方法中的参数是用来初始化的会话bean的。

  缺省的create()方法没有参数。例如,Sort例子使用了一个无状态的会话bean。根据定义,它有一个没有参数的create()方法。

   Sort sort=home.create();

   我们比较一下另一个例子:Cart例子,使用的是有状态的会话bean。在其home接口中实现了多个的create()方法。其中一个create ()方法带了三个参数,三个参数用来标识cart的购买者,返回了Cart的home接口的引用。Cart客户先将三个参数的值给 cartHoldName,creditCartNumber和expirationDate这三个变量,然后调用create()方法。其代码如下:

如何调用create()方法的代码:

Cart cart;

{

String cartHolderName=”Jack B.Quick”

String creditCartNumber = “345-346-32525252”

Date expirationDate = new GregorianCalendar(2001, Calendar JULY, 1) getTime();

Cart = home.create(cartHolderName,creditCartNumber,expirationDate);

}

另外,要注意的是,会话Bean没有finder方法。


实体 bean:

   通过finder方法,或者通过create方法,客户得到实体对象的引用。我们在前面提到,实体对象代表了存储在数据库中的某些数据。既然 Entity bean代表了一些持久的数据,那么通常实体bean存在相对长的一段时间,肯定比客户调用它的时间要长,这样,客户通常需要寻找一个代表 了数据库中它感兴趣的那一段数据的实体bean,而不是创建(create)一个实体bean。Create操作将会产生一个新的数据,并将新的数据存在 底层的数据库中。

  客户通过find操作来定位一个已经存在的实体bean。可以是相关数据库里面指定的行。也就是说, finder操作定位一个原来已经插入到数据库中的数据实体。这个数据也许已经被实体bean加入到数据库中,也许已经被加入到EJB上下文的外部(例如 是数据库管理系统DBMS)。或者是在原有系统中,这数据的在安装EJB之前就已经存在。

  客户使用create方法产生一个新的 数据实体,并将数据实体存放在底层的数据库中。实体bean的create方法将实体数据插入到数据库中,用create方法的参数初始化实体的变量。实 体bean的create方法总是返回一个remote接口。但是,对应的ejbcreate()方法是返回实体Bean实例的主键。

  每一个实体bean都必须有一个主键值来唯一标识它。一个实体bean也可以有次键值,用来定位特定的实体对象。


Find方法和主键类:

  一个实体bean的缺省的find方法是findByPrimaryKey()方法。它通过主键来定位实体bean。其语法如下:

findByPrimaryKey( primary key)

  每一个实体bean必须实现findByPrimaryKey方法。PrimaryKey参数是一个独立的定义在配置描述器中的主键类。键的类型是主键,而且必须是RMI-IIOP合法的值。键类可以是任何Java类或者你自己写的类。

   例如,你可能有一个名字为Acount的实体bean。已经将它的主键类定义为AccountPK。AccountPK是一个字符串类型。它拥有 Account bean的标识。我们将account bean的标识设为AccountPK,然后调用findByPrimaryKey方法,就可以 得到account bean实例的引用。如下代码所示:

Finding a Entity bean instance using the primary key

AccountPK accountPK =new AccountPK(“1234-56-789”);

Account source = accountHome.findByPrimaryKey(accountPK);

Bean的提供者可以定义另外的finder方法给客户使用。


Create()方法和remove()方法:

   客户也能够用home接口中定义的create()方法来创建一个实体bean。当客户调用实体bean的create()方法的时候,一个新的实体 bean的实例就存到数据仓库中。新实例总是有一个标识它的主键值。它的状态可以用create方法传递的参数值来初始化。

  注 意:实体bean存在的时间与它在数据库中代表的数据是一样的。其生命并不由与客户的会话来决定。通过调用实体bean的remove方法,可以将实体 bean删除。Remove方法不仅将实体bean删除,也将它所代表的数据从数据库中删除。另外也可以直接删除实体bean。例如,可以通过用原来的应 用程序或用DBMS删除数据库中的一条记录的方法来删除。


调用方法:

  一旦客户获得了bean的 remote接口的引用。就可以调用在remote接口中为enterprise bean定义的方法。属于此bean的应用逻辑的方法才是客户感兴趣 的。也有一些方法是用来获得enterprise bean的信息或者接口信息的。例如:获得bean对象的handle,检查一个bean是否与另一个 bean相同,删除bean的方法。

  下面的代码解释了客户如何调用enterprise bean中的方法。这个例子调用的是 Cart 这个会话bean。代码从产生一个新的Cart bean实例并重新找到一个cart bean实例的remote接口的引用开始。从这里开 始,客户就准备好可以调用bean的方法。

  首先,客户创建了一个新的book对象,设定了其title 和price参数。然 后,调用了enterprise bean的应用方法addItem()来将一个book对象加到shopping cart中去。AddItem()方 法是在CartBean 这个会话bean中定义的,通过Cart的remote接口把它变成公共的方法。客户增加了一项其它的东西,然后用 summairze()方法列出shopping cart里面的所有的Items。最后,就调用remove方法来删除bean的实例。注意,客户用调 用其他的方法也是通过同样的途径,即使是自己定义的方法summarize()。

调用Bean的方法

………

Cart cart;

{



//获得bean的remote接口的实例。

Cart = home.create(cartHodlerName,creditCardNumber,expirationDate);

}

//创建一个新的book对象。

Book knuthBook = new Book(“The Art of Computer Programming”,49.95f);

//将新书加到Cart中。

Cart.addItem(knutBook);

………

//列举当前Cart中的书

summarize(cart);

cart.removeItem(knutBook);

……


删除bean的实例:

   remove方法对会话bean的操作和对实体bean的操作是不同的。因为对于客户来说,会话对象的存在是不持久的。会话对象的客户在完成了会话之后 需要调用remove方法。对客户来说,有两个remove方法可以调用:可以用javax.ejb.EJBObject.remove()方法来删除会 话bean;也可以用javax.ejb.EJBHome.remove(Handle handle)方法来删除会话bean的handle。

   一个好的编程风格是不需要由客户删除一个会话bean对象。如果客户没有删除一个有状态的会话bean,容器在过了一段时间(指定的超时值 timeout value)之后会自动删除这个对象。Timeout value是一个配置属性。但是,客户能够为以后的引用保持这个对象的 handle。

  Entity bean的客户不需要考虑这个问题,因为实体bean只是在客户的事务期间。由容器负责它的生命周期,包括激活和钝化。只是当客户需要将实体对象从底层数据库中删除的时候,才调用remove方法。

使用bean的句柄:

   句柄是用来引用enterprise bean的另一种方法。句柄相当于bean的一个较长的指针。你可以从remote接口获得句柄。一旦你拥有了句 柄,就可以将它写入到文件或其它的持久存贮器里面。便于以后可以重新得到句柄,用它来重新建立enterprise bean的引用。

  但是,你只能用remote接口的句柄来重新建立bean的引用。你不能用句柄来创建bean本身。如果另一个进程删除了bean,或者系统崩溃或关闭,删除了bean的实例,则当应用程序试图用句柄重新建立对bean的引用时会抛出异常。

  当你不确定bean的实例是否依然存在的时候,你可以不用remote接口的句柄。而是保存bean的home接口的句柄,在以后要用的时候再通过调用create方法或finder方法重新创建bean对象。

   在客户创建了bean的实例以后,就能够用getHandle()方法来获得实例的句柄。一旦拥有的句柄,就能够将它写到文件里面去。在以后的时间,客 户可以读这个文件,将读出来的对象转化为句柄类型。然后,就可以在句柄上调用的getEJBObject方法来获得bean的引用。最后再将 getEJBObject方法返回的值转化为合适的类型。

使用句柄来引用一个Bean

Import java.io;

Import javax.ejb.Handle;

……

Cart cart;

……

cart = home.create(cartHolderName,creditcartNumber,expirationDate);

//在cart对象上调用getHander方法来获得它的句柄。

CartHander=cart.getHandler();

//将hander写到文件中去。

FileOutputStream f = new FileOutputStream(“carthandle.ser”);

ObjectOutputStream o = new ObjectOutputStream(f);

o.writeObject(myHandle);

o.flush();

o.close();

……

//在以后的某个时间,可以从文件中读出handle

FileInputStream fi = new FileInputStream(“carthandle.ser”);

ObjectInputSteam oi = new ObjectInputStream(fi);

//从文件中读出对象并将它转化为Hander类型。

CartHanle = (Handle)oi.readObject();

Oi.close;

……

//使用handle来引用bean的实例

try{

Object ref = context.lookup(“cart”);

Cart cart1 = (Cart)javax.rmi.PortableRemoteObject.narrow(ref,Cart.class);

……

}catch(RemoteException e){

……

}

……

  当用完会话bean的句柄以后,客户将使用javax.ejb.EJBHome.remove(Handle handle)方法来删除句柄。


二、管理事务:

  客户程序能够管理它自己的事务,而不是让enterprise bean或者是容器来管理。客户管理自己事务的时,就好象会话bean管理它自己的事务一样。

  当客户管理自己的事务的时候,需要自己来描述事务的分界线。这也就是说,它必须明确的开始一个事务和终止(提交或回滚)一个事务。

   客户使用javax.transaction.UserTransaction接口来管理它自己的事务。它必须首先用JNDI来获得 UserTransaction接口的引用。一旦有了UserTranscation的上下文,就可以用UserTransaction.begin() 方法来开始一个事务(后面用UserTranscation.commit()方法提交或Usertransction.rollback()方法回滚这 个事务)。这之间客户做有关的查询和更新操作。

  如下代码演示了客户如何实现管理它自己的事务。客户管理的属于协议的那部分用粗体显示:

客户管理事务:

import javax.naming.initialContext;

import javax.transcation.UserTransaction;

……

public class clientTransaction{

public static void main(String[] argv){

UserTranscation ut=null;

InitialContext initContext = new InitialContext();

……

ut = (UserTransaction)initContext.lookup(“java:comp/UserTranscation”);

//开始一个事务

ut.begin();

//做事务工作。

……

ut.commit(); //or ut.rollback();

}

}


三、获得enterprise bean的信息:

  enterprise bean的信息是一个指向metadata引用。客户使用enterprise bean的home接口的getMetaData()方法能够获得bean的metadata信息。

  GetMetaData()方法经常被开发环境和build工具所使用,因为它们需要知道enterprise bean的相关信息,例如哪些链接到一起的bean已经被安装。脚本客户也需要获得bean的metadata信息。

  一旦客户重新得到home接口的引用。就能够在home接口上调用getEJBMetaData()方法。然后,客户就可以通过调用EJBMetaData接口上的方法来取得如下信息。

  用EJBMetaData.getEJBHome()方法获得bean的EJBHome接口。


  用EJBMetaData.getHomeInterfaecClass()方法来获得home接口类的对象。包括其接口,类,域和方法。


  用EJBMetaData.getRemoteInterfaceClass()方法来获得remote接口类的对象。包括所有的类信息。

  用EJBMetaData.getPrimaryKeyClass()方法来获得bean的主键类对象。

  不管是会话bean还是实体bean。可用EJBMetaData.isSession()方法来判断。

  用EJBMetaData.isStatelessSession()来判断会话bean是否有状态还是无状态的。


四、JNDI的支持:

  EJB规范定义了定位home接口的API。JNDI是在其它的服务(CORBA的命名服务,LDAP/X.500,flat files,目录服务)上面实现的。下图解释了不同的实现选择。典型的,EJB服务提供者选择一个特定的JNDI实现。



  这个技术实现了JNDI底层的与客户无关性。客户只需要使用JNDI的API就可以了。


五、EJB到CORBA的映射:

  EJB和CORBA之间有许多的联系。有三点很重要:

  用ORB实现EJB容器/服务。


  将原有系统放到EJB中间层的综合能力。


  从非java组件的客户,访问EJB的能力。


  EJB规范目前只涉及到这三个方面。

  CORBA是实现EJB下层组织的很适合而且很自然的平台。CORBA提供了所有的EJB规范与CORBA核心规范或者与CORBA核心服务之间的相关的东西。

持分布式:CORBA核心和CORBA命名服务


支持事务:CORBA对象的事务服务


支持安全:CORBA的安全规范,包括IIOP-over-SSL


  另外:CORBA允许非JAVA组件与应用程序的结合。这些组件可以是原来的系统或程序,将它们插入到不同的客户中去。后端系统能够很容易的用OTS和任何能够与IDL映射的程序设计语言结合在一起。这需要容器提供OTS和IIOP的APIs。


  EJB规范允许非JAVA客户访问enterprise bean,也提供了EJB到CORBA的映射。EJB/CORBA映射的目的是:

  支持用任何CORBA支持的程序设计语言编写的客户端和基于CORBA的EJB服务上的enterprise bean的结合。


  使客户程序在相同的事务处理中与CORBA对象或者enterprise bean相结合。


  支持在涉及到不同代理商提供的多个客户端在基于CORBA的EJB服务器上运行时的分布式事务。


   映射是基于java-to-IDL映射的。其规范包括了如下几个方面:分布式关系的映射,命名约定的映射,事务处理的映射,安全的映射。下面的部分,我 们将解释每一个映射。因为映射用了新的IDL特性,这些特性在OMG的Object-by-Value规范中介绍。与其它语言的结合需要与 CORBA2.3ORB规范兼容。


分布式的映射:

  enterprise bean有两个可以远程访问的接口:remote接口和home接口。IDL规范中有这样的JAVA/IDL到这些接口的映射。EJB规范中定义的基类也是以同样的方式映射到IDL中的。

  例如:让我们看看下面的IDL接口,这是ATM那个例子。是一个enterprise 会话bean。有一个方法在accounts之间转帐。也可以抛出资金不足的异常。通过JAVA/IDL映射其home接口和remote接口。我们得到如下的IDL接口:


Module transaction{

Module ejb{

Valuetype InsufficientFundsException: ::java::lang::Exception{};


Exception InsufficientFundsEx{

::transcation::ejb::InsufficientFundsException value;

};


interface Atm: ::javax::ejb::EJBObject{

void transfer(in string arg[], in string arg1, in float arg2)

raise(::transaction::ejb::InsufficientFundsEx);

};


interface AtmHome: ::javax.:ejb::EJBHome{

::transaction::ejb::Atm create{}

raise(::javax::ejb::CreateEx);

};

};

};


命名映射:

   基于CORBA的EJB运行时环境如果要想让所有的CORBA客户都能够访问enterprise bean,就必须使用CORBA命名服务来发布 enterprise bean的home接口。运行时能够直接使用CORBA的命名服务,或者通过JNDI及其到CORBA命名服务的标准映射来间接的 使用。

  JNDI命名用一个字符串表示成如下形式:“directory1/directory2/…/directotyN/objectName”。CORBA的命名服务将名字定义成一系列的名字组件:

Typedef string Istring;

Struct NameComponet{

Istring id;

Istring kind;

};

typedef sequence Name;

  每一个由”/”分开的JNDI字符串名字都被映射成一个名字组件。最左边的组件就是CORBA命名服务名字的第一个入口。

JNDI字符串名字与一些命名上下文有关。我们把这样的上下文叫做JNDI根部上下文。JNDI根部上下文相当于CORBA的命名服务的初始化上下文。CORBA命名服务的名字与CORBA的初始化上下文有关。

通 过在ORB的虚拟对象上面调用resolv_initial_reference(“NameService”),CORBA应用程序能够得到初始的 CORBA命名服务的上下文。CORBA命名服务并没有指定如何组织命名上下文,这样,根上下文的概念就不起作用了。ORB的初始化通过 resolve_initial_reference()来决定上下文。

例如:一个C++的客户端能够定位我们的ATM会话bean的home接口。这个ATM bean已经用JNDI字符串“transaction/corbaEjb/atm”注册。首先,我们得到初始的命名上下文。

oject_ptr obj = orb->resolve_initial_references(“NameService”);

NameContext initialNameContext = NameingContext.narrow(obj);

if (initialNameingContext == NULL) {

cerr <<”Could not initial naming context” <
exit(1);

}

然后,我们产生了一个CORBA命名服务的名字并且根据上面所说的对它进行初始化。

Name name = new Name(1);

name[0].id=”atm”;

name[0].kind=””;

现在我们解决了初始化命名服务的名字问题。假定我们成功的进行了初始化,我们也有了enterprise bean名字域上的上下文。我们将CORBA对象范围缩小到所需要的类型,并且,确信这样的缩小是成功的。

Object_ptr obj=initialNamingContext->resolve(name);

AtmSessionHome_ptr atmSessionHome = AtmSessionHome.narrow(obj);

if (atmSessionHome == NULL){

cerr<<”Could not narrow to ATMSessionHome” <
exit(1);

}


事务处理的映射:

基于CORBA的enterprise bean运行时环境需要使CORBA的客户端参加到涉及enterprise bean的事务处理中来,就必须使用CORBA的OTS(Object Transaction Service)来进行事务控制。

当enterprise bean配置好之后,能够根据不同的事务服务方针进行安装。方针是定义在配置描述器中的。

事务性的enterprise bean有如下的定义规则:CORBA客户通过IDL接口产生的stub来调用enterprise bean的remote接口和home接口。如果涉及到事务处理,它使用CORBA OTS提供的接口。

例如:一个C++的客户能够调用ATM会话bean:

try{



//obtain transaction current

Object_ptr obj = orb->resolve_initial_reference(“Current”);

Current current = Current.narrow(obj);

if(current==NULL){

cerr<<”Could not resolve current ”<
exit(1);

}

//execute transaction

try{

current->begin();

atmSession->transfer(“checking”,”saving”,100.00);

current->commit(0);

}catch(…){

current->rollback();

}

}catch(…){

……

}


安全的映射:

EJB规范的安全方面主要考虑的是控制enterprise bean的访问权限。CORBA规定了一些方法来定义标识符,包括如下的方面:

Plain IIOP (简单的IIOP方式):CORBA的主要接口在1998年早期并没有被接受。主要的接口用来确定客户的标识。但是,CORBA安全服务的作者却实现了不 同的途径:GIOP。GIOP规范包括了一个叫服务上下文的组件,其实是一个元素为值对的数组。其标识符是CORBA的long型的,值是十进制的序列。 服务上下文的入口可以用来标识调用者。


Secure IIOP(可靠的IIOP方式):CORBA的安全规范为身份定义了一个不透明的数据类型。身份的实际类型是由所选择的安全机制所决定的。例如:GSS Kerberos,SPKM,或者CSI-ECMA。


IIOP over SSL:SSL(加密套接字协议层)用X.509来来证明服务器或者是客户的身份。当服务器需要客户的身份验证的时候,服务器使用这个证书作为客户的身份验证。

来自 “ ITPUB博客 ” ,链接:http://blog.itpub.net/374079/viewspace-131594/,如需转载,请注明出处,否则将追究法律责任。

请登录后发表评论 登录
全部评论

注册时间:2018-08-23

  • 博文量
    433
  • 访问量
    278425