Added in API level 26

Summary: Ctors | Methods | Inherited Methods

PKCS12Attribute

public final class PKCS12Attribute
extends Object implements KeyStore.Entry.Attribute

java.lang.Object
↳	java.security.PKCS12Attribute

An attribute associated with a PKCS12 keystore entry. The attribute name is an ASN.1 Object Identifier and the attribute value is a set of ASN.1 types.

Summary

Public constructors
`PKCS12Attribute(byte[] encoded)` Constructs a PKCS12 attribute from its ASN.1 DER encoding.
`PKCS12Attribute(String name, String value)` Constructs a PKCS12 attribute from its name and value.

Public methods
`boolean`	`equals(Object obj)` Compares this `PKCS12Attribute` and a specified object for equality.
`byte[]`	`getEncoded()` Returns the attribute's ASN.1 DER encoding.
`String`	`getName()` Returns the attribute's ASN.1 Object Identifier represented as a list of dot-separated integers.
`String`	`getValue()` Returns the attribute's ASN.1 DER-encoded value as a string.
`int`	`hashCode()` Returns the hashcode for this `PKCS12Attribute`.
`String`	`toString()` Returns a string representation of this `PKCS12Attribute`.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

From interface


        
          java.security.KeyStore.Entry.Attribute

`abstract String`	`getName()` Returns the attribute's name.
`abstract String`	`getValue()` Returns the attribute's value.

Public constructors

PKCS12Attribute

Added in API level 26

public PKCS12Attribute (byte[] encoded)

Constructs a PKCS12 attribute from its ASN.1 DER encoding. The DER encoding is specified by the following ASN.1 definition:


 Attribute ::= SEQUENCE {
     type   AttributeType,
     values SET OF AttributeValue
 }
 AttributeType ::= OBJECT IDENTIFIER
 AttributeValue ::= ANY defined by type

Parameters
`encoded`	`byte`: the attribute's ASN.1 DER encoding. It is cloned to prevent subsequent modificaion.

Throws
`NullPointerException`	if `encoded` is `null`
`IllegalArgumentException`	if `encoded` is incorrectly formatted

PKCS12Attribute

Added in API level 26

public PKCS12Attribute (String name, 
                String value)

Constructs a PKCS12 attribute from its name and value. The name is an ASN.1 Object Identifier represented as a list of dot-separated integers. A string value is represented as the string itself. A binary value is represented as a string of colon-separated pairs of hexadecimal digits. Multi-valued attributes are represented as a comma-separated list of values, enclosed in square brackets. See Arrays.toString(java.lang.Object[]).

A string value will be DER-encoded as an ASN.1 UTF8String and a binary value will be DER-encoded as an ASN.1 Octet String.

Parameters
`name`	`String`: the attribute's identifier
`value`	`String`: the attribute's value

Throws
`NullPointerException`	if `name` or `value` is `null`
`IllegalArgumentException`	if `name` or `value` is incorrectly formatted

Public methods

equals

Added in API level 26

public boolean equals (Object obj)

Compares this PKCS12Attribute and a specified object for equality.

Parameters
`obj`	`Object`: the comparison object

Returns
`boolean`	true if `obj` is a `PKCS12Attribute` and their DER encodings are equal.

getEncoded

Added in API level 26

public byte[] getEncoded ()

Returns the attribute's ASN.1 DER encoding.

Returns
`byte[]`	a clone of the attribute's DER encoding

getName

Added in API level 26

public String getName ()

Returns the attribute's ASN.1 Object Identifier represented as a list of dot-separated integers.

Returns
`String`	the attribute's identifier

getValue

Added in API level 26

public String getValue ()

Returns the attribute's ASN.1 DER-encoded value as a string. An ASN.1 DER-encoded value is returned in one of the following String formats:

the DER encoding of a basic ASN.1 type that has a natural string representation is returned as the string itself. Such types are currently limited to BOOLEAN, INTEGER, OBJECT IDENTIFIER, UTCTime, GeneralizedTime and the following six ASN.1 string types: UTF8String, PrintableString, T61String, IA5String, BMPString and GeneralString.
the DER encoding of any other ASN.1 type is not decoded but returned as a binary string of colon-separated pairs of hexadecimal digits.

Multi-valued attributes are represented as a comma-separated list of values, enclosed in square brackets. See Arrays.toString(java.lang.Object[]).

Returns
`String`	the attribute value's string encoding

hashCode

Added in API level 26

public int hashCode ()

Returns the hashcode for this PKCS12Attribute. The hash code is computed from its DER encoding.

Returns
`int`	the hash code

toString

Added in API level 26

public String toString ()

Returns a string representation of this PKCS12Attribute.

Returns
`String`	a name/value pair separated by an 'equals' symbol