Added in API level 26

PKCS12Attribute

class PKCS12Attribute : KeyStore.Entry.Attribute

kotlin.Any
↳	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(encoded: ByteArray!) Constructs a PKCS12 attribute from its ASN.
PKCS12Attribute(name: String!, value: String!) Constructs a PKCS12 attribute from its name and value.

Public methods
Boolean	equals(other: Any?) Compares this PKCS12Attribute and a specified object for equality.
ByteArray!	getEncoded() Returns the attribute's ASN.
String!	getName() Returns the attribute's ASN.
String!	getValue() Returns the attribute's ASN.
Int	hashCode() Returns the hashcode for this PKCS12Attribute.
String	toString() Returns a string representation of this PKCS12Attribute.

Public constructors

PKCS12Attribute

Added in API level 26

PKCS12Attribute(encoded: ByteArray!)

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	ByteArray!: the attribute's ASN.1 DER encoding. It is cloned to prevent subsequent modificaion.

Exceptions
java.lang.NullPointerException	if encoded is null
java.lang.IllegalArgumentException	if encoded is incorrectly formatted

PKCS12Attribute

Added in API level 26

PKCS12Attribute(
    name: String!, 
    value: String!)

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

Exceptions
java.lang.NullPointerException	if name or value is null
java.lang.IllegalArgumentException	if name or value is incorrectly formatted

Public methods

equals

Added in API level 26

fun equals(other: Any?): Boolean

Compares this PKCS12Attribute and a specified object for equality.

Parameters
obj	the comparison object

Return
Boolean	true if obj is a PKCS12Attribute and their DER encodings are equal.

getEncoded

Added in API level 26

fun getEncoded(): ByteArray!

Returns the attribute's ASN.1 DER encoding.

Return
ByteArray!	a clone of the attribute's DER encoding

getName

Added in API level 26

fun getName(): String!

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

Return
String!	the attribute's identifier

getValue

Added in API level 26

fun getValue(): String!

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[]).

Return
String!	the attribute value's string encoding

hashCode

Added in API level 26

fun hashCode(): Int

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

Return
Int	the hash code

toString

Added in API level 26

fun toString(): String

Returns a string representation of this PKCS12Attribute.

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