blob: 44e41feabb207f289d733302760289c7d260a7e7 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<HEAD>
<!-- $PAGETITLE -->
<TITLE>OpenEJB - Clients</TITLE>
<LINK href="http://openejb.apache.org/all.css" rel="stylesheet" type="text/css">
<!--[if IE]><link rel="stylesheet" type="text/css" media="screen, projection" href="openejb.apache.org/ie.css"><![endif]-->
<LINK rel="SHORTCUT ICON" href="http://openejb.apache.org/images/favicon.ico">
<META http-equiv="Content-Type" content="text/html;charset=UTF-8">
</HEAD>
<BODY>
<!-- Delay the loading of the external javascript file needed for labels (as it takes too long to load and visibly holds loading of the page body) -->
<!-- To do this without javascript errors over undefined functions, we need to declare stubs here (that are overrided later by the proper implementations) -->
<SCRIPT language="JavaScript" type="text/javascript">
function doAddLabel(hideTextfieldAfterAddParam)
{
// stub
}
function onAddLabel()
{
// stub
}
function showLabelsInput()
{
// stub
}
</SCRIPT>
<A name="top"></A>
<TABLE class="frameTable" cellpadding="0" cellspacing="0" border="0">
<TR class="Row1">
<TD class="Col1"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD>
<TD class="Col2"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD>
<TD class="Col3"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD>
<TD class="Col4"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD>
<TD class="Col5"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD>
</TR>
<TR class="Row2">
<TD class="Col1"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD>
<TD class="Col2">&nbsp;</TD>
<TD class="Col3" id="breadcrumbs">
<!-- $TOP_NAV_BAR -->
<A href="../OPENEJB/index.html" title="Index">Home</A> | <A href="../OPENEJB/download.html" title="Download">Download</A> | <A href="../OPENEJB/mailing-lists.html" title="Mailing Lists">Lists</A> | <A href="http://issues.apache.org/jira/browse/OPENEJB" class="external-link" rel="nofollow">Issues</A>
</TD>
<TD class="Col4"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD>
<TD class="Col5">&nbsp;</TD>
</TR>
<TR class="Row3">
<TD class="Col1"><IMG alt="" class="Row3Img" id="thinLine" src="http://openejb.apache.org/images/line_sm.gif"></TD>
<TD class="Col2"><IMG alt="" class="Row3Img" src="http://openejb.apache.org/images/dotTrans.gif"></TD>
<TD class="Col3"><IMG alt="" class="Row3Img" src="http://openejb.apache.org/images/dotTrans.gif"></TD>
<TD class="Col4"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD>
<TD class="Col5"><IMG alt="" class="Row3Img" src="http://openejb.apache.org/images/dotTrans.gif"></TD>
</TR>
<TR class="Row4">
<TD class="Col1">
<SPAN id="Navigation">
<H3><A name="Navigation-Overview"></A>Overview</H3>
<UL class="alternate" type="square">
<LI><A href="../OPENEJB/index.html" title="Index">Home</A></LI>
<LI><A href="../OPENEJB/news.html" title="News">News</A></LI>
<LI><A href="../OPENEJB/faq.html" title="FAQ">FAQ</A></LI>
<LI><A href="../OPENEJB/download.html" title="Download">Download</A></LI>
<LI><A href="index.html" title="Index">Documentation</A></LI>
<LI><A href="../OPENEJB/examples.html" title="Examples">Examples</A></LI>
<LI><A href="http://cwiki.apache.org/confluence/display/OPENEJB/Lightening%20Demos" class="external-link" rel="nofollow">Lightning Demos</A></LI>
<LI><A href="../OPENEJB/mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
<LI><A href="../OPENEJB/source-code.html" title="Source Code">Source Code</A></LI>
<LI><A href="http://blogs.apache.org/openejb" class="external-link" rel="nofollow">Project Blog</A></LI>
</UL>
<H3><A name="Navigation-Servers"></A>Servers</H3>
<UL class="alternate" type="square">
<LI><A href="../OPENEJB/local-server.html" title="Local Server">Local</A></LI>
<LI><A href="../OPENEJB/remote-server.html" title="Remote Server">Remote</A></LI>
</UL>
<H3><A name="Navigation-Integrations"></A>Integrations</H3>
<UL class="alternate" type="square">
<LI><A href="tomcat.html" title="Tomcat">Tomcat</A></LI>
<LI><A href="../OPENEJB/geronimo.html" title="Geronimo">Geronimo</A></LI>
<LI><A href="../OPENEJB/webobjects.html" title="WebObjects">WebObjects</A></LI>
</UL>
<H3><A name="Navigation-Community"></A>Community</H3>
<UL class="alternate" type="square">
<LI><A href="../OPENEJB/team.html" title="Team">Team</A></LI>
<LI><A href="../OPENEJB/articles.html" title="Articles">Articles</A></LI>
<LI><A href="http://webchat.freenode.net/?channels=openejb" class="external-link" rel="nofollow">IRC</A></LI>
</UL>
<H3><A name="Navigation-RelatedProjects"></A>Related Projects</H3>
<UL class="alternate" type="square">
<LI><A href="http://activemq.apache.org/" class="external-link" rel="nofollow">ActiveMQ</A></LI>
<LI><A href="http://openjpa.apache.org/" class="external-link" rel="nofollow">OpenJPA</A></LI>
<LI><A href="http://cxf.apache.org/" class="external-link" rel="nofollow">CXF</A></LI>
</UL>
<H3><A name="Navigation-Index"></A>Index</H3>
<UL class="alternate" type="square">
<LI><A href="../OPENEJB/space-index.html" title="Space Index">Site Index</A></LI>
<LI><A href="space-index.html" title="Space Index">Doc Index</A></LI>
</UL>
<H3>
<A name="Navigation-Feeds"></A>
Feeds
</H3>
<UL class="feeds">
<LI>
<A href="http://cwiki.apache.org/confluence/spaces/rss.action?key=OPENEJB&newPages=false">
<IMG src="http://openejb.apache.org/images/rss.gif"></A>
<A class="feedsText" href="http://cwiki.apache.org/confluence/spaces/rss.action?key=OPENEJB&newPages=false">Site</A>
</LI>
<LI><A href="http://cwiki.apache.org/confluence/spaces/blogrss.action?key=OPENEJB">
<IMG src="http://openejb.apache.org/images/rss.gif"></A>
<A class="feedsText" href="http://cwiki.apache.org/confluence/spaces/blogrss.action?key=OPENEJB">News</A>
</LI>
</UL>
</SPAN>
</TD>
<TD class="Col2">&nbsp;</TD>
<TD class="Col3">
<TABLE id="PageHeader" border="0" width="100%">
<TR>
<TD>
<A href="http://openejb.org/">
<IMG hspace="0" src="http://openejb.apache.org/images/logo_openejb.gif" vspace="0">
</A>
</TD>
<TD align="right">
<A href="http://www.apache.org/">
<IMG src="http://www.apache.org/images/asf-logo.gif" width="258" height="66">
</A>
</TD>
</TR>
<TR>
<TD id="page_title">
<!-- $TITLE -->
Clients
</TD>
<TD align="right">
<BR><BR>
<!-- Google CSE Search Box Begins -->
<FORM 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 name="q" type="text" size="25">
<INPUT type="submit" name="sa" value="Search">
</FORM>
<SCRIPT type="text/javascript" src="http://www.google.com/coop/cse/brand?form=searchbox_010475492895890475512:_t4iqjrgx90"></SCRIPT>
<!-- Google CSE Search Box Ends -->
</TD>
</TR>
</TABLE>
<P>
<!-- $BODY -->
<DIV id="PageContent">
<H1><A name="Clients-LocalClient%28embeddedcontainer%29"></A>Local Client (embedded container)</H1>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
Properties p = <SPAN class="code-keyword">new</SPAN> Properties();
p.put(<SPAN class="code-quote">&quot;java.naming.factory.initial&quot;</SPAN>, <SPAN class="code-quote">&quot;org.apache.openejb.client.LocalInitialContextFactory&quot;</SPAN>);
InitialContext ctx = <SPAN class="code-keyword">new</SPAN> InitialContext(p);
MyBean myBean = (MyBean) ctx.lookup(<SPAN class="code-quote">&quot;MyBeanRemote&quot;</SPAN>);
</PRE>
</DIV></DIV>
<H1><A name="Clients-LocalClient%28nondefaultrealmname%29"></A>Local Client (non-default realm name)</H1>
<H2><A name="Clients-Loginconfigurationfile%28conf%2Flogin.config%29"></A>Login configuration file (conf/login.config)</H2>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
PropertiesLogin {
org.apache.openejb.core.security.jaas.PropertiesLoginModule required
Debug=<SPAN class="code-keyword">true</SPAN>
UsersFile=<SPAN class="code-quote">&quot;users.properties&quot;</SPAN>
GroupsFile=<SPAN class="code-quote">&quot;groups.properties&quot;</SPAN>;
};
MyApp {
org.apache.openejb.core.security.jaas.SQLLoginModule required
dataSourceName=<SPAN class="code-quote">&quot;MyDataSource&quot;</SPAN>
userSelect=<SPAN class="code-quote">&quot;SELECT username, password FROM users WHERE username=?&quot;</SPAN>
groupSelect=<SPAN class="code-quote">&quot;SELECT username, grp FROM users WHERE username=?&quot;</SPAN>;
};
</PRE>
</DIV></DIV>
<H2><A name="Clients-Programcode"></A>Program code</H2>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
Properties p = <SPAN class="code-keyword">new</SPAN> Properties();
p.put(<SPAN class="code-quote">&quot;java.naming.factory.initial&quot;</SPAN>, <SPAN class="code-quote">&quot;org.apache.openejb.client.LocalInitialContextFactory&quot;</SPAN>);
p.put(<SPAN class="code-quote">&quot;openejb.authentication.realmName&quot;</SPAN>, <SPAN class="code-quote">&quot;MyApp&quot;</SPAN>);
InitialContext ctx = <SPAN class="code-keyword">new</SPAN> InitialContext(p);
MyBean myBean = (MyBean) ctx.lookup(<SPAN class="code-quote">&quot;MyBeanRemote&quot;</SPAN>);
</PRE>
</DIV></DIV>
<H1><A name="Clients-RemoteClient%28openejbstandalone%29"></A>Remote Client (openejb standalone)</H1>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
Properties p = <SPAN class="code-keyword">new</SPAN> Properties();
p.put(<SPAN class="code-quote">&quot;java.naming.factory.initial&quot;</SPAN>, <SPAN class="code-quote">&quot;org.apache.openejb.client.RemoteInitialContextFactory&quot;</SPAN>);
p.put(<SPAN class="code-quote">&quot;java.naming.provider.url&quot;</SPAN>, <SPAN class="code-quote">&quot;ejbd:<SPAN class="code-comment">//localhost:4201&quot;</SPAN>);
</SPAN><SPAN class="code-comment">// user and pass optional
</SPAN>p.put(<SPAN class="code-quote">&quot;java.naming.security.principal&quot;</SPAN>, <SPAN class="code-quote">&quot;myuser&quot;</SPAN>);
p.put(<SPAN class="code-quote">&quot;java.naming.security.credentials&quot;</SPAN>, <SPAN class="code-quote">&quot;mypass&quot;</SPAN>);
InitialContext ctx = <SPAN class="code-keyword">new</SPAN> InitialContext(p);
MyBean myBean = (MyBean) ctx.lookup(<SPAN class="code-quote">&quot;MyBeanRemote&quot;</SPAN>);
</PRE>
</DIV></DIV>
<H1><A name="Clients-RemoteClientwithHTTP%28openejbstandalone%29"></A>Remote Client with HTTP (openejb standalone)</H1>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
Properties p = <SPAN class="code-keyword">new</SPAN> Properties();
p.put(<SPAN class="code-quote">&quot;java.naming.factory.initial&quot;</SPAN>, <SPAN class="code-quote">&quot;org.apache.openejb.client.RemoteInitialContextFactory&quot;</SPAN>);
p.put(<SPAN class="code-quote">&quot;java.naming.provider.url&quot;</SPAN>, <SPAN class="code-quote">&quot;http:<SPAN class="code-comment">//localhost:4204/ejb&quot;</SPAN>);
</SPAN><SPAN class="code-comment">// user and pass optional
</SPAN>p.put(<SPAN class="code-quote">&quot;java.naming.security.principal&quot;</SPAN>, <SPAN class="code-quote">&quot;myuser&quot;</SPAN>);
p.put(<SPAN class="code-quote">&quot;java.naming.security.credentials&quot;</SPAN>, <SPAN class="code-quote">&quot;mypass&quot;</SPAN>);
InitialContext ctx = <SPAN class="code-keyword">new</SPAN> InitialContext(p);
MyBean myBean = (MyBean) ctx.lookup(<SPAN class="code-quote">&quot;MyBeanRemote&quot;</SPAN>);
</PRE>
</DIV></DIV>
<H1><A name="Clients-RemoteClientwithHTTP%28intomcat%29"></A>Remote Client with HTTP (in tomcat)</H1>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
Properties p = <SPAN class="code-keyword">new</SPAN> Properties();
p.put(<SPAN class="code-quote">&quot;java.naming.factory.initial&quot;</SPAN>, <SPAN class="code-quote">&quot;org.apache.openejb.client.RemoteInitialContextFactory&quot;</SPAN>);
p.put(<SPAN class="code-quote">&quot;java.naming.provider.url&quot;</SPAN>, <SPAN class="code-quote">&quot;http:<SPAN class="code-comment">//127.0.0.1:8080/openejb/ejb&quot;</SPAN>);
</SPAN><SPAN class="code-comment">// user and pass optional
</SPAN>p.put(<SPAN class="code-quote">&quot;java.naming.security.principal&quot;</SPAN>, <SPAN class="code-quote">&quot;myuser&quot;</SPAN>);
p.put(<SPAN class="code-quote">&quot;java.naming.security.credentials&quot;</SPAN>, <SPAN class="code-quote">&quot;mypass&quot;</SPAN>);
InitialContext ctx = <SPAN class="code-keyword">new</SPAN> InitialContext(p);
MyBean myBean = (MyBean) ctx.lookup(<SPAN class="code-quote">&quot;MyBeanRemote&quot;</SPAN>);
</PRE>
</DIV></DIV>
</DIV>
</P>
</TD>
<TD class="Col4"><IMG src="http://openejb.apache.org/images/dotTrans.gif"></TD>
<TD class="Col5">
</TD>
</TR>
<TR class="Row5">
<TD class="Col1">&nbsp;</TD>
<TD class="Col2">&nbsp;</TD>
<TD class="Col3">
<BR>
<BR>
<IMG width="100%" height="1" src="http://openejb.apache.org/images/line_light.gif">
<TABLE width="100%">
<TR>
<TD>
<SPAN class="bodyGrey">
<SMALL>
<NOTICE><!-- $FOOTER -->
Apache OpenEJB is an project of The Apache Software Foundation (ASF)
</NOTICE>
<BR>
Site Powered by
<A href="http://atlassian.com/">Atlassian</A>
<A href="http://atlassian.com/confluence/">Confluence</A>
.
</SMALL>
</SPAN>
</TD>
<TD align="right">
<A style="color:#999;font-size:small;font-weight:normal;" href="https://cwiki.apache.org/confluence/pages/editpage.action?spaceKey=OPENEJBx30&title=Clients">[ edit ]</A>
</TD>
</TR>
</TABLE>
<BR>
</TD>
<TD class="Col4"><IMG src="http://openejb.apache.org/images/dotTrans.gif"></TD>
<TD class="Col5">&nbsp;</TD>
</TR>
</TABLE>
<!-- Needed for composition plugin -->
<!-- delay the loading of large javascript files to the end so that they don't interfere with the loading of page content -->
<SPAN style="display: none">
<SCRIPT type="text/javascript" language="JavaScript" src="http://cwiki.apache.org/confluence/labels-javascript"></SCRIPT>
<SCRIPT src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</SCRIPT>
<SCRIPT type="text/javascript">
_uacct = "UA-2717626-1";
urchinTracker();
</SCRIPT>
</SPAN>
</BODY>
</HTML>