23.5.  Component Instance

A component instance is an instance of a component (see Section 23.4, “ Component) which may reside on a node instance (see Section 23.3, “ Node Instance). In the UML metamodel ComponentInstance is a sub-class of Instance and is specifically an instance that is derived from a component.

A component is represented on a class diagram as a box with two small rectangles protruding from its left side, labeled with its name.

A component instance is represented on a sequence diagram in ArgoUML as a box with two small rectangles protruding from its left side labeled with the component instance name (if any) and component type, separated by a colon ( :).

[Tip]Tip

It is the presence of the colon (:) and the underlining of the name and type that distinguishes a component instance from a component.

23.5.1.  Component Instance Details Tabs

The details tabs that are active for component instances are as follows.

ToDoItem

Standard tab.

Properties

See Section 23.5.2, “ Component Instance Property Toolbar and Section 23.5.3, “ Property Fields For Component Instance below.

Documentation

Standard tab.

Presentation

Standard tab. The Bounds: field defines the bounding box for the component on the diagram.

Source

Standard tab, containing just the name of the component instance.

[Caution]Caution

A component instance should not generate any code, so having this tab active is probably a mistake.

Tagged Values

Standard tab.

[Note]Note

The UML Element metaclass from which all other model elements are derived includes the tagged element documentation which is handled by the documentation tab under ArgoUML

Checklist

Standard tab for an Instance.

23.5.2.  Component Instance Property Toolbar

Go up

Navigate up through the package structure.

New Stereotype

This creates a new Stereotype (see Section 16.6, “ Stereotype) for the selected component instance, navigating immediately to the properties tab for that stereotype.

Delete

This deletes the component instance from the model

[Warning]Warning

This is a deletion from the model not just the diagram. To delete a component instance from the diagram, but keep it within the model, use the main menu Remove From Diagram (or press the Delete key).

23.5.3.  Property Fields For Component Instance

Name

Text box. The name of the component instance. By convention component instance names start with a lower case letter and use bumpy caps to divide words within the name.

[Note]Note

ArgoUML does not enforce this naming convention.

Stereotype

Drop down selector. Component instance has no stereotypes by default in the UML standard.

Navigate Stereotype

icon. If a stereotype has been selected, this will navigate to the stereotype property panel (see Section 16.6, “ Stereotype).

Namespace

Drop down selector. Records and allows to change the namespace for the component instance. This is the package hierarchy.

Stimuli sent

(To Be Written).

Stimuli Received

(To Be Written).

Residents

Text box. Lists any residents (see Section 23.4, “ Component) designed to be deployed on this component.

Button 1 double click navigates to the selected entry.

Classifiers

Drop down selector. A Component instance type can be selected here.

[Caution]Caution

ArgoUML V0.18 lists many more items in the dropdown list then solely Components. Beware to select Components only.