Java compact1, compact2, compact3 java.security Class PKCS12Attribute（JDK8）

Constructor Detail

• PKCS12Attribute

  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 - the attribute's identifier

  value - the attribute's value

  Throws:

  NullPointerException - if name or value is null

  IllegalArgumentException - if name or value is incorrectly formatted

• PKCS12Attribute

  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 - 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

Method Detail

• getName

  public String getName()

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

  Specified by:

  getName in interface KeyStore.Entry.Attribute

  Returns:

  the attribute's identifier

• getValue

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

  Specified by:

  getValue in interface KeyStore.Entry.Attribute

  Returns:

  the attribute value's string encoding

• getEncoded

  public byte[] getEncoded()

  Returns the attribute's ASN.1 DER encoding.

  Returns:

  a clone of the attribute's DER encoding

• equals

  public boolean equals(Object obj)

  Compares this PKCS12Attribute and a specified object for equality.

  Overrides:

  equals in class Object

  Parameters:

  obj - the comparison object

  Returns:

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

  See Also:

  Object.hashCode(), HashMap

• hashCode

  public int hashCode()

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

  Overrides:

  hashCode in class Object

  Returns:

  the hash code

  See Also:

  Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

• toString

  public String toString()

  Returns a string representation of this PKCS12Attribute.

  Overrides:

  toString in class Object

  Returns:

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