关于jboss 5.0.0 上配置数据源要注意的一个问题

同weblogic不同,在jboss中配置数据源并没有可视化的控制台.一般.大家都是到%JBOSS_HOME%\docs\examples\jca目录下,找到自己所要配置的数据源的模板文件,然后修改jndi-name,connection-url,driver-class,user-name,password,等等,然后把修改后的配置文件丢到要使用的domain下的deploy目录下就可以了,但是这时住往会有个问题.
你会发现,你在客户端查找不到你刚刚配置的数据源.

<datasources>
  <local-tx-datasource>
    <jndi-name>MySqlDS</jndi-name>
    <connection-url>jdbc:mysql://mysql-hostname:3306/jbossdb</connection-url>
    <driver-class>com.mysql.jdbc.Driver</driver-class>
    <user-name>x</user-name>
    <password>y</password>
    <exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.MySQLExceptionSorter</exception-sorter-class-name>
    <metadata>
       <type-mapping>mySQL</type-mapping>
    </metadata>
  </local-tx-datasource>
</datasources>

上面是一个从%JBOSS_HOME%\docs\examples\jca目录下copy下来的配置文件.
以它为例.
我们看一下, 在客户端来查找这个新配置的数据源会出现什么情况呢.


客户端代码如下:
  

Properties  prop=new Properties();
   prop.put(Context.INITIAL_CONTEXT_FACTORY,
   "org.jnp.interfaces.NamingContextFactory");
   prop.put(Context.PROVIDER_URL, "localhost:1099");
   Context  context=new InitialContext(prop);
   context.lookup("MySqlDS"));

  

结果是一大堆异常:

Exception in thread "main" javax.naming.NameNotFoundException: MySqlDS not bound
	at org.jnp.server.NamingServer.getBinding(NamingServer.java:542)
	at org.jnp.server.NamingServer.getBinding(NamingServer.java:550)
	at org.jnp.server.NamingServer.getObject(NamingServer.java:556)
	at org.jnp.server.NamingServer.lookup(NamingServer.java:296)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
  

JNDI查找不到"MySqlDS"这个名称..
为什么呢?
我们去JBOSS的控制台去查看JNDI树结构.

Other components with java:comp namespace
java: Namespace
  +- ClusteredXAConnectionFactory (class: org.jboss.jms.client.JBossConnectionFactory)
  +- jaas (class: javax.naming.Context)
  |   +- messaging (class: org.jboss.security.plugins.SecurityDomainContext)
  +- TransactionPropagationContextImporter (class: com.arjuna.ats.internal.jbossatx.jta.PropagationContextManager)
  +- MySqlDS (class: org.jboss.resource.adapter.jdbc.WrapperDataSource)

很明显"MySqlDS"做为key被绑定在ＪＮＤＩ上了．那么为什么还会出错呢．．．

：　）我浪费了很长时间在找这个错误的过程中，中间甚至一度以为，ＪＢＯＳＳ不支持在服务器外获取数据源．后来一个家伙好像在写ＥＪＢ3.0的时候也遇到这个问题，并且找来了下面这个项文文档．．让我惊为天人啊．．．

<use-java-context> - A boolean indicating if the jndi-name should be prefixed with java: which causes the DataSource to only be accessible from within the jboss server vm. The default is true.

Configuring a DataSource for remote usage
As of jboss-4.0.0 there is support for accessing a DataSource from a remote client. The one change that is necessary for the client to be able to lookup the DataSource from JNDI is to specify use-java-context=false as shown here:

<datasources>  <local-tx-datasource>    <jndi-name>GenericDS</jndi-name>    <use-java-context>false</use-java-context>    <connection-url>...</connection-url>...
This results in the DataSource being bound under the JNDI name "GenericDS" instead of the default of "java:/GenericDS" which restricts the lookup to the same VM as the jboss server.

身为高级知识分子，我相信大家即使读不懂上面的英文，金山词霸总是会使用的．
它说的大概意思就是．
当你指定<use-java-context>的值为false时，你就可以在jboss运行的ＶＭ外的ＶＭ上查找到这个DataSource．
这个属性默认．为true　　　：（　
即，默认情况下你是不可以在ＪＢＯＳＳ的ＶＭ外来查找这个数据源．　

其实吧，这个问题看起来很普通，解决起来也很简单只是加了一行代码，但是．ＪＢＯＳＳ服务器的提供厂商是否有想过，一个example配置文件中，具然少了这种重要的配置信息．
至少你把它配上，然后注掉也好啊．

ＰＳ：上述数据源的配置如果不
      填加 <use-java-context>false</use-java-context>
　　　你基本上就会现，你在ＪＢＯＳＳ上写的第一组EntityBean都会报找不到数据源的错误．    　
　　　各位学习EJB3.0的小哥们留意．．．