geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chir...@apache.org
Subject svn commit: r429962 - in /geronimo/xbean/site: colossus-bootstrap.html home.html
Date Wed, 09 Aug 2006 05:00:11 GMT
Author: chirino
Date: Tue Aug  8 22:00:11 2006
New Revision: 429962

URL: http://svn.apache.org/viewvc?rev=429962&view=rev
Log:
Latest export from confluence

Added:
    geronimo/xbean/site/colossus-bootstrap.html
Modified:
    geronimo/xbean/site/home.html

Added: geronimo/xbean/site/colossus-bootstrap.html
URL: http://svn.apache.org/viewvc/geronimo/xbean/site/colossus-bootstrap.html?rev=429962&view=auto
==============================================================================
--- geronimo/xbean/site/colossus-bootstrap.html (added)
+++ geronimo/xbean/site/colossus-bootstrap.html Tue Aug  8 22:00:11 2006
@@ -0,0 +1,245 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+  <HEAD>
+<!--
+    Pier's plugin always overwrites the stylesheet so lets explicitly use another one
+    <link type="text/css" rel="stylesheet" href="autoexport:///XB/resources/space.css">
+-->
+    <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+    <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+    <TITLE>
+Colossus Bootstrap
+    </TITLE>
+  <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+  <BODY onload="init()">
+
+    <!-- Banner -->
+    <DIV id="site-banner">
+
+      <TABLE border="0" cellpadding="0" cellspacing="0" width="100%">
+        <TR>
+          <TD align="left" class="topbardiv" nowrap="">
+            <DIV style="color:black; font-size:32pt; font-weight:bold;">XBean</DIV>
+          </TD>
+          <TD align="right" nowrap="">
+            <IMG border="0" src="http://geronimo.apache.org/images/topleft_logo_437x64.gif">
+          </TD>
+        </TR> 
+      </TABLE>
+
+    </DIV>
+
+    <!-- Bread crumbs and Quick Links -->
+    <DIV id="site-navbar">
+      <TABLE border="0" cellpadding="0" cellspacing="0" width="100%">
+        <TR>
+          <TD align="left" valign="middle" nowrap="">
+            <DIV id="site-breadcrumbs">
+<A href="home.html" title="XBean">XBean</A>&nbsp;&gt;&nbsp;<A
href="home.html" title="Home">Home</A>&nbsp;&gt;&nbsp;<A href="" title="Colossus
Bootstrap">Colossus Bootstrap</A>
+            </DIV>
+          </TD>
+          <TD align="right" valign="middle" nowrap="">
+            <DIV id="site-quicklinks">
+
+<P><A href="download.html" title="Download">Download</A> | <SPAN class="nobr"><A
href="http://geronimo.apache.org/xbean/dist/xbean-2.4/site/" title="Visit page outside Confluence"
rel="nofollow">JavaDocs<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>
| <A href="source.html" title="Source">Source</A> | <SPAN class="nobr"><A
href="http://goopen.org/confluence/pages/listpages.action?key=XB" title="Visit page outside
Confluence" rel="nofollow">Wiki<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>
| <A href="lists.html" title="Lists">Mailing Lists</A> | <SPAN class="nobr"><A
href="http://issues.apache.org/jira/browse/XBEAN" title="Visit page outside Confluence" rel="nofollow">Support<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/
 icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></P>
+            </DIV>
+          </TD>
+        </TR> 
+      </TABLE>
+    </DIV>
+
+<!-- Integrate google search later.
+          <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>
+-->
+
+      <DIV id="site-content">
+        <TABLE>
+        <TR>
+        <TD valign="top">
+          <DIV id="site-navigation">
+<H3><A name="Navigation-Overview"></A>Overview</H3>
+<UL class="alternate" type="square">
+	<LI><A href="home.html" title="Home">Home</A></LI>
+	<LI><A href="news.html" title="News">News</A></LI>
+	<LI><A href="site.html" title="Site">Site</A></LI>
+	<LI><A href="faq.html" title="FAQ">FAQ</A></LI>
+	<LI><A href="download.html" title="Download">Download</A></LI>
+</UL>
+
+
+<H3><A name="Navigation-Features"></A>Features</H3>
+<UL class="alternate" type="square">
+	<LI><A href="custom-xml.html" title="Custom XML">Custom XML</A></LI>
+	<LI><A href="editing-custom-xml.html" title="Editing Custom XML">Editing Custom
XML</A></LI>
+	<LI><A href="xbean-ant-task.html" title="XBean Ant Task">XBean Ant Task</A></LI>
+	<LI><A href="jaxb-jndi.html" title="A JNDI provider using JAXB2">JAXB JNDI</A></LI>
+	<LI><A href="annotation-based-dependency-injection.html" title="Annotation based
Dependency Injection">AnDI</A></LI>
+</UL>
+
+
+<H3><A name="Navigation-RelatedProjects"></A>Related Projects</H3>
+<UL class="alternate" type="square">
+	<LI><SPAN class="nobr"><A href="http://www.springframework.org/" title="Visit
page outside Confluence" rel="nofollow">Spring<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><SPAN class="nobr"><A href="http://geronimo.apache.org/" title="Visit
page outside Confluence" rel="nofollow">Geronimo<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><SPAN class="nobr"><A href="http://activemq.org/" title="Visit page outside
Confluence" rel="nofollow">ActiveMQ<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><SPAN class="nobr"><A href="http://openejb.org/" title="Visit page outside
Confluence" rel="nofollow">OpenEJB<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><SPAN class="nobr"><A href="http://jencks.org/" title="Visit page outside
Confluence" rel="nofollow">Jencks<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><SPAN class="nobr"><A href="http://servicemix.org/" title="Visit page
outside Confluence" rel="nofollow">ServiceMix<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+</UL>
+
+
+<H3><A name="Navigation-Support"></A>Support</H3>
+<UL class="alternate" type="square">
+	<LI><SPAN class="nobr"><A href="hhttp://issues.apache.org/jira/browse/XBEAN"
title="Visit page outside Confluence" rel="nofollow">Issues<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle"
alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><SPAN class="nobr"><A href="http://issues.apache.org/jira/browse/XBEAN?report=com.atlassian.jira.plugin.system.project:roadmap-panel"
title="Visit page outside Confluence" rel="nofollow">Roadmap<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle"
alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><SPAN class="nobr"><A href="http://issues.apache.org/jira/browse/XBEAN?report=com.atlassian.jira.plugin.system.project:changelog-panel"
title="Visit page outside Confluence" rel="nofollow">Change log<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle"
alt="" border="0"></SUP></A></SPAN></LI>
+</UL>
+
+
+<H3><A name="Navigation-Community"></A>Community</H3>
+<UL class="alternate" type="square">
+	<LI><SPAN class="nobr"><A href="http://goopen.org/confluence/pages/listpages.action?key=XB"
title="Visit page outside Confluence" rel="nofollow">Wiki<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle"
alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><A href="lists.html" title="Lists">Mailing Lists</A></LI>
+	<LI><A href="contributor.html" title="Contributor">Who We Are</A></LI>
+	<LI><A href="contributing.html" title="Contributing">Contributing</A></LI>
+</UL>
+
+
+<H3><A name="Navigation-Developers"></A>Developers</H3>
+<UL class="alternate" type="square">
+	<LI><A href="source.html" title="Source">Source Code</A></LI>
+	<LI><SPAN class="nobr"><A href="http://geronimo.apache.org/xbean/dist/xbean-2.4/site/"
title="Visit page outside Confluence" rel="nofollow">JavaDocs<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle"
alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><SPAN class="nobr"><A href="http://geronimo.apache.org/xbean/dist/xbean-2.4/site/"
title="Visit page outside Confluence" rel="nofollow">Source XRef<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle"
alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><SPAN class="nobr"><A href="http://geronimo.apache.org/xbean/dist/xbean-2.4/site/"
title="Visit page outside Confluence" rel="nofollow">Test Source XRef<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><A href="release-procedure.html" title="Release Procedure">Release Procedure</A></LI>
+</UL>
+
+          </DIV>
+        </TD>
+        <TD valign="top">
+          <DIV id="site-page">
+
+<!--          
+            <div class="pagetitle">Colossus Bootstrap</div>
+-->
+            <DIV class="wiki-content"><H1><A name="ColossusBootstrap-Bootstrap"></A>Bootstrap</H1>
+
+<H2><A name="ColossusBootstrap-Goal"></A>Goal</H2>
+
+<P>The goal of the bootstrap module is to create the initial environment for a server.
 Normally this sort of bootstrap is handled by java directly via command line arguments to
the java executable or via manifest entries in an executable jar.  Unfortunately, the bootstrap
built into Java is so limited and hard to work with that it is often augmented with shell
scripts to generate the command line arguments.  The xbean-bootstrap module will support the
following features:</P>
+
+<UL>
+	<LI>Creation of a bootstrap class loader which is a child of the system class loader.
 This leaves the system class loader clean of the bootstrap classes, which makes class loader
isolation much easier.</LI>
+</UL>
+
+
+<UL>
+	<LI>Support for ant style pattern matching for the specification of the bootstrap
class path.  Normally one writes a shell script to find all jars and zips in the lib directory,
or one has to list the exact name of each jar.</LI>
+</UL>
+
+
+<UL>
+	<LI>Pluggable bootstrap loaders.  The bootstrap code determines what should be loaded
(normally this is a file but is it really just a string so anything goes), and finds loader
that can handle the resource (this will normally be the spring loader).</LI>
+</UL>
+
+
+<UL>
+	<LI>Bootstrap jar should be reusable.  In most cases, the default values should be
good enough for a server.  In cases where defaults need to be changed, the manifest can be
modified to change them.</LI>
+</UL>
+
+
+<UL>
+	<LI>Bootstrap should be completely self contained meaning no dependencies.</LI>
+</UL>
+
+
+<UL>
+	<LI>Bootstrap should do as little as possible.  Create the class loader, create the
loader, start the loading, and get out of the way.</LI>
+</UL>
+
+
+<H2><A name="ColossusBootstrap-Properties"></A>Properties</H2>
+
+<P>The bootstrap code will need a bunch of properties to start up, and there are many
way to get properties into the server.   This is a little something I learned from OpenEJB
is we load properties in layers from multiple sources and then present the final startup code
with a single properties object. </P>
+
+<P>Another trick from OpenEJB is the system properties on the command line come from
the left side of the java class name and to make life easy you also scan the command line
args for aditional -Dname=value properties.  Then you just add those properties to the system
making the admin&apos;s life easier.</P>
+
+<OL>
+	<LI>System properties</LI>
+	<LI>bin/bootstrap.properties</LI>
+	<LI>META-INF/bootstrap.properties</LI>
+</OL>
+
+
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Property </TH>
+<TH class="confluenceTh"> Default </TH>
+<TH class="confluenceTh"> Description </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> xbean.base.dir </TD>
+<TD class="confluenceTd"> if can locate startup jar or startup classes dir (the one
containing a the bootstrap class)<BR>
+     if startup jar is named &quot;bin&quot; use parent else use startup jar<BR>
+  else throw error </TD>
+<TD class="confluenceTd"> The base directory of the server.  This is simply set into
the environment.</TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> xbean.bootstrap.ClassPath </TD>
+<TD class="confluenceTd"> lib/&#42;.jar lib&#42;.zip </TD>
+<TD class="confluenceTd"> The paths used for the bootstrap class loader. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> xbean.bootstrap.ClassLoaderFactory </TD>
+<TD class="confluenceTd"> UrlClassLoaderFactory </TD>
+<TD class="confluenceTd"> The factory used to create the bootstrap class loader. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> xbean.bootstrap.Loader </TD>
+<TD class="confluenceTd"> Use xbean-finder to search class path for file named META-INF/org/xbean/bootstrap/loader.properties
</TD>
+<TD class="confluenceTd"> The class used to load the bootstrap resource </TD>
+</TR>
+</TBODY></TABLE>
+
+<H2><A name="ColossusBootstrap-StartupProcedure"></A>Startup Procedure</H2>
+
+<OL>
+	<LI>Process properties
+	<OL>
+		<LI>determine base dir and set into system property xbean.base.dir</LI>
+		<LI>determine class path</LI>
+		<LI>determine class loader factory</LI>
+		<LI>determine the bootstrap loader</LI>
+	</OL>
+	</LI>
+	<LI>Resolve class path</LI>
+	<LI>Create class loader</LI>
+	<LI>Create the bootstrap loader</LI>
+	<LI>Call loader passing in the class loader, properties, and cli args (without any
consumed during bootstrap)</LI>
+</OL>
+</DIV>
+          
+                  </DIV>
+        </TD>
+      </TR>
+      </TABLE>     
+      </DIV>
+    </DIV>
+    <DIV id="site-footer">
+          Added by     <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=dain">Dain
Sundstrom</A>,
+    last edited by     <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=dain">Dain
Sundstrom</A> on Aug 08, 2006
+                  
+      (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=9600">edit
page</A>)
+    </DIV>
+
+  </BODY>
+
+</HTML>
\ No newline at end of file

Modified: geronimo/xbean/site/home.html
URL: http://svn.apache.org/viewvc/geronimo/xbean/site/home.html?rev=429962&r1=429961&r2=429962&view=diff
==============================================================================
--- geronimo/xbean/site/home.html (original)
+++ geronimo/xbean/site/home.html Tue Aug  8 22:00:11 2006
@@ -214,7 +214,10 @@
               <a href="javascript:hideChildren()">Hide Children</a></span>
           </div>
           <div class="greybox" id="children" style="display: none;">
-                                      <a href="http://goopen.org/confluence/display/XB/Overview"
title="Overview">Overview</a>
+                                      <a href="http://goopen.org/confluence/display/XB/Colossus+Bootstrap"
title="Colossus Bootstrap">Colossus Bootstrap</a>
+              <span class="smalltext">(XBean)</span>
+              <br>
+                          <a href="http://goopen.org/confluence/display/XB/Overview" title="Overview">Overview</a>
               <span class="smalltext">(XBean)</span>
               <br>
                           <a href="http://goopen.org/confluence/display/XB/Features" title="Features">Features</a>



Mime
View raw message