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: */
23: package biz.hammurapi.rules;
24:
25: import java.util.Collection;
26:
27: /**
28: * Implementations manage collections for rules.
29: * Rules itself shall not maintain collections of
30: * facts and objects, but use CollectionManager.
31: *
32: * @author Pavel Vlasov
33: * @version ${Revision}
34: */
35: public interface CollectionManager extends Negatable {
36:
37: /**
38: * Retrieves collection from the manager.
39: * If a collection for this name doesn't exist it
40: * should be created.
41: * @param ruleName Name of the rule this collection belongs to.
42: * @param collectionName Name of the collection withing the rule.
43: * @return Collection, never null.
44: * @param lock Collection monitor for synchronization.
45: */
46: Collection get(String ruleName, String collectionName, Object lock);
47:
48: /**
49: * Clears all collections.
50: */
51: void clear();
52: }
|