01: /* ====================================================================
02: The Jicarilla Software License
03:
04: Copyright (c) 2003 Leo Simons.
05: All rights reserved.
06:
07: Permission is hereby granted, free of charge, to any person obtaining
08: a copy of this software and associated documentation files (the
09: "Software"), to deal in the Software without restriction, including
10: without limitation the rights to use, copy, modify, merge, publish,
11: distribute, sublicense, and/or sell copies of the Software, and to
12: permit persons to whom the Software is furnished to do so, subject to
13: the following conditions:
14:
15: The above copyright notice and this permission notice shall be
16: included in all copies or substantial portions of the Software.
17:
18: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19: EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20: MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
21: IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
22: CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23: TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24: SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25: ==================================================================== */
26: package org.jicarilla.lang;
27:
28: /**
29: * <p>Determines whether a particular object should be 'selected'. What exactly
30: * the object is selected for depends on the context in which the selector is
31: * use. Selectors can be used to model a more flexible version of a @{link
32: * java.util.HashMap HashMap}, to model the '===' operator found in some other
33: * languages, as the basis of an object-oriented multiway switch/case, and for
34: * many other purposes.</p>
35: *
36: * <p>An example of the "rich HashMap" application of selectors can be seen in
37: * the implementation of the <code>DefaultContainer</code> that is part of the
38: * Jicarilla platform. An example of using the selector as part of a multiway
39: * switch is found in the {@link org.jicarilla.plumbing.Screener Screener} interface.</p>
40: *
41: * @author <a href="lsimons at jicarilla dot org">Leo Simons</a>
42: * @version $Id: Selector.java,v 1.1 2004/03/23 13:37:56 lsimons Exp $
43: */
44: public interface Selector {
45: /**
46: * Determine whether the argument is part of the set spanned by this
47: * selector.
48: *
49: * @param object
50: *
51: * @return true if the argument is part of the set spanned by this
52: * selector, false otherwise
53: */
54: boolean select(Object object);
55: }
|