org.apache.directory.shared.kerberos.components
Class PrincipalName

java.lang.Object
  org.apache.directory.shared.asn1.AbstractAsn1Object
      org.apache.directory.shared.kerberos.components.PrincipalName

All Implemented Interfaces:

org.apache.directory.shared.asn1.Asn1Object

public class PrincipalName
extends org.apache.directory.shared.asn1.AbstractAsn1Object

A principal Name, composed of a type and N names.

 PrincipalName   ::= SEQUENCE {
        name-type       [0] Int32,
        name-string     [1] SEQUENCE OF KerberosString
 }
 

Author:

Apache Directory Project

Constructor Summary

PrincipalName()
Creates a new empty instance of PrincipalName.

PrincipalName(KerberosPrincipal principal)
Creates a new instance of PrincipalName, given a KerberosPrincipal.

PrincipalName(String nameString, int nameType)
Creates a new instance of PrincipalName.

PrincipalName(String nameString, PrincipalNameType nameType)
Creates a new instance of PrincipalName given a String and an prinipal type.

Method Summary

void	addName(String name) Add a new name to the PrincipalName
int	computeLength() Compute the PrincipalName length
ByteBuffer	encode(ByteBuffer buffer) Encode the PrincipalName message to a PDU.
boolean	equals(Object obj)
List<String>	getNames() Returns the name components.
String	getNameString()
PrincipalNameType	getNameType() Returns the type of the PrincipalName.
int	hashCode()
void	setNameType(int nameType) Set the Principal name Type
void	setNameType(PrincipalNameType nameType) Set the Principal name Type
String	toString()

Methods inherited from class org.apache.directory.shared.asn1.AbstractAsn1Object

addLength, getCurrentLength, getExpectedLength, getParent, getTlvId, setCurrentLength, setExpectedLength, setParent

Methods inherited from class java.lang.Object

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

Constructor Detail

PrincipalName

public PrincipalName()

Creates a new empty instance of PrincipalName.

PrincipalName

public PrincipalName(KerberosPrincipal principal)

Creates a new instance of PrincipalName, given a KerberosPrincipal. We assume that a principal has only one type, even if there are more than one name component.

Parameters:

principal - A Sun kerberosPrincipal instance

PrincipalName

public PrincipalName(String nameString,
                     PrincipalNameType nameType)
              throws ParseException

Creates a new instance of PrincipalName given a String and an prinipal type.

Parameters:

nameString - The name string, which can contains more than one nameComponent

nameType - The principal name

Throws:

ParseException

PrincipalName

public PrincipalName(String nameString,
                     int nameType)

Creates a new instance of PrincipalName.

Parameters:

nameString -

nameType -

Method Detail

getNameType

public PrincipalNameType getNameType()

Returns the type of the PrincipalName.

Returns:

The type of the PrincipalName.

setNameType

public void setNameType(PrincipalNameType nameType)

Set the Principal name Type

Parameters:

nameType - the Principal name Type

setNameType

public void setNameType(int nameType)

Set the Principal name Type

Parameters:

nameType - the Principal name Type

getNames

public List<String> getNames()

Returns the name components.

Returns:

The name components.

getNameString

public String getNameString()

Returns:

A String representing the principal names as a String

addName

public void addName(String name)

Add a new name to the PrincipalName

Parameters:

name - The name to add

computeLength

public int computeLength()

Compute the PrincipalName length

 PrincipalName :
 
 0x30 L1 PrincipalName sequence
  |
  +--> 0xA1 L2 name-type tag
  |     |
  |     +--> 0x02 L2-1 addressType (int)
  |
  +--> 0xA2 L3 name-string tag
        |
        +--> 0x30 L3-1 name-string (SEQUENCE OF KerberosString)
              |
              +--> 0x1B L4[1] value (KerberosString)
              |
              +--> 0x1B L4[2] value (KerberosString)
              |
              ...
              |
              +--> 0x1B L4[n] value (KerberosString)
 

encode

public ByteBuffer encode(ByteBuffer buffer)
                  throws org.apache.directory.shared.asn1.EncoderException

Encode the PrincipalName message to a PDU.

 PrincipalName :
 
 0x30 LL
   0xA0 LL 
     0x02 0x01 name-type (integer)
   0xA1 LL 
     0x30 LL name-string (SEQUENCE OF KerberosString)
       0x1B LL name-string[1]
       0x1B LL name-string[2]
       ...
       0x1B LL name-string[n]
 

Specified by:

encode in interface org.apache.directory.shared.asn1.Asn1Object

Overrides:

encode in class org.apache.directory.shared.asn1.AbstractAsn1Object

Parameters:

buffer - The buffer where to put the PDU. It should have been allocated before, with the right size.

Returns:

The constructed PDU.

Throws:

org.apache.directory.shared.asn1.EncoderException

toString

public String toString()

Overrides:

toString in class Object

See Also:

Object.toString()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object