KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > columba > core > tagging > api > ITagManager


1 package org.columba.core.tagging.api;
2
3 import java.util.Hashtable JavaDoc;
4 import java.util.Iterator JavaDoc;
5
6 import org.columba.api.exception.StoreException;
7
8 /**
9  * Providers CRUD operations for <code>ITag</code>.
10  *
11  * @author mhub
12  * @author fdietz
13  */

14 public interface ITagManager {
15
16     /**
17      * Add tag with given name.
18      *
19      * @param name
20      * @return
21      * @throws StoreException
22      */

23     ITag addTag(String JavaDoc name) throws StoreException;
24     
25     /**
26      * Retrieve tag with specified id.
27      *
28      * @param id
29      * @return
30      */

31     ITag getTag(String JavaDoc id);
32     
33     /**
34      * Get iterator of all tags.
35      * @return
36      */

37     Iterator JavaDoc<ITag> getAllTags();
38     
39     /**
40      * Update all changes in tag.
41      *
42      * @param tag
43      * @throws StoreException
44      */

45     void replaceTag(ITag tag) throws StoreException;
46     
47     /**
48      * Delete tag with given id.
49      *
50      * @param id
51      * @throws StoreException
52      */

53     void removeTag(String JavaDoc id) throws StoreException;
54     
55
56     /**
57      * Add listener for changes in tags.
58      */

59     public void addTagListener(ITagListener l);
60     
61     /**
62      * Remove listener for changes in tags.
63      * @param l
64      */

65     public void removeTagListener(ITagListener l);
66 }
67
Popular Tags