microsoft.exchange.webservices.data.security
Class XmlNameTable

java.lang.Object
  microsoft.exchange.webservices.data.security.XmlNameTable

public abstract class XmlNameTable
extends Object

Table of atomized String objects.

Constructor Summary

protected

XmlNameTable() Initializes a new instance of the XmlNameTable class.

Method Summary

abstract String	Add(char[] array, int offset, int length) Reads an XML Schema from the supplied stream.
abstract String	Add(String array) When overridden in a derived class, atomizes the specified String and adds it to the XmlNameTable.
abstract String	Get(char[] array, int offset, int length) When overridden in a derived class, gets the atomized String containing the same characters as the specified range of characters in the given array.
abstract String	Get(String array) When overridden in a derived class, gets the atomized String containing the same value as the specified String.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XmlNameTable

protected XmlNameTable()

Initializes a new instance of the XmlNameTable class.

Method Detail

Add

public abstract String Add(String array)

When overridden in a derived class, atomizes the specified String and adds it to the XmlNameTable.

Parameters:

array - : The name to add.

Returns:

The new atomized String or the existing one if it already exists.

Throws:

ArgumentNullException - array is null.

Add

public abstract String Add(char[] array,
                           int offset,
                           int length)

Reads an XML Schema from the supplied stream.

Parameters:

array - The character array containing the name to add.

offset - Zero-based index into the array specifying the first character of the name.

length - The number of characters in the name.

Returns:

The new atomized String or the existing one if it already exists. If length is zero, String.Empty is returned

Throws:

ArgumentOutOfRangeException - 0 > offset -or- offset >= array.Length -or- length > array.Length The above conditions do not cause an exception to be thrown if length =0.

ArgumentOutOfRangeException - length < 0.

Get

public abstract String Get(String array)

When overridden in a derived class, gets the atomized String containing the same value as the specified String.

Parameters:

array - The name to look up.

Returns:

The atomized String or null if the String has not already been atomized.

Throws:

ArgumentNullException - : array is null.

Get

public abstract String Get(char[] array,
                           int offset,
                           int length)

When overridden in a derived class, gets the atomized String containing the same characters as the specified range of characters in the given array.

Parameters:

array - The character array containing the name to add.

offset - Zero-based index into the array specifying the first character of the name.

length - The number of characters in the name.

Returns:

The atomized String or null if the String has not already been atomized. If length is zero, String.Empty is returned

Throws:

ArgumentOutOfRangeException - 0 > offset -or- offset >= array.Length -or- length > array.Length The above conditions do not cause an exception to be thrown if length =0.

ArgumentOutOfRangeException - length < 0.