testing-transactions-example.html - tomee-site-pub - Git at Google

 <!DOCTYPE html>
 <html lang="en">
   <head>

     <meta charset="UTF-8">
       <title>Testing Transactions Example</title>
     <meta name="description" content="Apache TomEE">
     <meta name="author" content="Apache TomEE">
     <meta name="google-translate-customization" content="f36a520c08f4c9-0a04e86a9c075ce9-g265f3196f697cf8f-10">
     <meta http-equiv="Pragma" content="no-cache">
     <meta http-equiv="Expires" content="0">
     <meta http-equiv="Cache-Control" content="no-store, no-cache, must-revalidate, max-age=0">

     <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
     <!--[if lt IE 9]>
       <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
     <![endif]-->

     <!-- Le styles -->
     <link href="./resources/css/bootstrap.css" rel="stylesheet">
     <link href="./resources/css/prettify.css" rel="stylesheet">
     <!--link href="./resources/css/bootstrap-mods.css" rel="stylesheet"-->
     <link href="./resources/css/main.css" rel="stylesheet">
     <link href="./resources/font-awesome-4.6.3/css/font-awesome.min.css" rel="stylesheet">

     <script type="text/javascript">
         var t = encodeURIComponent(document.title.replace(/^\s+|\s+$/g,""));
         var u = encodeURIComponent(""+document.URL);

       function fbshare () {
           window.open(
                   "http://www.facebook.com/sharer/sharer.php?u="+u,
                   'Share on Facebook',
                   'width=640,height=426');
       };
       function gpshare () {
           window.open(
                   "https://plus.google.com/share?url="+u,
                   'Share on Google+',
                   'width=584,height=385');
       };
       function twshare () {
           window.open(
                   "https://twitter.com/intent/tweet?url="+u+"&text="+t,
                   'Share on Twitter',
                   'width=800,height=526');
       };
       function pinshare () {
           window.open("//www.pinterest.com/pin/create/button/?url="+u+"&media=http%3A%2F%2Ftomee.apache.org%2Fresources%2Fimages%2Ffeather-logo.png&description="+t,
                   'Share on Pinterest',
                   'width=800,height=526');
       };
     </script>

     <!-- Le fav and touch icons -->
     <link rel="shortcut icon" href="./favicon.ico">
     <link rel="apple-touch-icon" href="./resources/images/apple-touch-icon.png">
     <link rel="apple-touch-icon" sizes="72x72" href="./resources/images/apple-touch-icon-72x72.png">
     <link rel="apple-touch-icon" sizes="114x114" href="./resources/images/apple-touch-icon-114x114.png">

     <script src="./resources/js/prettify.js" type="text/javascript"></script>
     <script src="./resources/js/jquery-latest.js"></script>
     <script src="http://platform.twitter.com/widgets.js" type="text/javascript"></script>
     <script src="./resources/js/common.js"></script>
     <script src="./resources/js/prettyprint.js"></script>
     <!--script src="//assets.pinterest.com/js/pinit.js" type="text/javascript" async></script//-->

     <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="topbar" data-dropdown="dropdown">
       <div class="fill">
         <div class="container">
           <a class="brand" href="./index.html">Apache TomEE</a>
           <ul class="nav">
               <li class="dropdown">
                   <a class="dropdown-toggle" data-toggle="dropdown" href="#">
                   Apache
                       <b class="caret"></b>
                   </a>
                   <ul class="dropdown-menu">
                      <!-- <li><a href="./misc/whoweare.html">Who we are?</a></li> -->
                      <!-- <li><a href="./misc/heritage.html">Heritage</a></li> -->
                      <li><a href="http://www.apache.org">Apache Home</a></li>
                      <!-- <li><a href="./misc/resources.html">Resources</a></li> -->
                      <li><a href="./misc/contact.html">Contact</a></li>
                      <li><a href="./misc/legal.html">Legal</a></li>
                      <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
                      <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
                      <li class="divider"/>
                      <li><a href="http://www.apache.org/security">Security</a></li>
                   </ul>
               </li>
               <li><a href="./index.html">Home</a></li>
               <li><a href="./downloads.html">Downloads</a></li>
               <li><a href="./documentation.html">Documentation</a></li>
               <li><a href="./examples-trunk/index.html">Examples</a></li>
               <li><a href="./support.html">Support</a></li>
               <li><a href="./contribute.html">Contribute</a></li>
               <li><a href="./security/index.html">Security</a></li>
           </ul>

             <!-- Google CSE Search Box Begins  -->
             <FORM class="pull-right" id="searchbox_010475492895890475512:_t4iqjrgx90" action="http://www.google.com/cse">
                 <INPUT type="hidden" name="cx" value="010475492895890475512:_t4iqjrgx90">
                 <INPUT type="hidden" name="cof" value="FORID:0">
                 <INPUT size="18" width="130" style="width:130px" name="q" type="text" placeholder="Search">
             </FORM>
             <!--<SCRIPT type="text/javascript" src="http://www.google.com/coop/cse/brand?form=searchbox_010475492895890475512:_t4iqjrgx90"></SCRIPT>-->
             <!-- Google CSE Search Box Ends -->
         </div>
       </div>
     </div>

     <div class="container">


 <div class="page-header">
     <small><a href="./index.html">Home</a></small><br>
     <h1>Testing Transactions Example

         <div style="float: right; position: relative; bottom: -10px; ">
             <a onclick="javascript:gpshare()" class="gp-share sprite" title="Share on Google+">share [gp]</a>
             <a onclick="javascript:fbshare()" class="fb-share sprite" title="Share on Facebook">share [fb]</a>
             <a onclick="javascript:twshare()" class="tw-share sprite" title="Share on Twitter">share [tw]</a>
             <a onclick="javascript:pinshare()" class="pin-share sprite" title="Share on Pinterest">share [pin]</a>
             <a data-toggle="modal" href="#edit" class="edit-page" title="Contribute to this Page">contribute</a>
         </div>
     </h1>
 </div>

 <p><a name="TestingTransactionsExample-Overview"></a></p>

 <h1>Overview</h1>

 <p>Testing an EntityManager that uses the default,
 PersistenceContextType.TRANSACTION, can be challenging due to Entities
 detaching around transaction boundaries.  If you were to take the <a href="injection-of-entitymanager-example.html">Injection of EntityManager Example</a>
  which uses an EXTENDED persistence context and switch it to a TRANSACTION
 persistence context making no other changes, you'd find that the test would
 fail.  This would be because of the detach.</p>

 <p>Generally, when using an EntityManager with TRANSACTION persistence
 context, your transaction should surround your use of the Entities
 themselves, not just the use of the EntityManager.  Using a <a href="unit-testing-transactions.html">transaction in your unit test</a>
  can make testing these scenarios possible.</p>

 <p>This example shows use of @PersistenceContext to have an <em>EntityManager</em>
 with an <em>TRANSACTION</em> persistence context injected into a <em>@Stateful</em> bean
 using the <em>@TransactionAttribute</em> annotation and a TestCase that runs test
 code in a JTA <em>Transaction</em>.  An EJB 3 @Entity bean is used with the
 EntityManager to create, persist and merge data to a database.</p>

 <p><em>The source for this example is in the "testing-transactions" directory
 located in the <a href="http://tomee.apache.org/downloads.html">openejb-examples.zip</a>
  available on the <a href="http://tomee.apache.org/downloads.html">download page</a>.</em></p>

 <p><a name="TestingTransactionsExample-TheCode"></a></p>

 <h1>The Code</h1>

 <p>In the code below we see that the transaction attribute for all method
 of the bean has been changed the default, which is
 TransactionAttributeType.REQUIRED, to TransactionAttributeType.MANDATORY.
 The MANDATORY transaction attribute is similar to REQUIRED in that the bean
 method is guaranteed to be executed in a transaction, but with the added
 restriction that if a transaction isn't started by the client before
 calling the method, an exception will be thrown.  </p>

 <p>The benefit of MANDATORY in this example is that it is impossible for the
 client to get detached Entity issues.  The client either has a transaction
 and therefore gets Entities which are still attached and persistent, or the
 client would get an exception stating that the use of a transaction is
 mandatory.</p>

 <p>See the <a href="transaction-annotations.html">Transaction Annotations</a>
  page for a full description of the available transaction attributes.</p>

 <p><a name="TestingTransactionsExample-Writingaunittestfortheexample"></a></p>

 <h2>Movie</h2>

 <pre><code>package org.superbiz.injection.tx;

 import javax.persistence.Entity;

 @Entity
 public class Movie {

     private String director;
     private String title;
     private int year;

     public Movie() {
     }

     public Movie(String director, String title, int year) {
         this.director = director;
         this.title = title;
         this.year = year;
     }

     public String getDirector() {
         return director;
     }

     public void setDirector(String director) {
         this.director = director;
     }

     public String getTitle() {
         return title;
     }

     public void setTitle(String title) {
         this.title = title;
     }

     public int getYear() {
         return year;
     }

     public void setYear(int year) {
         this.year = year;
     }

 }
 </code></pre>

 <h2>Movies</h2>

 <pre><code>package org.superbiz.injection.tx;

 import javax.ejb.Stateful;
 import javax.ejb.TransactionAttribute;
 import javax.persistence.EntityManager;
 import javax.persistence.PersistenceContext;
 import javax.persistence.PersistenceContextType;
 import javax.persistence.Query;
 import java.util.List;

 import static javax.ejb.TransactionAttributeType.MANDATORY;

 //START SNIPPET: code
 @Stateful(name = "Movies")
 @TransactionAttribute(MANDATORY)
 public class Movies {

     @PersistenceContext(unitName = "movie-unit", type = PersistenceContextType.TRANSACTION)
     private EntityManager entityManager;

     public void addMovie(Movie movie) throws Exception {
         entityManager.persist(movie);
     }

     public void deleteMovie(Movie movie) throws Exception {
         entityManager.remove(movie);
     }

     public List&lt;Movie&gt; getMovies() throws Exception {
         Query query = entityManager.createQuery("SELECT m from Movie as m");
         return query.getResultList();
     }
 }
 </code></pre>

 <h2>persistence.xml</h2>

 <pre><code>&lt;persistence xmlns="http://java.sun.com/xml/ns/persistence" version="1.0"&gt;

   &lt;persistence-unit name="movie-unit"&gt;
     &lt;jta-data-source&gt;movieDatabase&lt;/jta-data-source&gt;
     &lt;non-jta-data-source&gt;movieDatabaseUnmanaged&lt;/non-jta-data-source&gt;
     &lt;class&gt;org.superbiz.injection.tx.Movie&lt;/class&gt;

     &lt;properties&gt;
       &lt;property name="openjpa.jdbc.SynchronizeMappings" value="buildSchema(ForeignKeys=true)"/&gt;
     &lt;/properties&gt;
   &lt;/persistence-unit&gt;
 &lt;/persistence&gt;
 </code></pre>

 <h1>Writing a unit test for the example</h1>

 <p>The magic in the TestCase below is the <em>TransactionBean</em> @Stateless bean
 which is tucked away as an inner class of the TestCase itself.  With this
 bean, we can call our test code within the scope of a container controlled
 transaction.  This allows our test code to use the EntityManager and the
 Entities in the scope of a transaction, avoid any detach issues and
 satisfying the TransactionAttributeType.MANDATORY requirement of our
 MoviesImpl @Stateful bean.
 <div class="snippet">:id=code|url=openejb3/examples/testing-transactions/src/test/java/org/superbiz/injection/tx/MoviesTest.java|lang=java}</p>

 <p>Curious on the InitialContext parameters used?  See the <a href="injection-of-datasource-example.html">Injection of DataSource Example</a>
  for an explanation of how any Resource can be configured via properties in
 the TestCase itself or via an openejb.xml file.</p>

 <h2>MoviesTest</h2>

 <pre><code>package org.superbiz.injection.tx;

 import junit.framework.TestCase;

 import javax.ejb.EJB;
 import javax.ejb.Stateless;
 import javax.ejb.TransactionAttribute;
 import javax.ejb.embeddable.EJBContainer;
 import java.util.List;
 import java.util.Properties;
 import java.util.concurrent.Callable;

 import static javax.ejb.TransactionAttributeType.REQUIRES_NEW;

 /**
  * See the transaction-rollback example as it does the same thing
  * via UserTransaction and shows more techniques for rollback
  */
 //START SNIPPET: code
 public class MoviesTest extends TestCase {

     @EJB
     private Movies movies;

     @EJB
     private Caller transactionalCaller;

     protected void setUp() throws Exception {
         final Properties p = new Properties();
         p.put("movieDatabase", "new://Resource?type=DataSource");
         p.put("movieDatabase.JdbcDriver", "org.hsqldb.jdbcDriver");
         p.put("movieDatabase.JdbcUrl", "jdbc:hsqldb:mem:moviedb");

         EJBContainer.createEJBContainer(p).getContext().bind("inject", this);
     }

     private void doWork() throws Exception {

         movies.addMovie(new Movie("Quentin Tarantino", "Reservoir Dogs", 1992));
         movies.addMovie(new Movie("Joel Coen", "Fargo", 1996));
         movies.addMovie(new Movie("Joel Coen", "The Big Lebowski", 1998));

         List&lt;Movie&gt; list = movies.getMovies();
         assertEquals("List.size()", 3, list.size());

         for (Movie movie : list) {
             movies.deleteMovie(movie);
         }

         assertEquals("Movies.getMovies()", 0, movies.getMovies().size());
     }

     public void testWithTransaction() throws Exception {
         transactionalCaller.call(new Callable() {
             public Object call() throws Exception {
                 doWork();
                 return null;
             }
         });
     }

     public void testWithoutTransaction() throws Exception {
         try {
             doWork();
             fail("The Movies bean should be using TransactionAttributeType.MANDATORY");
         } catch (javax.ejb.EJBTransactionRequiredException e) {
             // good, our Movies bean is using TransactionAttributeType.MANDATORY as we want
         }
     }


     public static interface Caller {
         public &lt;V&gt; V call(Callable&lt;V&gt; callable) throws Exception;
     }

     /**
      * This little bit of magic allows our test code to execute in
      * the scope of a container controlled transaction.
      */
     @Stateless
     @TransactionAttribute(REQUIRES_NEW)
     public static class TransactionBean implements Caller {

         public &lt;V&gt; V call(Callable&lt;V&gt; callable) throws Exception {
             return callable.call();
         }
     }
 }
 </code></pre>

 <h1>Running</h1>

 <pre><code>-------------------------------------------------------
  T E S T S
 -------------------------------------------------------
 Running org.superbiz.injection.tx.MoviesTest
 Apache OpenEJB 4.0.0-beta-1    build: 20111002-04:06
 http://tomee.apache.org/
 INFO - openejb.home = /Users/dblevins/examples/testing-transactions
 INFO - openejb.base = /Users/dblevins/examples/testing-transactions
 INFO - Using 'javax.ejb.embeddable.EJBContainer=true'
 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=movieDatabase, type=Resource, provider-id=Default JDBC Database)
 INFO - Found EjbModule in classpath: /Users/dblevins/examples/testing-transactions/target/classes
 INFO - Found EjbModule in classpath: /Users/dblevins/examples/testing-transactions/target/test-classes
 INFO - Beginning load: /Users/dblevins/examples/testing-transactions/target/classes
 INFO - Beginning load: /Users/dblevins/examples/testing-transactions/target/test-classes
 INFO - Configuring enterprise application: /Users/dblevins/examples/testing-transactions
 INFO - Configuring Service(id=Default Stateful Container, type=Container, provider-id=Default Stateful Container)
 INFO - Auto-creating a container for bean Movies: Container(type=STATEFUL, id=Default Stateful Container)
 INFO - Configuring Service(id=Default Stateless Container, type=Container, provider-id=Default Stateless Container)
 INFO - Auto-creating a container for bean TransactionBean: Container(type=STATELESS, id=Default Stateless Container)
 INFO - Configuring Service(id=Default Managed Container, type=Container, provider-id=Default Managed Container)
 INFO - Auto-creating a container for bean org.superbiz.injection.tx.MoviesTest: Container(type=MANAGED, id=Default Managed Container)
 INFO - Configuring PersistenceUnit(name=movie-unit)
 INFO - Auto-creating a Resource with id 'movieDatabaseNonJta' of type 'DataSource for 'movie-unit'.
 INFO - Configuring Service(id=movieDatabaseNonJta, type=Resource, provider-id=movieDatabase)
 INFO - Adjusting PersistenceUnit movie-unit &lt;non-jta-data-source&gt; to Resource ID 'movieDatabaseNonJta' from 'movieDatabaseUnmanaged'
 INFO - Enterprise application "/Users/dblevins/examples/testing-transactions" loaded.
 INFO - Assembling app: /Users/dblevins/examples/testing-transactions
 INFO - PersistenceUnit(name=movie-unit, provider=org.apache.openjpa.persistence.PersistenceProviderImpl) - provider time 406ms
 INFO - Jndi(name="java:global/testing-transactions/Movies!org.superbiz.injection.tx.Movies")
 INFO - Jndi(name="java:global/testing-transactions/Movies")
 INFO - Jndi(name="java:global/testing-transactions/TransactionBean!org.superbiz.injection.tx.MoviesTest$Caller")
 INFO - Jndi(name="java:global/testing-transactions/TransactionBean")
 INFO - Jndi(name="java:global/EjbModule2036741132/org.superbiz.injection.tx.MoviesTest!org.superbiz.injection.tx.MoviesTest")
 INFO - Jndi(name="java:global/EjbModule2036741132/org.superbiz.injection.tx.MoviesTest")
 INFO - Created Ejb(deployment-id=Movies, ejb-name=Movies, container=Default Stateful Container)
 INFO - Created Ejb(deployment-id=TransactionBean, ejb-name=TransactionBean, container=Default Stateless Container)
 INFO - Created Ejb(deployment-id=org.superbiz.injection.tx.MoviesTest, ejb-name=org.superbiz.injection.tx.MoviesTest, container=Default Managed Container)
 INFO - Started Ejb(deployment-id=Movies, ejb-name=Movies, container=Default Stateful Container)
 INFO - Started Ejb(deployment-id=TransactionBean, ejb-name=TransactionBean, container=Default Stateless Container)
 INFO - Started Ejb(deployment-id=org.superbiz.injection.tx.MoviesTest, ejb-name=org.superbiz.injection.tx.MoviesTest, container=Default Managed Container)
 INFO - Deployed Application(path=/Users/dblevins/examples/testing-transactions)
 INFO - EJBContainer already initialized.  Call ejbContainer.close() to allow reinitialization
 Tests run: 2, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.403 sec

 Results :

 Tests run: 2, Failures: 0, Errors: 0, Skipped: 0
 </code></pre>


         <div id="edit" class="modal hide fade in" style="display: none; ">
             <div class="modal-header">
                 <a class="close" data-dismiss="modal">x</a>

                 <h3>Thank you for contributing to the documentation!</h3>
             </div>
             <div class="modal-body">
                 <h4>Any help with the documentation is greatly appreciated.</h4>
                 <p>All edits are reviewed before going live, so feel free to do much more than fix typos or links.  If you see a page that could benefit from an entire rewrite, we'd be thrilled to review it.  Don't be surprised if we like it so much we ask you for help with other pages :)</p>
                 <small>NOTICE: unless indicated otherwise on the pages in question, all editable content available from apache.org is presumed to be licensed under the Apache License (AL) version 2.0 and hence all submissions to apache.org treated as formal Contributions under the license terms.</small>
                 <!--[if gt IE 6]>
                 <h4>Internet Explorer Users</h4>
                 <p>If you are not an Apache committer, click the Yes link and enter a <i>anonymous</i> for the username and leave the password empty</p>
                 <![endif]-->

             </div>
             <div class="modal-footer">
                 Do you have an Apache ID?
                 <a href="javascript:void(location.href='https://cms.apache.org/redirect?uri='+escape(location.href))" class="btn">Yes</a>
                 <a href="javascript:void(location.href='https://anonymous:@cms.apache.org/redirect?uri='+escape(location.href))" class="btn">No</a>
             </div>
         </div>
         <script src="./resources/js/bootstrap-modal.js"></script>

         <footer>
             <p>Copyright &copy; 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>
         </footer>

     </div> <!-- /container -->

     <!-- Javascript
     ================================================== -->
     <!-- Placed at the end of the document so the pages load faster -->
     <script src="./resources/js/bootstrap-dropdown.js"></script>

   </body>
 </html>
	<!DOCTYPE html>
	<html lang="en">
	<head>

	<meta charset="UTF-8">
	<title>Testing Transactions Example</title>
	<meta name="description" content="Apache TomEE">
	<meta name="author" content="Apache TomEE">
	<meta name="google-translate-customization" content="f36a520c08f4c9-0a04e86a9c075ce9-g265f3196f697cf8f-10">
	<meta http-equiv="Pragma" content="no-cache">
	<meta http-equiv="Expires" content="0">
	<meta http-equiv="Cache-Control" content="no-store, no-cache, must-revalidate, max-age=0">

	<!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
	<!--[if lt IE 9]>
	<script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
	<![endif]-->

	<!-- Le styles -->
	<link href="./resources/css/bootstrap.css" rel="stylesheet">
	<link href="./resources/css/prettify.css" rel="stylesheet">
	<!--link href="./resources/css/bootstrap-mods.css" rel="stylesheet"-->
	<link href="./resources/css/main.css" rel="stylesheet">
	<link href="./resources/font-awesome-4.6.3/css/font-awesome.min.css" rel="stylesheet">

	<script type="text/javascript">
	var t = encodeURIComponent(document.title.replace(/^\s+\|\s+$/g,""));
	var u = encodeURIComponent(""+document.URL);

	function fbshare () {
	window.open(
	"http://www.facebook.com/sharer/sharer.php?u="+u,
	'Share on Facebook',
	'width=640,height=426');
	};
	function gpshare () {
	window.open(
	"https://plus.google.com/share?url="+u,
	'Share on Google+',
	'width=584,height=385');
	};
	function twshare () {
	window.open(
	"https://twitter.com/intent/tweet?url="+u+"&text="+t,
	'Share on Twitter',
	'width=800,height=526');
	};
	function pinshare () {
	window.open("//www.pinterest.com/pin/create/button/?url="+u+"&media=http%3A%2F%2Ftomee.apache.org%2Fresources%2Fimages%2Ffeather-logo.png&description="+t,
	'Share on Pinterest',
	'width=800,height=526');
	};
	</script>

	<!-- Le fav and touch icons -->
	<link rel="shortcut icon" href="./favicon.ico">
	<link rel="apple-touch-icon" href="./resources/images/apple-touch-icon.png">
	<link rel="apple-touch-icon" sizes="72x72" href="./resources/images/apple-touch-icon-72x72.png">
	<link rel="apple-touch-icon" sizes="114x114" href="./resources/images/apple-touch-icon-114x114.png">

	<script src="./resources/js/prettify.js" type="text/javascript"></script>
	<script src="./resources/js/jquery-latest.js"></script>
	<script src="http://platform.twitter.com/widgets.js" type="text/javascript"></script>
	<script src="./resources/js/common.js"></script>
	<script src="./resources/js/prettyprint.js"></script>
	<!--script src="//assets.pinterest.com/js/pinit.js" type="text/javascript" async></script//-->

	<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="topbar" data-dropdown="dropdown">
	<div class="fill">
	<div class="container">
	<a class="brand" href="./index.html">Apache TomEE</a>
	<ul class="nav">
	<li class="dropdown">
	<a class="dropdown-toggle" data-toggle="dropdown" href="#">
	Apache
	<b class="caret"></b>
	</a>
	<ul class="dropdown-menu">
	<!-- <li><a href="./misc/whoweare.html">Who we are?</a></li> -->
	<!-- <li><a href="./misc/heritage.html">Heritage</a></li> -->
	<li><a href="http://www.apache.org">Apache Home</a></li>
	<!-- <li><a href="./misc/resources.html">Resources</a></li> -->
	<li><a href="./misc/contact.html">Contact</a></li>
	<li><a href="./misc/legal.html">Legal</a></li>
	<li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
	<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
	<li class="divider"/>
	<li><a href="http://www.apache.org/security">Security</a></li>
	</ul>
	</li>
	<li><a href="./index.html">Home</a></li>
	<li><a href="./downloads.html">Downloads</a></li>
	<li><a href="./documentation.html">Documentation</a></li>
	<li><a href="./examples-trunk/index.html">Examples</a></li>
	<li><a href="./support.html">Support</a></li>
	<li><a href="./contribute.html">Contribute</a></li>
	<li><a href="./security/index.html">Security</a></li>
	</ul>

	<!-- Google CSE Search Box Begins -->
	<FORM class="pull-right" id="searchbox_010475492895890475512:_t4iqjrgx90" action="http://www.google.com/cse">
	<INPUT type="hidden" name="cx" value="010475492895890475512:_t4iqjrgx90">
	<INPUT type="hidden" name="cof" value="FORID:0">
	<INPUT size="18" width="130" style="width:130px" name="q" type="text" placeholder="Search">
	</FORM>
	<!--<SCRIPT type="text/javascript" src="http://www.google.com/coop/cse/brand?form=searchbox_010475492895890475512:_t4iqjrgx90"></SCRIPT>-->
	<!-- Google CSE Search Box Ends -->
	</div>
	</div>
	</div>

	<div class="container">


	<div class="page-header">
	<small><a href="./index.html">Home</a></small><br>
	<h1>Testing Transactions Example

	<div style="float: right; position: relative; bottom: -10px; ">
	<a onclick="javascript:gpshare()" class="gp-share sprite" title="Share on Google+">share [gp]</a>
	<a onclick="javascript:fbshare()" class="fb-share sprite" title="Share on Facebook">share [fb]</a>
	<a onclick="javascript:twshare()" class="tw-share sprite" title="Share on Twitter">share [tw]</a>
	<a onclick="javascript:pinshare()" class="pin-share sprite" title="Share on Pinterest">share [pin]</a>
	<a data-toggle="modal" href="#edit" class="edit-page" title="Contribute to this Page">contribute</a>
	</div>
	</h1>
	</div>

	<p><a name="TestingTransactionsExample-Overview"></a></p>

	<h1>Overview</h1>

	<p>Testing an EntityManager that uses the default,
	PersistenceContextType.TRANSACTION, can be challenging due to Entities
	detaching around transaction boundaries. If you were to take the <a href="injection-of-entitymanager-example.html">Injection of EntityManager Example</a>
	which uses an EXTENDED persistence context and switch it to a TRANSACTION
	persistence context making no other changes, you'd find that the test would
	fail. This would be because of the detach.</p>

	<p>Generally, when using an EntityManager with TRANSACTION persistence
	context, your transaction should surround your use of the Entities
	themselves, not just the use of the EntityManager. Using a <a href="unit-testing-transactions.html">transaction in your unit test</a>
	can make testing these scenarios possible.</p>

	<p>This example shows use of @PersistenceContext to have an <em>EntityManager</em>
	with an <em>TRANSACTION</em> persistence context injected into a <em>@Stateful</em> bean
	using the <em>@TransactionAttribute</em> annotation and a TestCase that runs test
	code in a JTA <em>Transaction</em>. An EJB 3 @Entity bean is used with the
	EntityManager to create, persist and merge data to a database.</p>

	<p><em>The source for this example is in the "testing-transactions" directory
	located in the <a href="http://tomee.apache.org/downloads.html">openejb-examples.zip</a>
	available on the <a href="http://tomee.apache.org/downloads.html">download page</a>.</em></p>

	<p><a name="TestingTransactionsExample-TheCode"></a></p>

	<h1>The Code</h1>

	<p>In the code below we see that the transaction attribute for all method
	of the bean has been changed the default, which is
	TransactionAttributeType.REQUIRED, to TransactionAttributeType.MANDATORY.
	The MANDATORY transaction attribute is similar to REQUIRED in that the bean
	method is guaranteed to be executed in a transaction, but with the added
	restriction that if a transaction isn't started by the client before
	calling the method, an exception will be thrown. </p>

	<p>The benefit of MANDATORY in this example is that it is impossible for the
	client to get detached Entity issues. The client either has a transaction
	and therefore gets Entities which are still attached and persistent, or the
	client would get an exception stating that the use of a transaction is
	mandatory.</p>

	<p>See the <a href="transaction-annotations.html">Transaction Annotations</a>
	page for a full description of the available transaction attributes.</p>

	<p><a name="TestingTransactionsExample-Writingaunittestfortheexample"></a></p>

	<h2>Movie</h2>

	<pre><code>package org.superbiz.injection.tx;

	import javax.persistence.Entity;

	@Entity
	public class Movie {

	private String director;
	private String title;
	private int year;

	public Movie() {
	}

	public Movie(String director, String title, int year) {
	this.director = director;
	this.title = title;
	this.year = year;
	}

	public String getDirector() {
	return director;
	}

	public void setDirector(String director) {
	this.director = director;
	}

	public String getTitle() {
	return title;
	}

	public void setTitle(String title) {
	this.title = title;
	}

	public int getYear() {
	return year;
	}

	public void setYear(int year) {
	this.year = year;
	}

	}
	</code></pre>

	<h2>Movies</h2>

	<pre><code>package org.superbiz.injection.tx;

	import javax.ejb.Stateful;
	import javax.ejb.TransactionAttribute;
	import javax.persistence.EntityManager;
	import javax.persistence.PersistenceContext;
	import javax.persistence.PersistenceContextType;
	import javax.persistence.Query;
	import java.util.List;

	import static javax.ejb.TransactionAttributeType.MANDATORY;

	//START SNIPPET: code
	@Stateful(name = "Movies")
	@TransactionAttribute(MANDATORY)
	public class Movies {

	@PersistenceContext(unitName = "movie-unit", type = PersistenceContextType.TRANSACTION)
	private EntityManager entityManager;

	public void addMovie(Movie movie) throws Exception {
	entityManager.persist(movie);
	}

	public void deleteMovie(Movie movie) throws Exception {
	entityManager.remove(movie);
	}

	public List<Movie> getMovies() throws Exception {
	Query query = entityManager.createQuery("SELECT m from Movie as m");
	return query.getResultList();
	}
	}
	</code></pre>

	<h2>persistence.xml</h2>

	<pre><code><persistence xmlns="http://java.sun.com/xml/ns/persistence" version="1.0">

	<persistence-unit name="movie-unit">
	<jta-data-source>movieDatabase</jta-data-source>
	<non-jta-data-source>movieDatabaseUnmanaged</non-jta-data-source>
	<class>org.superbiz.injection.tx.Movie</class>

	<properties>
	<property name="openjpa.jdbc.SynchronizeMappings" value="buildSchema(ForeignKeys=true)"/>
	</properties>
	</persistence-unit>
	</persistence>
	</code></pre>

	<h1>Writing a unit test for the example</h1>

	<p>The magic in the TestCase below is the <em>TransactionBean</em> @Stateless bean
	which is tucked away as an inner class of the TestCase itself. With this
	bean, we can call our test code within the scope of a container controlled
	transaction. This allows our test code to use the EntityManager and the
	Entities in the scope of a transaction, avoid any detach issues and
	satisfying the TransactionAttributeType.MANDATORY requirement of our
	MoviesImpl @Stateful bean.
	<div class="snippet">:id=code\|url=openejb3/examples/testing-transactions/src/test/java/org/superbiz/injection/tx/MoviesTest.java\|lang=java}</p>

	<p>Curious on the InitialContext parameters used? See the <a href="injection-of-datasource-example.html">Injection of DataSource Example</a>
	for an explanation of how any Resource can be configured via properties in
	the TestCase itself or via an openejb.xml file.</p>

	<h2>MoviesTest</h2>

	<pre><code>package org.superbiz.injection.tx;

	import junit.framework.TestCase;

	import javax.ejb.EJB;
	import javax.ejb.Stateless;
	import javax.ejb.TransactionAttribute;
	import javax.ejb.embeddable.EJBContainer;
	import java.util.List;
	import java.util.Properties;
	import java.util.concurrent.Callable;

	import static javax.ejb.TransactionAttributeType.REQUIRES_NEW;

	/**
	* See the transaction-rollback example as it does the same thing
	* via UserTransaction and shows more techniques for rollback
	*/
	//START SNIPPET: code
	public class MoviesTest extends TestCase {

	@EJB
	private Movies movies;

	@EJB
	private Caller transactionalCaller;

	protected void setUp() throws Exception {
	final Properties p = new Properties();
	p.put("movieDatabase", "new://Resource?type=DataSource");
	p.put("movieDatabase.JdbcDriver", "org.hsqldb.jdbcDriver");
	p.put("movieDatabase.JdbcUrl", "jdbc:hsqldb:mem:moviedb");

	EJBContainer.createEJBContainer(p).getContext().bind("inject", this);
	}

	private void doWork() throws Exception {

	movies.addMovie(new Movie("Quentin Tarantino", "Reservoir Dogs", 1992));
	movies.addMovie(new Movie("Joel Coen", "Fargo", 1996));
	movies.addMovie(new Movie("Joel Coen", "The Big Lebowski", 1998));

	List<Movie> list = movies.getMovies();
	assertEquals("List.size()", 3, list.size());

	for (Movie movie : list) {
	movies.deleteMovie(movie);
	}

	assertEquals("Movies.getMovies()", 0, movies.getMovies().size());
	}

	public void testWithTransaction() throws Exception {
	transactionalCaller.call(new Callable() {
	public Object call() throws Exception {
	doWork();
	return null;
	}
	});
	}

	public void testWithoutTransaction() throws Exception {
	try {
	doWork();
	fail("The Movies bean should be using TransactionAttributeType.MANDATORY");
	} catch (javax.ejb.EJBTransactionRequiredException e) {
	// good, our Movies bean is using TransactionAttributeType.MANDATORY as we want
	}
	}


	public static interface Caller {
	public <V> V call(Callable<V> callable) throws Exception;
	}

	/**
	* This little bit of magic allows our test code to execute in
	* the scope of a container controlled transaction.
	*/
	@Stateless
	@TransactionAttribute(REQUIRES_NEW)
	public static class TransactionBean implements Caller {

	public <V> V call(Callable<V> callable) throws Exception {
	return callable.call();
	}
	}
	}
	</code></pre>

	<h1>Running</h1>

	<pre><code>-------------------------------------------------------
	T E S T S
	-------------------------------------------------------
	Running org.superbiz.injection.tx.MoviesTest
	Apache OpenEJB 4.0.0-beta-1 build: 20111002-04:06
	http://tomee.apache.org/
	INFO - openejb.home = /Users/dblevins/examples/testing-transactions
	INFO - openejb.base = /Users/dblevins/examples/testing-transactions
	INFO - Using 'javax.ejb.embeddable.EJBContainer=true'
	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=movieDatabase, type=Resource, provider-id=Default JDBC Database)
	INFO - Found EjbModule in classpath: /Users/dblevins/examples/testing-transactions/target/classes
	INFO - Found EjbModule in classpath: /Users/dblevins/examples/testing-transactions/target/test-classes
	INFO - Beginning load: /Users/dblevins/examples/testing-transactions/target/classes
	INFO - Beginning load: /Users/dblevins/examples/testing-transactions/target/test-classes
	INFO - Configuring enterprise application: /Users/dblevins/examples/testing-transactions
	INFO - Configuring Service(id=Default Stateful Container, type=Container, provider-id=Default Stateful Container)
	INFO - Auto-creating a container for bean Movies: Container(type=STATEFUL, id=Default Stateful Container)
	INFO - Configuring Service(id=Default Stateless Container, type=Container, provider-id=Default Stateless Container)
	INFO - Auto-creating a container for bean TransactionBean: Container(type=STATELESS, id=Default Stateless Container)
	INFO - Configuring Service(id=Default Managed Container, type=Container, provider-id=Default Managed Container)
	INFO - Auto-creating a container for bean org.superbiz.injection.tx.MoviesTest: Container(type=MANAGED, id=Default Managed Container)
	INFO - Configuring PersistenceUnit(name=movie-unit)
	INFO - Auto-creating a Resource with id 'movieDatabaseNonJta' of type 'DataSource for 'movie-unit'.
	INFO - Configuring Service(id=movieDatabaseNonJta, type=Resource, provider-id=movieDatabase)
	INFO - Adjusting PersistenceUnit movie-unit <non-jta-data-source> to Resource ID 'movieDatabaseNonJta' from 'movieDatabaseUnmanaged'
	INFO - Enterprise application "/Users/dblevins/examples/testing-transactions" loaded.
	INFO - Assembling app: /Users/dblevins/examples/testing-transactions
	INFO - PersistenceUnit(name=movie-unit, provider=org.apache.openjpa.persistence.PersistenceProviderImpl) - provider time 406ms
	INFO - Jndi(name="java:global/testing-transactions/Movies!org.superbiz.injection.tx.Movies")
	INFO - Jndi(name="java:global/testing-transactions/Movies")
	INFO - Jndi(name="java:global/testing-transactions/TransactionBean!org.superbiz.injection.tx.MoviesTest$Caller")
	INFO - Jndi(name="java:global/testing-transactions/TransactionBean")
	INFO - Jndi(name="java:global/EjbModule2036741132/org.superbiz.injection.tx.MoviesTest!org.superbiz.injection.tx.MoviesTest")
	INFO - Jndi(name="java:global/EjbModule2036741132/org.superbiz.injection.tx.MoviesTest")
	INFO - Created Ejb(deployment-id=Movies, ejb-name=Movies, container=Default Stateful Container)
	INFO - Created Ejb(deployment-id=TransactionBean, ejb-name=TransactionBean, container=Default Stateless Container)
	INFO - Created Ejb(deployment-id=org.superbiz.injection.tx.MoviesTest, ejb-name=org.superbiz.injection.tx.MoviesTest, container=Default Managed Container)
	INFO - Started Ejb(deployment-id=Movies, ejb-name=Movies, container=Default Stateful Container)
	INFO - Started Ejb(deployment-id=TransactionBean, ejb-name=TransactionBean, container=Default Stateless Container)
	INFO - Started Ejb(deployment-id=org.superbiz.injection.tx.MoviesTest, ejb-name=org.superbiz.injection.tx.MoviesTest, container=Default Managed Container)
	INFO - Deployed Application(path=/Users/dblevins/examples/testing-transactions)
	INFO - EJBContainer already initialized. Call ejbContainer.close() to allow reinitialization
	Tests run: 2, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.403 sec

	Results :

	Tests run: 2, Failures: 0, Errors: 0, Skipped: 0
	</code></pre>




	<div id="edit" class="modal hide fade in" style="display: none; ">
	<div class="modal-header">
	<a class="close" data-dismiss="modal">x</a>

	<h3>Thank you for contributing to the documentation!</h3>
	</div>
	<div class="modal-body">
	<h4>Any help with the documentation is greatly appreciated.</h4>
	<p>All edits are reviewed before going live, so feel free to do much more than fix typos or links. If you see a page that could benefit from an entire rewrite, we'd be thrilled to review it. Don't be surprised if we like it so much we ask you for help with other pages :)</p>
	<small>NOTICE: unless indicated otherwise on the pages in question, all editable content available from apache.org is presumed to be licensed under the Apache License (AL) version 2.0 and hence all submissions to apache.org treated as formal Contributions under the license terms.</small>
	<!--[if gt IE 6]>
	<h4>Internet Explorer Users</h4>
	<p>If you are not an Apache committer, click the Yes link and enter a <i>anonymous</i> for the username and leave the password empty</p>
	<![endif]-->

	</div>
	<div class="modal-footer">
	Do you have an Apache ID?
	<a href="javascript:void(location.href='https://cms.apache.org/redirect?uri='+escape(location.href))" class="btn">Yes</a>
	<a href="javascript:void(location.href='https://anonymous:@cms.apache.org/redirect?uri='+escape(location.href))" class="btn">No</a>
	</div>
	</div>
	<script src="./resources/js/bootstrap-modal.js"></script>

	<footer>
	<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>
	</footer>

	</div> <!-- /container -->

	<!-- Javascript
	================================================== -->
	<!-- Placed at the end of the document so the pages load faster -->
	<script src="./resources/js/bootstrap-dropdown.js"></script>

	</body>
	</html>