Class LocationCreationTO

java.lang.Object
org.opentcs.access.to.CreationTO
org.opentcs.access.to.model.LocationCreationTO
All Implemented Interfaces:
java.io.Serializable

public class LocationCreationTO
extends CreationTO
implements java.io.Serializable
A transfer object describing a location in a plant model.
See Also:
Serialized Form
  • Constructor Details

    • LocationCreationTO

      public LocationCreationTO​(@Nonnull java.lang.String name, @Nonnull java.lang.String typeName, @Nonnull Triple position)
      Creates a new instance
      Parameters:
      name - The name of this location.
      typeName - The name of this location's type.
      position - The position of this location.
  • Method Details

    • withName

      public LocationCreationTO withName​(@Nonnull java.lang.String name)
      Creates a copy of this object with the given name.
      Overrides:
      withName in class CreationTO
      Parameters:
      name - The new name.
      Returns:
      A copy of this object, differing in the given name.
    • getTypeName

      @Nonnull public java.lang.String getTypeName()
      Returns the name of this location's type.
      Returns:
      The name of this location's type.
    • withTypeName

      public LocationCreationTO withTypeName​(@Nonnull java.lang.String typeName)
      Creates a copy of this object with the location's type.
      Parameters:
      typeName - The location type.
      Returns:
      A copy of this object, differing in the given type.
    • getPosition

      @Nonnull public Triple getPosition()
      Returns the position of this location (in mm).
      Returns:
      The position of this location (in mm).
    • withPosition

      public LocationCreationTO withPosition​(@Nonnull Triple position)
      Creates a copy of this object with the given position (in mm).
      Parameters:
      position - the new position of this location (in mm).
      Returns:
      A copy of this object, differing in the given position.
    • getLinks

      @Nonnull public java.util.Map<java.lang.String,​java.util.Set<java.lang.String>> getLinks()
      Returns the links attaching points to this location. This is a map of point names to allowed operations.
      Returns:
      The links attaching points to this location.
    • withLinks

      public LocationCreationTO withLinks​(@Nonnull java.util.Map<java.lang.String,​java.util.Set<java.lang.String>> links)
      Creates a copy of this object with the given links that attach points to this location.
      Parameters:
      links - the new links. This is supposed to be a map of point names to allowed operations.
      Returns:
      A copy of this object, differing in the given links.
    • withLink

      public LocationCreationTO withLink​(@Nonnull java.lang.String pointName, @Nonnull java.util.Set<java.lang.String> allowedOperations)
      Creates a copy of this object with the given links that attach points to this location.
      Parameters:
      pointName - The name of the point linked to.
      allowedOperations - The operations allowed at the point.
      Returns:
      A copy of this object, differing in the given link.
    • isLocked

      public boolean isLocked()
      Returns the lock status of this location (i.e. whether it my be used by vehicles or not).
      Returns:
      true if this location is currently locked (i.e. it may not be used by vehicles), else false.
    • withLocked

      public LocationCreationTO withLocked​(boolean locked)
      Creates a copy of this object with the given locked flag.
      Parameters:
      locked - The new locked attribute.
      Returns:
      A copy of this object, differing in the locked attribute.
    • withProperties

      public LocationCreationTO withProperties​(@Nonnull java.util.Map<java.lang.String,​java.lang.String> properties)
      Creates a copy of this object with the given properties.
      Overrides:
      withProperties in class CreationTO
      Parameters:
      properties - The new properties.
      Returns:
      A copy of this object, differing in the given properties.
    • withProperty

      public LocationCreationTO withProperty​(@Nonnull java.lang.String key, @Nonnull java.lang.String value)
      Creates a copy of this object and adds the given property. If value == null, then the key-value pair is removed from the properties.
      Overrides:
      withProperty in class CreationTO
      Parameters:
      key - the key.
      value - the value
      Returns:
      A copy of this object that either includes the given entry in it's current properties, if value != null or excludes the entry otherwise.
    • getLayout

      public LocationCreationTO.Layout getLayout()
      Returns the information regarding the grahical representation of this location.
      Returns:
      The information regarding the grahical representation of this location.
    • withLayout

      public LocationCreationTO withLayout​(LocationCreationTO.Layout layout)
      Creates a copy of this object, with the given layout.
      Parameters:
      layout - The value to be set in the copy.
      Returns:
      A copy of this object, differing in the given value.
    • toString

      public java.lang.String toString()
      Overrides:
      toString in class java.lang.Object