Erro WebSphere: "A JDBC Driver or DataSource class name must be specified in the ConnectionDriverName property"

Essa semana tive algumas complicações com esse erro descrito no título (em inglês por ser melhor visualizado em ferramentas de busca, ou em português para a galera que usa o servidor em português: Um Driver JDBC ou um nome de classe DataSource deve ser especificado na propriedade ConnectionDriverName).

O erro, em sua essência, é bem simples... Diz que a propriedade de conexão "driver" deveria ter sido informado para a mesma configuração de conexão. Isso pode ser simples de resolver, se você estiver usando conexões com arquivos de propriedades como manda o script antigamente, a conexão bruta. Mas pode se tornar uma baita dor de cabeça se estiver usando EJBs, um servidor JEE ou até mesmo alguma ferramenta IBM (WebSphere e RSA/RAD) como foi o meu caso.

O projeto em que trabalhava consistia de alguns AS (Application Service's) que carregavam, via injeção de dependência, o objeto EntityManager (JPA 2.0) para uso em todos os casos de uso. Este mesmo entityManager seria carregado através da especificação EJB que faz uso de alias (references) no datasource previamente criado no IBM WebSphere (7.0) usado como servidor do projeto.

Pesquisando, vi que aconselhavam a mudar a forma como estava sendo feito o lookup pelo persistence.xml. Antes eu tinha:

<persistence-unit name="myUnitName" transaction-type="JTA">
  <provider>org.apache.openjpa.persistence.PersistenceProviderImpl</provider>
  <jta-data-source>java:comp/env/ref-jdbc/myDS</jta-data-source>
  // ...

Essa representa o acesso indirect ao recurso JNDI do seu datasource. Em alguns blogs alguns aconselhavam a mudar o acesso para direct:

<jta-data-source>jdbc/myDS</jta-data-source>

Entretanto, isso somente camuflaria o problema, uma vez que acessando o recurso diretamente, teus EJBs não teriam problema em carregá-lo.

Foi então que percebi que o problema consistia na anotação dos AS nos arquivos de ejb-jar.xml e ibm-ejb-jar.xml que precisavam de mais um recurso, uma vez que eu estava  a usar 2 datasources distintos, mas havia criado o mapeamento para apenas um deles:

<!-- ejb-jar.xml | Configuração do service -->
<session>
  <ejb-name>myAppService</ejb-name>
  <ejb-class>br.as.MyAppService</ejb-class>
  <session-type>Stateless</session-type>
  <transaction-type>Container</transaction-type>
  <resource-ref>
    <description></description>
    <res-ref-name>ref-jdbc/myDS</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
    <res-sharing-scope>Shareable</res-sharing-scope>
  </resource-ref>
  <resource-ref>
    <description></description>
    <res-ref-name>ref-jdbc/myDS</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
    <res-sharing-scope>Shareable</res-sharing-scope>
  </resource-ref>
</session>

<!-- ibm-ejb-jar.xml | Configuração do service -->
<session name="UnidadeOperacionalAS">
  <resource-ref name="ref-jdbc/myDS" binding-name="jdbc/myRealJNDI">
  </resource-ref>
  <resource-ref name="ref-jdbc/myDS" binding-name="jdbc/myRealJNDI">
  </resource-ref>
</session>

Notem que antes só havia um mapeamento e o erro em questão aparecia porque os EJBs não conseguiam enxergar o outro DS criado. A partir dessa adição de referências tudo funcionou normalmente.

Lembrando que esse foi um caso à parte, pode ser que não funcione para o seu caso, que seja outra problema de fato. No mais, espero ter ajudado! :)