You are currently viewing a snapshot of www.mozilla.org taken on April 21, 2008. Most of this content is highly out of date (some pages haven't been updated since the project began in 1998) and exists for historical purposes only. If there are any pages on this archive site that you think should be added back to www.mozilla.org, please file a bug.

Skip to main content

Mozilla

• About
• Developers
• Store
• Support
• Products

search mozilla:

• Roadmap
• Projects
• Coding
  • Module Owners
  • Hacking
  • Get the Source
  • Build It
• Testing
  • Releases
  • Nightly Builds
  • Report A Problem
• Tools
  • Bugzilla
  • Tinderbox
  • Bonsai
  • LXR
• FAQs

org.mozilla.jss.pkix.primitive
Class DirectoryString

java.lang.Object
  org.mozilla.jss.pkix.primitive.DirectoryString

All Implemented Interfaces:

ASN1Value

public class DirectoryString
extends java.lang.Object
implements ASN1Value

An X.500 DirectoryString. DirectoryString is defined as follows:

 DirectoryString ::= CHOICE {
      teletexString               TeletexString (SIZE (1..MAX)),
      printableString             PrintableString (SIZE (1..MAX)),
      universalString             UniversalString (SIZE (1..MAX)),
      utf8String                  UTF8String (SIZE (1..MAX)),
      bmpString                   BMPString (SIZE (1..MAX))  }
 

Nested Class Summary

static class

DirectoryString.Template A Template for decoding DirectoryStrings from their BER encoding.

Constructor Summary

DirectoryString(CharacterString s)
Creates a DirectoryString from an ASN.1 string.

DirectoryString(java.lang.String s)
Encodes a Java String into a Directory String.

Method Summary

void	encode(java.io.OutputStream ostream) Write this value's DER encoding to an output stream using its own base tag.
void	encode(Tag implicitTag, java.io.OutputStream ostream) Write this value's DER encoding to an output stream using an implicit tag.
Tag	getTag() Returns the base tag for this type, not counting any tags that may be imposed on it by its context.
static DirectoryString.Template	getTemplate() Returns a singleton instance of the decoding template for this class.
java.lang.String	toString() Converts an ASN.1 DirectoryString to a Java string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DirectoryString

public DirectoryString(java.lang.String s)
                throws java.io.CharConversionException

Encodes a Java String into a Directory String. The following rules for choosing an encoding are from the IETF PKIX document Internet X.509 Public Key Infrastructure: Certificate and CRL Profile:

• The preferred encoding is UTF8String, and all certificates issued after December 31, 2003, MUST use UTF8String encoding, with a few exceptions.
• Until December 31, 2003, strings that fit in the PrintableString character set MAY use PrintableString.
• Until December 31, 2003, string that fit in the BMPString character set MAY use BMPString.
• Strings that fit in neither the PrintableString nor the BMPString character set MUST use UTF8String.

This is all very nice, but for backwards compatibility, what we really do is:

• Try PrintableString
• Try TeletexString
• Try UniversalString

Throws:

java.io.CharConversionException

DirectoryString

public DirectoryString(CharacterString s)

Creates a DirectoryString from an ASN.1 string.

Parameters:

s - Must be a TeletexString, PrintableString, UniversalString, UTF8String, or BMPString.

Method Detail

toString

public java.lang.String toString()

Converts an ASN.1 DirectoryString to a Java string.

Overrides:

toString in class java.lang.Object

Parameters:

dirstr - An ANY containing a BER-encoded DirectoryString.

Throws:

InvalidBERException - If the encoding does not contain a valid DirectoryString.

getTag

public Tag getTag()

Description copied from interface: ASN1Value

Returns the base tag for this type, not counting any tags that may be imposed on it by its context.

Specified by:

getTag in interface ASN1Value

encode

public void encode(java.io.OutputStream ostream)
            throws java.io.IOException

Description copied from interface: ASN1Value

Write this value's DER encoding to an output stream using its own base tag.

Specified by:

encode in interface ASN1Value

Throws:

java.io.IOException

encode

public void encode(Tag implicitTag,
                   java.io.OutputStream ostream)
            throws java.io.IOException

Description copied from interface: ASN1Value

Write this value's DER encoding to an output stream using an implicit tag.

Specified by:

encode in interface ASN1Value

Throws:

java.io.IOException

getTemplate

public static DirectoryString.Template getTemplate()

Returns a singleton instance of the decoding template for this class.