| <!DOCTYPE html> |
| <html lang="en"> |
| <head> |
| |
| <meta charset="UTF-8"> |
| <title>Xbean usage in OpenEJB</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> » <a href="./../dev/">Dev</a></small><br> |
| <h1>Xbean usage in OpenEJB |
| |
| <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="XbeanusageinOpenEJB-HowXBeanisusedinOpenEJB"></a></p> |
| |
| <h1>How XBean is used in OpenEJB</h1> |
| |
| <p>Below is an explanation by David Blevins on the usage of xbean in OpenEJB. This text was taken from an email conversation. To view the full conversation, click <a href="http://www.nabble.com/How-is-XBean-used-in-OpenEJB-3--tf2148639.html#a5959172">here</a></p> |
| |
| <p><a name="XbeanusageinOpenEJB-xbean-reflect"></a></p> |
| |
| <h2>xbean-reflect</h2> |
| |
| <p>xbean-reflect is a beefed up reflection library.</p> |
| |
| <p>Earlier all pluggable components had an "init(Properties props)" method? |
| Same concept except now we throw the component class and the |
| properties into an "ObjectRecipe" and call create(). The recipe will |
| take the props out, convert them to the right data types, and construct |
| the object using the right constructor and setters.</p> |
| |
| <p>So our Containers and stuff now use constructors and setters. Same with anything in a <a href="http://svn.apache.org/viewvc/tomee/tomee/trunk/container/openejb-core/src/main/resources/META-INF/org.apache.openejb/service-jar.xml?view=markup">service-jar.xml</a> |
| file.</p> |
| |
| <p><a name="XbeanusageinOpenEJB-Somecoderefs:"></a></p> |
| |
| <h4>Some code refs:</h4> |
| |
| <ol> |
| <li><a href="http://svn.apache.org/viewvc/tomee/tomee/trunk/container/openejb-core/src/main/java/org/apache/openejb/assembler/classic/Assembler.java?revision=546308&view=markup">Assembler.java</a> |
| We also use it to construct Stateful and Stateless session bean instances.</li> |
| <li><a href="http://svn.apache.org/viewvc/tomee/tomee/trunk/container/openejb-core/src/main/java/org/apache/openejb/core/stateful/StatefulInstanceManager.java?revision=546308&view=markup">StatefulInstanceManager.java</a></li> |
| <li><a href="http://svn.apache.org/viewvc/tomee/tomee/trunk/container/openejb-core/src/main/java/org/apache/openejb/core/stateless/StatelessInstanceManager.java?revision=546308&view=markup">StatelessInstanceManager.java</a></li> |
| </ol> |
| |
| <p><a name="XbeanusageinOpenEJB-xbean-finder"></a></p> |
| |
| <h2>xbean-finder</h2> |
| |
| <p>xbean-finder is the second coolest library ever. It's a beefed |
| up service finder for grabbing stuff in your classpath. We use |
| it at a couple of places.</p> |
| |
| <p><a name="XbeanusageinOpenEJB-COMMANDLINETOOL:"></a></p> |
| |
| <h3>COMMAND LINE TOOL:</h3> |
| |
| <p>The available commands are in properties files in |
| "META-INF/org.openejb.cli/{name}", where {name} is the name of the |
| command. See: |
| 1. <a href="http://svn.apache.org/viewvc/tomee/tomee/trunk/container/openejb-core/src/main/resources/META-INF/org.apache.openejb.cli/">openejb cli</a> |
| 1. <a href="http://svn.apache.org/viewvc/tomee/tomee/trunk/itests/openejb-itests-client/src/main/resources/META-INF/org.openejb.cli/">openejb cli for itests</a></p> |
| |
| <p>Earlier we had the "test" command hardcoded in a script, but the |
| person may have uninstalled the itests? Well now, if you have |
| the itests jar, the "test" command will be available. If you |
| don't have the itests jar, the "test" |
| command won't be available. The "test" command itself is in the |
| itests jar. You can put any command in any jar and it will |
| automatically become available on the command line. Remove the |
| jar and the command is gone.</p> |
| |
| <p>When someone types "java -jar openejb.jar start" this guy will look |
| for "META-INF/org.openejb.cli/start". If he finds it, he'll |
| create it and execute it. If he doesn't find it, he'll list the |
| available commands by enumerating over all the files he see's in the |
| classpath under the "META-INF/org.openejb.cli/" directory. See <a href="http://svn.apache.org/viewvc/tomee/tomee/trunk/container/openejb-core/src/main/java/org/apache/openejb/cli/MainImpl.java?revision=546308&view=markup">MainImpl.java</a></p> |
| |
| <p>An extra cool thing is that each command has in it's properties a |
| "description" property. This is localized, so if the VM locale |
| is "pl" it will look for a "description.pl" property and use its |
| value when printing command line help. |
| I'd like to give Jeremy Whitlock a big shout-out for doing such a |
| bang up job on this. He and I worked out the idea and |
| white-boarded it in the wiki, then Jeremy went off and coded up the |
| whole thing! It was fantastic.</p> |
| |
| <p><a name="XbeanusageinOpenEJB-SERVERSERVICES:"></a></p> |
| |
| <h3>SERVER SERVICES:</h3> |
| |
| <p>We also use the xbean-finder to create our Server Services (aka. |
| protocols). Our ServerService implementations are in properties |
| files under "META-INF/org.openejb.server.ServerService/{protocolName}. |
| See: |
| 1. <a href="http://svn.apache.org/viewvc/tomee/tomee/trunk/server/openejb-server/src/main/resources/META-INF/org.apache.openejb.server.ServerService/">OpenEJB Server - ServerService</a> |
| 1. <a href="http://svn.apache.org/viewvc/tomee/tomee/trunk/server/openejb-ejbd/src/main/resources/META-INF/org.apache.openejb.server.ServerService/">OpenEJB ejbd - ServerService</a> |
| 1. <a href="http://svn.apache.org/viewvc/tomee/tomee/trunk/server/openejb-telnet/src/main/resources/META-INF/org.apache.openejb.server.ServerService/">OpenEJB Telnet - ServerService</a> |
| 1. <a href="http://svn.apache.org/viewvc/tomee/tomee/trunk/server/openejb-http/src/main/resources/META-INF/org.apache.openejb.server.ServerService/">OpenEJB HTTP - ServerService</a></p> |
| |
| <p>The very first time a ServerService is constructed, we squirt the |
| properties file into the openejb/conf/ directory so the user can edit |
| it. The properties files for ServerServices are very xinet.d |
| like. For example, here is the definition of the "admin" server |
| service:</p> |
| |
| <p> server = |
| org.openejb.server.admin.AdminDaemon |
| bind = 127.0.0.1 |
| port = 4200 |
| disabled = false |
| threads = 1 |
| only_from = localhost</p> |
| |
| <p>You can reconfigure the "admin" server service, for example, via the |
| properties file in openejb/conf/admin.properties. Or you can do |
| it on the command line as such:</p> |
| |
| <p><in-a-shell> |
| $ ./bin/openejb start -Dadmin.bind=192.168.42.13 |
| OPENEJB_HOME=/Users/dblevins/work/openejb1/target/openejb-1.1-SNAPSHOT |
| OpenEJB 1.1-SNAPSHOT build: 20060420-2356 |
| <a href="http://www.openejb.org">http://www.openejb.org</a> |
| resources 1 |
| OpenEJB ready. |
| [init](init.html) |
| OpenEJB Remote Server |
| ** Starting Services ** |
| NAME |
| IP PORT |
| webadmin 127.0.0.1 |
| 4203 |
| httpejbd 127.0.0.1 |
| 4204 |
| telnet |
| 127.0.0.1 4202 |
| ejbd |
| 127.0.0.1 4201 |
| admin |
| 192.168.42.13 4200 |
| ------- |
| Ready! |
| </in-a-shell></p> |
| |
| <p>You can override any server service property in the same way. |
| Here are a bunch more examples:</p> |
| |
| <p> Option: -D<service>.bind=<address> |
| openejb start -Dejbd.bind=10.45.67.8 |
| openejb start -Dejbd.bind=myhost.foo.com |
| openejb start -Dtelnet.bind=myhost.foo.com</p> |
| |
| <p> Option: -D<service>.port=<port> |
| openejb start -Dejbd.port=8765 |
| openejb start -Dhttpejbd.port=8888</p> |
| |
| <p> Option: -D<service>.only_from=<addresses> |
| openejb start -Dadmin.only_from=192.168.1.12 |
| openejb start |
| -Dadmin.only_from=192.168.1.12,joe.foo.com,robert</p> |
| |
| <p> Option: -D<service>.threads=<max> |
| openejb start -Dejbd.threads=200</p> |
| |
| <p> Option: -D<service>.disabled=<true/false> |
| openejb start -Dtelnet.disabled=true</p> |
| |
| |
| |
| |
| <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> |
