Package org.bouncycastle.asn1.x509

Class X509Name

java.lang.Object
org.bouncycastle.asn1.ASN1Object
org.bouncycastle.asn1.x509.X509Name
All Implemented Interfaces:
ASN1Encodable
Direct Known Subclasses:
X509Principal
public class X509Name
extends ASN1Object
Deprecated.
use org.bouncycastle.asn1.x500.X500Name.
     RDNSequence ::= SEQUENCE OF RelativeDistinguishedName

     RelativeDistinguishedName ::= SET SIZE (1..MAX) OF AttributeTypeAndValue

     AttributeTypeAndValue ::= SEQUENCE {
                                   type  OBJECT IDENTIFIER,
                                   value ANY }

  • Field Details

  • Constructor Details

    • X509Name

      protected X509Name()
      Deprecated.

    • X509Name

      public X509Name​(ASN1Sequence seq)
      Deprecated.
      use X500Name.getInstance()
      Constructor from ASN1Sequence the principal will be a list of constructed sets, each containing an (OID, String) pair.

    • X509Name

      public X509Name​(Hashtable attributes)
      Deprecated.
      use an ordered constructor! The hashtable ordering is rarely correct
      constructor from a table of attributes.

      it's is assumed the table contains OID/String pairs, and the contents of the table are copied into an internal table as part of the construction process.

      Note: if the name you are trying to generate should be following a specific ordering, you should use the constructor with the ordering specified below.

    • X509Name

      public X509Name​(Vector ordering, Hashtable attributes)
      Deprecated.
      Constructor from a table of attributes with ordering.

      it's is assumed the table contains OID/String pairs, and the contents of the table are copied into an internal table as part of the construction process. The ordering vector should contain the OIDs in the order they are meant to be encoded or printed in toString.

    • X509Name

      public X509Name​(Vector ordering, Hashtable attributes, X509NameEntryConverter converter)
      Deprecated.
      use X500Name, X500NameBuilder
      Constructor from a table of attributes with ordering.

      it's is assumed the table contains OID/String pairs, and the contents of the table are copied into an internal table as part of the construction process. The ordering vector should contain the OIDs in the order they are meant to be encoded or printed in toString.

      The passed in converter will be used to convert the strings into their ASN.1 counterparts.

    • X509Name

      public X509Name​(Vector oids, Vector values)
      Deprecated.
      use X500Name, X500NameBuilder
      Takes two vectors one of the oids and the other of the values.

    • X509Name

      public X509Name​(Vector oids, Vector values, X509NameEntryConverter converter)
      Deprecated.
      use X500Name, X500NameBuilder
      Takes two vectors one of the oids and the other of the values.

      The passed in converter will be used to convert the strings into their ASN.1 counterparts.

    • X509Name

      public X509Name​(String dirName)
      Deprecated.
      use X500Name, X500NameBuilder
      Takes an X509 dir name as a string of the format "C=AU, ST=Victoria", or some such, converting it into an ordered set of name attributes.

    • X509Name

      public X509Name​(String dirName, X509NameEntryConverter converter)
      Deprecated.
      use X500Name, X500NameBuilder
      Takes an X509 dir name as a string of the format "C=AU, ST=Victoria", or some such, converting it into an ordered set of name attributes with each string value being converted to its associated ASN.1 type using the passed in converter.

    • X509Name

      public X509Name​(boolean reverse, String dirName)
      Deprecated.
      use X500Name, X500NameBuilder
      Takes an X509 dir name as a string of the format "C=AU, ST=Victoria", or some such, converting it into an ordered set of name attributes. If reverse is true, create the encoded version of the sequence starting from the last element in the string.

    • X509Name

      public X509Name​(boolean reverse, String dirName, X509NameEntryConverter converter)
      Deprecated.
      use X500Name, X500NameBuilder
      Takes an X509 dir name as a string of the format "C=AU, ST=Victoria", or some such, converting it into an ordered set of name attributes with each string value being converted to its associated ASN.1 type using the passed in converter. If reverse is true the ASN.1 sequence representing the DN will be built by starting at the end of the string, rather than the start.

    • X509Name

      public X509Name​(boolean reverse, Hashtable lookUp, String dirName)
      Deprecated.
      use X500Name, X500NameBuilder
      Takes an X509 dir name as a string of the format "C=AU, ST=Victoria", or some such, converting it into an ordered set of name attributes. lookUp should provide a table of lookups, indexed by lowercase only strings and yielding a ASN1ObjectIdentifier, other than that OID. and numeric oids will be processed automatically.
      If reverse is true, create the encoded version of the sequence starting from the last element in the string.
      Parameters:
      reverse - true if we should start scanning from the end (RFC 2553).
      lookUp - table of names and their oids.
      dirName - the X.500 string to be parsed.

    • X509Name

      public X509Name​(boolean reverse, Hashtable lookUp, String dirName, X509NameEntryConverter converter)
      Deprecated.
      Takes an X509 dir name as a string of the format "C=AU, ST=Victoria", or some such, converting it into an ordered set of name attributes. lookUp should provide a table of lookups, indexed by lowercase only strings and yielding a ASN1ObjectIdentifier, other than that OID. and numeric oids will be processed automatically. The passed in converter is used to convert the string values to the right of each equals sign to their ASN.1 counterparts.
      Parameters:
      reverse - true if we should start scanning from the end, false otherwise.
      lookUp - table of names and oids.
      dirName - the string dirName
      converter - the converter to convert string values into their ASN.1 equivalents

  • Method Details

    • getInstance

      public static X509Name getInstance​(ASN1TaggedObject obj, boolean explicit)
      Deprecated.
      Return a X509Name based on the passed in tagged object.
      Parameters:
      obj - tag object holding name.
      explicit - true if explicitly tagged false otherwise.
      Returns:
      the X509Name

    • getInstance

      public static X509Name getInstance​(Object obj)
      Deprecated.

    • getOIDs

      public Vector getOIDs()
      Deprecated.
      return a vector of the oids in the name, in the order they were found.

    • getValues

      public Vector getValues()
      Deprecated.
      return a vector of the values found in the name, in the order they were found.

    • getValues

      public Vector getValues​(ASN1ObjectIdentifier oid)
      Deprecated.
      return a vector of the values found in the name, in the order they were found, with the DN label corresponding to passed in oid.

    • toASN1Primitive

      public ASN1Primitive toASN1Primitive()
      Deprecated.
      Specified by:
      toASN1Primitive in interface ASN1Encodable
      Specified by:
      toASN1Primitive in class ASN1Object

    • equals

      public boolean equals​(Object obj, boolean inOrder)
      Deprecated.
      Parameters:
      inOrder - if true the order of both X509 names must be the same, as well as the values associated with each element.

    • hashCode

      public int hashCode()
      Deprecated.
      Description copied from class: Object
      Returns an integer hash code for this object. By contract, any two objects for which Object.equals(java.lang.Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

      Note that hash values must not change over time unless information used in equals comparisons also changes.

      See Writing a correct hashCode method if you intend implementing your own hashCode method.

      Overrides:
      hashCode in class ASN1Object
      Returns:
      this object's hash code.
      See Also:
      Object.equals(java.lang.Object)

    • equals

      public boolean equals​(Object obj)
      Deprecated.
      test for equality - note: case is ignored.
      Overrides:
      equals in class ASN1Object
      Parameters:
      obj - the object to compare this instance with.
      Returns:
      true if the specified object is equal to this Object; false otherwise.
      See Also:
      Object.hashCode()

    • toString

      public String toString​(boolean reverse, Hashtable oidSymbols)
      Deprecated.
      convert the structure to a string - if reverse is true the oids and values are listed out starting with the last element in the sequence (ala RFC 2253), otherwise the string will begin with the first element of the structure. If no string definition for the oid is found in oidSymbols the string value of the oid is added. Two standard symbol tables are provided DefaultSymbols, and RFC2253Symbols as part of this class.
      Parameters:
      reverse - if true start at the end of the sequence and work back.
      oidSymbols - look up table strings for oids.

    • toString

      public String toString()
      Deprecated.
      Description copied from class: Object
      Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression: 
         getClass().getName() + '@' + Integer.toHexString(hashCode())

      See Writing a useful toString method if you intend implementing your own toString method.

      Overrides:
      toString in class Object
      Returns:
      a printable representation of this object.