net.rim.device.api.io
Class MobitexAddress

java.lang.Object
  net.rim.device.api.io.DatagramAddressBase
      net.rim.device.api.io.MobitexAddress

Deprecated. Mobitex is no longer supported.

public final class MobitexAddress
extends DatagramAddressBase

Encapsulates mobitex addressing information. The syntax for opening a mobitex connection is as follows:

mobitex:<type>:<MAN>

where <type> is one of:

• "TEXT"
• "DATA"
• "STATUS"
• "HPDATA{HPID}" (in which case HPID is in ascii-decimal format)

and MAN is in ascii-decimal format.

To open a server connection (that is a listener) leave the MAN field blank.

Connector.open() will return a DatagramConnectionBase in this case

See Also:

Connector, MobitexPacketHeader

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

Field Summary
	static int	TYPE_DATA Deprecated. Data packet.
	static int	TYPE_HPDATA Deprecated. HP data type.
	static int	TYPE_STATUS Deprecated. Status packet.
	static int	TYPE_TEXT Deprecated. Text type.

Fields inherited from class net.rim.device.api.io.DatagramAddressBase

NONE, _address, _key

Constructor Summary
	MobitexAddress() Deprecated. Creates a new, empty MobitexAddress instance.
	MobitexAddress(int man, int type, int hpid) Deprecated. Creates a new MobitexAddress with provided MAN, type, and HPID.
	MobitexAddress(int man, int type, int hpid, MobitexPacketHeader header) Deprecated.
	MobitexAddress(String address) Deprecated. Creates a new MobitexAddress instance with provided address string.
	MobitexAddress(DatagramAddressBase addressBase) Deprecated. Creates a new MobitexAddress instance from provided address base.

Method Summary
	static void	appendAddress(StringBuffer buf, boolean open, int man, int type, int hpid) Deprecated. Forms an address string and appends it to provided buffer.
	boolean	equals(Object addressBase) Deprecated. Compares this address object with provided address base.
	String	getAddress() Deprecated. Retrieves this object's address.
	int	getHpid() Deprecated. Retrieves this address object's high protocol ID.
	int	getMan() Deprecated. Retrieves this address object's MAN.
	MobitexPacketHeader	getPacketHeader() Deprecated. Retrieves packet header associated with this address object.
	int	getType() Deprecated. Retrieves this address object's packet type.
	int	hashCode() Deprecated. Retrieves hash of this address object.
	static String	makeAddress(boolean open, int man, int type, int hpid) Deprecated. Forms an address string from provided settings.
	void	setAddress(String address) Deprecated. Sets a new address for this address object.
	void	setPacketHeader(MobitexPacketHeader mph) Deprecated. Sets new packet header for this address object.

Methods inherited from class net.rim.device.api.io.DatagramAddressBase

appendHex, appendHex, getKey, getSubAddress, getSubAddressBase, indexOfNextDelim, parseInt, parseInt, parseLong, readInt, readShort, writeInt, writeShort

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

TYPE_TEXT

public static final int TYPE_TEXT

Deprecated.

Text type.

See Also:

Constant Field Values

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

TYPE_DATA

public static final int TYPE_DATA

Deprecated.

Data packet.

See Also:

Constant Field Values

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

TYPE_STATUS

public static final int TYPE_STATUS

Deprecated.

Status packet.

See Also:

Constant Field Values

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

TYPE_HPDATA

public static final int TYPE_HPDATA

Deprecated.

HP data type.

See Also:

Constant Field Values

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

Constructor Detail

MobitexAddress

public MobitexAddress()

Deprecated.

Creates a new, empty MobitexAddress instance.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

MobitexAddress

public MobitexAddress(int man,
                      int type,
                      int hpid)

Deprecated.

Creates a new MobitexAddress with provided MAN, type, and HPID.

Parameters:

man - MAN for this new address.

type - Packet type for this new address.

hpid - HPID value for this new address.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

MobitexAddress

public MobitexAddress(int man,
                      int type,
                      int hpid,
                      MobitexPacketHeader header)

Deprecated.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.2

MobitexAddress

public MobitexAddress(DatagramAddressBase addressBase)

Deprecated.

Creates a new MobitexAddress instance from provided address base.

Parameters:

addressBase - Address base to provide settings for this new address object.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

MobitexAddress

public MobitexAddress(String address)

Deprecated.

Creates a new MobitexAddress instance with provided address string.

Parameters:

address - Address to use for this address object.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

Method Detail

getPacketHeader

public MobitexPacketHeader getPacketHeader()

Deprecated.

Retrieves packet header associated with this address object.

Returns:

Packet header object for this address.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

setPacketHeader

public void setPacketHeader(MobitexPacketHeader mph)

Deprecated.

Sets new packet header for this address object.

If set, the provided packet header is used for all addressing operations; the values set on the addressbase are ignored.

Parameters:

mph - New packet header object for this address.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

getMan

public int getMan()

Deprecated.

Retrieves this address object's MAN.

Returns:

This address object's MAN.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

getType

public int getType()

Deprecated.

Retrieves this address object's packet type.

Returns:

Packet type for this address object.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

getHpid

public int getHpid()

Deprecated.

Retrieves this address object's high protocol ID.

Returns:

HPID for this address object.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

setAddress

public void setAddress(String address)

Deprecated.

Sets a new address for this address object.

Overrides:

setAddress in class DatagramAddressBase

Parameters:

address - New address for this object.

Throws:

IllegalArgumentException - If you provide a malformed or illegal address.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

getAddress

public String getAddress()

Deprecated.

Retrieves this object's address.

Overrides:

getAddress in class DatagramAddressBase

Returns:

Address for this address object.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

equals

public boolean equals(Object addressBase)

Deprecated.

Compares this address object with provided address base.

Overrides:

equals in class DatagramAddressBase

Parameters:

addressBase - Address base to compare with this address object.

Returns:

True if this address object is equal to provided address base (either the same object or address base with the same MAN, type, and HPID); otherwise, false.

See Also:

Boolean.hashCode(), Hashtable

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

hashCode

public int hashCode()

Deprecated.

Retrieves hash of this address object.

Overrides:

hashCode in class DatagramAddressBase

Returns:

Hash of this address object.

See Also:

Object.equals(java.lang.Object), Hashtable

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

makeAddress

public static String makeAddress(boolean open,
                                 int man,
                                 int type,
                                 int hpid)

Deprecated.

Forms an address string from provided settings.

Parameters:

open - True if formed address should be open format; false if not.

man - MAN for formed address.

type - Type for formed address.

hpid - HPID for formed address.

Returns:

Address string formed from provided settings.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

appendAddress

public static void appendAddress(StringBuffer buf,
                                 boolean open,
                                 int man,
                                 int type,
                                 int hpid)

Deprecated.

Forms an address string and appends it to provided buffer.

Parameters:

buf - String buffer to contain formed address.

open - True if formed address should be open format; false if not.

man - MAN for formed address.

type - Type for formed address.

hpid - HPID for formed address.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0