net.sourceforge.htmlunit.xerces.xni

Interface Augmentations

All Known Implementing Classes:

AugmentationsImpl, HTMLAugmentations

public interface Augmentations

The Augmentations interface defines a table of additional data that may be passed along the document pipeline. The information can contain extra arguments or infoset augmentations, for example PSVI. This additional information is identified by a String key.

Note: Methods that receive Augmentations are required to copy the information if it is to be saved for use beyond the scope of the method. The Augmentations content is volatile, and maybe modified by any method in any component in the pipeline. Therefore, methods passed this structure should not save any reference to the structure.

Author:

Elena Litani, IBM

Method Summary

Modifier and Type	Method and Description
void	clear() Remove all objects from the Augmentations structure.
Object	get(String key) Get information identified by a key from the Augmentations structure
Set<String>	keys()
Object	put(String key, Object item) Add additional information identified by a key to the Augmentations structure.
Object	remove(String key) Remove additional info from the Augmentations structure

Method Detail

put

Object put(String key,
           Object item)

Add additional information identified by a key to the Augmentations structure.

Parameters:

key - Identifier, can't be null

item - Additional information

Returns:

the previous value of the specified key in the Augmentations structure, or null if it did not have one.

get

Object get(String key)

Get information identified by a key from the Augmentations structure

Parameters:

key - Identifier, can't be null

Returns:

the value to which the key is mapped in the Augmentations structure; null if the key is not mapped to any value.

remove

Object remove(String key)

Remove additional info from the Augmentations structure

Parameters:

key - Identifier, can't be null

Returns:

the previous value of the specified key in the Augmentations structure, or null if it did not have one.

keys

Set<String> keys()

Returns:

an enumeration of the keys in the Augmentations structure

clear

void clear()

Remove all objects from the Augmentations structure.