| <!DOCTYPE html> |
| <html lang="en"> |
| |
| <head> |
| <meta charset="UTF-8"> |
| <meta http-equiv="X-UA-Compatible" content="IE=edge"> |
| <meta name="viewport" content="width=device-width, initial-scale=1"> |
| <title>Apache TomEE</title> |
| <meta name="description" |
| content="Apache TomEE is a lightweight, yet powerful, JavaEE Application server with feature rich tooling." /> |
| <meta name="keywords" content="tomee,asf,apache,javaee,jee,shade,embedded,test,junit,applicationcomposer,maven,arquillian" /> |
| <meta name="author" content="Luka Cvetinovic for Codrops" /> |
| <link rel="icon" href="../../favicon.ico"> |
| <link rel="icon" type="image/png" href="../../favicon.png"> |
| <meta name="msapplication-TileColor" content="#80287a"> |
| <meta name="theme-color" content="#80287a"> |
| <link rel="stylesheet" type="text/css" href="../../css/normalize.css"> |
| <link rel="stylesheet" type="text/css" href="../../css/bootstrap.css"> |
| <link rel="stylesheet" type="text/css" href="../../css/owl.css"> |
| <link rel="stylesheet" type="text/css" href="../../css/animate.css"> |
| <link rel="stylesheet" type="text/css" href="../../fonts/font-awesome-4.1.0/css/font-awesome.min.css"> |
| <link rel="stylesheet" type="text/css" href="../../fonts/eleganticons/et-icons.css"> |
| <link rel="stylesheet" type="text/css" href="../../css/jqtree.css"> |
| <link rel="stylesheet" type="text/css" href="../../css/idea.css"> |
| <link rel="stylesheet" type="text/css" href="../../css/cardio.css"> |
| |
| <script type="text/javascript"> |
| |
| var _gaq = _gaq || []; |
| _gaq.push(['_setAccount', 'UA-2717626-1']); |
| _gaq.push(['_setDomainName', 'apache.org']); |
| _gaq.push(['_trackPageview']); |
| |
| (function() { |
| var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; |
| ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; |
| var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); |
| })(); |
| |
| </script> |
| </head> |
| |
| <body> |
| <div class="preloader"> |
| <img src="../../img/loader.gif" alt="Preloader image"> |
| </div> |
| <nav class="navbar"> |
| <div class="container"> |
| <div class="row"> <div class="col-md-12"> |
| |
| <!-- Brand and toggle get grouped for better mobile display --> |
| <div class="navbar-header"> |
| <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1"> |
| <span class="sr-only">Toggle navigation</span> |
| <span class="icon-bar"></span> |
| <span class="icon-bar"></span> |
| <span class="icon-bar"></span> |
| </button> |
| <a class="navbar-brand" href="/"> |
| <span> |
| |
| |
| <img src="../../img/logo-active.png"> |
| |
| |
| </span> |
| Apache TomEE |
| </a> |
| </div> |
| <!-- Collect the nav links, forms, and other content for toggling --> |
| <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> |
| <ul class="nav navbar-nav navbar-right main-nav"> |
| <li><a href="../../docs.html">Documentation</a></li> |
| <li><a href="../../community/index.html">Community</a></li> |
| <li><a href="../../security/security.html">Security</a></li> |
| <li><a href="../../download-ng.html">Downloads</a></li> |
| </ul> |
| </div> |
| <!-- /.navbar-collapse --> |
| </div></div> |
| </div> |
| <!-- /.container-fluid --> |
| </nav> |
| |
| |
| <div id="main-block" class="container main-block"> |
| <div class="row title"> |
| <div class="col-md-12"> |
| <div class='page-header'> |
| |
| <h1>EJB 2.1 CMP EntityBeans (CMP2)</h1> |
| </div> |
| </div> |
| </div> |
| <div class="row"> |
| |
| <div class="col-md-12"> |
| <p>OpenEJB, the EJB Container for TomEE and Geronimo, does support all of EJB 1.1 to 3.1, including CMP2.</p> |
| <p>The CMP2 implementation is actually done by adapting the CMP2 bean into a JPA Entity dynamically at deploy time.</p> |
| <p>Appropriate subclasses, a JPA persistence.xml file and a mapping.xml file are generated at deployment time for the CMP2 EntityBeans and all the Entities will be then run on OpenJPA. This innovative code has been used as the sole CMP2 implementation in Geronimo for its J2EE 1.4, JavaEE 5 and JavaEE 6 certifications.</p> |
| <p>The persistence.xml and mapping.xml files generated at deploy time can be saved to disk and included in the application, allowing you to:</p> |
| <ul> |
| <li>gain finer control over persistence options</li> |
| <li>slowly convert individual entities from CMP2 to JPA</li> |
| </ul> |
| <p>Let's see an example.</p> |
| <h1>Movies application</h1> |
| <p>The following is a basic EJB 2.1 application consisting of one CMP2 Entity. For those that are reading this example out of curiosity and are not familiar with CMP2 or EJB 2.x, each CMP2 Entity is composed of two parts</p> |
| <ul> |
| <li> |
| <p><strong>A Home interface</strong> which has data access methods like "find", "create", and "remove". This is essentially<br/> what people use <code>@Stateless</code> beans for today, but with difference that you do not need to supply<br/> the implementation of the interface -- the container will generate one for you. This is partly what inspired<br/> the creation of the OpenEJB-specific <a href="../dynamic-dao-implementation/README.html">Dynamic DAO</a> feature.</p></li> |
| <li> |
| <p><strong>An abstract EntityBean class</strong> which declares the persistent "properties" of the entity without actually<br/>declaring any fields. It is the container's job to implement the actual methods and create the appropriate fields. OpenEJB will implement this bean as a JPA <code>@Entity</code> bean.</p></li> |
| </ul> |
| <p>As such a CMP2 EntityBean is really just the description of a persistent object and the description of a data-access object. There is no actual code to write.</p> |
| <p>The majority of work in CMP2 is done in the xml:</p> |
| <ul> |
| <li><strong>ejb-jar.xml</strong> mapping information, which describes the persistent properties of the entity and the queries<br/> for all <em>Home</em> find, create and remove methods. This information will be converted by OpenEJB into<br/> a JPA mapping.xml file. All queries in the cmp2 part of the ejb-jar.xml are converted<br/> into named queries in JPA and generally everything is converted to its JPA equivalent.</li> |
| </ul> |
| <h2>CMP2 EntityBean, MovieBean</h2> |
| <pre><code>package org.superbiz.cmp2; |
| |
| import javax.ejb.EntityBean; |
| |
| public abstract class MovieBean implements EntityBean { |
| |
| public MovieBean() { |
| } |
| |
| public Integer ejbCreate(String director, String title, int year) { |
| this.setDirector(director); |
| this.setTitle(title); |
| this.setYear(year); |
| return null; |
| } |
| |
| public abstract java.lang.Integer getId(); |
| |
| public abstract void setId(java.lang.Integer id); |
| |
| public abstract String getDirector(); |
| |
| public abstract void setDirector(String director); |
| |
| public abstract String getTitle(); |
| |
| public abstract void setTitle(String title); |
| |
| public abstract int getYear(); |
| |
| public abstract void setYear(int year); |
| |
| } |
| </code></pre> |
| <h2>CMP2 Home interface, Movies</h2> |
| <pre><code>package org.superbiz.cmp2; |
| |
| import javax.ejb.CreateException; |
| import javax.ejb.FinderException; |
| import java.util.Collection; |
| |
| /** |
| * @version $Revision$ $Date$ |
| */ |
| interface Movies extends javax.ejb.EJBLocalHome { |
| Movie create(String director, String title, int year) throws CreateException; |
| |
| Movie findByPrimaryKey(Integer primarykey) throws FinderException; |
| |
| Collection<Movie> findAll() throws FinderException; |
| |
| Collection<Movie> findByDirector(String director) throws FinderException; |
| } |
| </code></pre> |
| <h2>CMP2 mapping in ejb-jar.xml</h2> |
| <pre><code><ejb-jar> |
| <enterprise-beans> |
| <entity> |
| <ejb-name>MovieBean</ejb-name> |
| <local-home>org.superbiz.cmp2.Movies</local-home> |
| <local>org.superbiz.cmp2.Movie</local> |
| <ejb-class>org.superbiz.cmp2.MovieBean</ejb-class> |
| <persistence-type>Container</persistence-type> |
| <prim-key-class>java.lang.Integer</prim-key-class> |
| <reentrant>false</reentrant> |
| <cmp-version>2.x</cmp-version> |
| <abstract-schema-name>MovieBean</abstract-schema-name> |
| <cmp-field> |
| <field-name>id</field-name> |
| </cmp-field> |
| <cmp-field> |
| <field-name>director</field-name> |
| </cmp-field> |
| <cmp-field> |
| <field-name>year</field-name> |
| </cmp-field> |
| <cmp-field> |
| <field-name>title</field-name> |
| </cmp-field> |
| <primkey-field>id</primkey-field> |
| <query> |
| <query-method> |
| <method-name>findByDirector</method-name> |
| <method-params> |
| <method-param>java.lang.String</method-param> |
| </method-params> |
| </query-method> |
| <ejb-ql>SELECT m FROM MovieBean m WHERE m.director = ?1</ejb-ql> |
| </query> |
| <query> |
| <query-method> |
| <method-name>findAll</method-name> |
| <method-params/> |
| </query-method> |
| <ejb-ql>SELECT m FROM MovieBean as m</ejb-ql> |
| </query> |
| </entity> |
| </enterprise-beans> |
| </ejb-jar> |
| </code></pre> |
| <h2>openejb-jar.xml</h2> |
| <pre><code><openejb-jar xmlns="http://www.openejb.org/xml/ns/openejb-jar-2.1"> |
| <enterprise-beans> |
| <entity> |
| <ejb-name>MovieBean</ejb-name> |
| <key-generator xmlns="http://www.openejb.org/xml/ns/pkgen-2.1"> |
| <uuid/> |
| </key-generator> |
| </entity> |
| </enterprise-beans> |
| </openejb-jar> |
| </code></pre> |
| <h2>MoviesTest</h2> |
| <pre><code>package org.superbiz.cmp2; |
| |
| import junit.framework.TestCase; |
| |
| import javax.naming.Context; |
| import javax.naming.InitialContext; |
| import java.util.Collection; |
| import java.util.Properties; |
| |
| /** |
| * @version $Revision: 607077 $ $Date: 2007-12-27 06:55:23 -0800 (Thu, 27 Dec 2007) $ |
| */ |
| public class MoviesTest extends TestCase { |
| |
| public void test() throws Exception { |
| Properties p = new Properties(); |
| p.put(Context.INITIAL_CONTEXT_FACTORY, "org.apache.openejb.core.LocalInitialContextFactory"); |
| p.put("movieDatabase", "new://Resource?type=DataSource"); |
| p.put("movieDatabase.JdbcDriver", "org.hsqldb.jdbcDriver"); |
| p.put("movieDatabase.JdbcUrl", "jdbc:hsqldb:mem:moviedb"); |
| |
| p.put("movieDatabaseUnmanaged", "new://Resource?type=DataSource"); |
| p.put("movieDatabaseUnmanaged.JdbcDriver", "org.hsqldb.jdbcDriver"); |
| p.put("movieDatabaseUnmanaged.JdbcUrl", "jdbc:hsqldb:mem:moviedb"); |
| p.put("movieDatabaseUnmanaged.JtaManaged", "false"); |
| |
| Context context = new InitialContext(p); |
| |
| Movies movies = (Movies) context.lookup("MovieBeanLocalHome"); |
| |
| movies.create("Quentin Tarantino", "Reservoir Dogs", 1992); |
| movies.create("Joel Coen", "Fargo", 1996); |
| movies.create("Joel Coen", "The Big Lebowski", 1998); |
| |
| Collection<Movie> list = movies.findAll(); |
| assertEquals("Collection.size()", 3, list.size()); |
| |
| for (Movie movie : list) { |
| movies.remove(movie.getPrimaryKey()); |
| } |
| |
| assertEquals("Movies.findAll()", 0, movies.findAll().size()); |
| } |
| } |
| </code></pre> |
| <h1>Running</h1> |
| <pre><code>------------------------------------------------------- |
| T E S T S |
| ------------------------------------------------------- |
| Running org.superbiz.cmp2.MoviesTest |
| Apache OpenEJB 4.0.0-beta-1 build: 20111002-04:06 |
| http://tomee.apache.org/ |
| INFO - openejb.home = /Users/dblevins/examples/simple-cmp2/target |
| INFO - openejb.base = /Users/dblevins/examples/simple-cmp2/target |
| INFO - Configuring Service(id=Default Security Service, type=SecurityService, provider-id=Default Security Service) |
| INFO - Configuring Service(id=Default Transaction Manager, type=TransactionManager, provider-id=Default Transaction Manager) |
| INFO - Configuring Service(id=movieDatabaseUnmanaged, type=Resource, provider-id=Default JDBC Database) |
| INFO - Configuring Service(id=movieDatabase, type=Resource, provider-id=Default JDBC Database) |
| INFO - Found EjbModule in classpath: /Users/dblevins/examples/simple-cmp2/target/classes |
| INFO - Beginning load: /Users/dblevins/examples/simple-cmp2/target/classes |
| INFO - Configuring enterprise application: /Users/dblevins/examples/simple-cmp2/target/classpath.ear |
| INFO - Configuring Service(id=Default CMP Container, type=Container, provider-id=Default CMP Container) |
| INFO - Auto-creating a container for bean MovieBean: Container(type=CMP_ENTITY, id=Default CMP Container) |
| INFO - Configuring PersistenceUnit(name=cmp) |
| INFO - Adjusting PersistenceUnit cmp <jta-data-source> to Resource ID 'movieDatabase' from 'null' |
| INFO - Adjusting PersistenceUnit cmp <non-jta-data-source> to Resource ID 'movieDatabaseUnmanaged' from 'null' |
| INFO - Enterprise application "/Users/dblevins/examples/simple-cmp2/target/classpath.ear" loaded. |
| INFO - Assembling app: /Users/dblevins/examples/simple-cmp2/target/classpath.ear |
| INFO - PersistenceUnit(name=cmp, provider=org.apache.openjpa.persistence.PersistenceProviderImpl) - provider time 160ms |
| INFO - Jndi(name=MovieBeanLocalHome) --> Ejb(deployment-id=MovieBean) |
| INFO - Jndi(name=global/classpath.ear/simple-cmp2/MovieBean!org.superbiz.cmp2.Movies) --> Ejb(deployment-id=MovieBean) |
| INFO - Jndi(name=global/classpath.ear/simple-cmp2/MovieBean) --> Ejb(deployment-id=MovieBean) |
| INFO - Created Ejb(deployment-id=MovieBean, ejb-name=MovieBean, container=Default CMP Container) |
| INFO - Started Ejb(deployment-id=MovieBean, ejb-name=MovieBean, container=Default CMP Container) |
| INFO - Deployed Application(path=/Users/dblevins/examples/simple-cmp2/target/classpath.ear) |
| Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.919 sec |
| |
| Results : |
| |
| Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 |
| </code></pre> |
| <h1>CMP2 to JPA</h1> |
| <p>As mentioned OpenEJB will implement the abstract CMP2 <code>EntityBean</code> as a JPA <code>@Entity</code>, create a <code>persistence.xml</code> file and convert all <code>ejb-jar.xml</code> mapping and queries to a JPA <code>entity-mappings.xml</code> file.</p> |
| <p>Both of these files will be written to disk by setting the system property <code>openejb.descriptors.output</code> to <code>true</code>. In the testcase above, this can be done via the <code>InitialContext</code> parameters via code like this:</p> |
| <pre><code>Properties p = new Properties(); |
| p.put(Context.INITIAL_CONTEXT_FACTORY, "org.apache.openejb.core.LocalInitialContextFactory"); |
| |
| // setup the data sources as usual... |
| |
| // write the generated descriptors |
| p.put("openejb.descriptors.output", "true"); |
| |
| Context context = new InitialContext(p); |
| </code></pre> |
| <p>Below are the generated <code>persistence.xml</code> and <code>mapping.xml</code> files for our CMP2 <code>EntityBean</code></p> |
| <h2>CMP2 to JPA generated persistence.xml file</h2> |
| <pre><code><?xml version="1.0" encoding="UTF-8" standalone="yes"?> |
| <persistence xmlns="http://java.sun.com/xml/ns/persistence" version="1.0"> |
| <persistence-unit name="cmp" transaction-type="JTA"> |
| <jta-data-source>movieDatabase</jta-data-source> |
| <non-jta-data-source>movieDatabaseUnmanaged</non-jta-data-source> |
| <mapping-file>META-INF/openejb-cmp-generated-orm.xml</mapping-file> |
| <class>openejb.org.superbiz.cmp2.MovieBean</class> |
| <properties> |
| <property name="openjpa.jdbc.SynchronizeMappings" |
| value="buildSchema(ForeignKeys=true, Indexes=false, IgnoreErrors=true)"/> |
| <property name="openjpa.Log" value="DefaultLevel=INFO"/> |
| </properties> |
| </persistence-unit> |
| </persistence> |
| </code></pre> |
| <p>All of this <code>persitence.xml</code> can be changed, however the <code>persistence-unit</code> must have the <code>name</code> fixed to <code>cmp</code>.</p> |
| <h2>CMP2 to JPA generated mapping file</h2> |
| <p>Note that the <code>persistence.xml</code> above refers to this mappings file as <code>META-INF/openejb-cmp-generated-orm.xml</code>. It is possible to rename this file to whatever name you prefer, just make sure to update the <code><mapping-file></code> element of the <code>cmp</code> persistence unit accordingly.</p> |
| <pre><code><?xml version="1.0" encoding="UTF-8" standalone="yes"?> |
| <entity-mappings xmlns="http://java.sun.com/xml/ns/persistence/orm" version="1.0"> |
| <entity class="openejb.org.superbiz.cmp2.MovieBean" name="MovieBean"> |
| <description>simple-cmp2#MovieBean</description> |
| <table/> |
| <named-query name="MovieBean.findByDirector(java.lang.String)"> |
| <query>SELECT m FROM MovieBean m WHERE m.director = ?1</query> |
| </named-query> |
| <named-query name="MovieBean.findAll"> |
| <query>SELECT m FROM MovieBean as m</query> |
| </named-query> |
| <attributes> |
| <id name="id"> |
| <generated-value strategy="IDENTITY"/> |
| </id> |
| <basic name="director"/> |
| <basic name="year"/> |
| <basic name="title"/> |
| </attributes> |
| </entity> |
| </entity-mappings> |
| </code></pre> |
| </div> |
| |
| </div> |
| </div> |
| <footer> |
| <div class="container"> |
| <div class="row"> |
| <div class="col-sm-6 text-center-mobile"> |
| <h3 class="white">Be simple. Be certified. Be Tomcat.</h3> |
| <h5 class="light regular light-white">"A good application in a good server"</h5> |
| <ul class="social-footer"> |
| <li><a href="https://www.facebook.com/ApacheTomEE/"><i class="fa fa-facebook"></i></a></li> |
| <li><a href="https://twitter.com/apachetomee"><i class="fa fa-twitter"></i></a></li> |
| <li><a href="https://plus.google.com/communities/105208241852045684449"><i class="fa fa-google-plus"></i></a></li> |
| </ul> |
| </div> |
| <div class="col-sm-6 text-center-mobile"> |
| <div class="row opening-hours"> |
| <div class="col-sm-3 text-center-mobile"> |
| <h5><a href="../../latest/docs/" class="white">Documentation</a></h5> |
| <ul class="list-unstyled"> |
| <li><a href="../../latest/docs/admin/configuration/index.html" class="regular light-white">How to configure</a></li> |
| <li><a href="../../latest/docs/admin/file-layout.html" class="regular light-white">Dir. Structure</a></li> |
| <li><a href="../../latest/docs/developer/testing/index.html" class="regular light-white">Testing</a></li> |
| <li><a href="../../latest/docs/admin/cluster/index.html" class="regular light-white">Clustering</a></li> |
| </ul> |
| </div> |
| <div class="col-sm-3 text-center-mobile"> |
| <h5><a href="../../latest/examples/" class="white">Examples</a></h5> |
| <ul class="list-unstyled"> |
| <li><a href="../../latest/examples/simple-cdi-interceptor.html" class="regular light-white">CDI Interceptor</a></li> |
| <li><a href="../../latest/examples/rest-cdi.html" class="regular light-white">REST with CDI</a></li> |
| <li><a href="../../latest/examples/ejb-examples.html" class="regular light-white">EJB</a></li> |
| <li><a href="../../latest/examples/jsf-managedBean-and-ejb.html" class="regular light-white">JSF</a></li> |
| </ul> |
| </div> |
| <div class="col-sm-3 text-center-mobile"> |
| <h5><a href="../../community/index.html" class="white">Community</a></h5> |
| <ul class="list-unstyled"> |
| <li><a href="../../community/contributors.html" class="regular light-white">Contributors</a></li> |
| <li><a href="../../community/social.html" class="regular light-white">Social</a></li> |
| <li><a href="../../community/sources.html" class="regular light-white">Sources</a></li> |
| </ul> |
| </div> |
| <div class="col-sm-3 text-center-mobile"> |
| <h5><a href="../../security/index.html" class="white">Security</a></h5> |
| <ul class="list-unstyled"> |
| <li><a href="http://apache.org/security" target="_blank" class="regular light-white">Apache Security</a></li> |
| <li><a href="http://apache.org/security/projects.html" target="_blank" class="regular light-white">Security Projects</a></li> |
| <li><a href="http://cve.mitre.org" target="_blank" class="regular light-white">CVE</a></li> |
| </ul> |
| </div> |
| </div> |
| </div> |
| </div> |
| <div class="row bottom-footer text-center-mobile"> |
| <div class="col-sm-12 light-white"> |
| <p>Copyright © 1999-2016 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache TomEE, TomEE, Apache, the Apache feather logo, and the Apache TomEE project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</p> |
| </div> |
| </div> |
| </div> |
| </footer> |
| <!-- Holder for mobile navigation --> |
| <div class="mobile-nav"> |
| <ul> |
| <li><a hef="../../latest/docs/admin/index.html">Administrators</a> |
| <li><a hef="../../latest/docs/developer/index.html">Developers</a> |
| <li><a hef="../../latest/docs/advanced/index.html">Advanced</a> |
| <li><a hef="../../community/index.html">Community</a> |
| </ul> |
| <a href="#" class="close-link"><i class="arrow_up"></i></a> |
| </div> |
| <!-- Scripts --> |
| <script src="../../js/jquery-1.11.1.min.js"></script> |
| <script src="../../js/owl.carousel.min.js"></script> |
| <script src="../../js/bootstrap.min.js"></script> |
| <script src="../../js/wow.min.js"></script> |
| <script src="../../js/typewriter.js"></script> |
| <script src="../../js/jquery.onepagenav.js"></script> |
| <script src="../../js/tree.jquery.js"></script> |
| <script src="../../js/highlight.pack.js"></script> |
| <script src="../../js/main.js"></script> |
| </body> |
| |
| </html> |
| |
