Projetos do Enterprise JavaBean (EJB 2.0 para EJB 2.1)
O Assistente para Migração do J2EE suporta a migração de descritores de implementação de bean corporativo do recurso EJB do nível de especificação J2EE 1.3 para J2EE 1.4. Os beans de sessão stateless e os beans acionados por mensagens são migrados para o J2EE 1.4.
Migrando Beans de Sessão
O Assistente para Migração do J2EE migra os beans de sessão sem preservação de estado definidos como SEI (Service Endpoint Interfaces) no descritor webservices.xml de um projeto EJB no J2EE 1.3 para o nível de especificação J2EE 1.4, configurando novas service endpoint interfaces no bean de sessão sem preservação de estado.A especificação J2EE 1.4 requer que uma SEI seja definida em um bean de sessão stateless, se o bean de sessão for utilizado como um terminal da web em serviço. Durante a migração de um EJB JAR, todos os beans de sessão no projeto EJB recebem o nó de extremidade de serviço definido para o nome utilizado no descritor webservices.xml do projeto EJB. Segue um exemplo de como os metadados de um projeto EJB ficarão antes e depois da migração para o nível de especificação J2EE 1.4.
O projeto EJB no J2EE 1.3: descritor webservices.xml com um bean de sessão stateless usado como uma interface de terminal de serviço da Web antes da migração:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE webservices PUBLIC "-//IBM Corporation, Inc.//DTD J2EE Web services 1.0//EN"
"http://www.ibm.com/webservices/dtd/j2ee_web_services_1_0.dtd">
<webservices id="WebServices_1084831328093">
<webservice-description id="WebServiceDescription_1084831328093">
<webservice-description-name>EchoEJBService</webservice-description-name>
<wsdl-file>META-INF/wsdl/EchoEJB.wsdl</wsdl-file>
<jaxrpc-mapping-file>META-INF/EchoEJB_mapping.xml</jaxrpc-mapping-file>
<port-component id="PortComponent_1084831328103">
<port-component-name>EchoEJB</port-component-name>
<wsdl-port id="WSDLPort_1084831328103">
<namespaceURI>http://test</namespaceURI>
<localpart>EchoEJB</localpart>
</wsdl-port>
<service-endpoint-interface>test.EchoEJB</service-endpoint-interface>
<service-impl-bean id="ServiceImplBean_1084831328103">
<ejb-link>EchoEJB</ejb-link>
</service-impl-bean>
</port-component>
</webservice-description>
</webservices>
As tags <service-endpoint-interface> e <service-impl-bean>
no exemplo anterior definem o bean de sessão sem preservação de estado "EchoEJB" como um terminal
em serviço do descritor de webservices no nível de especificação J2EE 1.3
anterior à migração.Projeto EJB no J2EE 1.4: descritor de implementação do EJB para o mesmo bean de sessão stateless "EchoEJB" com a interface de terminal em serviço criada pelo processo de migração:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ejb-jar>
<ejb-jar id="ejb-jar_ID" version="2.1" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/ejb-jar_2_1.xsd">
<display-name>
EchoEJBProject</display-name>
<enterprise-beans>
<session id="EchoEJB">
<ejb-name>EchoEJB</ejb-name>
<home>test.EchoEJBHome</home>
<remote>test.EchoEJB</remote>
<service-endpoint>test.EchoEJB</service-endpoint>
<ejb-class>test.EchoEJBBean</ejb-class>
<session-type>Stateless</session-type>
<transaction-type>Container</transaction-type>
</session>
</enterprise-beans>
</ejb-jar>
A tag <service-endpoint> no exemplo anterior
define "EchoEJB" como um terminal em serviço no nível de especificação J2EE 1.4
após a migração.Migrando Beans Orientados a Mensagens
O Assistente para Migração do J2EE suporta a migração de beans orientados a mensagens do EJB 2.0 para o EJB 2.1.Os beans orientados a mensagens foram introduzidos no EJB 2.0 para suportar o processamento das mensagens assíncronas de um JMS (Java™ Message Service). A especificação EJB 2.1 expande a definição do bean acionado por mensagens a fim de que ele possa oferecer suporte a qualquer sistema de mensagens, não apenas ao JMS.
- acknowledgeMode
- messageSelector
- destinationType
- subscriptionDurablity
O exemplo a seguir compara os elementos de um bean de amostra no EJB 2.0 com a aparência que os elementos terão no EJB 2.1.
Um exemplo de elementos do bean acionado por mensagens no EJB 2.0:
<message-driven id="Mdb20">
<ejb-name>Mdb</ejb-name>
<ejb-class>ejbs.MdbBean</ejb-class>
<transaction-type>Bean</transaction-type>
<message-selector>mdbMessage</message-selector>
<acknowledge-mode>Auto-acknowledge</acknowledge-mode>
<message-driven-destination>
<destination-type>javax.jms.Topic</destination-type>
<subscription-durability>Durable</subscription-durability>
</message-driven-destination>
</message-driven>
Um exemplo de elementos do bean acionado por mensagens no EJB 2.1:
<message-driven id="Mdb21">
<ejb-name>Foo/ejb-name>
<ejb-class>ejbs.FooBean</ejb-class>
<messaging-type>javax.jms.MessageListener</messaging-type>
<transaction-type>Bean/transaction-type>
<message-destination-type>javax.jms.Topic</message-destination-type>
<activation-config>
<activation-config-property>
<activation-config-property-name>destinationType</activation-config-property-name>
<activation-config-property-value>javax.jms.Topic</activation-config-property-value>
</activation-config-property>
<activation-config-property>
<activation-config-property-name>subscriptionDurability</activation-config-property-name>
<activation-config-property-value>Durable</activation-config-property-value>
</activation-config-property>
<activation-config-property>
<activation-config-property-name>acknowledgeMode</activation-config-property-name>
<activation-config-property-value>AutoAcknowledge</activation-config-property-value>
</activation-config-property>
<activation-config-property>
<activation-config-property-name>messageSelector</activation-config-property-name>
<activation-config-property-value>fooSelector</activation-config-property-value>
</activation-config-property>
</activation-config>
</message-driven>