Composition System Specification Language Reference

Through the Composition System Specification Language the concepts for a Composition System are defined. This is done by defining fragment roles and port types for these roles as well as by defining composition associations between port types. Composition Systems are specified in files with the extension csys.

Examples

Several examples can be found in the Applications section. Here are some direct links to csys files:

• reuseTaipan.csys
• ReuseUMLActivity.csys

• ClassWeaving.csys

• UMLActivityExt.csys
• UMLActivityExt2.csys

CSYS File Structure

Header

The header of a Composition System Specification has the following schema:

 compositionsystem ID
 { 
    fragmentRoleDefinitions + 
    compositionAssociationDefinitions + 
 }

• ID Gives an unique ID to the Composition System. This is used in Reuse Extensions (defined in the Reuse Extension Language) to refer to a Composition System. A default composition system is provided under the ID org.reuseware.lib.systems.default.

Fragment Role Definitions

A fragment role is defined as follows:

 fragment role roleName
 { portTypeDefinitions + }

• roleName gives a unique name to the fragment role. This name is used in Reuse Extensions for binding the role.

A fragment role contains a set of port types. A port type is either static or dynamic.

 static port portName

• portName A static port has to exist exactly one time on a fragment. The name is used to refer to the port in Reuse Extensions and will also be the name of any port that is of the defined type. Therefore static ports allow to make assumptions about a fragment's interface.

 dynamic port portName

• portName A dynamic port will appear several times on a fragment depending on the fragment's content. The names of these ports are derived from the fragment's content and are not known beforehand. The here defined port name is only used to refer to the port type in Reuse Extensions.

Composition Association Definitions

A composition association is either contributing or configuring. From this, the kind of composition that is performed for a composition link is determined (see Composition Language).

 contributing association associationName {
    fragmentRoleName.portName --> fragmentRoleName.portName
 }

 configuring association associationName {
    fragmentRoleName.portName --> fragmentRoleName.portName
 }

• associationName A name for the composition association.
• fragmentRoleName A fragment role defined above.
• portName A port of the corresponding fragment role defined above.