com.sun.identity.saml.assertion
Class NameIdentifier

java.lang.Object
  |
  +--com.sun.identity.saml.assertion.NameIdentifier

public class NameIdentifier

extends java.lang.Object

The NameIdentifier element specifies a Subject by a combination of a name and a security domain governing the name of the Subject.

Constructor Summary

NameIdentifier(org.w3c.dom.Element nameIdentifierElement)
Constructs a NameIdentifer element from an existing XML block.

NameIdentifier(java.lang.String name)
constructor

NameIdentifier(java.lang.String name, java.lang.String nameQualifier)
Constructs a NameQualifier instance.

NameIdentifier(java.lang.String name, java.lang.String nameQualifier, java.lang.String format)
Constructs a NameQualifier instance.

Method Summary

boolean	equals(NameIdentifier nid) Checks for equality between this object and the NameQualifier passed down as parameter.
java.lang.String	getFormat() Returns format.
java.lang.String	getName() Returns the name from NameQualifier.
java.lang.String	getNameQualifier() Returns the name.
boolean	setFormat(java.lang.String format) Set the format attribute.
boolean	setNameQualifier(java.lang.String nameQualifier) Set nameQualifier attribute.
java.lang.String	toString() Returns a String representation of the element.
java.lang.String	toString(boolean includeNS, boolean declareNS) Returns String representation of the <NameIdentifier> element.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

NameIdentifier

public NameIdentifier(org.w3c.dom.Element nameIdentifierElement)
               throws SAMLException

Constructs a NameIdentifer element from an existing XML block.

Parameters:

nameIdentifierElement - A org.w3c.dom.Element representing DOM tree for NameIdentifier object

Throws:

SAMLException - if it could not process the org.w3c.dom.Element properly, implying that there is an error in the sender or in the element definition.

NameIdentifier

public NameIdentifier(java.lang.String name)
               throws SAMLException

constructor

Parameters:

name - - The string representing the name of the Subject

Throws:

SAMLException - if the input has an error.

NameIdentifier

public NameIdentifier(java.lang.String name,
                      java.lang.String nameQualifier)
               throws SAMLException

Constructs a NameQualifier instance.

Parameters:

name - The string representing the name of the Subject

nameQualifier - The security or administrative domain that qualifies the name of the Subject. This is optional, could be null or "".

Throws:

SAMLException - if the input has an error.

NameIdentifier

public NameIdentifier(java.lang.String name,
                      java.lang.String nameQualifier,
                      java.lang.String format)
               throws SAMLException

Constructs a NameQualifier instance.

Parameters:

name - The string representing the name of the Subject

nameQualifier - The security or administrative domain that qualifies the name of the Subject. This is optional could be null or "".

format - The syntax used to describe the name of the Subject. This optional, could be null or "".

Throws:

SAMLException - if the input has an error.

Method Detail

getFormat

public java.lang.String getFormat()

Returns format.

Returns:

format element. Returns null if there is no format specified.

setFormat

public boolean setFormat(java.lang.String format)

Set the format attribute.

Parameters:

format - A String representing the format.

Returns:

true if operation succeeds.

getNameQualifier

public java.lang.String getNameQualifier()

Returns the name.

Returns:

A String representing the nameQualifier. Returns null if there is no nameQualifier.

setNameQualifier

public boolean setNameQualifier(java.lang.String nameQualifier)

Set nameQualifier attribute.

Parameters:

nameQualifier - name qualifier.

Returns:

true if operation succeeds.

getName

public java.lang.String getName()

Returns the name from NameQualifier.

Returns:

name

toString

public java.lang.String toString()

Returns a String representation of the element.

Overrides:

toString in class java.lang.Object

Returns:

A string containing the valid XML for this element By default name space name is prepended to the element name example <saml:NameIdentifier>.

toString

public java.lang.String toString(boolean includeNS,
                                 boolean declareNS)

Returns String representation of the <NameIdentifier> element.

Parameters:

includeNS - Determines whether or not the namespace qualifier is prepended to the Element when converted.

declareNS - Determines whether or not the namespace is declared within the Element.

Returns:

A string containing the valid XML for this element

equals

public boolean equals(NameIdentifier nid)

Checks for equality between this object and the NameQualifier passed down as parameter. Checks if Name is equal and if it has NameQualifier and Format defined checks for equality in those too.

Parameters:

nid - NameIdentifier to be checked

Returns:

true if the two NameQualifier are equal or not