Summary: Ctors | Methods | Inherited Methods | [Expand All]
public class

# X501DistinguishedName

extends Object
implements AutoCloseable

java.lang.Object
↳ | com.pdftron.crypto.X501DistinguishedName

## Class Overview

This class represents a distinguished name (DN) as defined in X.501. See the X.500 standards, RFC 5280, and an OID repository for more information.

## Summary

Public Constructors
| X501DistinguishedName(long impl_ptr)

Public Methods
long | __GetHandle()
void | close() Frees the native memory of the object.
void | destroy() Frees the native memory of the object.
X501AttributeTypeAndValue[] | getAllAttributesAndValues() Retrieves all of the attribute-type-to-value pairs in this distinguished name.
String[] | getStringValuesForAttribute(ObjectIdentifier in_oid) Returns a container full of string representations of all the values in this distinguished name that match a particular attribute's object identifier (OID).
boolean | hasAttribute(ObjectIdentifier in_oid) Returns whether this distinguished name contains a particular attribute, identified by its object identifier (OID).

[Expand] Inherited Methods
From class java.lang.Object
boolean | equals(Object arg0)
final Class<?> | getClass()
int | hashCode()
final void | notify()
final void | notifyAll()
String | toString()
final void | wait(long arg0, int arg1)
final void | wait(long arg0)
final void | wait()
From interface java.lang.AutoCloseable
abstract void | close()

## Public Constructors

#### public X501DistinguishedName (long impl_ptr)

## Public Methods

#### public long __GetHandle ()

#### public void close ()

Frees the native memory of the object. This can be explicity called to control the deallocation of native memory and avoid situations where the garbage collector does not free the object in a timely manner.

##### Throws

PDFNetException |

#### public void destroy ()

Frees the native memory of the object. This can be explicity called to control the deallocation of native memory and avoid situations where the garbage collector does not free the object in a timely manner.

##### Throws

PDFNetException |

#### public X501AttributeTypeAndValue[] getAllAttributesAndValues ()

Retrieves all of the attribute-type-to-value pairs in this distinguished name.

##### Returns

- a container of X501AttributeTypeAndValue objects

##### Throws

PDFNetException |

#### public String[] getStringValuesForAttribute (ObjectIdentifier in_oid)

Returns a container full of string representations of all the values in this distinguished name that match a particular attribute's object identifier (OID). If an attribute's OID defines the corresponding value to not be of a string type, then that value will not be returned from this function.

##### Parameters

in_oid | the object identifier representing the sought attribute.

##### Returns

- a container of string values containing any strings associated with the supplied attribute

##### Throws

PDFNetException |

#### public boolean hasAttribute (ObjectIdentifier in_oid)

Returns whether this distinguished name contains a particular attribute, identified by its object identifier (OID).

##### Parameters

in_oid | the object identifier representing the sought attribute.

##### Returns

- a boolean value representing whether this distinguished name contains the supplied attribute

##### Throws

PDFNetException |