com.sun.identity.saml.assertion
Class SubjectLocality

java.lang.Object
  com.sun.identity.saml.assertion.SubjectLocality

public class SubjectLocality
extends Object

The SubjectLocality element specifies the DNS domain name and IP address for the system entity that performed the authentication. It exists as part of AuthenticationStatement element.

Constructor Summary

SubjectLocality()
Default Constructor

SubjectLocality(Element localityElement)
Constructs an instance of SubjectLocality from an existing XML block.

SubjectLocality(String ipAddress, String dnsAddress)
Constructs an instance of SubjectLocality.

Method Summary

String	getDNSAddress() Returns the DNS address from SubjectLocality locality
String	getIPAddress() Returns the IP address from SubjectLocality locality
boolean	setDNSAddress(String dnsAddress) Sets the DNS address for SubjectLocality> locality.
boolean	setIPAddress(String ipAddress) Sets the IP address for SubjectLocality locality.
String	toString() Returns a String representation of the element.
String	toString(boolean includeNS, boolean declareNS) Returns a String representation of the <SubjectLocality> element.

Constructor Detail

SubjectLocality

public SubjectLocality()

Default Constructor

SubjectLocality

public SubjectLocality(Element localityElement)
                throws SAMLException

Constructs an instance of SubjectLocality from an existing XML block.

Parameters:

localityElement - A org.w3c.dom.Element representing DOM tree for SubjectLocality object.

Throws:

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

SubjectLocality

public SubjectLocality(String ipAddress,
                       String dnsAddress)

Constructs an instance of SubjectLocality.

Parameters:

ipAddress - String representing the IP Address of the entity that was authenticated.

dnsAddress - String representing the DNS Address of the entity that was authenticated. As per SAML specification they are both optional, so values can be null.

Method Detail

getIPAddress

public String getIPAddress()

Returns the IP address from SubjectLocality locality

Returns:

A String representation of IP address.

setDNSAddress

public boolean setDNSAddress(String dnsAddress)

Sets the DNS address for SubjectLocality> locality.

Parameters:

dnsAddress - A String representation of DNS address.

Returns:

true indicating the success of the operation.

setIPAddress

public boolean setIPAddress(String ipAddress)

Sets the IP address for SubjectLocality locality.

Parameters:

ipAddress - A String representation of IP address.

Returns:

true indicating the success of the operation.

getDNSAddress

public String getDNSAddress()

Returns the DNS address from SubjectLocality locality

Returns:

A String representation of DNS address.

toString

public String toString()

Returns a String representation of the element.

Overrides:

toString in class Object

Returns:

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

toString

public String toString(boolean includeNS,
                       boolean declareNS)

Returns a String representation of the <SubjectLocality> 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