Se você tiver criado código em um projeto da Web tendo como destino o WebSphere Application
Server V5.1 que utilizou registros relacionais ou listas de registros relacionais WDO (WebSphere Data Objects), ao ter como destino o
WebSphere Application
Server V6.0 para esses aplicativos, você deverá utilizar registros relacionais e listas de registros relacionais SDO (Service Data Objects). A migração do WDO para o SDO ocorre automaticamente quando você alterar o servidor de destino de seu aplicativo do WebSphere Application Server V5.1 para o WebSphere Application
Server V6.0.
O servidor de destino pode ser alterado de duas maneiras:
Os tópicos de ajuda sobre como alterar seu servidor de destino e sobre como utilizar o Assistente
para Migração do J2EE podem ser encontrados na ajuda on-line do
Rational Web Developer.
Considerações de Compatibilidade
- Qualquer código gravado nas APIs (Application Programming Interfaces) públicas para
os beans de acesso do WDO será suportado na V6.0 (apesar das classes de implementação
terem sido alteradas para apontar o tempo de execução do SDO).
- O novo código gerado para o WebSphere Application Server V6.0 não
utilizará os beans de acesso do WDO, mas irá gerar código para as APIs puras
do SDO.
- Qualquer código gerado para um projeto tendo como destino a V6.0 não será executado em um servidor V5.1, mesmo se migrado de volta, redefinido o servidor de destino.
- Código gravado para a V5.1 pode ser migrado para frente e para trás tendo como destino um servidor V5.1.
Erros de Conflito de Tipos Podem Ocorrer após a Migração de WDO
para SDO
Depois que um projeto utilizando o WDO for migrado para um projeto
baseado em SDO, se você incluir dados SDO em uma página JSP existente que tenha dados
WDO existentes, poderão ocorrer erros de conflito de tipos. Isso ocorre devido à mistura de beans de acesso existentes do WDO e APIs independentes do SDO. Por exemplo, você poderá ver um erro de compilação no arquivo de origem Java do JSP semelhante ao seguinte:
A importação de com.ibm.websphere.sdo.mediator.exception.MediatorException é conflitante com um outro tipo importado
Esses erros de conflito de tipos podem ser corrigidos da seguinte forma:
- Remova a instrução de importação conflitante do arquivo de origem Java. Utilizando o exemplo anterior, você
removeria a seguinte instrução de importação do arquivo de origem:
import com.ibm.websphere.wdo.mediator.exception.MediatorException;
- Modifique o arquivo de origem Java que referencia esse tipo para utilizar o nome completo
da classe. Com base no exemplo acima, o tipo MediatorException deve
ser alterado para com.ibm.websphere.wdo.mediator.exception.MediatorException.
Por exemplo, o código fonte gravado como
catch ( MediatorException e1 ) {
deve
ser alterado para catch
( com.ibm.websphere.wdo.mediator.exception.MediatorException e1 ) {
Alterações de um Projeto da Web Depois de Alterar o Servidor de Destino da
V5.1 para a V6.0 (WDO para SDO)
As alterações a seguir são feitas automaticamente
quando o servidor de destino é alterado da V5.1 para V6.0:
- Os arquivos JARs (Java archive) wdo_web.jar e wdo_jdbc_access.jar são
removidos do projeto.
- Os arquivos JARs a seguir são removidos do caminho de classe do projeto:
- emf-runtime.jar
- emf-event.jar
- wdo-interface.jar
- wdo.jar
- jdbcmediator.jar
- wdo.xmlmediator.jar
- Os arquivos sdo_web.jar e sdo_access_beans.jar são
incluídos no projeto (os arquivos JAR do tempo de execução do SDO são automaticamente
incluídos em algum caminho de classe do projeto V6.0).
- Todos os arquivos JARs da JSTL (JavaServer Pages Standard Tag Library) são removidos
do projeto. (Os arquivos JARs do JSTL 1.1/JSP 2.0 são automaticamente incluídos em qualquer
caminho de classe do projeto V6.0.)
- As instruções de importação a seguir são alteradas em qualquer arquivo de origem Java:
- com.ibm.websphere.wdo.access.connections.ConnectionManager muda para
com.ibm.websphere.sdo.access.connections.ConnectionManager.
- com.ibm.websphere.wdo.mediator.rdb.ConnectionWrapper muda para
com.ibm.websphere.sdo.mediator.jdbc.ConnectionWrapper.
Alterações de um Projeto da Web Depois de Alterar o Destino do Servidor da
V6.0 para a V5.1 (SDO a WDO)
As alterações a seguir são feitas automaticamente
quando o servidor de destino é alterado da V6.0 para V5.1:
- Os arquivos JARs sdo_web.jar e sdo_access_beans.jar são
removidos do projeto.
- Os arquivos JARs wdo_web.jar e wdo_jdbc_access.jar são
incluídos no projeto.
- Os arquivos JARs a seguir são incluídos no caminho de classe do projeto:
- emf-runtime.jar
- emf-event.jar
- wdo-interface.jar
- wdo.jar
- jdbcmediator.jar
- wdo.xmlmediator.jar
- Os arquivos JARs do JSTL 1.0 são incluídos no projeto. (Os JARs do JSTL 1.1/JSP 2.0 são
removidos do caminho de classe do projeto).
- As instruções de importação a seguir são alteradas em qualquer arquivo de origem Java:
- com.ibm.websphere.sdo.access.connections.ConnectionManager torna-se com.ibm.websphere.wdo.access.connections.ConnectionManager.
- com.ibm.websphere.sdo.mediator.jdbc.ConnectionWrapper torna-se com.ibm.websphere.wdo.mediator.rdb.ConnectionWrapper.
Alterações de um Projeto da Web Depois de Alterar o Nível de J2EE de seu Aplicativo de
1.3 para 1.4
Além das alterações que ocorrem para migrar
do WSD para o SDO alterando o destino do servidor para o WebSphere Application
Server V6.0, alterar o nível de especificação J2EE de seu aplicativo de 1.3 para 1.4
atualiza todas as referências da biblioteca de tags (taglib) de suas JSPs (JavaServer
Pages) da utilização de WDO, bibliotecas de tags JSTL 1.0 para SDO, bibliotecas de tags
JSTL 1.1/jsp 2.0. A tabela a seguir mostra as alterações nas referências de taglibs JSP,
quando você move do J2EE 1.3 para J2EE 1.4.
Tabela 1. Referências de Taglibs JSP
no J2EE 1.3 e J2EE 1.4.Taglib J2EE 1.3 (WDO) |
Taglib J2EE 1.4 (SDO) |
http://www.ibm.com/websphere/wdo/core |
http://www.ibm.com/websphere/sdo/core |
http://java.sun.com/jstl/core |
http://java.sun.com/jsp/jstl/core |
http://java.sun.com/jstl/fmt |
http://java.sun.com/jsp/jstl/fmt |
http://java.sun.com/jstl/xml |
http://java.sun.com/jsp/jstl/xml |
http://java.sun.com/jstl/sql |
http://java.sun.com/jsp/jstl/sql |