Rough outline of the Axis Arch. Doc

[Steve Graham <sg...@us.ibm.com>]

Folks:
What follows is a first cut at the outline of an Apache Arch. Doc.  The
structure will vary, based on the resolution to various issues.
Lets discuss this at the IRC tomorrow, otherwise please post comments for
suggested modifications to the structure.



1  About this Document

  1.1  Reader Prerequisites
  1.2  Conventions
  1.3  What is AXIS?
  1.4  Note from the Editor
  1.5  Revision History

2  Requirements


3  Axis Architecture

  3.1  Perspectives
  3.2  Object Structure Overview
   3.2.1  Message
   3.2.2  Flow Object (Chainable Content)
   3.2.3  AxisContext
   3.2.4  TransportContext
  3.3  Component overview
   3.3.1  Transport Listener
   3.3.2  Transport Sender
   3.3.3  Deserializer
   3.3.4  Serializer
   3.3.5  Canonicalizer
   3.3.6  ChainContainer
   3.3.7  Chain
   3.3.8  Handler
   3.3.9  Router
   3.3.10 Dispatcher (eg pluggable providers stuff)

4  Scenario: Purchase Order Request

  4.1  Provider Perspective
  4.2  Requestor Perspective

5  Service Provider Message Processing (runtime)

  5.1  Use Case: Receipt of Request/Response Message
  5.2  Use Case: Receipt of one-way input Message
  5.3  Use Case: Issuance of one-way outbound Message
  5.4  One Message or Two?
  5.5  Stateful Handlers vs Stateless
  5.6  Fault Handling
  5.7  Handling SOAP:mustUnderstand
  5.8  Handling SOAP:Actor
  5.9  Start/Stop of Message Processing

6  Service Provider Deployment/Initialization

  6.1  Deployment-Time Architecture Overview
  6.2  Use Case: Deploying components to the Axis Node
  6.3  Use Case: Deploying a Global WSDD
  6.4  Use Case: Deploying a Web Service
  6.5  Use Case: Node Start-up/Shutdown
  6.6  Use Case: re-deploying a Web Service (lifecycle)
  6.7  Use Case: re-deploying components (lifecycle)
  6.8  Other configuration items

7  Service Requestor Message Processing (runtime)


8  Service Requestor Deployment/Initialization


Appendix A: Issues List

  [AXIS ISSUE 1]: Input/output Message or Single Message
  [AXIS ISSUE 2] Lifetime Management of Chainables
  [AXIS ISSUE 3] Message object or stream of bits

Appendix B: Deferred Requirements


Appendix C: Glossary






++++++++
Steve Graham
sggraham@us.ibm.com
(919)254-0615 (T/L 444)
<<Pithecanthropus Erectus>>
Emerging Internet Technologies
++++++++