| <!DOCTYPE html> | 
 | <html lang="en"> | 
 |   <head> | 
 |  | 
 |     <meta charset="UTF-8"> | 
 |       <title></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> | 
 |  | 
 |         <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> | 
 |  | 
 | <ul> | 
 | <li><a href="alternate-descriptors.html">alternate-descriptors</a></li> | 
 | <li><a href="annotations,-xml-and-defaults.html">annotations,-xml-and-defaults</a></li> | 
 | <li><a href="apache-openejb-3.1.3.html">apache-openejb-3.1.3</a></li> | 
 | <li><a href="apache-openejb-3.1.4.html">apache-openejb-3.1.4</a></li> | 
 | <li><a href="apache-tomee.html">apache-tomee</a></li> | 
 | <li><a href="app-clients-and-jndi.html">app-clients-and-jndi</a></li> | 
 | <li><a href="application-discovery-via-the-classpath.html">application-discovery-via-the-classpath</a></li> | 
 | <li><a href="articles.html">articles</a></li> | 
 | <li><a href="basics---getting-things.html">basics---getting-things</a></li> | 
 | <li><a href="basics---security.html">basics---security</a></li> | 
 | <li><a href="basics---transactions.html">basics---transactions</a></li> | 
 | <li><a href="built-in-type-converters.html">built-in-type-converters</a></li> | 
 | <li><a href="callbacks.html">callbacks</a></li> | 
 | <li><a href="client-server-transports.html">client-server-transports</a></li> | 
 | <li><a href="clients.html">clients</a></li> | 
 | <li><a href="collapsed-ear.html">collapsed-ear</a></li> | 
 | <li><a href="common-datasource-configurations.html">common-datasource-configurations</a></li> | 
 | <li><a href="common-errors.html">common-errors</a></li> | 
 | <li><a href="common-persistenceprovider-properties.html">common-persistenceprovider-properties</a></li> | 
 | <li><a href="concepts.html">concepts</a></li> | 
 | <li><a href="configuration.html">configuration</a></li> | 
 | <li><a href="configuring-containers-in-tests.html">configuring-containers-in-tests</a></li> | 
 | <li><a href="configuring-datasources-in-tests.html">configuring-datasources-in-tests</a></li> | 
 | <li><a href="configuring-datasources.html">configuring-datasources</a></li> | 
 | <li><a href="configuring-durations.html">configuring-durations</a></li> | 
 | <li><a href="configuring-javamail.html">configuring-javamail</a></li> | 
 | <li><a href="configuring-logging-in-tests.html">configuring-logging-in-tests</a></li> | 
 | <li><a href="configuring-persistenceunits-in-tests.html">configuring-persistenceunits-in-tests</a></li> | 
 | <li><a href="constructor-injection.html">constructor-injection</a></li> | 
 | <li><a href="containers-and-resources.html">containers-and-resources</a></li> | 
 | <li><a href="custom-injection.html">custom-injection</a></li> | 
 | <li><a href="datasource-password-encryption.html">datasource-password-encryption</a></li> | 
 | <li><a href="deploy-tool.html">deploy-tool</a></li> | 
 | <li><a href="deployment-id.html">deployment-id</a></li> | 
 | <li><a href="deployments.html">deployments</a></li> | 
 | <li><a href="details-on-openejb-jar.html">details-on-openejb-jar</a></li> | 
 | <li><a href="documentation.html">documentation</a></li> | 
 | <li><a href="downloads.html">downloads</a></li> | 
 | <li><a href="dynamic-datasource.html">dynamic-datasource</a></li> | 
 | <li><a href="eclipse-plugin.html">eclipse-plugin</a></li> | 
 | <li><a href="ejb-+-jpa-+-jsf-+-jax-rs.html">ejb-+-jpa-+-jsf-+-jax-rs</a></li> | 
 | <li><a href="ejb-2.1-compatibility-example.html">ejb-2.1-compatibility-example</a></li> | 
 | <li><a href="ejb-3-roadmap.html">ejb-3-roadmap</a></li> | 
 | <li><a href="ejb-3.0-specification.html">ejb-3.0-specification</a></li> | 
 | <li><a href="ejb-3.1-roadmap.html">ejb-3.1-roadmap</a></li> | 
 | <li><a href="ejb-annotation-example.html">ejb-annotation-example</a></li> | 
 | <li><a href="ejb-annotation-examples.html">ejb-annotation-examples</a></li> | 
 | <li><a href="ejb-example.html">ejb-example</a></li> | 
 | <li><a href="ejb-examples.html">ejb-examples</a></li> | 
 | <li><a href="ejb-glossary.html">ejb-glossary</a></li> | 
 | <li><a href="ejb-howto.html">ejb-howto</a></li> | 
 | <li><a href="ejb-local-ref.html">ejb-local-ref</a></li> | 
 | <li><a href="ejb-ref.html">ejb-ref</a></li> | 
 | <li><a href="ejb-refs.html">ejb-refs</a></li> | 
 | <li><a href="ejb-sample-applications.html">ejb-sample-applications</a></li> | 
 | <li><a href="ejb-sample.html">ejb-sample</a></li> | 
 | <li><a href="ejb-samples.html">ejb-samples</a></li> | 
 | <li><a href="ejb-servlet.html">ejb-servlet</a></li> | 
 | <li><a href="ejb-tutorial.html">ejb-tutorial</a></li> | 
 | <li><a href="ejb-tutorials.html">ejb-tutorials</a></li> | 
 | <li><a href="ejb3-annotation-example.html">ejb3-annotation-example</a></li> | 
 | <li><a href="ejb3-annotation-examples.html">ejb3-annotation-examples</a></li> | 
 | <li><a href="ejb3-example.html">ejb3-example</a></li> | 
 | <li><a href="ejb3-examples.html">ejb3-examples</a></li> | 
 | <li><a href="ejb3-howto.html">ejb3-howto</a></li> | 
 | <li><a href="ejb3-sample-applications.html">ejb3-sample-applications</a></li> | 
 | <li><a href="ejb3-sample.html">ejb3-sample</a></li> | 
 | <li><a href="ejb3-samples.html">ejb3-samples</a></li> | 
 | <li><a href="ejb3-tutorial.html">ejb3-tutorial</a></li> | 
 | <li><a href="ejb3-tutorials.html">ejb3-tutorials</a></li> | 
 | <li><a href="embedded-and-remotable.html">embedded-and-remotable</a></li> | 
 | <li><a href="embedded-configuration.html">embedded-configuration</a></li> | 
 | <li><a href="embedding.html">embedding</a></li> | 
 | <li><a href="example.html">example</a></li> | 
 | <li><a href="examples-table.html">examples-table</a></li> | 
 | <li><a href="failover-logging.html">failover-logging</a></li> | 
 | <li><a href="failover.html">failover</a></li> | 
 | <li><a href="faq.html">faq</a></li> | 
 | <li><a href="faq_openejb-jar.html.html">faq_openejb-jar.html</a></li> | 
 | <li><a href="features.html">features</a></li> | 
 | <li><a href="functional-testing-with-openejb,-jetty-and-selenium.html">functional-testing-with-openejb,-jetty-and-selenium</a></li> | 
 | <li><a href="generating-ejb-3-annotations.html">generating-ejb-3-annotations</a></li> | 
 | <li><a href="geronimo.html">geronimo</a></li> | 
 | <li><a href="getting-started.html">getting-started</a></li> | 
 | <li><a href="hello-world.html">hello-world</a></li> | 
 | <li><a href="hibernate.html">hibernate</a></li> | 
 | <li><a href="injection-of-datasource-example.html">injection-of-datasource-example</a></li> | 
 | <li><a href="injection-of-entitymanager-example.html">injection-of-entitymanager-example</a></li> | 
 | <li><a href="injection-of-env-entry-example.html">injection-of-env-entry-example</a></li> | 
 | <li><a href="injection-of-other-ejbs-example.html">injection-of-other-ejbs-example</a></li> | 
 | <li><a href="installation.html">installation</a></li> | 
 | <li><a href="javaagent-with-maven-surefire.html">javaagent-with-maven-surefire</a></li> | 
 | <li><a href="javaagent.html">javaagent</a></li> | 
 | <li><a href="jms-resources-and-mdb-container.html">jms-resources-and-mdb-container</a></li> | 
 | <li><a href="jndi-names.html">jndi-names</a></li> | 
 | <li><a href="jpa-concepts.html">jpa-concepts</a></li> | 
 | <li><a href="jpa-usage.html">jpa-usage</a></li> | 
 | <li><a href="lightening-demos.html">lightening-demos</a></li> | 
 | <li><a href="local-client-injection.html">local-client-injection</a></li> | 
 | <li><a href="local-server.html">local-server</a></li> | 
 | <li><a href="lookup-of-other-ejbs-example.html">lookup-of-other-ejbs-example</a></li> | 
 | <li><a href="mailing-lists.html">mailing-lists</a></li> | 
 | <li><a href="management-and-voting.html">management-and-voting</a></li> | 
 | <li><a href="manual-installation.html">manual-installation</a></li> | 
 | <li><a href="multiple-business-interface-hazzards.html">multiple-business-interface-hazzards</a></li> | 
 | <li><a href="new-in-openejb-3.0.html">new-in-openejb-3.0</a></li> | 
 | <li><a href="openejb-0.9.2.html">openejb-0.9.2</a></li> | 
 | <li><a href="openejb-1.0-beta-1.html">openejb-1.0-beta-1</a></li> | 
 | <li><a href="openejb-1.0-test-matrix.html">openejb-1.0-test-matrix</a></li> | 
 | <li><a href="openejb-1.0.html">openejb-1.0</a></li> | 
 | <li><a href="openejb-3.0-beta-1.html">openejb-3.0-beta-1</a></li> | 
 | <li><a href="openejb-3.0-beta-2.html">openejb-3.0-beta-2</a></li> | 
 | <li><a href="openejb-3.0.html">openejb-3.0</a></li> | 
 | <li><a href="openejb-3.1.1.html">openejb-3.1.1</a></li> | 
 | <li><a href="openejb-3.1.2.html">openejb-3.1.2</a></li> | 
 | <li><a href="openejb-3.1.html">openejb-3.1</a></li> | 
 | <li><a href="openejb-3.html">openejb-3</a></li> | 
 | <li><a href="openejb-binaries.html">openejb-binaries</a></li> | 
 | <li><a href="openejb-eclipse-plugin.html">openejb-eclipse-plugin</a></li> | 
 | <li><a href="openejb-jsr-107-integration.html">openejb-jsr-107-integration</a></li> | 
 | <li><a href="openejb.xml.html">openejb.xml</a></li> | 
 | <li><a href="openjpa.html">openjpa</a></li> | 
 | <li><a href="persistence-context.html">persistence-context</a></li> | 
 | <li><a href="persistence-unit-ref.html">persistence-unit-ref</a></li> | 
 | <li><a href="privacy-policy.html">privacy-policy</a></li> | 
 | <li><a href="properties-tool.html">properties-tool</a></li> | 
 | <li><a href="property-overriding.html">property-overriding</a></li> | 
 | <li><a href="quickstart.html">quickstart</a></li> | 
 | <li><a href="remote-server.html">remote-server</a></li> | 
 | <li><a href="resource-injection.html">resource-injection</a></li> | 
 | <li><a href="resource-ref-for-datasource.html">resource-ref-for-datasource</a></li> | 
 | <li><a href="running-a-standalone-openejb-server.html">running-a-standalone-openejb-server</a></li> | 
 | <li><a href="securing-a-web-service.html">securing-a-web-service</a></li> | 
 | <li><a href="security-annotations.html">security-annotations</a></li> | 
 | <li><a href="security.html">security</a></li> | 
 | <li><a href="service-locator.html">service-locator</a></li> | 
 | <li><a href="simple-stateful-example.html">simple-stateful-example</a></li> | 
 | <li><a href="simple-stateless-example.html">simple-stateless-example</a></li> | 
 | <li><a href="singleton-beans.html">singleton-beans</a></li> | 
 | <li><a href="singleton-ejb.html">singleton-ejb</a></li> | 
 | <li><a href="singleton-example.html">singleton-example</a></li> | 
 | <li><a href="site-index.html">site-index</a></li> | 
 | <li><a href="spring-and-openejb-3.0.html">spring-and-openejb-3.0</a></li> | 
 | <li><a href="spring-ejb-and-jpa.html">spring-ejb-and-jpa</a></li> | 
 | <li><a href="spring.html">spring</a></li> | 
 | <li><a href="startup.html">startup</a></li> | 
 | <li><a href="support.html">support</a></li> | 
 | <li><a href="system-properties.html">system-properties</a></li> | 
 | <li><a href="team.html">team</a></li> | 
 | <li><a href="telnet-console.html">telnet-console</a></li> | 
 | <li><a href="testcase-with-testbean-inner-class.html">testcase-with-testbean-inner-class</a></li> | 
 | <li><a href="testing-security-example.html">testing-security-example</a></li> | 
 | <li><a href="testing-transactions-example.html">testing-transactions-example</a></li> | 
 | <li><a href="time-saved.html">time-saved</a></li> | 
 | <li><a href="tomcat-detailed-instructions.html">tomcat-detailed-instructions</a></li> | 
 | <li><a href="tomcat-ejb-refs.html">tomcat-ejb-refs</a></li> | 
 | <li><a href="tomcat-installation.html">tomcat-installation</a></li> | 
 | <li><a href="tomcat-object-factory.html">tomcat-object-factory</a></li> | 
 | <li><a href="tomcat.html">tomcat</a></li> | 
 | <li><a href="transaction-annotations.html">transaction-annotations</a></li> | 
 | <li><a href="understanding-callbacks.html">understanding-callbacks</a></li> | 
 | <li><a href="understanding-the-directory-layout.html">understanding-the-directory-layout</a></li> | 
 | <li><a href="unit-testing-transactions.html">unit-testing-transactions</a></li> | 
 | <li><a href="validation-tool.html">validation-tool</a></li> | 
 | <li><a href="webadmin.html">webadmin</a></li> | 
 | <li><a href="webobjects.html">webobjects</a></li> | 
 | </ul> | 
 |  | 
 |  | 
 |  | 
 |  | 
 |         <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> |