Package com.structurizr.model
Class Person
java.lang.Object
com.structurizr.model.Element
com.structurizr.model.StaticStructureElement
com.structurizr.model.Person
public final class Person extends StaticStructureElement
Represents a "person" in the C4 model.
-
Method Summary
Modifier and Type Method Description Perspective
addPerspective(java.lang.String name, java.lang.String description)
Adds a perspective to this model item.void
addProperty(java.lang.String name, java.lang.String value)
Adds a name-value pair property to this element.void
addTags(java.lang.String... tags)
Relationship
delivers(Person destination, java.lang.String description)
Adds a unidirectional relationship between this element and a person.Relationship
delivers(Person destination, java.lang.String description, java.lang.String technology)
Adds a unidirectional relationship between this element and a person.Relationship
delivers(Person destination, java.lang.String description, java.lang.String technology, InteractionStyle interactionStyle)
Adds a unidirectional relationship between this element and a person.java.lang.String
getCanonicalName()
java.lang.String
getId()
Gets the ID of this item in the model.Location
getLocation()
Gets the location of this person.Element
getParent()
Gets the parent of this element.java.util.Set<Perspective>
getPerspectives()
Gets the set of perspectives associated with this model item.java.util.Map<java.lang.String,java.lang.String>
getProperties()
Gets the collection of name-value property pairs associated with this element, as a Map.protected java.util.Set<java.lang.String>
getRequiredTags()
java.lang.String
getTags()
Gets the comma separated list of tags.java.util.Set<java.lang.String>
getTagsAsSet()
boolean
hasTag(java.lang.String tag)
Determines whether this model item has the given tag.Relationship
interactsWith(Person destination, java.lang.String description)
Adds an interaction between this person and another.Relationship
interactsWith(Person destination, java.lang.String description, java.lang.String technology)
Adds an interaction between this person and another.Relationship
interactsWith(Person destination, java.lang.String description, java.lang.String technology, InteractionStyle interactionStyle)
Adds an interaction between this person and another.boolean
removeTag(java.lang.String tag)
Removes the given tag.void
setLocation(Location location)
Methods inherited from class com.structurizr.model.StaticStructureElement
uses, uses, uses, uses, uses, uses, uses, uses, uses, uses
Methods inherited from class com.structurizr.model.Element
getDescription, getEfferentRelationshipWith, getModel, getName, getRelationships, getUrl, hasAfferentRelationships, hasEfferentRelationshipWith, setDescription, setModel, setUrl, toString
-
Method Details
-
getParent
Description copied from class:Element
Gets the parent of this element. -
getLocation
Gets the location of this person.- Returns:
- a Location
-
setLocation
-
getCanonicalName
public java.lang.String getCanonicalName()- Specified by:
getCanonicalName
in classElement
-
getRequiredTags
protected java.util.Set<java.lang.String> getRequiredTags() -
delivers
Description copied from class:StaticStructureElement
Adds a unidirectional relationship between this element and a person.- Overrides:
delivers
in classStaticStructureElement
- Parameters:
destination
- the target of the relationshipdescription
- a description of the relationship (e.g. "sends e-mail to")- Returns:
- the relationship that has just been created and added to the model
-
delivers
public Relationship delivers(Person destination, java.lang.String description, java.lang.String technology)Description copied from class:StaticStructureElement
Adds a unidirectional relationship between this element and a person.- Overrides:
delivers
in classStaticStructureElement
- Parameters:
destination
- the target of the relationshipdescription
- a description of the relationship (e.g. "sends e-mail to")technology
- the technology details (e.g. JSON/HTTPS)- Returns:
- the relationship that has just been created and added to the model
-
delivers
public Relationship delivers(Person destination, java.lang.String description, java.lang.String technology, InteractionStyle interactionStyle)Description copied from class:StaticStructureElement
Adds a unidirectional relationship between this element and a person.- Overrides:
delivers
in classStaticStructureElement
- Parameters:
destination
- the target of the relationshipdescription
- a description of the relationship (e.g. "sends e-mail to")technology
- the technology details (e.g. JSON/HTTPS)interactionStyle
- the interaction style (sync vs async)- Returns:
- the relationship that has just been created and added to the model
-
interactsWith
Adds an interaction between this person and another.- Parameters:
destination
- the Person being interacted withdescription
- a description of the interaction- Returns:
- the resulting Relatioship
-
interactsWith
public Relationship interactsWith(Person destination, java.lang.String description, java.lang.String technology)Adds an interaction between this person and another.- Parameters:
destination
- the Person being interacted withdescription
- a description of the interactiontechnology
- the technology of the interaction (e.g. Telephone)- Returns:
- the resulting Relatioship
-
interactsWith
public Relationship interactsWith(Person destination, java.lang.String description, java.lang.String technology, InteractionStyle interactionStyle)Adds an interaction between this person and another.- Parameters:
destination
- the Person being interacted withdescription
- a description of the interactiontechnology
- the technology of the interaction (e.g. Telephone)interactionStyle
- the interaction style (e.g. Synchronous or Asynchronous)- Returns:
- the resulting Relatioship
-
getId
public java.lang.String getId()Gets the ID of this item in the model.- Returns:
- the ID, as a String
-
getTags
public java.lang.String getTags()Gets the comma separated list of tags.- Returns:
- a comma separated list of tags, or an empty string if there are no tags
-
getTagsAsSet
public java.util.Set<java.lang.String> getTagsAsSet() -
addTags
public void addTags(java.lang.String... tags) -
removeTag
public boolean removeTag(java.lang.String tag)Removes the given tag.- Parameters:
tag
- the tag to remove- Returns:
- true if the tag was removed; will return false if a non-existent tag is passed, or if an attempt is made to remove required tags, which cannot be removed.
-
hasTag
public boolean hasTag(java.lang.String tag)Determines whether this model item has the given tag.- Parameters:
tag
- the tag to check for- Returns:
- true if tag is present as a tag on this item, or if it is one of the required tags defined by the model in getRequiredTags(), false otherwise
-
getProperties
public java.util.Map<java.lang.String,java.lang.String> getProperties()Gets the collection of name-value property pairs associated with this element, as a Map.- Returns:
- a Map (String, String) (empty if there are no properties)
-
addProperty
public void addProperty(java.lang.String name, java.lang.String value)Adds a name-value pair property to this element.- Parameters:
name
- the name of the propertyvalue
- the value of the property
-
getPerspectives
Gets the set of perspectives associated with this model item.- Returns:
- a Set of Perspective objects (empty if there are none)
-
addPerspective
Adds a perspective to this model item.- Parameters:
name
- the name of the perspective (e.g. "Security", must be unique)description
- a description of the perspective- Returns:
- a Perspective object
- Throws:
java.lang.IllegalArgumentException
- if perspective details are not specified, or the named perspective exists already
-