FreeHEP API
Version 3.0

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.


FreeHEP API
Version 3.0

Copyright © 2000-2002 AIDA Team, All Rights Reserved.