|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.sblim.cimclient.internal.cim.CIMOctetString
public class CIMOctetString
This class represents a CIM octet string, or length-prefixed string, where
the length is four octets (32 bits) AND includes the four octets it occupies.
In other words, the length of the octet string is the number of characters in
the string plus four. There are three possible representations:
1) Byte array - This is an array of UnsignedInteger8 (unit8) objects. The
first four bytes contain the length, so the ASCII string "DEB" would be
represented as { 0x00, 0x00, 0x00, 0x07, 0x44, 0x45, 0x42 }
2) Hexadecimal string - This is a string of hexadecimal digits. The four
bytes after the initial "0x" contain the length, so the ASCII string "DEB"
would be represented as "0x00000007444542".
3) ASCII string
One of these representations is passed into a constructor. The other
representations are created on demand when a get() method is invoked or when
the equals() method is invoked and the two octet strings have no
representations in common.
Constructor Summary | |
---|---|
CIMOctetString(java.lang.String pString,
boolean pIsHex)
Constructs a CIMOctetString from the given string. |
|
CIMOctetString(UnsignedInteger8[] pBytes)
Constructs a CIMOctetString from the given byte array. |
Method Summary | |
---|---|
boolean |
equals(java.lang.Object pObj)
Takes a CIM octet string and returns true if it is equal to
this CIM octet string. |
java.lang.String |
getASCIIString(char pReplacementChar)
Returns ASCII string representation of octet string with non-printable characters replaced by pReplacementChar . |
UnsignedInteger8[] |
getBytes()
Returns byte array representation of octet string. |
java.lang.String |
getHexString()
Returns hexadecimal string representation of octet string. |
int |
hashCode()
Returns hash code value for octet string. |
int |
length()
Returns length of octet string, where length is number of octets plus four. |
java.lang.String |
toString()
Returns string representation of octet string. |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public CIMOctetString(UnsignedInteger8[] pBytes) throws java.lang.IllegalArgumentException
CIMOctetString
from the given byte array.
pBytes
- Byte array representation of octet string.
java.lang.IllegalArgumentException
public CIMOctetString(java.lang.String pString, boolean pIsHex) throws java.lang.IllegalArgumentException
CIMOctetString
from the given string.
pString
- String representation of octet string.pIsHex
- true
if string is hexadecimal string,
false
if string is ASCII string.
java.lang.IllegalArgumentException
Method Detail |
---|
public boolean equals(java.lang.Object pObj)
true
if it is equal to
this CIM octet string. Otherwise, it returns false
. Two
octet strings are considered equal if all of their common representations
are equal. If the octet strings have no representations in common, this
method will build the missing one, starting with byte array and then
hexadecmial string.
NOTE: The ASCII string representation is only considered if both octet
strings were constructed with an ASCII string.
equals
in class java.lang.Object
pObj
- The object to be compared a CIM element.
true
if the specified CIM octet string equals this
CIM octet string, false
otherwise.public java.lang.String getASCIIString(char pReplacementChar)
pReplacementChar
. If the ASCII string
has not yet been created, it is created from the byte array or
hexadecimal string.
pReplacementChar
- Replacement character for non-printable characters which must
be between 0x20 and 0x7E, inclusive.
public UnsignedInteger8[] getBytes()
public java.lang.String getHexString()
public int hashCode()
hashCode
in class java.lang.Object
public int length()
public java.lang.String toString()
toString
in class java.lang.Object
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |