Class ConstructedDefSeg
- java.lang.Object
-
- com.automation_pros.odva.cip.path.PathSegment
-
- com.automation_pros.odva.cip.path.DataDefinitionSeg
-
- com.automation_pros.odva.cip.path.ConstructedDefSeg
-
- All Implemented Interfaces:
java.lang.Comparable<PathSegment>
public class ConstructedDefSeg extends DataDefinitionSeg
Encapsulates an elementary data type annotation within a CIP Path definition. Type annotations are generally not passed on the wire, but delimit the path fragment that will go on the wire (before the data type) from the path fragment that will be applied to the payload on the wire.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
ConstructedDefSeg.Decoder
Decode bytes expected to contain one encoded path segment.static class
ConstructedDefSeg.Parser
-
Nested classes/interfaces inherited from class com.automation_pros.odva.cip.path.DataDefinitionSeg
DataDefinitionSeg.DataDefinitionFragment
-
Nested classes/interfaces inherited from class com.automation_pros.odva.cip.path.PathSegment
PathSegment.HasAlternateHex
-
-
Field Summary
Fields Modifier and Type Field Description protected boolean
locked
protected BaseDataType<?>
sample
protected int
typeCode
-
Fields inherited from class com.automation_pros.odva.cip.path.DataDefinitionSeg
sLogger
-
Fields inherited from class com.automation_pros.odva.cip.path.PathSegment
identifierChars, segtype
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
ConstructedDefSeg()
protected
ConstructedDefSeg(int typeCode)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description int
compareTo(PathSegment o)
protected BaseDataType<?>
construct(int[] dimensions, DataContext ctx)
Construct an instance of the type represented by this definition, using the given dimensions.boolean
equals(java.lang.Object o)
int
getBytes()
Obtain the number of bytes needed to encode this segment instance in packed format.static ConstructedDefSeg
getCached(int typeCode)
BaseDataType<?>
getSample()
int
getSize(DataContext ctx, int... dims)
Return the number of bytes occupied by the given data type.int
getSizeImpl(DataContext ctx)
Return the number of bytes occupied by a single instance of the given data type.java.util.List<java.lang.String>
getTokens()
int
getTypeCode()
int
hashCode()
boolean
isBoolImpl()
Size calculations for boolean min and max must defer to .getSize() to get the right answer for boolean arrays.ConstructedDefSeg
lock()
static ConstructedDefSeg
lookup(java.lang.Class<?> clazz)
static ConstructedDefSeg
lookup(java.lang.String token)
protected void
makeSample()
int
nestedSize(DataContext ctx, int... dims)
Certain types (Omron strings and booleans) can have different encodings when packed into structures.void
put(java.nio.ByteBuffer dest, boolean padded)
Encode the current instance to the given destination.PathSegment
set(java.nio.ByteBuffer source, boolean padded)
Replace the current instance content with the decoded source bytes.java.lang.String
simpleString()
Supply s simple descriptive name usable when browsing a hierarchy.-
Methods inherited from class com.automation_pros.odva.cip.path.DataDefinitionSeg
alignment, browseInner, construct, follow, followOffsets, fromClass, fromData, getPermItem, isBoolHost, isStringData, maxSize, minSize, nestedMaxSize, nestedMinSize, nestedSizeImpl
-
Methods inherited from class com.automation_pros.odva.cip.path.PathSegment
decode, decodeAll, getSegtype, getWords, hexString, mergeTokens, registerHandler, setSegtype, toString
-
-
-
-
Field Detail
-
locked
protected boolean locked
-
typeCode
protected int typeCode
-
sample
protected BaseDataType<?> sample
-
-
Method Detail
-
getCached
public static ConstructedDefSeg getCached(int typeCode)
-
lookup
public static ConstructedDefSeg lookup(java.lang.Class<?> clazz)
-
lookup
public static ConstructedDefSeg lookup(java.lang.String token)
-
lock
public ConstructedDefSeg lock()
-
getTypeCode
public int getTypeCode()
-
getSample
public BaseDataType<?> getSample()
-
getSizeImpl
public int getSizeImpl(DataContext ctx)
Description copied from class:DataDefinitionSeg
Return the number of bytes occupied by a single instance of the given data type. When the data is indirect, size is zero. When the data is variable length, size is -1;- Specified by:
getSizeImpl
in classDataDefinitionSeg
- Returns:
- Number of bytes.
-
isBoolImpl
public boolean isBoolImpl()
Description copied from class:DataDefinitionSeg
Size calculations for boolean min and max must defer to .getSize() to get the right answer for boolean arrays.- Overrides:
isBoolImpl
in classDataDefinitionSeg
- Returns:
-
getSize
public int getSize(DataContext ctx, int... dims)
Description copied from class:DataDefinitionSeg
Return the number of bytes occupied by the given data type. When the data is indirect (hosted elsewhere), or variable length, size is -1.When dimensions are provided, compute the bytes the complete array will occupy. Otherwise report the size of a singleton.
- Overrides:
getSize
in classDataDefinitionSeg
- Returns:
- Number of bytes.
-
nestedSize
public int nestedSize(DataContext ctx, int... dims)
Description copied from class:DataDefinitionSeg
Certain types (Omron strings and booleans) can have different encodings when packed into structures.- Overrides:
nestedSize
in classDataDefinitionSeg
-
construct
protected BaseDataType<?> construct(int[] dimensions, DataContext ctx)
Description copied from class:DataDefinitionSeg
Construct an instance of the type represented by this definition, using the given dimensions. This is an implementation detail that permits a DecoratedDefSeg to create arrays.Use the provided context to look up any ambiguous data types.
- Specified by:
construct
in classDataDefinitionSeg
- Returns:
-
makeSample
protected void makeSample()
-
compareTo
public int compareTo(PathSegment o)
- Specified by:
compareTo
in interfacejava.lang.Comparable<PathSegment>
- Overrides:
compareTo
in classPathSegment
-
equals
public boolean equals(java.lang.Object o)
- Overrides:
equals
in classPathSegment
-
hashCode
public int hashCode()
- Overrides:
hashCode
in classjava.lang.Object
-
simpleString
public java.lang.String simpleString()
Description copied from class:PathSegment
Supply s simple descriptive name usable when browsing a hierarchy. A simple type name for elementary types, a non-detailed description for complex types.- Specified by:
simpleString
in classPathSegment
- Returns:
-
set
public PathSegment set(java.nio.ByteBuffer source, boolean padded)
Description copied from class:PathSegment
Replace the current instance content with the decoded source bytes.The caller must ensure that the instance is appropriate for the bytes supplied. This permits instance re-use in optimized applications.
- Specified by:
set
in classPathSegment
- Parameters:
source
- The bytes to be decoded. The position will be left after the last byte of the decoded segment.padded
- Alternate format selection. Packed format when false.- Returns:
- The same instance.
-
put
public void put(java.nio.ByteBuffer dest, boolean padded)
Description copied from class:PathSegment
Encode the current instance to the given destination.- Specified by:
put
in classPathSegment
- Parameters:
dest
- The buffer receiving the complete encoded instance.padded
- Alternate format selection. Packed format when false.
-
getBytes
public int getBytes()
Description copied from class:PathSegment
Obtain the number of bytes needed to encode this segment instance in packed format.- Specified by:
getBytes
in classPathSegment
- Returns:
- Number of bytes, assuming put() will be called with padded false.
-
getTokens
public java.util.List<java.lang.String> getTokens()
- Specified by:
getTokens
in classPathSegment
-
-