`

JNDI ENV 全攻略

EJBJBossJMSJDBCWeb 
阅读更多

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>

分享到：
| 序列化与反序列化
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    jndi-1_2_1.zip_jndi_jndi-1.2.1.jar

    标题中的"jndi-1_2_1.zip_jndi_jndi-1.2.1.jar"表明这是一个关于JNDI的版本1.2.1的开源软件包，其中包含了一个名为"jndi-1.2.1.jar"的JAR文件。这个JAR文件包含了JNDI库的所有实现，使得开发者可以在他们的Java项目...

    Tomcat中JNDI原理

    这段代码中，`InitialContext`是JNDI的标准入口点，`java:comp/env`是默认的上下文名称，而`jdbc/myDataSource`是具体资源的名称。通过这样的机制，`myApp`可以透明地访问其所需的数据源，而无需关心具体的实现细节...

    jndi-tool JNDI服务利用工具

    "jndi-tool"是一个专门针对JNDI服务的利用工具，它可以被用来测试和利用JNDI相关的安全漏洞。此工具特别关注RMI和LDAP服务，这两种服务是JNDI常用的两种协议。RMI允许Java对象在不同的Java虚拟机之间进行远程调用，...

    JNDIDemo 以及相关文档

    Java Naming and Directory Interface (JNDI) 是Java平台中用于访问命名和目录服务的一组API。JNDI允许Java应用程序查找和操作各种类型的资源，如数据源、对象服务、邮件服务器等，而无需知道这些资源的具体实现细节...

    JNDI配置原理详解.doc

    env.put(Context.INITIAL_CONTEXT_FACTORY, "weblogic.jndi.WLInitialContextFactory"); env.put(Context.PROVIDER_URL, "t3://localhost:7001"); InitialContext ctx = new InitialContext(env); ``` 然而，这种...

    初学jndi笔记

    weblogic.jndi.Environment env = new weblogic.jndi.Environment(); env.setProviderURL("t3://127.0.0.1:7001"); env.setSecurityPrincipal("System"); env.setSecurityCredentials("password"); Context ctx...

    JNDI简单应用示例

    Java Naming and Directory Interface (JNDI) 是Java平台中用于访问命名和目录服务的一组API。它提供了一种标准的方法来查找和绑定数据，这些数据可以是对象引用、配置信息或者其他资源。JNDI通常与Java应用程序...

    tomcat6.0连接通过JNDI连接mysql实例

    * 通过 JNDI 查找数据源，该 JNDI 为 java:comp/env/jdbc/sjxbbs， * 分成两个部分。java:comp/env 是 Tomcat 固定的， * Tomcat 提供的 JNDI 绑定都必须加该前缀。 * jdbc/sjxbbs 是配置文件中定义的数据源名。...

    04_JNDI.pdf

    env.put(Context.INITIAL_CONTEXT_FACTORY, "weblogic.jndi.WLInitialContextFactory"); env.put(Context.PROVIDER_URL, "t3://localhost:7001"); env.put(Context.SECURITY_PRINCIPAL, "system"); env.put(Context....

    jndi数据库查询例子

    **JNDI（Java Naming and Directory Interface）数据库查询例子** JNDI是Java平台中用于查找和绑定资源的接口，它允许程序通过名称查找数据源、对象服务等。在Java应用中，特别是企业级Java应用中，JNDI被广泛用于...

    java jndi的使用

    例如，一个常见的JNDI名称可能是`java:comp/env/jdbc/MyDataSource`。 使用JNDI的步骤大致如下： 1. **初始化初始上下文**：首先，我们需要创建一个初始上下文（InitialContext）对象，它是所有JNDI操作的起点。这...

    JNDI学习文档.doc

    **Java Naming and Directory Interface (JNDI) 是Java平台中用于访问命名和目录服务的一组API。它提供了一个统一的接口来查找、访问和管理分布式系统中的资源，如数据库连接池、邮件服务器、对象服务等。JNDI的核心...

    jndi用到的所有jar

    描述中提到的"jndi数据源（保证最全的jar）"意味着这个压缩包可能包含了支持JNDI数据源的各种库，包括但不限于以下： 1. **javax.naming** 和 **javax.naming.directory**：这是Java标准版（Java SE）提供的核心...

    JNDI Java操作示例

    2. **设置参数**：将`adminName`, `adminPassword`, `ldapURL`以及JNDI相关的属性放入`env`中。 3. **创建初始上下文**：使用`InitialDirContext`类的构造函数，传入`env`参数，创建初始上下文。 4. **执行LDAP操作*...

    j2ee JNDI 存储 和 读取程序 weblogic

    - 将配置好的数据源绑定到一个JNDI名称，例如"java:comp/env/jdbc/MyDataSource"。 2. **在Java代码中查找并使用数据源**： ```java Context initialContext = new InitialContext(); DataSource dataSource = ...

    JNDI (1)

    **JNDI（Java Naming and Directory Interface）**是Java平台中的一个重要组件，它提供了一种标准的接口，用于在分布式环境中查找和管理资源。JNDI允许Java应用程序通过名字来查找和绑定各种类型的网络资源，如数据...

    配置 JNDI 数据源

    &lt;property name="jndiName" value="java:comp/env/jdbc/MyDataSource"/&gt; ``` 这里，`jndiName`属性对应于Tomcat中设置的JNDI数据源名称。 2. Tomcat配置：在Tomcat的`conf/server.xml`文件中，需要添加一个...

    JNDI配置详细介绍

    ### JNDI配置在Tomcat中的详细介绍 JNDI（Java Naming and Directory Interface）是Java平台的一个标准接口，用于访问命名和目录服务。在企业级应用中，JNDI常被用于查找和引用各种资源，如数据库连接、消息队列等...

    jndi连接数据库配置方法

    首先，创建一个`InitialContext`实例，然后调用其`lookup()`方法，传入你之前设定的JNDI名称，例如`"java:comp/env/jdbc/MyDB"`。 ```java Context initialContext = new InitialContext(); DataSource ...

    从实例看JNDI设计

    例如，`ctx.lookup("java:comp/env/jdbc/MyDB")`会查找名为"jdbc/MyDB"的数据源。 3. **绑定资源**：如果需要将一个对象绑定到Name Space，可以使用`bind`方法。例如，`ctx.bind("myBean", myBeanInstance)`将...

Magicbox
Global site tag (gtag.js) - Google Analytics