JNDI ENC与依赖注入

JNDI ENC与依赖注入
请搞清楚：通过注解还是XML注册资源，通过注入还查找得到资源，注解与XML等价方式。
以下说的是EJB引用资源

每个部署于应用服务器中的EJB容器都拥有一个属于它自己的内部注册表(internal registry),该内部注册表被称为Enterprise Naming Context(ENC),ENC是由JNDI实现的。开发人员可以通过注解或XML为某个EJB 的JNDI ENC(这是一个局部JNDI)定义资源、EJB或外部环境的别名，而后在编写EJB业务逻辑时，通过别名在JNDI中查找这些引用，在EJB3.0中，还可以把这些引用直接注入到bean数据成员中。

JNDI ENC中可以注册哪些内容
指向EJB接口的引用、JMS队列或主题的目标地址、JMS连接工厂、数据源、任何JCA资源、基本的数据类型常量，还有一些java EE服务(javax.ejb.TimerService、javax.transaction.UserTransaction、org.omg.CORBA.ORB)

如何配置JNDI ENC
ENC的JNDI名字空间可以通过XML或通过注解来定义。

如何从ENC中获取引用
通过InitialContext查找
@Stateful
@EJB(name=”ejb/ProcessPayment”, //类级的注解
beanInterface=ProcessPaymentLocal.class,
beanName=”ProcessPaymentBean”)
public class TravelAgentBean implements TravelAgentRemote{
public TicketDO bookPassage(CreditCarDO card,double amount){
ProcessPaymentLocal payment=null;
try{
//EJB厂商不同，初始化方式也许不同
javax.naming.InitialContext ctx=new InitialContext();
//如果是本地接口，对于其他资源(如EntityManagerFactory等)也是类似的查找方法
payment=(ProcessPaymentLocal)ctx.lookup(
“java:comp/env/ejb/ ProcessPayment”);//使用java:comp/env上下文
//如果是远程接口，要用narrow方法
Object ref= ctx.lookup(“java:comp/env/ejb/ ProcessPayment”);
(ProcessPaymentRemote)javax.rmi.PortableRemoteObject.narrow(ref,
ProcessPaymentRemote.class);
}catch(javax.naming.NamingException ne){…..}……..
}
}

使用EJBContext查找
javax.ejb.SessionContext和javax.ejb.MessageDrivenContext接口都继承自javax.ejb.EJBContext,并且都可以用来查找ENC注册项。
@Stateful
@EJB(name=”ejb/ProcessPayment”,
beanInterface=ProcessPaymentLocal.class,
beanName=”ProcessPaymentBean”)
public class TravelAgentBean implements TravelAgentRemote{
@Resource private javax.ejb.SessionContext ejbContext;
public TicketDO bookPassage(CreditCarDO card,double amount){
ProcessPaymentLocal payment=(ProcessPaymentLocal)ejbContext.lookup(
“ejb/ ProcessPayment”);
……….
}
}

注解注入
import com.titan.travelagent;//包名
@Stateful
public class TravelAgentBean implements TravelAgentRemote{
@EJB private ProcessPaymentLocal payment;//通过成员变量注解直接注入
//默认ENC名称为:com.titan.travelagent.TravelAgentBean/payment;
//或者通过setter方法注解直接注入
@EJB public void setProcessPayment(ProcessPaymentLocal payment){
//默认ENC名称为:com.titan.travelagent.TravelAgentBean/processPayment;
this.payment=payment;
}
}

XML注入
<enterprise-beans>
<session>
<ejb-name>TravelAgentBean</ejb-name>
<ejb-local-ref>
<ejb-ref-name> com.titan.travelagent.TravelAgentBean/payment </ejb-ref-name>注册名
<ejb-ref-type>Session</ejb-ref-type>EJB类型有Session、Entity
<local>com.tian.Processpayment.ProcessPaymentLocal</local>
实现接口的EJB，由于ENC名与注解的一致，这个配置会覆盖注解
<ejb-link>ProcessPaymentBean</ejb-link>
<injection-target> 要直接注入时才用这个配置
<injection-target-class>
com.titan.travelagent.TravelAgentBean
</injection-target-class>
下面的payment也可以使用processPayment,以通过setter注入
<injection-target-name>payment</injection-target-name>
</injection-target>
</ejb-local-ref>
</session>
</enterprise-beans>

XML覆盖
XML可以覆盖注解，它比注解具有一更高的优先级。覆盖方式见上一节,通过XML可以覆盖注解中要引入的实现类。

注入与继承
如果父类的数据成员或成员方法标有注入用注解，则注入父类的引用也会在子类中被引入，子类也可以覆盖父类的注入注解，但是如果父类的方法是private的，那么子类是无法覆盖它的注入注解的，这时父类和子类可能存在两个不同的引用。

不同类型的引用与注入
EJB类型的引用
@java.ejb.EJB用于引入一个EJB，@java.ejb.EJBs用于引入多个EJB
@EJB(name=”ejb/ProcessPayment”, //ENC注册名
beanInterface=ProcessPaymentLocal.class,//接口
beanName=”processPaymentEJB”,//实现这个接口的类，如果有多个类实现这个接口，必须指定这个
mappedName=”….”)//根据EJB容器厂商的不同而有所不同，可能是一个键值，指向厂商的全局注册表
以上注解标注在bean class类之上，表示注册一个引用，要通过lookup查找，如果用于bean class的setter方法或数据成员(类型是EJB的成员)，却表示直接注入

通过XML指定远程EJB引用
<enterprise-beans>
<session>
<ejb-name>TravelAgentBean</ejb-name>//EJB名
<ejb-ref>
<ejb-ref-name> com.titan.travelagent.TravelAgentBean/payment </ejb-ref-name>注册名
<ejb-ref-type>Session</ejb-ref-type> EJB类型有Session、Entity
<remote>com.tian.Processpayment.ProcessPaymentRemote</ remote> 远程接口
<ejb-link>ProcessPaymentBean</ejb-link>实现接口的EJB，如果接口有多个实现类必须配置
<injection-target> 要直接注入时才用这个配置
<injection-target-class>
com.titan.travelagent.TravelAgentBean
</injection-target-class>
<injection-target-name>payment</injection-target-name>也可以使用processPayment
</injection-target>
</ejb-local-ref>
</session>
</enterprise-beans>

通过XML指定本地EJB引用
<enterprise-beans>
<session>
<ejb-name>TravelAgentBean</ejb-name>
<ejb-local-ref>
<ejb-ref-name> com.titan.travelagent.TravelAgentBean/payment</ejb-ref-name>注册名
<ejb-ref-type>Session</ejb-ref-type> EJB类型有Session、Entity
<local>com.tian.Processpayment.ProcessPaymentLocal</local> 本地接口
<ejb-link>ProcessPaymentBean</ejb-link> 与注解beanName等价，表示引用的EJB名。
<injection-target> 要直接注入时才用这个配置
<injection-target-class>
com.titan.travelagent.TravelAgentBean
</injection-target-class>
<injection-target-name>payment</injection-target-name>也可以使用processPayment
</injection-target>
</ejb-local-ref>
</session>
</enterprise-beans>

EJB名称的二义性和重载
对于某个特定的EJB JAR部署包而言，部署描述文件中的<ejb-name>元素及任何@Stateless或@Stateful注解的name属性必须是全局唯一的。但是对于同一个.ear文件的不同EJB-JAR部署包内，EJB名称是可以重复的，这了区分这些EJB，可以使用扩展语法：@EJB(beanName=”inventory-ejb.jar#InventoryEJB”) InventoryLocal inventory;

EntityManagerFactory类型的引用
在应用服务器对ENC进行配置或将EntityManagerFactory注入到EJB中之后，应用服务器会为你管理EntityManagerFactory实例的生命周期。定义引用的方式：
@javax.persistence.PersistenceUnit(name=”persistence/TitanDB”,//JNDI ENC名
unitName=”TitanDB”)//persistence.xml文件中声明的persistence unit名称
该注解标注bean class时，表示不直接注入，如果标注在bean class的setter方法或数据成员上，表示直接注入，如：
@ PersistenceUnit(unitName=”crmDB”)private EntityManagerFactory crm;
如果要引用多个persistenceunit，要使用@PersistenceUnits注解。

通过XML指定EntityManagerFactory类型的引用
<enterprise-beans>
<session>
<ejb-name>TravelAgentBean</ejb-name>
<persistence-unit-ref>
< persistence-unit-ref-name>persistence/TitanDB</persistence-unit-ref-name>注册名
persistence.xml文件声明的persistence unit名
< persistence-unit-ame>TitanDB</ persistence-unit-ame>
<injection-target> 要直接注入时才用这个配置
<injection-target-class>
com.titan.travelagent.TravelAgentBean
</injection-target-class>
<injection-target-name>ships<injection-target-name>
</injection-target>
</ persistence-unit-ref >
</session>
</enterprise-beans>

Persistence Unit名称的作用域及重载问题
可以在不同的地方声明persistence unit，它可以定义在EJB-JAR、EAR/lib目录下的JAR或WAR文件中。如果定义的persistence unit有重名，可以通过这个扩展语法访问：@ PersistenceUnit(unitName=”inventory.jar#InventoryDB”)

EntityManager类型的引用
当将EntityManager注册到JNDI ENC或注入到EJB时，EJB容器会对EntityManager所依赖的persistence contect具有完全的控制权(控制它的生命周期),注册方式与EntityManagerFactory很相似，如：
@PersistenceContext(name”persistence/TitanDB”//JNDI ENC名
unitName=”TitanDB”//与peristence.xml文件中声明的peristence unit名称相同
type=PersistenceContextType.EXTENDED)//表示extended persistence context(方法间事务，只用于 //stateful session)，还有一个取值TRANSACTION。
可以用于标注bean class，当标注在bean class的setter方法或数据成员上时，表示直接注入，如：
@ PersistenceContext(unitName=”crmDB”)private EntityManager crm;

通过XML指定EntityManager类型的引用
<enterprise-beans>
<session>
<ejb-name>TravelAgentBean</ejb-name>
<persistence-context-ref>
<persistence-context-ref-name>persistence/TitanDB</persistence-context-ref-name>名
persistence.xml文件声明的persistence unit名
<persistence-context-ame>TitanDB </persistence-context-ame>
<persistence-context-type>EXTENDED</persistence-context-type>
<injection-target> 要直接注入时才用这个配置
<injection-target-class>
com.titan.travelagent.TravelAgentBean
</injection-target-class>
<injection-target-name>ships<injection-target-name>
</injection-target>
</ persistence- context -ref >
</session>
</enterprise-beans>

资源类型的引用
外部资源同样会被映射到JNDI ENC名字空间中的名称上，并且可以有选择地注入到bean实例的数据成员或setter方法中，被引用的外部资源类型可以是：javax.sql.DataSource、javax.jms.ConnectionFactory、javax.jms.QueueConnectionFactory、javax.jms.TopicConnectonFactory、javax.mail.Session、java.net.URL、javax.resource.cci.ConnectionFactory以及由JCA资源适配器定义的其他类型。下面以javax.sql.DataSource为例。

@javax.annotation.Resource(annotation:注解)
@ Resource注解除了用来引用外部资源，还可以用来引用JMS消息的目标地址、JNDI的环境注册项、EJBContext，以及其他Java EE的核心服务。

@ Resource(name=”jdbc/OracleDB”,//JNDI ENC名
type=javax.sql.DataSource,//引入的类别
authenticationType=AuthenticationType.APPLICATION,
//认证方式，有容器认证(取值CONTAINER，容器根据部署的用户名和密码进行认证)和程序自行认证
//(getConnection时要提供用户名和密码)
shareable=true,//多个EJB在同一事务中是否可以使用相同的资源，使用相同的资源连接，以提高性能
mappedName=”java:/DefaultDS”)//外部资源的厂商专用标识符，大多数情况，它的取值等价于一个 //全局JNDI名。
如果要引用多个资源，可以使用@javax.annotation.Resources注解

通过XML指定资源类型的引用
<enterprise-beans>
<session>
<ejb-name>TravelAgentBean</ejb-name>
<resource-ref>
<res-ref-name>jdbc/OracleDB</res-ref-name>ENC注册名
<res-type>javax.sql.DataSource</res-type>类名
<res-auth>Container</res-auth>
<mapped-name>java:/DefaultDS</mapped-name>
java:/DefaultDS是一个全局JNDI中定义的一个数据源，数据源的配置请查询相关书籍

<injection-target> 要直接注入时才用这个配置
<injection-target-class>
com.titan.travelagent.TravelAgentBean
</injection-target-class>
<injection-target-name>oracle<injection-target-name>
</injection-target>
</resource-ref >
</session>
</enterprise-beans>

资源环境和受管对象
资源环境注册项可以引用包含受管对象的资源，受管对象是一种在部署期间被配置到容器中，并在运行期间由容器负责管理的资源，它的配置书中没有给出例子。资源环境注册项也可可以用于诸如：javax.transaction.Usertransaction和javax.transaction.TransactionSynchronizationRegistry服务,这时定义authenticationType和shareable 是非法的。
<enterprise-beans>
<session>
<ejb-name>TravelAgentBean</ejb-name>
<resource-env-ref>
<resource-env-ref-name>jdbc/OracleDB</resource-env-ref-name>//ENC注册名
<resource-env-ref-type>javax.transaction.Usertransaction</resource-env-ref-type>类
<injection-target> 要直接注入时才用这个配置
<injection-target-class>
com.titan.travelagent.TravelAgentBean
</injection-target-class>
<injection-target-name>utx<injection-target-name>
</injection-target>
</resource-env-ref >
</session>
</enterprise-beans>

环境注册项还可以用来配置String、Integer、Long、Double、Float、Byte、Boolean和Short这些包装类型的常量。
<enterprise-beans>
<session>
<ejb-name>ProcessPaymentBean</ejb-name>
<env-entry>
<env-entry-name>minCheckNumber</env-entry-name>ENC注册名
<env-entry-type>java.lang.Integer</env-entry-type>类名
<env-entry-value>2000</env-entry-value>常量值，这种引用几乎都是用XML来配置的
<injection-target> 要直接注入时才用这个配置
<injection-target-class>
com.titan.processpayment.ProcessPaymentBean
</injection-target-class>
<injection-target-name>minCheckNumber<injection-target-name>
</injection-target>
</env-entry>
</session>
</enterprise-beans>

消息目标地址类型的引用
在JNDI ENC中注册的消息目标地址引用指向JMS的主题或队列。
@Resource(name=”jms/TicketTopic”,//ENC名
type=javax.jms.Topic,//类型，还可以是队列(javax.jms.Queue)
mappedName=”topic/TicketTopic”)//全局的厂商专用标识符
注意，使用注解无法设置目标地址的连接(message-destincton-link)
等价XML
<enterprise-beans>
<session>
<ejb-name>TravelAgentBean</ejb-name>
<message-destination-ref>
<message-destination-ref-name>jms/TicketTopic</message-destination-ref-name>注册名
<message-destination-type>javax.jms.Topic</message-destination-type>消息类型
从目标地址收消息还是向其发消息
<message-destination-usage>Produces</message-destination-usage>
<message-destination-link>Distributor </message-destination-link>消息分发地址
<mapped-name> topic/TicketTopic </mapped-name>
topic/TicketTopic表示主题，它的配置请找相关书籍，原书练习中只讲到配置队列
<injection-target> 要直接注入时才用这个配置
<injection-target-class>
com.titan.travelagent.TravelAgentBean
</injection-target-class>
<injection-target-name>ticketTopic <injection-target-name>
</injection-target>
</ message-destination-ref >
</session>
</enterprise-beans>

Web Service类型的引用
在JNDI ENC中注册的web service引用指向服务的接口或服务的终端接口。19章有详细介绍
<enterprise-beans>
<session>
<ejb-name>TravelAgentBean</ejb-name>
<service-ref>
<service-ref-name>service/ChargeItProcessorService</service-ref-name>ENC注册名
<service-interface>com.charge_it.ProcessorService</service-interface>JAX-RPC服务接口
<wsdl-file>META-INF/wsdl/ChargeItProcesor.wsdl</wsdl-file> WSDL文件位置
<jaxrpc-mapping-file>META-INF/mapping.xml </jaxrpc-mapping-file> JAX-RPC映射文件
<service-qname>chargeIt:ProcessorService</service-qname>与WSDL文件定义的服务名一致
<mapped-name>webservice/ChargeItProcessorService</mapped-name>
webservice/ChargeItProcessorService映射应用服务器全局注册项
<injection-target> 要直接注入时才用这个配置
<injection-target-class>
com.titan.travelagent.TravelAgentBean
</injection-target-class>
<injection-target-name>chargeService <injection-target-name>
</injection-target>
</ message-destination-ref >
</session>
</enterprise-beans>