Migration Cheat Cheet for Java EE 5 to Java EE 6

Transcription

1 Java EE 6 EJB via CDI 1. Create a qualifier (annotation) for TYPE, METHOD, PARAMETER, MyBeanLocal { } 2. Create a new class to define the EJB as a resource and to provide a producer method with the MyBeanLocal mybean; // MyBeanLocal (EJB Local Interface) extends MyBean public MyBean getmybean() { } return mybean; 3. to inject the EJB as a resource into a MyBean mybean; JAX-RS via CDI 1. Delete the RESTEasy servlet configuration from the web.xml file, or delete the web.xml file itself. 2. Create the XML descriptor file (beans.xml) in the META-INF WEB-INF directory to enable CDI. <?xml version="1.0"?> <beans xmlns=" xmlns:xsi=" xsi:schemalocation=" /> 3. Create a JAX-RS Application subclass @ApplicationScoped public class MyApplication extends Application { } 1/6

2 Java EE 6 JPA 1. If the GenerationType.AUTO strategy defaults to the GenerationType.SEQUENCE strategy, replace it with the GenerationType.SEQUENCE strategy and supplement it with annotation. = GenerationType.SEQUENCE, generator = = "my_sequence", sequencename = = GenerationType.AUTO) 2. If second level caching is configured, (Hibernate) annotations @Cache(usage = CacheConcurrencyStrategy.TRANSACTIONAL) 3. If second level caching is configured, update the configuration properties in the persistence.xml file. <properties> <property name="hibernate.cache.use_second_level_cache" value="true" /> <property name="hibernate.cache.use_query_cache" value="true" /> <property name="hibernate.cache.region.factory_class" value="org.hibernate.cache.jbc2.jndimultiplexedjbosscacheregionfactory"/> <property name="hibernate.cache.region.jbc2.cachefactory" value="java:cachemanager"/> <property name="hibernate.cache.region.jbc2.cfg.query" value="local-query"/> </properties> 2/6

3 JBoss EAP 6 Arquillian 1. Delete the auth.conf file. 2. Delete the jndi.properties file. 3. Update the Arquillian configuration in the arquillian.xml file. EJB Client <?xml version="1.0" encoding="utf-8"?> <arquillian xmlns=" xmlns:xsi=" xsi:schemalocation=" <container qualifier="jboss" default="true"> <property name="managementaddress">localhost</property> <property name="managementport">9999</property> <property name="contextfactory">org.jboss.security.jndi.logininitialcontextfactory</property> </container> </arquillian> 1. Update the properties for the initial context. Properties properties = new Properties(); properties.put(context.url_pkg_prefixes, "org.jboss.ejb.client.naming"); properties.put(context.initial_context_factory, "org.jnp.interfaces.namingcontextfactory"); properties.put(context.provider_url, "jnp://localhost:1099"); 2. Update the JNDI name. ejb:<appname>/<modulename>/<distinctname>/<beanname>!<viewclassname> <appname>/<beanname>/remote 3. Create the jboss-ejb-client.properties file. remote.connectionprovider.create.options.org.xnio.options.ssl_enabled=false remote.connections=default remote.connection.default.host=localhost remote.connection.default.port= /6

4 JBoss EAP 6 JMS JNDI 1. Move the JMS configuration file to the META-INF directory and rename it (*-service.xml to *-jms.xml). 2. Update the JMS configuration file. <?xml version="1.0" encoding="utf-8"?> <messaging-deployment xmlns="urn:jboss:messaging-deployment:1.0"> <hornetq-server> <jms-destinations> <jms-queue name="myqueue"> <entry name="/queue/myqueue" /> </jms-queue> </jms-destinations> </hornetq-server> </messaging-deployment> 1. Update the JNDI names of JMS = = "queue/myqueue") Queue = = "java:/connectionfactory") QueueConnectionFactory connectionfactory; 4/6

5 Maven Java EE 6 1. Add the JBoss Java EE 6 API dependency (BOM). <dependencymanagement> <dependencies> <groupid>org.jboss.spec</groupid> <artifactid>jboss-javaee-6.0</artifactid> <version>3.0.1.final</version> <scope>import</scope> <type>pom</type> </dependencies> </dependencymanagement> 2. Add the CDI API dependency. <groupid>javax.enterprise</groupid> <artifactid>cdi-api</artifactid> 3. Replace the EJB API dependency. <groupid>org.jboss.spec.javax.ejb</groupid> <artifactid>jboss-ejb-api_3.1_spec</artifactid> 8. If the Hibernate Annotations dependency was only required for annotation, remove it. 9. Replace the JPA API dependency. <groupid>org.hibernate.javax.persistence</groupid> <artifactid>hibernate-jpa-2.0-api</artifactid> 10. Configure the Maven WAR plugin. <plugin> <artifactid>maven-war-plugin</artifactid> <version>2.1.1</version> <failonmissingwebxml>false</failonmissingwebxml> </plugin> 11. Update the Maven EAR plugin configuration. <version>6</version> <defaultlibbundledir>lib</defaultlibbundledir> <filenamemapping>no-version</filenamemapping> 4. If the RESTEasy dependency was only required for the JAX-RS implementation, remove it and its dependencies. 5. If the RESTEasy dependency was required for the client framework, update it. <groupid>org.jboss.resteasy</groupid> <artifactid>resteasy-jaxrs</artifactid> <version>2.3.2.final</version> 6. Replace the JAX-RS API dependency. <groupid>org.jboss.spec.javax.ws.rs</groupid> <artifactid>jboss-jaxrs-api_1.1_spec</artifactid> 7. Replace the JMS API dependency. <groupid>org.jboss.spec.javax.jms</groupid> <artifactid>jboss-jms-api_1.1_spec</artifactid> 5/6

6 Maven JBoss EAP 6 1. Update the Arquillian dependency (BOM). <dependencymanagement> <dependencies> <groupid>org.jboss.arquillian</groupid> <artifactid>arquillian-bom</artifactid> <version>1.0.0.final</version> <scope>import</scope> <type>pom</type> </dependencies> </dependencymanagement> 2. Replace the Arquillian JBoss AS, the JBoss AS Client, and the JBoss AS Profile Service Client dependencies with the JBoss AS Arquillian dependency. <groupid>org.jboss.as</groupid> <artifactid>jboss-as-arquillian-container-remote</artifactid> <version>7.1.1.final</version> 3. Remove the JBoss AS Client dependency. 4. Add the JBoss AS EJB Client dependency (BOM). <dependencymanagement> <dependencies> <groupid>org.jboss.as</groupid> <artifactid>jboss-as-ejb-client-bom</artifactid> <version>7.1.1.final</version> <scope>import</scope> <type>pom</type> </dependencies> </dependencymanagement> 5. Add the JBoss AS EJB Client dependencies. <groupid>org.jboss</groupid> <artifactid>jboss-ejb-client</artifactid> <groupid>org.jboss.marshalling</groupid> <artifactid>jboss-marshalling-river</artifactid> <groupid>org.jboss.sasl</groupid> <artifactid>jboss-sasl</artifactid> <groupid>org.jboss.xnio</groupid> <artifactid>xnio-nio</artifactid> <groupid>org.jboss.spec.javax.ejb</groupid> <artifactid>jboss-ejb-api_3.1_spec</artifactid> <groupid>org.jboss.spec.javax.transaction</groupid> <artifactid>jboss-transaction-api_1.1_spec</artifactid> 6. Replace the Maven Cargo plugin with the JBoss AS (7) plugin. <plugin> <groupid>org.jboss.as.plugins</groupid> <artifactid>jboss-as-maven-plugin</artifactid> <version>7.1.1.final</version> <username>admin</username> <password>password</password> <executions> <execution> <id>pre-integration-test</id> <phase>pre-integration-test</phase> <goals> <goal>deploy</goal> </goals> </execution> <execution> <id>post-integration-test</id> <phase>post-integration-test</phase> <goals> <goal>undeploy</goal> </goals> </execution> </executions> </plugin> 6/6