hep.aida
Interface IAnnotation

public interface IAnnotation

The annotation holds arbitrary information represented with (key,value) pairs of strings. A sticky bit is associated to every item to protect it (or not) from a reset operation.

Author:

The AIDA team (http://aida.freehep.org/)

Field Summary

static String

titleKey The list of the commonly accepted keys.

Method Summary

void	addItem(String key, String value) Add a key/value pair with a given sticky flag.
void	addItem(String key, String value, boolean sticky) Add a key/value pair with a given sticky flag.
String	key(int index) Get the key at a given position within the IAnnotation.
void	removeItem(String key) Remove the item indicated by a given key.
void	reset() Remove all the non-sticky items.
void	setSticky(String key, boolean sticky) Set the sticky flag for a given key.
void	setValue(String key, String value) Set the value for a given key.
int	size() Get the size of the IAnnotation, i.e. the number of keys contained in it.
String	value(int index) Get the value at a given position within the IAnnotation.
String	value(String key) Retrieve the value for a given key.

Field Detail

titleKey

public static final String titleKey

The list of the commonly accepted keys.

See Also:

Constant Field Values

Method Detail

addItem

public void addItem(String key,
                    String value)
             throws IllegalArgumentException

Add a key/value pair with a given sticky flag. If key alredy exists, override its value ?

Parameters:

key - The key to be added.

value - The key's value. not be removed when the method reset or removeItem are invoked. The default value for the sticky flag is false.

Throws:

IllegalArgumentException - If the key already exists.

addItem

public void addItem(String key,
                    String value,
                    boolean sticky)
             throws IllegalArgumentException

Add a key/value pair with a given sticky flag. If key alredy exists, override its value ?

Parameters:

key - The key to be added.

value - The key's value.

sticky - The key's sticky flag. If true the item will not be removed when the method reset or removeItem are invoked. The default value for the sticky flag is false.

Throws:

IllegalArgumentException - If the key already exists.

removeItem

public void removeItem(String key)
                throws IllegalArgumentException

Remove the item indicated by a given key.

Parameters:

key - The key to be removed. If the key is flagged as "sticky" it will not be removed.

Throws:

IllegalArgumentException - If the key is sticky.

value

public String value(String key)

Retrieve the value for a given key.

Parameters:

key - The key.

Returns:

The corresponding value.

setValue

public void setValue(String key,
                     String value)

Set the value for a given key.

Parameters:

key - The key whose vale is to be changed.

value - The new value.

setSticky

public void setSticky(String key,
                      boolean sticky)

Set the sticky flag for a given key.

Parameters:

key - The key whose stick flag is to be set.

sticky - The new sticky flag.

size

public int size()

Get the size of the IAnnotation, i.e. the number of keys contained in it.

Returns:

The size of the IAnnotation.

key

public String key(int index)

Get the key at a given position within the IAnnotation.

Parameters:

index - The key's position within the IAnnotation.

Returns:

The corresponding key.

value

public String value(int index)

Get the value at a given position within the IAnnotation.

Parameters:

index - The value's position within the IAnnotation.

Returns:

The corresponding value.

reset

public void reset()

Remove all the non-sticky items.