sun.security.x509

Class RFC822Name

java.lang.Object

sun.security.x509.RFC822Name

All Implemented Interfaces:

GeneralNameInterface

public class RFC822Name
extends java.lang.Object
implements GeneralNameInterface

This class implements the RFC822Name as required by the GeneralNames ASN.1 object.

Author:

Amit Kapoor, Hemma Prafullchandra

See Also:

GeneralName, GeneralNames, GeneralNameInterface

Field Summary

Fields inherited from interface sun.security.x509.GeneralNameInterface

NAME_ANY, NAME_DIFF_TYPE, NAME_DIRECTORY, NAME_DNS, NAME_EDI, NAME_IP, NAME_MATCH, NAME_NARROWS, NAME_OID, NAME_RFC822, NAME_SAME_TYPE, NAME_URI, NAME_WIDENS, NAME_X400

Constructor Summary

Constructors

Constructor and Description
RFC822Name(DerValue derValue) Create the RFC822Name object from the passed encoded Der value.
RFC822Name(java.lang.String name) Create the RFC822Name object with the specified name.

Method Summary

Methods

Modifier and Type	Method and Description
int	constrains(GeneralNameInterface inputName) Return constraint type: NAME_DIFF_TYPE = -1: input name is different type from name (i.e.
void	encode(DerOutputStream out) Encode the RFC822 name into the DerOutputStream.
boolean	equals(java.lang.Object obj) Compares this name with another, for equality.
java.lang.String	getName() Return the actual name value of the GeneralName.
int	getType() Return the type of the GeneralName.
int	hashCode() Returns the hash code value for this object.
void	parseName(java.lang.String name) Parse an RFC822Name string to see if it is a valid addr-spec according to IETF RFC822 and RFC2459: [local-part@]domain
int	subtreeDepth() Return subtree depth of this name for purposes of determining NameConstraints minimum and maximum bounds.
java.lang.String	toString() Convert the name into user readable string.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RFC822Name

public RFC822Name(DerValue derValue)
           throws java.io.IOException

Create the RFC822Name object from the passed encoded Der value.

Parameters:

derValue - the encoded DER RFC822Name.

Throws:

java.io.IOException - on error.

RFC822Name

public RFC822Name(java.lang.String name)
           throws java.io.IOException

Create the RFC822Name object with the specified name.

Parameters:

name - the RFC822Name.

Throws:

java.io.IOException - on invalid input name

Method Detail

parseName

public void parseName(java.lang.String name)
               throws java.io.IOException

Parse an RFC822Name string to see if it is a valid addr-spec according to IETF RFC822 and RFC2459: [local-part@]domain

local-part@ could be empty for an RFC822Name NameConstraint, but the domain at least must be non-empty. Case is not significant.

Parameters:

name - the RFC822Name string

Throws:

java.io.IOException - if name is not valid

getType

public int getType()

Return the type of the GeneralName.

Specified by:

getType in interface GeneralNameInterface

getName

public java.lang.String getName()

Return the actual name value of the GeneralName.

encode

public void encode(DerOutputStream out)
            throws java.io.IOException

Encode the RFC822 name into the DerOutputStream.

Specified by:

encode in interface GeneralNameInterface

Parameters:

out - the DER stream to encode the RFC822Name to.

Throws:

java.io.IOException - on encoding errors.

toString

public java.lang.String toString()

Convert the name into user readable string.

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Compares this name with another, for equality.

Overrides:

equals in class java.lang.Object

Returns:

true iff the names are equivalent according to RFC2459.

hashCode

public int hashCode()

Returns the hash code value for this object.

Overrides:

hashCode in class java.lang.Object

Returns:

a hash code value for this object.

constrains

public int constrains(GeneralNameInterface inputName)
               throws java.lang.UnsupportedOperationException

Return constraint type:

• NAME_DIFF_TYPE = -1: input name is different type from name (i.e. does not constrain)
• NAME_MATCH = 0: input name matches name
• NAME_NARROWS = 1: input name narrows name
• NAME_WIDENS = 2: input name widens name
• NAME_SAME_TYPE = 3: input name does not match or narrow name, but is same type

. These results are used in checking NameConstraints during certification path verification.

[RFC2459] When the subjectAltName extension contains an Internet mail address, the address MUST be included as an rfc822Name. The format of an rfc822Name is an "addr-spec" as defined in RFC 822 [RFC 822]. An addr-spec has the form "local-part@domain". Note that an addr-spec has no phrase (such as a common name) before it, has no comment (text surrounded in parentheses) after it, and is not surrounded by "<" and ">". Note that while upper and lower case letters are allowed in an RFC 822 addr-spec, no significance is attached to the case.

Specified by:

constrains in interface GeneralNameInterface

Parameters:

inputName - to be checked for being constrained

Throws:

java.lang.UnsupportedOperationException - if name is not exact match, but narrowing and widening are not supported for this name type.

subtreeDepth

public int subtreeDepth()
                 throws java.lang.UnsupportedOperationException

Return subtree depth of this name for purposes of determining NameConstraints minimum and maximum bounds.

Specified by:

subtreeDepth in interface GeneralNameInterface

Throws:

java.lang.UnsupportedOperationException - if not supported for this name type