SecsFormat22 (ErgoTech VIB/TransSECS Scripting API)

java.lang.Object
- com.ergotech.secs.SecsFormat22

All Implemented Interfaces:

SecsFormat
```
public class SecsFormat22
extends java.lang.Object
implements SecsFormat
```
Unicode Secs Format. This will support the folowing types:
Encoding Code | SECS Encoding Scheme | Java Canonical Name
1 | ISO 10646 UCS-2 | UnicodeBig
2 | UTF-8 | UTF8
3 | ISO 646-1991 | ASCII
4 | ISO 8859-1 | ISO8859_1
5 | ISO 8859-11 | ISO8859_11 (1)
6 | TIS 620 | TIS620
7 | IS 13194 (1991) | ISCII(1)
8 | Shift JIS | SJIS
9 | EUC-JP | EUC_JP
10 | EUC-KR | EUC_KR
11 | Simp. Chinese (GB) | ISO2022CN_GB
12 | EUC-CN | EUC_CN
13 | Trad. Chinese Big5 | Big5
14 | EUC-TW | EUC_TW
(1)NOTE:No known font support for this type

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`cvsRev`
`java.lang.String`	`encoding` This is the encoding used by this format.
`int`	`encodingCode` The encoding code.
`int`	`length` The length of the format.
`java.lang.String`	`theData` The data for this object.

Constructor Summary

Constructors
Constructor and Description
`SecsFormat22()` Creates an empty string using the default encoding.
`SecsFormat22(byte[] newValue, int encodingCode)`
`SecsFormat22(char[] newValue, int encodingCode)`
`SecsFormat22(java.lang.String newValue, int encodingCode)` Create a new object with a value, encoding and code.
`SecsFormat22(java.lang.String newValue, java.lang.String encoding, int encodingCode)` Create a new object with a value, encoding and code.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(java.lang.Object obj)`
`SecsFormat[]`	`getArray()` This allows for arrays of secsformats (not a list of secsformats).
`boolean`	`getBoolValue()` Returns the true if the length of the data is non-zero.
`byte`	`getByteValue()` Returns the data converted to a byte.
`double`	`getDoubleValue()` Returns the data converted to a double.
`float`	`getFloatValue()` Returns the data converted to a float.
`byte[]`	`getFormattedBytes()` Returns the list in a manner suitable for encoding directly into a SECS message byte stream used over SECSI or HSMS transport.
`int`	`getIntValue()` Returns the data converted to a int.
`int`	`getLength()` Returns the length of the format.
`long`	`getLongValue()` Returns the data converted to a long.
`int`	`getNumberOfLengthBytes()` Returns the number of length bytes.
`short`	`getShortValue()` Returns the data converted to a short.
`java.lang.String`	`getStringValue()` Returns the data as a string.
`int`	`hashCode()`
`void`	`registerEncoding(int encodingCode, java.lang.String encoding)` Register the encoding for the code.
`void`	`setArray(SecsFormat[] newValues)` This allows for a standard way to set arrays of secsformats.
`void`	`setDataFromByteArray(byte[] temp, int offset, int length)` stores the incoming value in the format object.
`void`	`setLength(int newValue)` Sets the length of the format.
`void`	`setNumberOfLengthBytes(int numberOfLengthBytes)` Sets the number of length bytes to send when the format is encoded.
`int`	`size()` Returns the size of the data.
`java.lang.String`	`toString()` Returns the SML string representing this value
`java.lang.String`	`toString(int indentCount)` Returns the indented SML string representing this value.
`boolean`	`zeroLength()` Returns true if the format is zero length.

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - cvsRev
```
public static final java.lang.String cvsRev
```
    See Also:
    
    Constant Field Values
  - encoding
```
public java.lang.String encoding
```
    This is the encoding used by this format. It is stored at the Java encoding and should be supported by the string.
  - encodingCode
```
public int encodingCode
```
    The encoding code.
  - length
```
public int length
```
    The length of the format. If this is not set it will default to the length of the string, which may or may not be useful for a Unicode string.
  - theData
```
public java.lang.String theData
```
    The data for this object. This is a Java String that supports the encoding.
- Constructor Detail
  - SecsFormat22
```
public SecsFormat22()
```
    Creates an empty string using the default encoding.
  - SecsFormat22
```
public SecsFormat22(byte[] newValue,
                    int encodingCode)
             throws SecsException
```
    Throws:
    
    SecsException
  - SecsFormat22
```
public SecsFormat22(char[] newValue,
                    int encodingCode)
             throws SecsException
```
    Throws:
    
    SecsException
  - SecsFormat22
```
public SecsFormat22(java.lang.String newValue,
                    int encodingCode)
             throws SecsException
```
    Create a new object with a value, encoding and code. The encoding should be an encoding supported by the newValue string and the string will be encoded with the encoding code provided.
    
    Throws:
    
    SecsException
  - SecsFormat22
```
public SecsFormat22(java.lang.String newValue,
                    java.lang.String encoding,
                    int encodingCode)
```
    Create a new object with a value, encoding and code. The encoding should be an encoding supported by the newValue string and the string will be encoded with the encoding code provided.
- Method Detail
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Overrides:
    
    equals in class java.lang.Object
  - getArray
```
public SecsFormat[] getArray()
```
    This allows for arrays of secsformats (not a list of secsformats). This will ALWAYS return an valid array... but if the SecsFormat has only one element, it will return an array of secsformats with one element (itself).
    
    Specified by:
    
    getArray in interface SecsFormat
  - getBoolValue
```
public boolean getBoolValue()
```
    Returns the true if the length of the data is non-zero.
    
    Specified by:
    
    getBoolValue in interface SecsFormat
    
    Returns:
    
    true if the string has characters, otherwise false.
  - getByteValue
```
public byte getByteValue()
```
    Returns the data converted to a byte. Will print an error and return zero if the value cannot be converted.
    
    Specified by:
    
    getByteValue in interface SecsFormat
    
    Returns:
    
    the data converted to a value
  - getDoubleValue
```
public double getDoubleValue()
```
    Returns the data converted to a double. Will print an error and return zero if the value cannot be converted.
    
    Specified by:
    
    getDoubleValue in interface SecsFormat
    
    Returns:
    
    the data converted to a value
  - getFloatValue
```
public float getFloatValue()
```
    Returns the data converted to a float. Will print an error and return zero if the value cannot be converted.
    
    Specified by:
    
    getFloatValue in interface SecsFormat
    
    Returns:
    
    the data converted to a value
  - getFormattedBytes
```
public byte[] getFormattedBytes()
                         throws SecsException
```
    Returns the list in a manner suitable for encoding directly into a SECS message byte stream used over SECSI or HSMS transport.
    
    Specified by:
    
    getFormattedBytes in interface SecsFormat
    
    Returns:
    
    a SECSII formatted byte array.
    
    Throws:
    
    SecsException
  - getIntValue
```
public int getIntValue()
```
    Returns the data converted to a int. Will print an error and return zero if the value cannot be converted.
    
    Specified by:
    
    getIntValue in interface SecsFormat
    
    Returns:
    
    the data converted to a value
  - getLength
```
public int getLength()
```
    Description copied from interface: SecsFormat
    
    Returns the length of the format.
    
    Specified by:
    
    getLength in interface SecsFormat
    
    Returns:
    
    the length
  - getLongValue
```
public long getLongValue()
```
    Returns the data converted to a long. Will print an error and return zero if the value cannot be converted.
    
    Specified by:
    
    getLongValue in interface SecsFormat
    
    Returns:
    
    the data converted to a value
  - getNumberOfLengthBytes
```
public int getNumberOfLengthBytes()
```
    Returns the number of length bytes. This will return -1 if the default number of length bytes are to be used, otherwise it will return 1, 2, or 3
    
    Specified by:
    
    getNumberOfLengthBytes in interface SecsFormat
  - getShortValue
```
public short getShortValue()
```
    Returns the data converted to a short. Will print an error and return zero if the value cannot be converted.
    
    Specified by:
    
    getShortValue in interface SecsFormat
    
    Returns:
    
    the data converted to a value
  - getStringValue
```
public java.lang.String getStringValue()
```
    Returns the data as a string.
    
    Specified by:
    
    getStringValue in interface SecsFormat
    
    Returns:
    
    the data itself
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - registerEncoding
```
public void registerEncoding(int encodingCode,
                             java.lang.String encoding)
```
    Register the encoding for the code. If the same code is registered more than once later registrations will overwrite earlier ones.
  - setArray
```
public void setArray(SecsFormat[] newValues)
              throws SecsException
```
    This allows for a standard way to set arrays of secsformats. This should also be valid if an array of one element be set. This will throw a secs exception if the secsformats are invalid or if (We will only accept a 1 element array with a SecsFormat10 in it.
    
    Specified by:
    
    setArray in interface SecsFormat
    
    Throws:
    
    SecsException
  - setDataFromByteArray
```
public void setDataFromByteArray(byte[] temp,
                                 int offset,
                                 int length)
                          throws SecsException
```
    Description copied from interface: SecsFormat
    
    stores the incoming value in the format object. The method of storage is type-specific. For example, the integer classes convert the incoming byte array to integers. Format20 the ASCII format uses a String, and so forth. This method will raise a SecsException if the value cannot be converted.
    
    Specified by:
    
    setDataFromByteArray in interface SecsFormat
    
    Throws:
    
    SecsException
  - setLength
```
public void setLength(int newValue)
```
    Description copied from interface: SecsFormat
    
    Sets the length of the format.
    
    Specified by:
    
    setLength in interface SecsFormat
    
    Parameters:
    
    newValue - the new length
  - setNumberOfLengthBytes
```
public void setNumberOfLengthBytes(int numberOfLengthBytes)
                            throws java.lang.IllegalArgumentException
```
    Sets the number of length bytes to send when the format is encoded. The SecsFormat will normally send the minimum number of length bytes required for the format. This allows that to be overridden so a different number of length bytes can be send. The only available number for the length bytes are -1, 1, 2 or 3. A value of -1 indicates that the default number of length bytes should be used. Any other value will throw an "IllegalArgumentException".
    
    Specified by:
    
    setNumberOfLengthBytes in interface SecsFormat
    
    Parameters:
    
    numberOfLengthBytes - the new number of length bytes. This should be 1, 2,3 or -1 to indicate the default
    
    Throws:
    
    java.lang.IllegalArgumentException - if the value is not 1, 2, 3 or -1
  - size
```
public int size()
```
    Returns the size of the data. This may be the length of the string and may be meaningless for a Unicode String.
  - toString
```
public java.lang.String toString()
```
    Returns the SML string representing this value
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
  - toString
```
public java.lang.String toString(int indentCount)
```
    Returns the indented SML string representing this value.
    
    Specified by:
    
    toString in interface SecsFormat
    
    Parameters:
    
    the - indentation
    
    Returns:
  - zeroLength
```
public boolean zeroLength()
```
    Description copied from interface: SecsFormat
    
    Returns true if the format is zero length.
    
    Specified by:
    
    zeroLength in interface SecsFormat

Class SecsFormat22

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

cvsRev

encoding

encodingCode

length

theData

Constructor Detail

SecsFormat22

SecsFormat22

SecsFormat22

SecsFormat22

SecsFormat22

Method Detail

equals

getArray

getBoolValue

getByteValue

getDoubleValue

getFloatValue

getFormattedBytes

getIntValue

getLength

getLongValue

getNumberOfLengthBytes

getShortValue

getStringValue

hashCode

registerEncoding

setArray

setDataFromByteArray

setLength

setNumberOfLengthBytes

size

toString

toString

zeroLength