Acceso a un recurso de origen de datos Java EE existente

Para acceder a un recurso de origen de datos Java™ Platform Enterprise Edition (Java™ EE) definido en la aplicación con la anotación DataSourceDefinition o con el elemento <data-source> del descriptor de despliegue, se puede utilizar el mismo modelo de programación del MBean DataSource y del MBean JDBCProvider que se utiliza para acceder a un origen de datos gestionado de WebSphere Application Server (definido en scripts o en Integrated Solutions Console). Esta característica mantiene la compatibilidad con los scripts existentes, lo que simplifica la gestión de los recursos.

Acerca de esta tarea

Esta tarea muestra mediante ejemplos cómo un MBean representa un recurso de origen de datos Java EE.

Utilización del bean gestionado de origen de datos

Utilice el campo de nombre del MBean DataSource como el nombre JNDI (Java Naming and Directory Interface) con caracteres especiales, de la forma siguiente:
JNDI name =  java:module/env/jdbc/myDataSource
name = java.module/env/jdbc/myDataSource
Cuando corresponde, se incluyen campos adicionales para aplicación, módulo y componente; por ejemplo:
WebSphere:type=DataSource,name=java.module/env/jdbc/myDataSource,application=MyApp,module=MyModule,*
Con estos valores, puede consultar el MBean para una aplicación determinada, de la manera siguiente:
WebSphere:type=DataSource,name=java.app/env/myDataSource,application=MyApp,*
o consulta un nombre JNDI java:app con el mismo nombre en una aplicación distinta, de la forma siguiente:
WebSphere:type=DataSource,name=java.app/env/myDataSource,application=MyOtherApp,*
Una consulta que omite el campo de aplicación devuelve ambos MBeans, de la forma siguiente:
WebSphere:type=DataSource,name=java.app/env/myDataSource,*

En el módulo web, la especificación Java EE define java:comp para que sea el mismo espacio de nombres que java:module. Por lo tanto, las consultas del MBean de orígenes de datos que se definan en el módulo web no deben incluir el campo de componente.

Para consultar java:comp/env/ds1 definido en el módulo web, utilice lo siguiente:
WebSphere:type=DataSource,name=java.comp/env/ds1,application=MyApp,module=MyModule,*
Para consultar java:comp/env/ds2 definido en un módulo Enterprise JavaBeans (EJB), utilice lo siguiente:
WebSphere:type=DataSource,name=java.comp/env/ds2,application=MyApp,module=MyModule,component=MyBean,*
Para consultar java:app/env/myDataSource definido en una aplicación denominada MyApp, utilice lo siguiente:
WebSphere:type=DataSource,name=java.app/env/myDataSource,application=MyApp,*
Para consultar un nombre JDNI java:app con el mismo nombre en una aplicación distinta denominada MyOtherApp, utilice lo siguiente:
WebSphere:type=DataSource,name=java.app/env/myDataSource,application=MyOtherApp,*
También se puede utilizar los parámetros de aplicación, módulo y componente para realizar una consulta general de todos los orígenes de datos que se definen en una aplicación determinada; por ejemplo:
WebSphere:type=DataSource,application=MyApp,*
Además del MBean DataSource para cada origen de datos Java, también hay un MBean JDBCProvider. El nombre del MBean JDBCProvider es el nombre del MBean DataSource con el prefijo JDBCprovider_, por ejemplo:
WebSphere:type=JDBCProvider,name=JDBCProvider_java.module/env/datasource3,application=MyApp,module=MyModule,*
El MBean JDBCProvider tiene un origen de datos asociado, tal como se muestra en el siguiente ejemplo:
WebSphere:type=DataSource,name=java.module/env/datasource3,application=MyApp,module=MyModule,*

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_jdbcjmx
File name: tdat_jdbcjmx.html