public class RedirectingPartyNumber extends AbstractLazyEncodedByteArray implements FastSerializable
The API offered by this class is as if the type were specified in ASN.1 as follows.
RedirectingPartyNumber ::= SEQUENCE { nature Nature, numberingPlan NumberingPlan, presentation Presentation, address DigitString }The class takes care of encoding the field values into a byte-array and decoding field values from a byte-array, the encoded representation being as tabulated below.
Data Encoding - based on ITU-T Q.763 (12/1999) §3.44 p49 | ||||||||
---|---|---|---|---|---|---|---|---|
8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | |
Octet 1 | Odd? | Nature of address | ||||||
Octet 2 | Spare | Numbering plan | Address presentation restricted | Spare | ||||
Octet 2+1 | Address digit 2 | Address digit 1 | ||||||
... | ... | ... | ||||||
Octet 2+n | Filler (0000) or Address digit 2n | Address digit 2n-1 |
Each digit of the address field is encoded into a semi-octet,
and if there is an odd number of digits then the last semi-octet is assigned a filler.
Unless overridden by a particular StringCodec
,
the filler is 0 and the encoding to semi-octets is as tabulated below.
Since 0 is also the encoding of a valid digit, a separate indicator is required
to encode whether there is an odd number of digits or not.
Decoded character | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | * | # | ||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Encoded hexadecimal | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | A | B | C | D | E | F |
Modifier and Type | Class and Description |
---|---|
static class |
RedirectingPartyNumber.Nature
Nature-of-address indicator constants.
|
static class |
RedirectingPartyNumber.NumberingPlan
Enumeration of Numbering Plan indicator constants.
|
static class |
RedirectingPartyNumber.Presentation
Enumeration of Address Presentation Restricted indicator constants.
|
Modifier and Type | Field and Description |
---|---|
static BCDStringCodec<RedirectingPartyNumber> |
ADDRESS_CODEC
BCD string codec for field Address.
|
protected EncodedStringWithIndicators |
Address_value
Encoded form of field Address.
|
protected RedirectingPartyNumber.Nature |
Nature_value
Value of field Nature.
|
protected RedirectingPartyNumber.NumberingPlan |
NumberingPlan_value
Value of field NumberingPlan.
|
protected RedirectingPartyNumber.Presentation |
Presentation_value
Value of field Presentation.
|
isDecoded
encoded
FIELD_ABSENT, FIELD_UNINITIALISED
Constructor and Description |
---|
RedirectingPartyNumber()
Constructs a new RedirectingPartyNumber object with no fields set.
|
RedirectingPartyNumber(byte[] data)
Constructs a new RedirectingPartyNumber object from network-encoded data.
|
RedirectingPartyNumber(byte[] data,
int start,
int len)
Constructs a new RedirectingPartyNumber object from part of network-encoded data.
|
RedirectingPartyNumber(DataInput in)
Constructs a new RedirectingPartyNumber object from data deserialized from a stream that was written by
toStream(DataOutput) . |
RedirectingPartyNumber(RedirectingPartyNumber.Nature nature,
RedirectingPartyNumber.NumberingPlan numberingPlan,
RedirectingPartyNumber.Presentation presentation,
String address)
Constructs a new RedirectingPartyNumber object from given values for all fields.
|
RedirectingPartyNumber(RedirectingPartyNumber.Nature nature,
RedirectingPartyNumber.NumberingPlan numberingPlan,
RedirectingPartyNumber.Presentation presentation,
String address,
StringCodec<RedirectingPartyNumber> Address_codec)
Constructs a new RedirectingPartyNumber object from given arguments,
using the given codecs for encoding fields of type String.
|
Modifier and Type | Method and Description |
---|---|
void |
checkFieldsSet()
Checks that all mandatory fields are present.
|
RedirectingPartyNumber |
clone()
Constructs a copy of this object and everything reachable from it.
|
static RedirectingPartyNumber |
copyOf(RedirectingPartyNumber from)
Creates a new object of this type, cloning the values of common fields from the given object of any subclass of the same base type.
|
protected void |
decode()
Computes the decoded form from the encoded form.
|
protected void |
encode()
Computes the encoded form from the decoded form.
|
protected boolean |
encodedIsInvalid()
Determines whether the encoded form is invalid.
|
String |
getAddress()
Gets the value of the number digits.
|
String |
getAddress(StringCodec<RedirectingPartyNumber> codec)
Gets the value of the number digits using the given codec.
|
StringCodec<RedirectingPartyNumber> |
getAddressCodec()
Gets the codec used for field Address.
|
EncodedStringWithIndicators |
getAddressEncoded()
Gets a clone of the encoded value of the number digits.
|
static int |
getContainedLength(byte[] data,
int start,
int len)
Determines the length of the encoded value that commences at offset
start in the given data . |
byte[] |
getEncodedForm()
Gets the encoded form.
|
static FieldAccessor[] |
getFieldAccessors()
Gets a new array of the accessors for fields of this type.
|
Map<String,Object> |
getFieldsMap(boolean withAbsents)
Gets a Map from field-name to field-value for the fields of a sequence.
|
RedirectingPartyNumber.Nature |
getNature()
Gets the value of the nature of address indicator.
|
RedirectingPartyNumber.NumberingPlan |
getNumberingPlan()
Gets the value of the numbering plan indicator.
|
RedirectingPartyNumber.Presentation |
getPresentation()
Gets the value of the address presentation restricted indicator.
|
boolean |
hasAddress()
Tests whether the field Address has a value.
|
boolean |
hasNature()
Tests whether the field Nature has a value.
|
boolean |
hasNumberingPlan()
Tests whether the field NumberingPlan has a value.
|
boolean |
hasPresentation()
Tests whether the field Presentation has a value.
|
RedirectingPartyNumber |
setAddress(String value)
Sets the value of the number digits.
|
RedirectingPartyNumber |
setAddress(String value,
StringCodec<RedirectingPartyNumber> codec)
Sets the value of the number digits using the given codec.
|
RedirectingPartyNumber |
setAddressEncoded(EncodedStringWithIndicators encoded)
Sets the encoded value of the number digits to a clone of the given EncodedStringIndicators.
|
RedirectingPartyNumber |
setNature(RedirectingPartyNumber.Nature value)
Sets the value of the nature of address indicator.
|
RedirectingPartyNumber |
setNumberingPlan(RedirectingPartyNumber.NumberingPlan value)
Sets the value of the numbering plan indicator.
|
RedirectingPartyNumber |
setPresentation(RedirectingPartyNumber.Presentation value)
Sets the value of the address presentation restricted indicator.
|
void |
toStream(DataOutput out)
Serializes this object to a stream in a form suitable for reading by
RedirectingPartyNumber(DataInput) . |
checkDecode, checkModifyAndDecode
equals, hashCode, toString
checkModify, isReadOnly, setReadOnly
public static final BCDStringCodec<RedirectingPartyNumber> ADDRESS_CODEC
protected RedirectingPartyNumber.Nature Nature_value
protected RedirectingPartyNumber.NumberingPlan NumberingPlan_value
protected RedirectingPartyNumber.Presentation Presentation_value
protected EncodedStringWithIndicators Address_value
public RedirectingPartyNumber()
public RedirectingPartyNumber(byte[] data)
data
- network-encoded dataNullPointerException
- if data is nullpublic RedirectingPartyNumber(byte[] data, int start, int len)
start
and is len
bytes long.
The data is not decoded and might not be decodable.data
- network-encoded datastart
- starting offset of network-encoded data in byte arraylen
- default length if not predictableNullPointerException
- if data is nullIllegalArgumentException
- if len is negativepublic RedirectingPartyNumber(RedirectingPartyNumber.Nature nature, RedirectingPartyNumber.NumberingPlan numberingPlan, RedirectingPartyNumber.Presentation presentation, String address)
nature
- the nature of address indicatornumberingPlan
- the numbering plan indicatorpresentation
- the address presentation restricted indicatoraddress
- the number digitspublic RedirectingPartyNumber(RedirectingPartyNumber.Nature nature, RedirectingPartyNumber.NumberingPlan numberingPlan, RedirectingPartyNumber.Presentation presentation, String address, StringCodec<RedirectingPartyNumber> Address_codec)
nature
- the nature of address indicatornumberingPlan
- the numbering plan indicatorpresentation
- the address presentation restricted indicatoraddress
- the number digitsAddress_codec
- StringCodec for addresspublic RedirectingPartyNumber(DataInput in) throws IOException
toStream(DataOutput)
.in
- the stream to read fromEOFException
- if reading is pre-empted by end-of-fileIOException
- if the data cannot be readpublic void toStream(DataOutput out) throws IOException
RedirectingPartyNumber(DataInput)
.toStream
in interface FastSerializable
out
- the stream to write toIOException
- if an I/O error occurspublic boolean hasNature() throws DecodeException
DecodeException
- if encoded state cannot be decodedpublic boolean hasNumberingPlan() throws DecodeException
DecodeException
- if encoded state cannot be decodedpublic boolean hasPresentation() throws DecodeException
DecodeException
- if encoded state cannot be decodedpublic boolean hasAddress() throws DecodeException
DecodeException
- if encoded state cannot be decodedpublic void checkFieldsSet() throws EncodeException
checkFieldsSet
in class AbstractLazyEncodedDataObject<byte[]>
EncodeException
- if any mandatory field is not presentpublic RedirectingPartyNumber.Nature getNature() throws DecodeException
DecodeException
- if encoded state cannot be decodedpublic RedirectingPartyNumber.NumberingPlan getNumberingPlan() throws DecodeException
DecodeException
- if encoded state cannot be decodedpublic RedirectingPartyNumber.Presentation getPresentation() throws DecodeException
DecodeException
- if encoded state cannot be decodedpublic String getAddress() throws DecodeException
getAddress(null)
.DecodeException
- if encoded state cannot be decodedpublic RedirectingPartyNumber setNature(RedirectingPartyNumber.Nature value) throws IllegalStateException
value
- Nature representation of the nature of address indicatorIllegalStateException
public RedirectingPartyNumber setNumberingPlan(RedirectingPartyNumber.NumberingPlan value) throws IllegalStateException
value
- NumberingPlan representation of the numbering plan indicatorIllegalStateException
public RedirectingPartyNumber setPresentation(RedirectingPartyNumber.Presentation value) throws IllegalStateException
value
- Presentation representation of the address presentation restricted indicatorIllegalStateException
public RedirectingPartyNumber setAddress(String value) throws IllegalStateException
value
- String representation of the number digitsIllegalStateException
public String getAddress(StringCodec<RedirectingPartyNumber> codec) throws DecodeException
codec
- StringCodec to use for decodingDecodeException
- if encoded state cannot be decodedpublic EncodedStringWithIndicators getAddressEncoded()
public RedirectingPartyNumber setAddress(String value, StringCodec<RedirectingPartyNumber> codec) throws IllegalArgumentException
value
- String representation of the number digitscodec
- StringCodec to use for encodingIllegalArgumentException
public RedirectingPartyNumber setAddressEncoded(EncodedStringWithIndicators encoded)
encoded
- EncodedStringWithIndicators representation of the number digitspublic static RedirectingPartyNumber copyOf(RedirectingPartyNumber from)
from
- the object from which to copypublic RedirectingPartyNumber clone()
clone
in interface DataObject
clone
in class AbstractDataObject
public static FieldAccessor[] getFieldAccessors()
public Map<String,Object> getFieldsMap(boolean withAbsents)
getFieldsMap
in class AbstractFieldsObject
withAbsents
- whether to put absent optional fields into Mapprotected boolean encodedIsInvalid()
public byte[] getEncodedForm() throws EncodeException
EncodeException
- if encoding failspublic static int getContainedLength(byte[] data, int start, int len)
start
in the given data
.
The value is not fully decoded and might not be decodable.
Values of this type are of variable length, so the given length
is returned if the data is long enough, otherwise 0 is returned.data
- network-encoded datastart
- index into data where value commenceslen
- length in data to be consideredpublic StringCodec<RedirectingPartyNumber> getAddressCodec()
protected void encode() throws EncodeException
encode
in class AbstractLazyEncodedDataObject<byte[]>
EncodeException
- if Nature is not in range [0,127], or Presentation is ADDRESS_NOT_AVAILABLE and any of Address is not empty or Nature is not 0 or NumberingPlan is not 0protected void decode()
decode
in class AbstractLazyEncodedDataObject<byte[]>
DecodeException
- if less than 2 octets to be decoded