summaryrefslogtreecommitdiffstats
path: root/site/trunk/site-publish/java-sca-overview.html
diff options
context:
space:
mode:
Diffstat (limited to 'site/trunk/site-publish/java-sca-overview.html')
-rw-r--r--site/trunk/site-publish/java-sca-overview.html196
1 files changed, 196 insertions, 0 deletions
diff --git a/site/trunk/site-publish/java-sca-overview.html b/site/trunk/site-publish/java-sca-overview.html
new file mode 100644
index 0000000000..afd797d376
--- /dev/null
+++ b/site/trunk/site-publish/java-sca-overview.html
@@ -0,0 +1,196 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <LINK type="text/css" rel="stylesheet" href="resources/space.css">
+ <STYLE type="text/css">
+ .footer {
+ background-image: url('http://cwiki.apache.org/confluence/images/border/border_bottom.gif');
+ background-repeat: repeat-x;
+ background-position: left top;
+ padding-top: 4px;
+ color: #666;
+ }
+ </STYLE>
+ <SCRIPT type="text/javascript" language="javascript">
+ var hide = null;
+ var show = null;
+ var children = null;
+
+ function init() {
+ /* Search form initialization */
+ var form = document.forms['search'];
+ if (form != null) {
+ form.elements['domains'].value = location.hostname;
+ form.elements['sitesearch'].value = location.hostname;
+ }
+
+ /* Children initialization */
+ hide = document.getElementById('hide');
+ show = document.getElementById('show');
+ children = document.all != null ?
+ document.all['children'] :
+ document.getElementById('children');
+ if (children != null) {
+ children.style.display = 'none';
+ show.style.display = 'inline';
+ hide.style.display = 'none';
+ }
+ }
+
+ function showChildren() {
+ children.style.display = 'block';
+ show.style.display = 'none';
+ hide.style.display = 'inline';
+ }
+
+ function hideChildren() {
+ children.style.display = 'none';
+ show.style.display = 'inline';
+ hide.style.display = 'none';
+ }
+ </SCRIPT>
+ <TITLE>Java SCA Overview</TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+ <TABLE border="0" cellpadding="2" cellspacing="0" width="100%">
+ <TR class="topBar">
+ <TD align="left" valign="middle" class="topBarDiv" nowrap="">
+ &nbsp;<A href="home.html" title="Apache Tuscany">Apache Tuscany</A>&nbsp;&gt;&nbsp;<A href="home.html" title="Home">Home</A>&nbsp;&gt;&nbsp;<A href="java-sca.html" title="Java SCA">Java SCA</A>&nbsp;&gt;&nbsp;<A href="java-sca-menu.html" title="Java SCA Menu">Java SCA Menu</A>&nbsp;&gt;&nbsp;<A href="" title="Java SCA Overview">Java SCA Overview</A>
+ </TD>
+ <TD align="right" valign="middle" nowrap="">
+ <FORM name="search" action="http://www.google.com/search" method="get">
+ <INPUT type="hidden" name="ie" value="UTF-8">
+ <INPUT type="hidden" name="oe" value="UTF-8">
+ <INPUT type="hidden" name="domains" value="">
+ <INPUT type="hidden" name="sitesearch" value="">
+ <INPUT type="text" name="q" maxlength="255" value="">
+ <INPUT type="submit" name="btnG" value="Google Search">
+ </FORM>
+ </TD>
+ </TR>
+ </TABLE>
+
+ <DIV id="PageContent">
+ <DIV class="pageheader" style="padding: 6px 0px 0px 0px;">
+ <!-- We'll enable this once we figure out how to access (and save) the logo resource -->
+ <!--img src="/wiki/images/confluence_logo.gif" style="float: left; margin: 4px 4px 4px 10px;" border="0"-->
+ <DIV style="margin: 0px 10px 0px 10px" class="smalltext">Apache Tuscany</DIV>
+ <DIV style="margin: 0px 10px 8px 10px" class="pagetitle">Java SCA Overview</DIV>
+
+ <DIV class="greynavbar" align="right" style="padding: 2px 10px; margin: 0px;">
+ <A href="http://cwiki.apache.org/confluence/pages/editpage.action?pageId=47661">
+ <IMG src="http://cwiki.apache.org/confluence/images/icons/notep_16.gif" height="16" width="16" border="0" align="absmiddle" title="Edit Page"></A>
+ <A href="http://cwiki.apache.org/confluence/pages/editpage.action?pageId=47661">Edit Page</A>
+ &nbsp;
+ <A href="http://cwiki.apache.org/confluence/pages/listpages.action?key=TUSCANY">
+ <IMG src="http://cwiki.apache.org/confluence/images/icons/browse_space.gif" height="16" width="16" border="0" align="absmiddle" title="Browse Space"></A>
+ <A href="http://cwiki.apache.org/confluence/pages/listpages.action?key=TUSCANY">Browse Space</A>
+ &nbsp;
+ <A href="http://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANY&fromPageId=47661">
+ <IMG src="http://cwiki.apache.org/confluence/images/icons/add_page_16.gif" height="16" width="16" border="0" align="absmiddle" title="Add Page"></A>
+ <A href="http://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANY&fromPageId=47661">Add Page</A>
+ &nbsp;
+ <A href="http://cwiki.apache.org/confluence/pages/createblogpost.action?spaceKey=TUSCANY&fromPageId=47661">
+ <IMG src="http://cwiki.apache.org/confluence/images/icons/add_blogentry_16.gif" height="16" width="16" border="0" align="absmiddle" title="Add News"></A>
+ <A href="http://cwiki.apache.org/confluence/pages/createblogpost.action?spaceKey=TUSCANY&fromPageId=47661">Add News</A>
+ </DIV>
+ </DIV>
+ <DIV class="pagesubheading" style="margin: 0px 10px 0px 10px;">
+ Added by <A href="http://cwiki.apache.org/confluence/users/viewuserprofile.action?username=jmarino">jmarino</A>, last edited by <A href="http://cwiki.apache.org/confluence/users/viewuserprofile.action?username=jmarino">jmarino</A> on Mar 03, 2007
+ &nbsp;(<A href="http://cwiki.apache.org/confluence/pages/diffpages.action?pageId=47661&originalId=47696">view change</A>)
+
+ </DIV>
+
+ <DIV class="pagecontent">
+ <DIV class="wiki-content">
+ <H3><A name="JavaSCAOverview-Overview"></A>Overview</H3>
+
+<P>The SCA Java runtime is composed of a <EM>kernel</EM> and extensions. The kernel is essentially a multi-VM wiring engine that connects components together using the principles of <SPAN class="nobr"><A href="http://en.wikipedia.org/wiki/Dependency_injection" title="Visit page outside Confluence" rel="nofollow">Dependency Injection<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN>, or <SPAN class="nobr"><A href="http://en.wikipedia.org/wiki/Inversion_of_control" title="Visit page outside Confluence" rel="nofollow">Inversion of Control<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN>.</P>
+
+<H3><A name="JavaSCAOverview-Kernel"></A>Kernel</H3>
+
+<P>The kernel is designed to be simple and limited in its capabilities: it wires functional units together. Capabilities such as service discovery, reliability, support for transport protocols, etc. are provided through extensions. The kernel extension model is based on the SCA 1.0 Java programming and assembly model. In otherwords, the kernel uses SCA to bootstrap itself. The mechanics of how this is done are described in detail elsewhere <SPAN class="nobr"><A href="http://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANY&title=Kernel%20Architecture&linkCreation=true&fromPageId=47661" title="Create Page: Kernel Architecture" class="createlink">Kernel Architecture<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN>. </P>
+
+<P>The kernel is divided into a number of modules: <EM>api</EM>, <EM>host_api</EM>, <EM>spi</EM> and <EM>core</EM>. The <EM>api</EM> module defines Tuscany proprietary programming model annotations and APIs. The <EM>host_api</EM> module defines APIs for interacting with the kernel. The <EM>spi</EM> module defines extension points and abstract helper classes. The <EM>core</EM> module contains the kernel implementation. </P>
+
+<H3><A name="JavaSCAOverview-Extensions"></A>Extensions</H3>
+
+<P>Extensions enhance the kernel with specific sets of functionality. Extension types are not fixed and the kernel is designed to be as flexible as possible by providing an open-ended extension model. From the kernel perspective, extensions are just a set of SCA components. However, there are a number of known extension types defined by the <EM>spi</EM> module, including:</P>
+
+<UL>
+ <LI><B>Component implementation types</B>, e.g. Spring, Groovy, and JavaScript</LI>
+ <LI><B>Binding types</B>, e.g. Axis, CXF, AMQP, ActiveMQ, JXTA</LI>
+ <LI><B>DataBinding types</B>, e.g. JAXB, SDO, XmlBeans</LI>
+</UL>
+
+
+<P>There are also a number of add-on extensions that do not correspond to a well-know type:</P>
+
+<UL>
+ <LI>The JPA extension for O/R mapping</LI>
+ <LI>The Geronimo Transaction Manager extension for transactional support in the runtime</LI>
+ <LI>The HOWL-based Persistent Store extension for high-throughput persistence of conversational state</LI>
+</UL>
+
+
+<P>More detail can be found in the <SPAN class="nobr"><A href="http://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANY&title=Extensions%20Guide&linkCreation=true&fromPageId=47661" title="Create Page: Extensions Guide" class="createlink">Extensions Guide<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN> section, but a few high-level best practices for designing extensions are listed here:</P>
+
+<UL>
+ <LI>Make sure you are familiar with SCA 1.0 Assembly and the SCA Java 1.0 programming model. Specifications can be found at <SPAN class="nobr"><A href="http://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANY&title=www.osoa.org&linkCreation=true&fromPageId=47661" title="Create Page: www.osoa.org" class="createlink">www.osoa.org<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN>.</LI>
+</UL>
+
+
+<UL>
+ <LI>Never reference any classes in <EM>core</EM>. These classes are implementation-specific and subject to change; they are not part of the public SPI contract.</LI>
+</UL>
+
+
+<UL>
+ <LI>Use autowire when assembling extension components.</LI>
+</UL>
+
+
+<UL>
+ <LI>Do not mess with classloaders such as setting the current context classloader unless it is absolutely necessary, i.e. a library used by an extension makes assumptions about context classloaders. Ideally the library can be refactored to not make these assumptions. If not, make sure the extension properly resets the current context classloader.</LI>
+</UL>
+
+
+<UL>
+ <LI>Preferrably use <SPAN class="nobr"><A href="http://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANY&title=www.easymock.org&linkCreation=true&fromPageId=47661" title="Create Page: www.easymock.org" class="createlink">EasyMock<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN> for mocking kernel functionality during extension unit testing.</LI>
+</UL>
+
+
+<UL>
+ <LI>Use the <SPAN class="nobr"><A href="http://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANY&title=Tuscany%20iTest%20Plugin%20Maven%2BPlugins&linkCreation=true&fromPageId=47661" title="Create Page: Tuscany iTest Plugin Maven+Plugins" class="createlink">Tuscany iTest Plugin Maven&#43;Plugins<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN> for integration testing the extension.</LI>
+</UL>
+
+
+<UL>
+ <LI>Preferrably use <SPAN class="nobr"><A href="http://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANY&title=www.easymock.org&linkCreation=true&fromPageId=47661" title="Create Page: www.easymock.org" class="createlink">EasyMock<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN> for mocking kernel functionality during extension unit testing.</LI>
+</UL>
+
+
+<UL>
+ <LI>Use the <SPAN class="nobr"><A href="http://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANY&title=Tuscany%20iTest%20Plugin%20Maven%2BPlugins&linkCreation=true&fromPageId=47661" title="Create Page: Tuscany iTest Plugin Maven+Plugins" class="createlink">Tuscany iTest Plugin Maven&#43;Plugins<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN> for integration testing the extension.</LI>
+</UL>
+
+
+<H3><A name="JavaSCAOverview-Runtimes"></A>Runtimes</H3>
+
+<P>The kernel is designed to be embedded in, or provisioned to, a number of different host environments. For example, the kernel may be provisioned to an OSGi container, a standalone runtime, a servlet engine, or JEE application server. There is even a Maven runtime that embeds kernel for integration testing. Runtime capabilities may vary based on the host environment. </P>
+
+
+
+ </DIV>
+
+
+ </DIV>
+ </DIV>
+ <DIV class="footer">
+ Generated by
+ <A href="http://www.atlassian.com/confluence/">Atlassian Confluence</A> (Version: 2.2.9 Build: 527 Sep 07, 2006)
+ <A href="http://could.it/autoexport/">AutoExport Plugin</A> (Version: Unknown - PluginManager Error)
+ </DIV>
+ </BODY>
+</HTML> \ No newline at end of file