JavaScript is disabled on your browser.
Skip navigation links
Java™ Platform
Standard Ed. 8
compact1, compact2, compact3
java.security

Class PKCS12Attribute

  • All Implemented Interfaces:
    KeyStore.Entry.Attribute


    public final class PKCS12Attribute
    extends Object
    implements KeyStore.Entry.Attribute 
    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.
    Since:
    1.8
    • Constructor Summary

      Constructors
      Constructor Description
      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.
    • Method Summary

      All Methods
      Modifier and Type Method Description
      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.
    • 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
      • 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
Skip navigation links
Java™ Platform
Standard Ed. 8

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.

Scripting on this page tracks web page traffic, but does not change the content in any way.

AltStyle によって変換されたページ (->オリジナル) /