You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@avalon.apache.org by ha...@apache.org on 2002/01/08 12:33:13 UTC

cvs commit: jakarta-avalon-cornerstone/src/xdocs book.xml cornerstone.uris index.xml demo-httpproxy.xml demo-simpleserver.xml

hammant     02/01/08 03:33:13

  Modified:    src/xdocs book.xml cornerstone.uris index.xml
  Removed:     src/xdocs demo-httpproxy.xml demo-simpleserver.xml
  Log:
  basic description of services and blocks.
  
  Revision  Changes    Path
  1.9       +0 -2      jakarta-avalon-cornerstone/src/xdocs/book.xml
  
  Index: book.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-cornerstone/src/xdocs/book.xml,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- book.xml	29 Dec 2001 19:29:03 -0000	1.8
  +++ book.xml	8 Jan 2002 11:33:12 -0000	1.9
  @@ -20,8 +20,6 @@
     </menu>
     <menu label="Demo Applications">
       <menu-item label="Applications" href="apps.html"/>
  -    <menu-item label="HTTP Proxy" href="demo-httpproxy.html"/>
  -    <menu-item label="Simple Server" href="demo-simpleserver.html"/>
     </menu>
   
   </book>
  
  
  
  1.7       +0 -2      jakarta-avalon-cornerstone/src/xdocs/cornerstone.uris
  
  Index: cornerstone.uris
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-cornerstone/src/xdocs/cornerstone.uris,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- cornerstone.uris	29 Dec 2001 19:29:03 -0000	1.6
  +++ cornerstone.uris	8 Jan 2002 11:33:12 -0000	1.7
  @@ -1,7 +1,5 @@
   apps.html
   changes.html
  -demo-httpproxy.html
  -demo-simpleserver.html
   features.html
   images/add.jpg
   images/fix.jpg
  
  
  
  1.4       +116 -7    jakarta-avalon-cornerstone/src/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-cornerstone/src/xdocs/index.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- index.xml	29 Dec 2001 19:29:03 -0000	1.3
  +++ index.xml	8 Jan 2002 11:33:12 -0000	1.4
  @@ -14,18 +14,127 @@
       <s1 title="Introduction">
         <p>
           Cornerstone is a set of services for the Phoenix kernel. It contains "blocks"
  -        that plug into Phoenix. Example blocks include ConnectionManager, SocketManager,
  -        Scheduler etc.
  +        that plug into Phoenix. 
         </p>
  -      <p>
  -        TODO - introduce the blocks that come with cornerstone.
  -      </p>      
       </s1>
  -  </body>
  +    <s1 title="Service List (&amp; the blocks that implement them)">
  +      <s2 title="ConnectionManager">
  +        <p>
  +          The ConnectionManager service provides a facility to listen for incoming socket connections.
  +        </p>
  +        <p>
  +          The DefaultConnectionManager block gives a thread pooled implementation of this service.
  +          If there  were many server components all depending on this block, they would all share 
  +          the same thread pool.
  +        </p>   
  +      </s2>
  +      <s2 title="DataSourceSelector">
  +        <p>
  +          The DataSourceSelector service provides a TODO-Eung-ju.
  +        </p>
  +        <p>
  +          The DefaultDataSourceSelector block gives TODO-Eung-ju.
  +        </p>   
  +      </s2>      
  +      <s2 title="DocumentBuilderFactory">
  +        <p>
  +          The DocumentBuilderFactory service provides a way to depend on a DOM Parser.  This
  +          implements the same methods (bar the factory one) that 
  +          javax.xml.parsers.DocumentBuilderFactory does.
  +        </p>
  +        <p>
  +          The DOMBuilderFactory block will instantiate a javax.xml.parsers.DocumentBuilderFactory
  +          parser as named in its configuration.
  +        </p>   
  +        <p>
  +          <strong>Note -</strong> One might ask why the javax.xml.parsers.DocumentBuilderFactory
  +          is not just used to load a parser.  The reason is that the factory method in that abstract
  +          class will register the first DOM parser loaded as the DOM parser to use for the whole VM.
  +          Clearly for a multi-server solution like Phoenix we must allow differet servers to load
  +          their preferred parser.  After all not all parser are created equal (in terms of features,
  +          speed and size).
  +        </p>        
  +      </s2>
  +      <s2 title="PacketManager">
  +        <p>
  +          The PacketManager service provides ...
  +        </p>
  +        <p>
  +          The DefaultPacketManager block ...
  +        </p>   
  +      </s2>            
  +      <s2 title="SAXParserFactory">
  +        <p>
  +          The SAXParserFactory service provides a way to depend on a SAX Parser.  This implements
  +          the same methods (bar the factory one) that javax.xml.parsers.SAXParserFactory does.
  +        </p>
  +        <p>
  +          The SAXParserFactoryImpl block will instantiate a javax.xml.parsers.SAXParserFactory
  +          parser as named in its configuration.
  +        </p>   
  +        <p>
  +          <strong>Note -</strong> Same note as for DocumentBuilderFactory above.
  +        </p>        
  +      </s2>
  +      <s2 title="TimeScheduler">
  +        <p>
  +          The TimeScheduler service provides a way to a depending block to do things an certain intervals.
  +        </p>
  +        <p>
  +          The DefaultTimeScheduler block implements the service.
  +        </p>   
  +        <p>
  +          Used in conjunction with the service is a TimeTrigger.  There are two such tiggers at the
  +          moment - CronTimeTrigger and PeriodicTimeTigger.
  +        </p>        
  +      </s2>      
  +      <s2 title="SOAPification">
  +        <p>
  +          The SOAPification service provides a way to publish an arbitart interface remotely using SOAP.
  +        </p>
  +        <p>
  +          The Glue block implements this service using the 'Glue' from 'The Mind Electric'.  As this
  +          product is commercial, we 1) do not include the jar for it in the source distro, 2) do not make
  +          available for download a Cornerstone that includes the Glue block.
  +        </p>   
  +        <p>
  +          There is some question currentl as to whether Glue 2,x works with with Pheonix.  Glue 1.3 does.
  +        </p>        
  +      </s2>     
  +      <s2 title="SocketManager">
  +        <p>
  +          The SocketManager service provides a way to lookup a factory for server of client sockets.
  +        </p>
  +        <p>
  +          The DefaultSocketManager block implements this service
  +        </p>
  +      </s2>
  +      <s2 title="Store">
  +        <p>
  +          The Store service provides a way to store named Objects or Streams without knowing how they
  +          are stored.
  +        </p>
  +        <p>
  +          The RepositoryManager block implements this service and provides (in invocation of select(..) ) an 
  +          appropriate Respository.  The two configurable implementations use the local file system for 
  +          storage.
  +        </p>
  +      </s2>
  +      <s2 title="ThreadManager">
  +        <p>
  +          The ThreadManager service provides a way get default or named Thread Pool.
  +        </p>
  +        <p>
  +          The DefaultThreadManager block implements this service an leans on Excalibur 
  +          implementations of ThreadPool.
  +        </p>   
  +      </s2>      
  +    </s1>   
  +  </body>  
     <footer>
       <legal>
         Copyright (c) @year@ The Jakarta Apache Project All rights reserved.
  -      $Revision: 1.3 $ $Date: 2001/12/29 19:29:03 $
  +      $Revision: 1.4 $ $Date: 2002/01/08 11:33:12 $
       </legal>
     </footer>
   </document>
  
  
  

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>