SHOW Signed

net.rim.device.api.crypto.certificate
Interface DistinguishedName

All Superinterfaces:
Persistable, net.rim.vm.Persistable
All Known Implementing Classes:
WTLSDistinguishedName, X509DistinguishedName

public interface DistinguishedName
extends Persistable

Represents a Distinguished Name used in a certificate.

Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Since:
JDE 3.6.0
See Also:
Certificate

Method Summary
 Category: Signed  String getCommonName()
          Retrieve the common name attribute associated with this distinguished name.
 Category: Signed  String getCountry()
          Retrieve the country attribute associated with this distinguished name.
 Category: Signed  String getEmailAddress()
          Retrieve the email attribute associated with this distinguished name.
 Category: Signed  byte[] getEncoding()
          Returns the encoding of the DistinguishedName.
 Category: Signed  String getLocality()
          Retrieve the locality attribute associated with this distinguished name.
 Category: Signed  Enumeration getOIDs()
          Returns an enumeration of all the OIDs in the name.
 Category: Signed  String getOrganization()
          Retrieve the organization attribute associated with this distinguished name.
 Category: Signed  String getOrganizationalUnit()
          Retrieve the organization unit attribute associated with this distinguished name.
 Category: Signed  String getStateOrProvince()
          Retrieve the state-or-province attribute associated with this distinguished name.
 Category: Signed  String getString(OID oid)
          Retrieve the String associated with this object identifier (OID).
 Category: Signed  String getSurname()
          Retrieve the surname attribute associated with this distinguished name.
 Category: Signed  String toString()
          Convert the DistinguishedName to a standard string format.
 

Method Detail

getString

public String getString(OID oid)
Retrieve the String associated with this object identifier (OID).

Parameters:
oid - The specified oid.
Returns:
A String representing the name. May be null.
Since:
JDE 4.0.2
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getCommonName

public String getCommonName()
Retrieve the common name attribute associated with this distinguished name.

Returns:
A String representing the common name. May be null.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getEmailAddress

public String getEmailAddress()
Retrieve the email attribute associated with this distinguished name.

Returns:
A String representing the email address. May be null.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getSurname

public String getSurname()
Retrieve the surname attribute associated with this distinguished name.

Returns:
A String representing the surname. May be null.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getCountry

public String getCountry()
Retrieve the country attribute associated with this distinguished name.

Returns:
A String representing the country name. May be null.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getLocality

public String getLocality()
Retrieve the locality attribute associated with this distinguished name.

Returns:
A String representing the locality. May be null.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getStateOrProvince

public String getStateOrProvince()
Retrieve the state-or-province attribute associated with this distinguished name.

Returns:
A String representing the state or province name. May be null.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getOrganization

public String getOrganization()
Retrieve the organization attribute associated with this distinguished name.

Returns:
A String representing the organization name. May be null.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getOrganizationalUnit

public String getOrganizationalUnit()
Retrieve the organization unit attribute associated with this distinguished name.

Returns:
A String representing the name of the organizational unit. May be null.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

toString

public String toString()
Convert the DistinguishedName to a standard string format.

Example output would be "CN=Joe Johnson, O=Company X, C=US".

Overrides:
toString in class Object
Returns:
A String.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getOIDs

public Enumeration getOIDs()
Returns an enumeration of all the OIDs in the name.

Returns:
An Enumeration of OIDs.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getEncoding

public byte[] getEncoding()
Returns the encoding of the DistinguishedName.

Returns:
A byte array containing the encoding. May be null.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.


Copyright 1999-2004 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.