01: /**
02: * hammurapi-rules @mesopotamia.version@
03: * Hammurapi rules engine.
04: * Copyright (C) 2005 Hammurapi Group
05: *
06: * This program is free software; you can redistribute it and/or
07: * modify it under the terms of the GNU Lesser General Public
08: * License as published by the Free Software Foundation; either
09: * version 2 of the License, or (at your option) any later version.
10: *
11: * This program is distributed in the hope that it will be useful,
12: * but WITHOUT ANY WARRANTY; without even the implied warranty of
13: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14: * Lesser General Public License for more details.
15: *
16: * You should have received a copy of the GNU Lesser General Public
17: * License along with this library; if not, write to the Free Software
18: * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19: *
20: * URL: http://http://www.hammurapi.biz
21: * e-Mail: support@hammurapi.biz
22: */package biz.hammurapi.rules;
23:
24: import java.util.Collection;
25:
26: import javax.rules.Handle;
27:
28: /**
29: * Handle manager - creates and maintains handle -> object
30: * mappings.
31: * @author Pavel Vlasov
32: * @version ${Revision}
33: */
34: public interface HandleManager extends Negatable {
35:
36: /**
37: * Establishes Handle -> Object mapping.
38: * @param object
39: * @return
40: */
41: Handle addObject(Object object);
42:
43: /**
44: * Retrieves object by handle
45: * @param handle
46: * @return
47: */
48: Object getObject(Handle handle);
49:
50: /**
51: * @return All objects with handles.
52: */
53: Collection getObjects();
54:
55: /**
56: * @return All handles.
57: */
58: Collection getHandles();
59:
60: /**
61: * Removes object entry by key.
62: * @param handle
63: */
64: void remove(Handle handle);
65:
66: /**
67: * Removes object entry by value;
68: * @param obj
69: */
70: void remove(Object obj);
71:
72: /**
73: * @param handle
74: * @return True there is a mapping with given handle in the manager.
75: */
76: boolean contains(Handle handle);
77:
78: /**
79: * Rebinds handle to another object
80: * @param handle
81: * @param object
82: */
83: void rebind(Handle handle, Object object);
84:
85: /**
86: * Removes all mappings.
87: */
88: void clear();
89: }
|