org.apache.directory.shared.kerberos.components

Class PrincipalName

java.lang.Object

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

All Implemented Interfaces:

org.apache.directory.api.asn1.Asn1Object

public class PrincipalName
extends Object
implements org.apache.directory.api.asn1.Asn1Object

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

Constructors

Constructor and Description
PrincipalName() Creates a new empty instance of PrincipalName.
PrincipalName(KerberosPrincipal principal) Creates a new instance of PrincipalName, given a KerberosPrincipal.
PrincipalName(String[] nameParts, int nameType) Creates a new instance of PrincipalName given a String[] and an principal type.
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 principal type.

Method Summary

Methods

Modifier and Type	Method and Description
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.
String	getRealm() Get the realm for the principal
int	hashCode()
void	setNameType(int nameType) Set the Principal name Type
void	setNameType(PrincipalNameType nameType) Set the Principal name Type
void	setRealm(String realm) Set the realm for the principal
String	toString()

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 principal type.

Parameters:

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

nameType - The principal name

Throws:

ParseException

PrincipalName

public PrincipalName(String[] nameParts,
             int nameType)

Creates a new instance of PrincipalName given a String[] and an principal type.

Parameters:

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

nameType - The principal name type

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

setRealm

public void setRealm(String realm)

Set the realm for the principal

Parameters:

realm - the realm of the principal

getRealm

public String getRealm()

Get the realm for the principal

Returns:

realm the realm of the principal

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)
 

Specified by:

computeLength in interface org.apache.directory.api.asn1.Asn1Object

encode

public ByteBuffer encode(ByteBuffer buffer)
                  throws org.apache.directory.api.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.api.asn1.Asn1Object

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.api.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