Contribution Preparation

Description:

Helps prepare contributions/composites for running across the nodes in a domain. Steps here could all be done manually by editing of the individual composite files.

input:

run the workplace
add contributions

steps:

1. add/list/remove contributions/composites/nodes
2. analyze/resolve/validate contributions and their dependencies
3. include composite (from the contributions above) in a domain
   1. A matter of selecting which composites will be top level composites in the domain
4. associate composites with nodes/apply physical binding defaults/propagate physical addresses based on domain level wiring
   1. Get contributions - hoping this is all done by previous steps
      1. For each contribution included
      2. Find all artifacts in the contribution
      3. Read each artifact and create a model (apart from composites which are done later)
      4. Enhance model with policy information
      5. resolve models against artifacts from contribution and its dependencies (not sure I need this)
   2. Read in node model - which provides
      1. Mapping of composite to node
      2. Default configuration of bindings at that node, e.g. the root URL required for binding.ws
5. read/compile-build/write composites without requiring a runtime

output:

contributions/composites configured for running on nodes

Node Start

input:
run the node.exe

steps:
Load extensions
create runtime artifacts (builders, activators etc)
Load definitions.xml

output
running node awaiting contribution/composite to run

Process Contribution

input:
a contribution jar or file system directory

steps:
Contribution Read

1. Find all artifacts in the contribution
2. Read each artifact and create a model (apart from composites which are done later)
3. Aggregate all definitions.xml files
4. Read composites
5. Enhance composite with policy sets based on appliesTo information
   1. For each composite file read the xml content first...
      1. For each policyset in the domain...
         1. Extract the value of 'appliesTo' attribute with is an xpath expression
         2. Evaluate this expression against the composite xml
         3. For each node that results out of the above evaluation
            1. if the node contains an attribute named 'applicablePolicySets'
               1. concatenate to its value, the name of the PolicySet
            2. else
               1. create an attribute named 'applicablePolicySet' and set its value to the name of the PolicySet
6. Wherever applicable the composite's elements will have the additional attribute name 'applicablePolicySets'.
7. Parse composites into in memory assembly model

Contribution Resolution

• resolve the contribution models against the physical artifacts available in the contribution.

output:
a contribution model in memory containing composite assembly models in memory

Model Build

Model Activate

Composite/Component Start