J2EE学习笔记六：本地与远程接口

本地接口(Local Interface)是EJB的特征之一，它的主要目的是提高位于同一EJB容器中的企业bean(enterprise bean)之间相互访问的性能。比如说，一个会话bean要调用某个实体bean中的一些方法，并且这个会话bean和实体bean存在于同一个EJB服务器中，那么使用本地接口速度就会更快并且耗费更少的资源，因为此时会话bean和实体bean在同一个JVM中运行，它们使用的是Java内存reference而不是Java RMI来传递数据。一个enterprise bean是该使用本地接口还是远程接口，可以遵循如下的规则：

●如果一个会话bean的方法要被位于其所在EJB服务器之外的客户端调用，那么这个会话bean要使用远程接口

●如果一个会话bean的方法仅仅被位于同一EJB服务器中的其它bean所调用，那么这个会话bean应该使用本地接口

●实体bean应该使用本地接口

一个接口如何本地化呢？对于Home Interface而言，它现在需要继承EJBLocalHome接口，相应地，对于Bean Interface而言，它需要继承EJBLocalObject接口。除此之外，因为本地接口不再使用RMI来传递数据，因此它的方法不用再抛出RemoteException了。 下面是一个简单使用了本地接口的实体bean的例子：

LocalStock.java：本地Bean Interface
package local;

import javax.ejb.EJBLocalObject;

public interface LocalStock extends EJBLocalObject  ...{
  // the public business methods on the Stock bean
  // these include the accessor methods from the bean
  
  // get the ticker. do not allow ticker to be set through the
  // interface because it is the primary key.
  public String getTickerSymbol();
  
  // get and set the name
  public String getName();
  public void setName(String name);
}

LocalStockHome.java：本地Home Interface
package local;

import javax.ejb.CreateException;
import javax.ejb.EJBLocalHome;
import javax.ejb.FinderException;

public interface LocalStockHome extends EJBLocalHome ...{
  // the create method for the Stock bean
  public LocalStock create(String ticker, String name)
    throws CreateException;
  
  // the find by primary key method for the Stock bean
  public LocalStock findByPrimaryKey(String ticker)
    throws FinderException;
}

StockBean .java：Bean Class
package local;

import javax.ejb.CreateException;
import javax.ejb.EntityBean;
import javax.ejb.EntityContext;

public abstract class StockBean implements EntityBean ...{

  // keeps the reference to the context
  private EntityContext _context;

  // the abstract access methods for persistent fields
  public abstract String getTickerSymbol();
  public abstract void setTickerSymbol(String ticker);
  
  public abstract String getName();
  public abstract void setName(String name);
  

  // standard entity bean methods

  public String ejbCreate(String ticker, String name)
    throws CreateException ...{

    setTickerSymbol(ticker);
    setName(name);
    return null;
  }
         
  public void ejbPostCreate(String ticker, String name)
    throws CreateException ...{ }

  public void setEntityContext(EntityContext ctx) ...{
      _context = ctx;
  }
    
  public void unsetEntityContext() ...{
      _context = null;
  }
    
  public void ejbRemove() ...{ }
  public void ejbLoad() ...{ }
  public void ejbStore() ...{ }
  public void ejbPassivate() ...{ }
  public void ejbActivate() ...{ }
}