hammant     2002/12/12 00:12:16

  Modified:    docs/excalibur/altrmi client-usage.html
                        connection-listeners.html facades.html
                        generating-proxies.html index.html
                        otherfeatures.html pingers.html publishing.html
                        tests.html transports.html
  Log:
  typos fixed
  
  Revision  Changes    Path
  1.7       +2 -2      
jakarta-avalon-site/docs/excalibur/altrmi/client-usage.html
  
  Index: client-usage.html
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/docs/excalibur/altrmi/client-usage.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- client-usage.html 10 Aug 2002 21:59:37 -0000      1.6
  +++ client-usage.html 12 Dec 2002 08:12:15 -0000      1.7
  @@ -1,12 +1,12 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
   <html><head><META http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><link rel="stylesheet" href="skin/tigris.css" 
type="text/css"><link rel="stylesheet" href="skin/site.css" 
type="text/css"><link media="print" rel="stylesheet" href="skin/print.css" 
type="text/css"><meta value="Avalon Documentation Team" name="author"><meta 
value="avalon-dev@jakarta.apache.org" name="email"><title>Excalibur AltRMI / 
Client Usage</title></head><body bgcolor="white" class="composite" 
marginheight="0" marginwidth="0"><div id="banner"><table width="100%" 
cellpadding="8" cellspacing="0" border="0"><tbody><tr><td align="left"><a 
href="http://jakarta.apache.org/";><img border="0" 
src="images/jakarta-logo.gif"></a></td><td align="right"><a 
href="http://jakarta.apache.org/avalon/";><img border="0" 
src="images/header.gif"></a></td></tr></tbody></table></div><table width="100%" 
cellpadding="0" cellspacing="0" border="0" id="breadcrumbs"><td><a 
href="http://jakarta.apache.org/";>Jakarta Main</a> |
               <a href="http://jakarta.apache.org/avalon";>Avalon Main</a> |
  -            <a href="../">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
  +            <a href="../index.html">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
               <a 
href="http://jakarta.apache.org/avalon/excalibur/";>Excalibur</a> |
               <a 
href="http://jakarta.apache.org/avalon/cornerstone/";>Cornerstone</a> |
               <a href="http://jakarta.apache.org/avalon/phoenix/";>Phoenix</a> |
               <a href="http://jakarta.apache.org/avalon/apps/";>Apps</a> |
  -            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/">API Docs</a></div><div><a href="otherfeatures.html">Other 
Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / Client 
Usage</h1><h2></h2></div><div class="h3">
  +            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/index.html">API Docs</a></div><div><a 
href="otherfeatures.html">Other Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / Client 
Usage</h1><h2></h2></div><div class="h3">
     
     
       <div class="h3"><h3>Introduction</h3></div>
  
  
  
  1.7       +4 -4      
jakarta-avalon-site/docs/excalibur/altrmi/connection-listeners.html
  
  Index: connection-listeners.html
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/docs/excalibur/altrmi/connection-listeners.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- connection-listeners.html 10 Aug 2002 21:59:37 -0000      1.6
  +++ connection-listeners.html 12 Dec 2002 08:12:15 -0000      1.7
  @@ -1,19 +1,19 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
   <html><head><META http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><link rel="stylesheet" href="skin/tigris.css" 
type="text/css"><link rel="stylesheet" href="skin/site.css" 
type="text/css"><link media="print" rel="stylesheet" href="skin/print.css" 
type="text/css"><meta value="Avalon Documentation Team" name="author"><meta 
value="avalon-dev@jakarta.apache.org" name="email"><title>Excalibur AltRMI / 
Connection Listener</title></head><body bgcolor="white" class="composite" 
marginheight="0" marginwidth="0"><div id="banner"><table width="100%" 
cellpadding="8" cellspacing="0" border="0"><tbody><tr><td align="left"><a 
href="http://jakarta.apache.org/";><img border="0" 
src="images/jakarta-logo.gif"></a></td><td align="right"><a 
href="http://jakarta.apache.org/avalon/";><img border="0" 
src="images/header.gif"></a></td></tr></tbody></table></div><table width="100%" 
cellpadding="0" cellspacing="0" border="0" id="breadcrumbs"><td><a 
href="http://jakarta.apache.org/";>Jakarta Main</a> |
               <a href="http://jakarta.apache.org/avalon";>Avalon Main</a> |
  -            <a href="../">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
  +            <a href="../index.html">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
               <a 
href="http://jakarta.apache.org/avalon/excalibur/";>Excalibur</a> |
               <a 
href="http://jakarta.apache.org/avalon/cornerstone/";>Cornerstone</a> |
               <a href="http://jakarta.apache.org/avalon/phoenix/";>Phoenix</a> |
               <a href="http://jakarta.apache.org/avalon/apps/";>Apps</a> |
  -            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/">API Docs</a></div><div><a href="otherfeatures.html">Other 
Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / Connection 
Listener</h1><h2></h2></div><div class="h3">
  +            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/index.html">API Docs</a></div><div><a 
href="otherfeatures.html">Other Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / Connection 
Listener</h1><h2></h2></div><div class="h3">
     
     
       <div class="h3"><h3>Introduction</h3></div>
         <p>
  -        Conenction listener can monitor each method invokation (affects 
performance) 
  +        A connection listener can monitor each method invocation (affects 
performance)
           and handle service suspensions and abnormal ends.  The connection 
listener 
  -        can decide how to do the reconnection andhow to obey the 
susepension.  In 
  +        can decide how to do the reconnection and how to obey the 
susepension.  In
           theory a method call can just be left blocking until the servce is 
           reconnected (after abend) or resumed after suspension.  Connection 
listeners
           run on the client side.
  
  
  
  1.7       +23 -22    jakarta-avalon-site/docs/excalibur/altrmi/facades.html
  
  Index: facades.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/excalibur/altrmi/facades.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- facades.html      10 Aug 2002 21:59:37 -0000      1.6
  +++ facades.html      12 Dec 2002 08:12:16 -0000      1.7
  @@ -1,52 +1,53 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
   <html><head><META http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><link rel="stylesheet" href="skin/tigris.css" 
type="text/css"><link rel="stylesheet" href="skin/site.css" 
type="text/css"><link media="print" rel="stylesheet" href="skin/print.css" 
type="text/css"><meta value="Avalon Documentation Team" name="author"><meta 
value="avalon-dev@jakarta.apache.org" name="email"><title>Excalibur AltRMI / 
Facade Design</title></head><body bgcolor="white" class="composite" 
marginheight="0" marginwidth="0"><div id="banner"><table width="100%" 
cellpadding="8" cellspacing="0" border="0"><tbody><tr><td align="left"><a 
href="http://jakarta.apache.org/";><img border="0" 
src="images/jakarta-logo.gif"></a></td><td align="right"><a 
href="http://jakarta.apache.org/avalon/";><img border="0" 
src="images/header.gif"></a></td></tr></tbody></table></div><table width="100%" 
cellpadding="0" cellspacing="0" border="0" id="breadcrumbs"><td><a 
href="http://jakarta.apache.org/";>Jakarta Main</a> |
               <a href="http://jakarta.apache.org/avalon";>Avalon Main</a> |
  -            <a href="../">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
  +            <a href="../index.html">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
               <a 
href="http://jakarta.apache.org/avalon/excalibur/";>Excalibur</a> |
               <a 
href="http://jakarta.apache.org/avalon/cornerstone/";>Cornerstone</a> |
               <a href="http://jakarta.apache.org/avalon/phoenix/";>Phoenix</a> |
               <a href="http://jakarta.apache.org/avalon/apps/";>Apps</a> |
  -            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/">API Docs</a></div><div><a href="otherfeatures.html">Other 
Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / Facade 
Design</h1><h2></h2></div><div class="h3">
  +            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/index.html">API Docs</a></div><div><a 
href="otherfeatures.html">Other Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / Facade 
Design</h1><h2></h2></div><div class="h3">
     
     
       <div class="h3"><h3>Introduction</h3></div>
         <p>
  -        AltRMI publishes objects via their interfaces.  It does not 
replicate all objects 
  -        on the client side, it generates proxies for those defines as 
facades.
  +        AltRMI publishes an object via its interface.  It does not replicate 
the object
  +        on the client side, it generates proxies for it defined as facades.
         </p>
                 
       <div class="h3"><h3>Facades</h3></div>
         <p>                
  -        Consider a whether system that models weather stations (fixed and 
mobile) and 
  +        Consider a system that models weather stations (fixed and mobile) and
           the meterologists that staff the stations.....
         </p>
  -      <p><img border="0" alt="" src=""></p>   
  +      
  +      <img border="0" alt="" src="images/facades.jpg">
         <p>
  -        The interfaces and the class on the right of the right of the green 
line are 'interface' 
  -        or API, and we want them to exist as is on the client side for 
general use.  Things on the 
  -        left are the implementation classes and they exist on theserver side 
only.  Though not 
  -        shown here, it would be easiest to have them is a seperate package.  
Representing those 
  -        objects on the client side are generated proxies.  Those proxies are 
pass-by-reference
  -        boudaries but are castable to any of the interfaces they represent.  
There is one 
  -        pass-by-value object and that is Coordinate.  It should be 
serializable and final 
  -        (Immutable pattern).        
  -      </p>  
  +        The interfaces and the class on the right of the green line are 
'interface'
  +        or API, and we want them to exist as is on the client side for 
general use.  Things on the
  +        left are the implementation classes and they exist on the server 
side only.  Though not
  +        shown here, it would be easiest to have them in a separate package.  
Representing those
  +        objects on the client side are generated proxies.  Proxies are 
pass-by-reference
  +        boundaries but are castable to any of the interfaces they represent. 
 There is one
  +        pass-by-value object and that is Coordinate.  It should be 
serializable and final
  +        (Immutable pattern).
  +      </p>
         <p>
  -        The principle point of entry into the system from the client point 
of view is 
  +        The principle point of entry into the system from the client point 
of view is
           'WeatherSystem'.  The mechanism of entry is a lookup on an agreed 
name. We recommend
           'WeatherSystem' or 'WeatherSystem_1.0' etc.
  -      </p>      
  -      <p>  
  -        Once the client has a handle on the WetherSystem normal Java 
tarversals are possibleL
  +      </p>
  +      <p>
  +        Once the client has a handle on the WeatherSystem normal Java 
tarversals are possible
   <pre>
   WeatherSystem ws = getWeatherSystem(); // some thing that does the JNDI 
lookup.
   // yes we know the following could throw NPEs or Array Index issues.
   String aName = 
ws.getWeatherStation("ArcticOne").getMeteorologists()[0].getName();
   </pre>
  -       To generate the correct proxies for the above, you would want to have 
the interface as 
  +       To generate the correct proxies for the above, you would want to have 
the interface as
          'WeatherSystem' and additional-facades of 'Meteorologist' and 
'WeatherStation'
  -      </p>      
  -           
  +      </p>
  +    
     
     
   <div id="authors" align="right">by&nbsp;Paul 
Hammant</div></div></div></div></td></tr></tbody></table><div 
id="footer"><table width="100%" cellpadding="4" cellspacing="0" 
border="0"><tbody><tr><td align="left">Copyright &copy; 2002 Apache Software 
Foundation. All Rights Reserved.</td><td></td><td align="right"><script 
language="JavaScript">
  
  
  
  1.7       +3 -3      
jakarta-avalon-site/docs/excalibur/altrmi/generating-proxies.html
  
  Index: generating-proxies.html
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/docs/excalibur/altrmi/generating-proxies.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- generating-proxies.html   10 Aug 2002 21:59:37 -0000      1.6
  +++ generating-proxies.html   12 Dec 2002 08:12:16 -0000      1.7
  @@ -1,17 +1,17 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
   <html><head><META http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><link rel="stylesheet" href="skin/tigris.css" 
type="text/css"><link rel="stylesheet" href="skin/site.css" 
type="text/css"><link media="print" rel="stylesheet" href="skin/print.css" 
type="text/css"><meta value="Avalon Documentation Team" name="author"><meta 
value="avalon-dev@jakarta.apache.org" name="email"><title>Excalibur AltRMI / 
Facade Design</title></head><body bgcolor="white" class="composite" 
marginheight="0" marginwidth="0"><div id="banner"><table width="100%" 
cellpadding="8" cellspacing="0" border="0"><tbody><tr><td align="left"><a 
href="http://jakarta.apache.org/";><img border="0" 
src="images/jakarta-logo.gif"></a></td><td align="right"><a 
href="http://jakarta.apache.org/avalon/";><img border="0" 
src="images/header.gif"></a></td></tr></tbody></table></div><table width="100%" 
cellpadding="0" cellspacing="0" border="0" id="breadcrumbs"><td><a 
href="http://jakarta.apache.org/";>Jakarta Main</a> |
               <a href="http://jakarta.apache.org/avalon";>Avalon Main</a> |
  -            <a href="../">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
  +            <a href="../index.html">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
               <a 
href="http://jakarta.apache.org/avalon/excalibur/";>Excalibur</a> |
               <a 
href="http://jakarta.apache.org/avalon/cornerstone/";>Cornerstone</a> |
               <a href="http://jakarta.apache.org/avalon/phoenix/";>Phoenix</a> |
               <a href="http://jakarta.apache.org/avalon/apps/";>Apps</a> |
  -            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/">API Docs</a></div><div><a href="otherfeatures.html">Other 
Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / Facade 
Design</h1><h2></h2></div><div class="h3">
  +            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/index.html">API Docs</a></div><div><a 
href="otherfeatures.html">Other Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / Facade 
Design</h1><h2></h2></div><div class="h3">
     
     
       <div class="h3"><h3>Introduction</h3></div>
         <p>
  -        You can choose to generate your procies in advance of use, or to 
defer generation 
  +        You can choose to generate your proxies in advance of use, or to 
defer generation
           until runtime.  As the generation requires javac in tools.jar (multi 
megabyte), you 
           have to decide whether your runtime environment or distribution can 
support or 
           legally distribute it.
  
  
  
  1.9       +5 -3      jakarta-avalon-site/docs/excalibur/altrmi/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/excalibur/altrmi/index.html,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- index.html        10 Aug 2002 21:59:37 -0000      1.8
  +++ index.html        12 Dec 2002 08:12:16 -0000      1.9
  @@ -1,18 +1,20 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
   <html><head><META http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><link rel="stylesheet" href="skin/tigris.css" 
type="text/css"><link rel="stylesheet" href="skin/site.css" 
type="text/css"><link media="print" rel="stylesheet" href="skin/print.css" 
type="text/css"><meta value="Avalon Documentation Team" name="author"><meta 
value="avalon-dev@jakarta.apache.org" name="email"><title>Excalibur AltRMI - 
Overview </title></head><body bgcolor="white" class="composite" 
marginheight="0" marginwidth="0"><div id="banner"><table width="100%" 
cellpadding="8" cellspacing="0" border="0"><tbody><tr><td align="left"><a 
href="http://jakarta.apache.org/";><img border="0" 
src="images/jakarta-logo.gif"></a></td><td align="right"><a 
href="http://jakarta.apache.org/avalon/";><img border="0" 
src="images/header.gif"></a></td></tr></tbody></table></div><table width="100%" 
cellpadding="0" cellspacing="0" border="0" id="breadcrumbs"><td><a 
href="http://jakarta.apache.org/";>Jakarta Main</a> |
               <a href="http://jakarta.apache.org/avalon";>Avalon Main</a> |
  -            <a href="../">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
  +            <a href="../index.html">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
               <a 
href="http://jakarta.apache.org/avalon/excalibur/";>Excalibur</a> |
               <a 
href="http://jakarta.apache.org/avalon/cornerstone/";>Cornerstone</a> |
               <a href="http://jakarta.apache.org/avalon/phoenix/";>Phoenix</a> |
               <a href="http://jakarta.apache.org/avalon/apps/";>Apps</a> |
  -            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/">API Docs</a></div><div><a href="otherfeatures.html">Other 
Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI - Overview 
</h1><h2></h2></div><div class="h3">
  +            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/index.html">API Docs</a></div><div><a 
href="otherfeatures.html">Other Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI - Overview 
</h1><h2></h2></div><div class="h3">
     
     
       <div class="h3"><h3>Introduction</h3></div>
         <p>
           AltRMI is a from-scratch replacement for RMI.  It has a number of 
different features 
  -        that make it easier to use.  It tries as far as possible to be 
transparent in use.
  +        that make it easier to use.  It tries as far as possible to be 
transparent in use.  It 
  +        is also inspired by the remoting facility in .NET.  This does not 
mean that it has SOAP 
  +        capabilty (yet), as it is more like the proprietary RPC transport 
for the .NET framework.
         </p>
         
           This package is under development, and the API is not
  
  
  
  1.7       +5 -5      
jakarta-avalon-site/docs/excalibur/altrmi/otherfeatures.html
  
  Index: otherfeatures.html
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/docs/excalibur/altrmi/otherfeatures.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- otherfeatures.html        10 Aug 2002 21:59:37 -0000      1.6
  +++ otherfeatures.html        12 Dec 2002 08:12:16 -0000      1.7
  @@ -1,12 +1,12 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
   <html><head><META http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><link rel="stylesheet" href="skin/tigris.css" 
type="text/css"><link rel="stylesheet" href="skin/site.css" 
type="text/css"><link media="print" rel="stylesheet" href="skin/print.css" 
type="text/css"><meta value="Avalon Documentation Team" name="author"><meta 
value="avalon-dev@jakarta.apache.org" name="email"><title>Excalibur AltRMI / 
Other Features</title></head><body bgcolor="white" class="composite" 
marginheight="0" marginwidth="0"><div id="banner"><table width="100%" 
cellpadding="8" cellspacing="0" border="0"><tbody><tr><td align="left"><a 
href="http://jakarta.apache.org/";><img border="0" 
src="images/jakarta-logo.gif"></a></td><td align="right"><a 
href="http://jakarta.apache.org/avalon/";><img border="0" 
src="images/header.gif"></a></td></tr></tbody></table></div><table width="100%" 
cellpadding="0" cellspacing="0" border="0" id="breadcrumbs"><td><a 
href="http://jakarta.apache.org/";>Jakarta Main</a> |
               <a href="http://jakarta.apache.org/avalon";>Avalon Main</a> |
  -            <a href="../">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
  +            <a href="../index.html">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
               <a 
href="http://jakarta.apache.org/avalon/excalibur/";>Excalibur</a> |
               <a 
href="http://jakarta.apache.org/avalon/cornerstone/";>Cornerstone</a> |
               <a href="http://jakarta.apache.org/avalon/phoenix/";>Phoenix</a> |
               <a href="http://jakarta.apache.org/avalon/apps/";>Apps</a> |
  -            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/">API Docs</a></div><div><a href="otherfeatures.html">Other 
Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / Other 
Features</h1><h2></h2></div><div class="h3">
  +            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/index.html">API Docs</a></div><div><a 
href="otherfeatures.html">Other Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / Other 
Features</h1><h2></h2></div><div class="h3">
     
     
       <div class="h3"><h3>Introduction</h3></div>
  @@ -22,7 +22,7 @@
           <p>
             Classes providing client side implementation of the transported 
          interface(s) can be either on the client side or the server side (and 
  -       duly transported) at time of lookup.  On the server side, the proxy 
classes
  +       duly transported) at the time of lookup.  On the server side, the 
proxy classes
             can be generated in advance (Ant Task) or at runtime - javac is 
invoked.
           </p>
         
  @@ -36,7 +36,7 @@
         
         <div class="h4"><h4>Suspendable/Resumable service.</h4></div>          
  
           <p>
  -          The Server supports suspend() and resume().  With the current impl 
this 
  +          The Server supports suspend() and resume().  With the current 
implementation this
          replies in a timely fashion to the client that the client should try
          later.  The client waits for the notified amount of time and 
seamlessly
          tries the request again.  A server could cycle through suspended and 
back
  @@ -88,7 +88,7 @@
         <div class="h4"><h4>No duplicate instances.</h4></div>            
           <p>
             For Facades, if you call Person p = getPerson("Fred") twice you 
will get 
  -       the same instance on the client side is it is the same instance on 
the 
  +       the same instance on the client side if it is the same instance on the
             server side.        
           </p>
         
  
  
  
  1.7       +7 -7      jakarta-avalon-site/docs/excalibur/altrmi/pingers.html
  
  Index: pingers.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/excalibur/altrmi/pingers.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- pingers.html      10 Aug 2002 21:59:37 -0000      1.6
  +++ pingers.html      12 Dec 2002 08:12:16 -0000      1.7
  @@ -1,26 +1,26 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
   <html><head><META http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><link rel="stylesheet" href="skin/tigris.css" 
type="text/css"><link rel="stylesheet" href="skin/site.css" 
type="text/css"><link media="print" rel="stylesheet" href="skin/print.css" 
type="text/css"><meta value="Avalon Documentation Team" name="author"><meta 
value="avalon-dev@jakarta.apache.org" name="email"><title>Excalibur AltRMI / 
Pingers</title></head><body bgcolor="white" class="composite" marginheight="0" 
marginwidth="0"><div id="banner"><table width="100%" cellpadding="8" 
cellspacing="0" border="0"><tbody><tr><td align="left"><a 
href="http://jakarta.apache.org/";><img border="0" 
src="images/jakarta-logo.gif"></a></td><td align="right"><a 
href="http://jakarta.apache.org/avalon/";><img border="0" 
src="images/header.gif"></a></td></tr></tbody></table></div><table width="100%" 
cellpadding="0" cellspacing="0" border="0" id="breadcrumbs"><td><a 
href="http://jakarta.apache.org/";>Jakarta Main</a> |
               <a href="http://jakarta.apache.org/avalon";>Avalon Main</a> |
  -            <a href="../">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
  +            <a href="../index.html">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
               <a 
href="http://jakarta.apache.org/avalon/excalibur/";>Excalibur</a> |
               <a 
href="http://jakarta.apache.org/avalon/cornerstone/";>Cornerstone</a> |
               <a href="http://jakarta.apache.org/avalon/phoenix/";>Phoenix</a> |
               <a href="http://jakarta.apache.org/avalon/apps/";>Apps</a> |
  -            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/">API Docs</a></div><div><a href="otherfeatures.html">Other 
Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / 
Pingers</h1><h2></h2></div><div class="h3">
  +            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/index.html">API Docs</a></div><div><a 
href="otherfeatures.html">Other Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / 
Pingers</h1><h2></h2></div><div class="h3">
     
     
       <div class="h3"><h3>Introduction</h3></div>
         <p>
           Although it may not be necessary for all types of transport, 
  -        there is a mechanism called a pinger that can be used to keep alive 
  -        the connection. Pingers run on the client side.
  +        there is a mechanism called a pinger that can be used to keep
  +        the connection alive. Pingers run on the client side.
         </p>
                 
       <div class="h3"><h3>Pinger Interface</h3></div>
         <p>
           It is possible to write your own or extend the exiting 
           ones if there are different requirements.  The interface for bespoke 
pingers 
  -        is <a href="api/org/apache/excalibur/altrmi/client/[EMAIL 
PROTECTED]">here</a>
  +        is <a href="api/org/apache/excalibur/altrmi/client/[EMAIL 
PROTECTED]">here</a>
         </p>    
                 
       <div class="h3"><h3>Pinger types</h3></div>    
  @@ -29,11 +29,11 @@
         </p>
         <div class="h4"><h4>DefaultConnectionPinger</h4></div>
           <p>
  -          This pinger pings every ten seconds, but stops one hundred seconds 
seoonds
  +          This pinger pings every ten seconds, but stops one hundred seconds
             after the last real request.  The 10 &amp; 100 are configurable of 
course.
           </p>
           <p> 
  -          This pinger is the default and will be used if none other is 
  +          This pinger is the default and will be used if no other is
             specified.
           </p>        
         
  
  
  
  1.7       +5 -5      jakarta-avalon-site/docs/excalibur/altrmi/publishing.html
  
  Index: publishing.html
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/docs/excalibur/altrmi/publishing.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- publishing.html   10 Aug 2002 21:59:37 -0000      1.6
  +++ publishing.html   12 Dec 2002 08:12:16 -0000      1.7
  @@ -1,26 +1,26 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
   <html><head><META http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><link rel="stylesheet" href="skin/tigris.css" 
type="text/css"><link rel="stylesheet" href="skin/site.css" 
type="text/css"><link media="print" rel="stylesheet" href="skin/print.css" 
type="text/css"><meta value="Avalon Documentation Team" name="author"><meta 
value="avalon-dev@jakarta.apache.org" name="email"><title>Excalibur AltRMI / 
Publishing</title></head><body bgcolor="white" class="composite" 
marginheight="0" marginwidth="0"><div id="banner"><table width="100%" 
cellpadding="8" cellspacing="0" border="0"><tbody><tr><td align="left"><a 
href="http://jakarta.apache.org/";><img border="0" 
src="images/jakarta-logo.gif"></a></td><td align="right"><a 
href="http://jakarta.apache.org/avalon/";><img border="0" 
src="images/header.gif"></a></td></tr></tbody></table></div><table width="100%" 
cellpadding="0" cellspacing="0" border="0" id="breadcrumbs"><td><a 
href="http://jakarta.apache.org/";>Jakarta Main</a> |
               <a href="http://jakarta.apache.org/avalon";>Avalon Main</a> |
  -            <a href="../">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
  +            <a href="../index.html">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
               <a 
href="http://jakarta.apache.org/avalon/excalibur/";>Excalibur</a> |
               <a 
href="http://jakarta.apache.org/avalon/cornerstone/";>Cornerstone</a> |
               <a href="http://jakarta.apache.org/avalon/phoenix/";>Phoenix</a> |
               <a href="http://jakarta.apache.org/avalon/apps/";>Apps</a> |
  -            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/">API Docs</a></div><div><a href="otherfeatures.html">Other 
Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / 
Publishing</h1><h2></h2></div><div class="h3">
  +            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/index.html">API Docs</a></div><div><a 
href="otherfeatures.html">Other Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / 
Publishing</h1><h2></h2></div><div class="h3">
     
     
       <div class="h3"><h3>Introduction</h3></div>
         <p>
  -        Publishing is an server responsibility obviously.  It is quite 
straight forward.
  +        Publishing is a server responsibility obviously, it is quite 
straight forward.
         </p>
                 
       <div class="h3"><h3>Publishing</h3></div>
         <p>                
  -        You have to choose your server, publish the impl (reiterating the 
interfaces that will 
  +        You have to choose your server, publish the implimentation 
(reiterating the interfaces that will
           be pass-by-reference boundaries), then start the server.....
   <pre>
   
  -        AbstractServer as new CompleteSocketCustomStreamServer(1235);
  +        AbstractServer as = new CompleteSocketCustomStreamServer(1235);
           TestInterfaceImpl ti = new TestInterfaceImpl();
           as.publish(ti, "Hello", new 
PublicationDescription(TestInterface.class, TestInterface2.class));
           as.start();
  
  
  
  1.6       +2 -2      jakarta-avalon-site/docs/excalibur/altrmi/tests.html
  
  Index: tests.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/excalibur/altrmi/tests.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- tests.html        10 Aug 2002 21:59:37 -0000      1.5
  +++ tests.html        12 Dec 2002 08:12:16 -0000      1.6
  @@ -1,12 +1,12 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
   <html><head><META http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><link rel="stylesheet" href="skin/tigris.css" 
type="text/css"><link rel="stylesheet" href="skin/site.css" 
type="text/css"><link media="print" rel="stylesheet" href="skin/print.css" 
type="text/css"><meta value="Avalon Documentation Team" name="author"><meta 
value="avalon-dev@jakarta.apache.org" name="email"><title>Excalibur AltRMI / 
Tests</title></head><body bgcolor="white" class="composite" marginheight="0" 
marginwidth="0"><div id="banner"><table width="100%" cellpadding="8" 
cellspacing="0" border="0"><tbody><tr><td align="left"><a 
href="http://jakarta.apache.org/";><img border="0" 
src="images/jakarta-logo.gif"></a></td><td align="right"><a 
href="http://jakarta.apache.org/avalon/";><img border="0" 
src="images/header.gif"></a></td></tr></tbody></table></div><table width="100%" 
cellpadding="0" cellspacing="0" border="0" id="breadcrumbs"><td><a 
href="http://jakarta.apache.org/";>Jakarta Main</a> |
               <a href="http://jakarta.apache.org/avalon";>Avalon Main</a> |
  -            <a href="../">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
  +            <a href="../index.html">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
               <a 
href="http://jakarta.apache.org/avalon/excalibur/";>Excalibur</a> |
               <a 
href="http://jakarta.apache.org/avalon/cornerstone/";>Cornerstone</a> |
               <a href="http://jakarta.apache.org/avalon/phoenix/";>Phoenix</a> |
               <a href="http://jakarta.apache.org/avalon/apps/";>Apps</a> |
  -            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/">API Docs</a></div><div><a href="otherfeatures.html">Other 
Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / 
Tests</h1><h2></h2></div><div class="h3">
  +            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/index.html">API Docs</a></div><div><a 
href="otherfeatures.html">Other Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / 
Tests</h1><h2></h2></div><div class="h3">
     
     
       <div class="h3"><h3>Introduction</h3></div>
  
  
  
  1.7       +24 -24    jakarta-avalon-site/docs/excalibur/altrmi/transports.html
  
  Index: transports.html
  ===================================================================
  RCS file: 
/home/cvs/jakarta-avalon-site/docs/excalibur/altrmi/transports.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- transports.html   10 Aug 2002 21:59:37 -0000      1.6
  +++ transports.html   12 Dec 2002 08:12:16 -0000      1.7
  @@ -1,12 +1,12 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
   <html><head><META http-equiv="Content-Type" content="text/html; 
charset=ISO-8859-1"><link rel="stylesheet" href="skin/tigris.css" 
type="text/css"><link rel="stylesheet" href="skin/site.css" 
type="text/css"><link media="print" rel="stylesheet" href="skin/print.css" 
type="text/css"><meta value="Avalon Documentation Team" name="author"><meta 
value="avalon-dev@jakarta.apache.org" name="email"><title>Excalibur AltRMI / 
Transports</title></head><body bgcolor="white" class="composite" 
marginheight="0" marginwidth="0"><div id="banner"><table width="100%" 
cellpadding="8" cellspacing="0" border="0"><tbody><tr><td align="left"><a 
href="http://jakarta.apache.org/";><img border="0" 
src="images/jakarta-logo.gif"></a></td><td align="right"><a 
href="http://jakarta.apache.org/avalon/";><img border="0" 
src="images/header.gif"></a></td></tr></tbody></table></div><table width="100%" 
cellpadding="0" cellspacing="0" border="0" id="breadcrumbs"><td><a 
href="http://jakarta.apache.org/";>Jakarta Main</a> |
               <a href="http://jakarta.apache.org/avalon";>Avalon Main</a> |
  -            <a href="../">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
  +            <a href="../index.html">Up</a></td><td style="text-align: right" 
align="right"><a 
href="http://jakarta.apache.org/avalon/framework/";>Framework</a> |
               <a 
href="http://jakarta.apache.org/avalon/excalibur/";>Excalibur</a> |
               <a 
href="http://jakarta.apache.org/avalon/cornerstone/";>Cornerstone</a> |
               <a href="http://jakarta.apache.org/avalon/phoenix/";>Phoenix</a> |
               <a href="http://jakarta.apache.org/avalon/apps/";>Apps</a> |
  -            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/">API Docs</a></div><div><a href="otherfeatures.html">Other 
Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / 
Transports</h1><h2></h2></div><div class="h3">
  +            <a 
href="http://jakarta.apache.org/avalon/logkit/";>Logkit</a></td></table><table 
id="main" width="100%" cellpadding="8" cellspacing="0" border="0"><tbody><tr 
valign="top"><td id="leftcol"><div 
id="navcolumn"><div><strong>About</strong><div><a 
href="index.html">Overview</a></div><div><a 
href="http://jakarta.apache.org/avalon/excalibur/index.html";>Excalibur 
Home</a></div><div><a 
href="http://jakarta.apache.org/builds/jakarta-avalon-excalibur/release";>Download</a></div><div><a
 href="api/index.html">API Docs</a></div><div><a 
href="otherfeatures.html">Other Features</a></div><div><a 
href="transports.html">Transports</a></div></div><div><strong>Using</strong><div><a
 href="facades.html">Facade Design</a></div><div><a 
href="generating-proxies.html">Generating proxies</a></div><div><a 
href="publishing.html">Publishing</a></div><div><a 
href="client-usage.html">Client usage</a></div><div><a 
href="pingers.html">Pingers</a></div><div><a 
href="connection-listeners.html">Connection Listeners</a></div><div><a 
href="tests.html">Tests</a></div></div></div></td><td><div id="bodycol"><div 
class="app"><div align="center"><h1>Excalibur AltRMI / 
Transports</h1><h2></h2></div><div class="h3">
     
     
       <div class="h3"><h3>Introduction</h3></div>
  @@ -25,7 +25,7 @@
           Avalon-Phoenix or or an implementation of the EJB specification will.
         </p>
         <p>
  -        All of these transports are synchronous too.  That means that an 
invokation acorss there connection
  +        All of these transports are synchronous too.  That means that an 
invocation acorss there connection
           will wait until the it is completed server side before the next 
invocation is allowed through.
         </p>
   
  @@ -43,7 +43,7 @@
         
         <div class="h4"><h4>Over RMI</h4></div>
           <p>
  -          This is another transport that bridges two different JVMs using 
TCP/IP.  It is actually the fstest of all the
  +          This is another transport that bridges two different JVMs using 
TCP/IP.  It is actually the fastest of all the
             TCP/IP using transports. and takes advantage of RMI as it's 
transport while hiding RMI from the AltRMI
             client and server.
           </p>
  @@ -51,18 +51,18 @@
         <div class="h4"><h4>Piped with same VM / ObjectStream &amp; 
CustomStream varients</h4></div>
           <p>
             In a similar way to the ObjectStream and CustomStream 
implementations of the plain sockets transport, these
  -          offer trasport using a pipe inside the JVM.  Not needed for most 
users of AltRMI these prove useful for
  +          offer transport using a pipe inside the JVM.  Not needed for most 
users of AltRMI these prove useful for
             developers making complex trees of classloaders with high 
separation from each other. As a Pipe is being
  -          used there is is some opportunity for buffering of invokations.  
This might slow the throughput down but
  -          this may releieve other parts of a particular design.
  +          used there is is some opportunity for buffering of invocations.  
This might slow the throughput down but
  +          this may relieve other parts of a particular design.
           </p>
         
         <div class="h4"><h4>Direct within same VM</h4></div>
           <p>
             There are 'Direct' and 'DirectMarshalled' transports.  These are 
use useful in the same scenarios as
  -          the Piped one, but with some small differences.  Principally, 
there is no pipe - the invokation is
  +          the Piped one, but with some small differences.  Principally, 
there is no pipe - the invocation is
             immediately handled on the server side.  With Direct there is also 
the fact that all mutually visible
  -          classes and interfaces woould have to be in a commonly visible 
classloader.  With DirectMarshalled,
  +          classes and interfaces would have to be in a commonly visible 
classloader.  With DirectMarshalled,
             there can be duplicate interfaces and class definitions as in the 
streamed types of transport.
           </p>
         
  @@ -75,11 +75,11 @@
       
       <div class="h3"><h3>Supplied Callback capable Transports</h3></div>
         <p>
  -        All of these transports are asynchronous.  Thais means that an 
invokation across there connection
  -        will does not wait until the reply is ready before it allows another 
request though.  This allows
  -        two thing - excpetionally lengthy requests (that might ordinarily 
affect timeouts) to be performed and
  -        callbacks (server invoking requests on the client).  There is a smal 
(15%) cost to using this transport for
  -        simple cases, but its benefits outweigh its deficiences.
  +        All of these transports are asynchronous.  Thais means that an 
invocation across the connection
  +        does not wait until the reply is ready before it allows another 
request though.  This allows
  +        two things - excpetionally lengthy requests (that might ordinarily 
affect timeouts) to be performed and
  +        callbacks (server invoking requests on the client).  There is a 
small (15%) cost to using this transport for
  +        simple cases, but its benefits outweigh its deficiencies.
         </p>
         <p>
           Whilst the Callback enabled transports are better from the point of 
view of asynchronous behaviour
  @@ -124,8 +124,8 @@
            <div class="h4"><h4>AltRMI types in the same VM</h4></div>
            <p>
   
  -         These are useful for complete classloader separation of interface 
&amp; impl using
  -         different classloaders. Impl and 'remote' proxy do not need to see 
the same
  +         These are useful for complete classloader separation of interface 
&amp; implementation using
  +         different classloaders. The implementation and 'remote' proxy do 
not need to see the same
               interfaces etc..<br>
               <br>
            Speed Test type                   Count Relative<br>
  @@ -147,9 +147,9 @@
            <p>
   
            - In VM, without using AltRMI - for comparison.
  -         - The inteface, impl and proxy cannot be separated in terms of
  +         - The inteface, implementation and proxy cannot be separated in 
terms of
              branches of classloader for these three. The same interfaces
  -           etc must be visible to both impl and proxy.
  +           etc must be visible to both implementation and proxy.
              <br>
            Speed Test type                   Count Relative<br>
            ------------------------------- ------- --------<br>
  @@ -176,21 +176,21 @@
           <b>void setObject(object o);</b> and <b>Object getObject();</b>, and 
clases in
           B amp; C could invoke those methods freely, the you might consider 
that B has a way of taking to C.  if B
           called (essentially) <b>A.setObject("Hello")</b>, then C could 
indeed call <b>String
  -        s = A.getObject()</b> without ny problem.  Say a class being passed 
were called 'Thing' and was in the
  +        s = A.getObject()</b> without any problem.  Say a class being passed 
were called 'Thing' and was in the
           classloader of B and duplicated in the classloader of C, but not in 
A at all, then it would not be passable
  -        by the setter/getter mechanism outlined above.  Why?  The JVM 
considers then differnt classes because they
  +        by the setter/getter mechanism outlined above.  Why?  The JVM 
considers then different classes because they
           are mounted in different classloaders (even though from the same 
source).  That is a secret
           of classloading (at least as it pertains to RPC in one VM).
         </p>
         <p>
           The issue is relevent to AltRMI mostly if it is being used to 
connect two nodes of a single classloader tree.
  -        If the trasport chosen is 'Direct' then you will get 
ClassCastExceptions thrown by the JVM if you had been
  +        If the transport chosen is 'Direct' then you will get 
ClassCastExceptions thrown by the JVM if you had been
           passed an Object you wanted to cast up to something, and that 
something were represented by a class definition
           in both the server and client nodes of the classloader tree.  If the 
something class were in a mutualy
  -        visible parent class loader then no issue would be apparent.  IF the 
client and server were in seperate VMs,
  -        then no issue would be apparent, princiapally because on the 
marchalling to serialized form natly hides the
  +        visible parent class loader then no issue would be apparent.  IF the 
client and server were in separate VMs,
  +        then no issue would be apparent, principally because the marchalling 
to serialized form neatly hides the
           two class definitions from the JVM.  This is the clue to the solving 
of the issue for a particular
  -        client/server (in one JVM) confiuration you may be cooking up.  If 
you choose Piped or DirectMarshalled as
  +        client/server (in one JVM) configuration you may be cooking up.  If 
you choose Piped or DirectMarshalled as
           trasnports, then you can have the same class definition in multiple 
classloader nodes.  Of couse, both Piped
           and DirectMarshalled are slower than Direct as transports.  
Configuration choices for the developer/deployer.
         </p>
  
  
  

--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to