Acessando um Recurso de Origem de Dados do Java EE Existente

O mesmo modelo de programação do MBean DataSource e do JDBCProvider MBean que você usa para acessar uma fonte de dados gerenciada do WebSphere® Application Server (definida em scripting ou no Integrated Solutions Console) pode ser usado para acessar um recurso de origem de dados Java™ Platform Enterprise Edition (Java™ EE) que é definido no aplicativo com a anotação DataSourceDefinition ou com o elemento de < data-source> do descritor de implantação. Esse recurso mantém a compatibilidade com scripts existentes, simplificando o gerenciamento dos seus recursos.

Sobre esta Tarefa

Esta tarefa ilustra através de exemplos como um MBean representa um recurso de origem de dados Java EE .

Usando o DataSource MBean

Use o campo de nome do MBean do DataSource como o nome Java Naming and Directory Interface (JNDI) com caracteres especiais, da seguinte forma:

JNDI name =  java:module/env/jdbc/myDataSource
name = java.module/env/jdbc/myDataSource

Campos adicionais para aplicativo, módulo e componente são incluídos sempre que aplicável, por exemplo:

WebSphere:type=DataSource,name=java.module/env/jdbc/myDataSource,application=MyApp,module=MyModule,*

Usando esses valores, é possível consultar o MBean para um determinado aplicativo, como a seguir:

WebSphere:type=DataSource,name=java.app/env/myDataSource,application=MyApp,*

ou uma consulta para um nome JNDI java:app nomeado identicamente em um aplicativo diferente como a seguir:

WebSphere:type=DataSource,name=java.app/env/myDataSource,application=MyOtherApp,*

Uma consulta que omite o campo do aplicativo retorna ambos os MBeans como a seguir:

WebSphere:type=DataSource,name=java.app/env/myDataSource,*

No módulo web, a especificação Java EE define java: comp para ser o mesmo namespace do java:module. Portanto, as consultas do MBean de origens de dados que estiverem definidas no módulo da Web não devem incluir o campo de componente.

Para consultar java:comp/env/ds1 definido no módulo da Web, use o seguinte:

WebSphere:type=DataSource,name=java.comp/env/ds1,application=MyApp,module=MyModule,*

Para consultar o java:comp/env/ds2 definido em um módulo Enterprise JavaBeans (EJB), utilize o seguinte:

WebSphere:type=DataSource,name=java.comp/env/ds2,application=MyApp,module=MyModule,component=MyBean,*

Para consultar java:app/env/myDataSource definido em um aplicativo nomeado MyApp, use o seguinte:

WebSphere:type=DataSource,name=java.app/env/myDataSource,application=MyApp,*

Para consultar um nome JNDI java:app nomeado identicamente em um aplicativo diferente nomeado MyOtherApp, use o seguinte:

WebSphere:type=DataSource,name=java.app/env/myDataSource,application=MyOtherApp,*

Os parâmetros do aplicativo, módulo e componente também podem ser usados para executar uma consulta geral de todas as origens de dados que estiverem definidas em um determinado aplicativo, por exemplo:

WebSphere:type=DataSource,application=MyApp,*

Usando o JDBCProvider MBean

Além do MBean do DataSource para cada fonte de dados Java EE , há também um MBean JDBCProvider. O nome do JDBCProvider MBean é o nome do DataSource MBean prefixado com JDBCProvider_, por exemplo:

WebSphere:type=JDBCProvider,name=JDBCProvider_java.module/env/datasource3,application=MyApp,module=MyModule,*

O JDBCProvider MBean possui uma origem de dados associada com ele, conforme ilustrado no seguinte exemplo:

WebSphere:type=DataSource,name=java.module/env/datasource3,application=MyApp,module=MyModule,*