JNDI ENV 全攻略- -转自http://jeffzhang.blogdriver.com/jeffzhang/635537.html

JNDI ENV 全攻略- -

                                       来自http://jeffzhang.blogdriver.com/jeffzhang/635537.html

 

ENC的概念:

 

The application component environment is referred to as the ENC, the enterprise naming context.

 

应用组件的业务逻辑应该是ENC中取得对象。组件提供者使用标准的部署描述符指定必需的ENC入口。这些ENC入口是运行时组件所依赖的资源等信息。

 

一个应用组件实例使用JNDI定位ENC。ENC的标准JNDI CONTEXT是:java;/comp/env

// Obtain the application component's ENC
Context iniCtx = new InitialContext();
Context compEnv = (Context) iniCtx.lookup("java:comp/env");

 

env环境是一个私有的环境,只能在该组件内部存取。对其它组件是不可见的。比如,EJB1不能存取EJB2的ENV。同样,任何一个客户端代码,不管它是运行在应用服务器的同一个JVM内或者是远程调用,均不能访问这些JNDI。这样的话,组件之间是相互隔离的,不同组件之间可以定义它自己的环境参数。比如EJB1可以定义自己的环境变量参数:java:comp/env/red

 

1、JBOSS的命名空间:

比如一个命名: java:comp/env  凡是绑定在java: 名字下面的子环境,均只能在JBOSS 服务器内部才能进行访问。无法进行远程访问,比如DataSource 均被绑定在 java:下面。不能远程访问。而EJB,JTA均被绑定在全局范围之内,能进行远程访问。

 

一些惯用的ENV:

ENV 用env-entry 进行申明。

ejb引用用 ejb-ref,ejb-local-ref 进行申明。

资源管理连接工厂用resource-ref 进行申明。

资源环境变量引用用resource-env-ref进行申明。

 

1.1 Environment Entries

例子:

<session>
    <ejb-name>ASessionBean</ejb-name>
    <!-- ... -->
    <env-entry>
        <description>The maximum number of tax exemptions allowed </description>
        <env-entry-name>maxExemptions</env-entry-name>
        <env-entry-type>java.lang.Integer</env-entry-type>
        <env-entry-value>15</env-entry-value>
    </env-entry>
    <env-entry>
        <description>The tax rate </description>
        <env-entry-name>taxRate</env-entry-name>
        <env-entry-type>java.lang.Float</env-entry-type>
        <env-entry-value>0.23</env-entry-value>
    </env-entry>
</session>

 

 ENC env-entry access code fragment

InitialContext iniCtx = new InitialContext();

Context envCtx = (Context) iniCtx.lookup("java:comp/env");

Integer maxExemptions = (Integer) envCtx.lookup("maxExemptions");

Float taxRate = (Float) envCtx.lookup("taxRate");

1.2 EJB Reference

在开发过程,有时候需在EJB之间进行相互引用。这个引用一般均要根据JNDI名字才能进行,但JNDI名字是在部署时才能决定。因此需要一种手段,引用在部署时的另一个EJB,ejb-reference就是为了满足这种要求。

ejb reference 是一个在应用组件命名环境下指向一个部署时EJB HOME的链接。J2EE规范推荐所有的此种链接应接被组织在java:/comp/env/ejb命名空间下。

<session>
    <ejb-name>ShoppingCartBean</ejb-name>
    <!-- ...-->
</session>

<session>
    <ejb-name>ProductBeanUser</ejb-name>
    <!--...-->
    <ejb-ref>
        <description>This is a reference to the store products entity </description>
此属性可选

        <ejb-ref-name>
ejb/ProductHome</ejb-ref-name>
        <ejb-ref-type>
Entity</ejb-ref-type>  只能选Entity与Session

        <home>
org.jboss.store.ejb.ProductHome</home>
    </ejb-ref>
    <remote> org.jboss.store.ejb.Product</remote>
</session>

<session>
     <ejb-name>ShoppingCartUser</ejb-name>
        <!--...-->

     <ejb-ref>
        <ejb-ref-name>
ejb/ShoppingCartHome
</ejb-ref-name>
        <ejb-ref-type>
Session
</ejb-ref-type>
        <home>
org.jboss.store.ejb.ShoppingCartHome
</home>
        <remote>
org.jboss.store.ejb.ShoppingCart
</remote>
        <ejb-link>
ShoppingCartBean</ejb-link> 

            指向同一个EJB JAR 或 同一个 APPLICATION UNIT中的一个EJB,且是该 EJB的名字。
    </ejb-ref>
</session>

<entity>
    <description>The Product entity bean </description>
    <ejb-name>ProductBean</ejb-name>
    <!--...-->
</entity>

ejb-ref的范围是属于申明此段属性的EJB组件。这就意味着其它的应用组件在运行时不能访问这些属性。其它组件定义相同的名字也不会引用名称冲突。

 

InitialContext iniCtx = new InitialContext();
Context ejbCtx = (Context) iniCtx.lookup("java:comp/env/ejb");
ShoppingCartHome home = (ShoppingCartHome) ejbCtx.lookup("ShoppingCartHome");

 

JBOSS的引用方法:

<session>
    <ejb-name>ProductBeanUser</ejb-name>
    <ejb-ref>
        <ejb-ref-name>ejb/ProductHome</ejb-ref-name> 
对应于ejb-jar.xml文件中的ejb-ref-name元素

        <jndi-name>jboss/store/ProductHome</jndi-name>
    </ejb-ref>
</session>
                       
<entity>
    <ejb-name>ProductBean</ejb-name>
    <jndi-name>jboss/store/ProductHome</jndi-name>
     <!-- ... -->
</entity>

 

从上面可以看出,如果ejb/ProductHome的引用被重新定向给了jndi-name : jboss/store/ProductHome

 

1.3 EJB Local Reference

EJB 2.0 增加了 ejb local reference , 从而从语义学的角度保证该引用为本地引用,而不是通过RMI的方式。

    <session>
        <ejb-name>
Probe
</ejb-name>
        <home>org.jboss.test.perf.interfaces.ProbeHome</home>
        <remote>org.jboss.test.perf.interfaces.Probe</remote>
        <local-home>org.jboss.test.perf.interfaces.ProbeLocalHome</local-home>
        <local>org.jboss.test.perf.interfaces.ProbeLocal</local>
        <ejb-class>org.jboss.test.perf.ejb.ProbeBean</ejb-class>
        <session-type>Stateless</session-type>
        <transaction-type>Bean</transaction-type>
    </session>
    <session>
        <ejb-name>
PerfTestSession
</ejb-name>
        <home>
org.jboss.test.perf.interfaces.PerfTestSessionHome
</home>
        <remote>
org.jboss.test.perf.interfaces.PerfTestSession
</remote>
        <ejb-class>
org.jboss.test.perf.ejb.PerfTestSessionBean
</ejb-class>
        <session-type>
Stateless
</session-type>
        <transaction-type>
Container
</transaction-type>
        <ejb-ref>
            <ejb-ref-name>
ejb/ProbeHome
</ejb-ref-name>
            <ejb-ref-type>
Session
</ejb-ref-type>
            <home>
org.jboss.test.perf.interfaces.SessionHome
</home>
            <remote>
org.jboss.test.perf.interfaces.Session
</remote>
            <ejb-link>
Probe
</ejb-link>
        </ejb-ref>
        <ejb-local-ref>
            <ejb-ref-name>
ejb/ProbeLocalHome
</ejb-ref-name>
            <ejb-ref-type>
Session
</ejb-ref-type>
            <local-home>
org.jboss.test.perf.interfaces.ProbeLocalHome
</local-home>
            <local>
org.jboss.test.perf.interfaces.ProbeLocal</local>

            EJB local interface 的全限定名
            <ejb-link>
Probe</ejb-link>
        </ejb-local-ref>
    </session>

 

存取的语法:

InitialContext iniCtx = new InitialContext();
Context ejbCtx = (Context) iniCtx.lookup("java:comp/env/ejb");
ProbeLocalHome home = (ProbeLocalHome) ejbCtx.lookup("ProbeLocalHome");

 

1.4 Resource manaager connection factory reference

由一系列的resource-ref 组成。每个引用以下几个子节点:

description (optional)

res-ref-name :   java:/comp/env 下面的相关的名字

res-type     :   资源的类型,资源管理器连接工厂的全限定名称。

res-auth     :   资源需要的权限管理。 分两种:Application或 container

res-share-scope (optional) : 目前JBOSS不支持。

 

J2EE规范推荐所有资源引用都组织在java:/comp/env 名称空间之下,并且每类资源有自己的子命名空间。

比如:JDBC DataSource Reference should be declared in the java:/comp/env/jdbc subContext.

      JMS connection factories should be declared int the java:/comp/env/jms subContext. 

 

一个在WEB.XML文件中的引用例子:

<web>
    <!-- ... -->
    <servlet>
        <servlet-name>AServlet</servlet-name>
        <!-- ... -->
    </servlet>
    <!-- ... -->
    <!-- JDBC DataSources (java:comp/env/jdbc) -->
    <resource-ref>
        <description>
The default DS
</description>
        <res-ref-name>
jdbc/DefaultDS</res-ref-name> 该名称必须与下面的描述文件中的一致

        <res-type>
javax.sql.DataSource</res-type>
        <res-auth>
Container
</res-auth>
    </resource-ref>
    <!-- JavaMail Connection Factories (java:comp/env/mail) -->
    <resource-ref>
        <description>
Default Mail
</description>
        <res-ref-name>
mail/DefaultMail
</res-ref-name>
        <res-type>
javax.mail.Session
</res-type>
        <res-auth>
Container
</res-auth>
    </resource-ref>
    <!-- JMS Connection Factories (java:comp/env/jms) -->
    <resource-ref>
        <description>
Default QueueFactory
</description>
        <res-ref-name>
jms/QueueFactory
</res-ref-name>
        <res-type>
javax.jms.QueueConnectionFactory
</res-type>
        <res-auth>
Container
</res-auth>
    </resource-re>

 

程序中进行引用:

Context initCtx = new InitialContext();
javax.mail.Session s = (javax.mail.Session)
initCtx.lookup("java:comp/env/mail/DefaultMail");

 

jboss-web.xml(对应于WEB),jboss.xml(对应于ejb) 文件提供res-ref-name对JNDI名字的转换。

这是通过在jboss.xml 或 jboss-web.xml 文件中提供 resource-ref 完成的。

 

比如:

<jboss-web>
    <!-- ... -->
    <resource-ref>
        <res-ref-name>
jdbc/DefaultDS
</res-ref-name>
        <res-type>
javax.sql.DataSource
</res-type>
        <jndi-name>
java:/DefaultDS</jndi-name>  将资源引用重定向到JNDI上面

    </resource-ref>
    <resource-ref>
        <res-ref-name>
mail/DefaultMail</res-ref-name>
        <res-type>
javax.mail.Session
</res-type>
        <jndi-name>
java:/Mail
</jndi-name>
    </resource-ref>
    <resource-ref>
        <res-ref-name>
jms/QueueFactory
</res-ref-name>
        <res-type>
javax.jms.QueueConnectionFactory
</res-type>
        <jndi-name>
QueueConnectionFactory
</jndi-name>
    </resource-ref>
    <!-- ... -->
</jboss-web>

 

Resource Environment References 提供了 resource 本身需要使用的资源。

<session>
    <ejb-name>MyBean</ejb-name>
   
    <resource-env-ref>
        <description>This is a reference to a JMS queue used in the
            processing of Stock info
        </description>
        <resource-env-ref-name>
jms/StockInfo
</resource-env-ref-name>
        <resource-env-ref-type>
javax.jms.Queue
</resource-env-ref-type>
    </resource-env-ref>
    <!-- ... -->
</session>

 

在程序中访问:

InitialContext iniCtx = new InitialContext();
javax.jms.Queue q = (javax.jms.Queue)
envCtx.lookup("java:comp/env/jms/StockInfo");

 

同样道理,特定平台仍需提供 resource-env-ref-name 至 JNDI 的转换,比如在JBOSS.xml文件中:

<session>
    <ejb-name>MyBean</ejb-name>        
        <resource-env-ref>
        <resource-env-ref-name>
jms/StockInfo
</resource-env-ref-name>
        <jndi-name>
queue/StockInfoQueue</jndi-name>   此为真正的全局JNDI名字

    </resource-env-ref>
    <!-- ... -->
</session>

 

以上为四类ENV的定义与引用。
 
  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值