Notation
The Component Specification consists of both a textual definition and visual model of a component's responsibilities,
characteristics, and interfaces.
The textual definition includes the following information:
Property
|
Description
|
UML Representation
|
Name
|
The name of the Component
|
The attribute "Name" on model element.
|
Description
|
Brief description of the component
|
Tagged value, of type "short text".
|
Responsibilities
|
List of component responsibilities
|
A (predefined) tagged value on the superclass "Type".
|
Required Service Levels (Non-Functional Requirements)
|
List of Service Levels supported by the Component
|
Tagged value, of type "short text".
|
Reasonableness & Risk
|
Statement(s) about the risks associated with the design of the component
|
Tagged value, of type "short text".
|
Design Rationale
|
Component design decisions
|
Tagged value, of type "short text".
|
Implementation Approach
|
Implementation guidance and instructions
|
Tagged value, of type "short text".
|
Diagrams
|
Diagrams (detailed below) local to the component that complete its specification.
|
Owned by an enclosing package, via the aggregation "owns".
|
The visual model consists of three UML diagrams:
-
Component Specification Diagram - shows the interfaces offered and used by a component
-
Interface Responsibility Diagram - depicts the data managed by each interface; shows dependencies
between data and interfaces
-
Interface Specification Diagram - shows the information types managed by interfaces; shows how
interfaces manage a component's state
Component Specification Diagram
A component specification diagram shows a single component with the interfaces it uses as well as the ones it
offers.
Interface Responsibility Diagram
An Interface Responsibility Diagram the information managed each interface and brings dependencies to the surface. It
shows an association between interfaces and entities from the logical data model (LDM). It does not show information or
state that the components manage through the interfaces.
Interface Specification Diagram
An Interface Specification Diagram depicts the information model of an interface. It shows all of the information types
that are needed by the interface. These types correspond to dynamic or "in-flight" data. They are not the same as
persistent data, but they usually map to the underlying entities of the logical data model from which they are derived.
|