01: package org.drools.jsr94.rules;
02:
03: /*
04: * $Id: Jsr94FactHandle.java,v 1.14 2005/02/04 02:13:38 mproctor Exp $
05: *
06: * Copyright 2003-2004 (C) The Werken Company. All Rights Reserved.
07: *
08: * Redistribution and use of this software and associated documentation
09: * ("Software"), with or without modification, are permitted provided that the
10: * following conditions are met:
11: *
12: * 1. Redistributions of source code must retain copyright statements and
13: * notices. Redistributions must also contain a copy of this document.
14: *
15: * 2. Redistributions in binary form must reproduce the above copyright notice,
16: * this list of conditions and the following disclaimer in the documentation
17: * and/or other materials provided with the distribution.
18: *
19: * 3. The name "drools" must not be used to endorse or promote products derived
20: * from this Software without prior written permission of The Werken Company.
21: * For written permission, please contact bob@werken.com.
22: *
23: * 4. Products derived from this Software may not be called "drools" nor may
24: * "drools" appear in their names without prior written permission of The Werken
25: * Company. "drools" is a registered trademark of The Werken Company.
26: *
27: * 5. Due credit should be given to The Werken Company.
28: * (http://drools.werken.com/).
29: *
30: * THIS SOFTWARE IS PROVIDED BY THE WERKEN COMPANY AND CONTRIBUTORS ``AS IS''
31: * AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
32: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
33: * ARE DISCLAIMED. IN NO EVENT SHALL THE WERKEN COMPANY OR ITS CONTRIBUTORS BE
34: * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
35: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
36: * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
37: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
38: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
39: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
40: * POSSIBILITY OF SUCH DAMAGE.
41: *
42: */
43:
44: import javax.rules.Handle;
45:
46: import org.drools.common.DefaultFactHandle;
47:
48: /**
49: * The Drools implementation of the <code>Handle</code> interface which provides
50: * a marker interface for Drools-specific object identity mechanism. When using
51: * the <code>StatefulRuleSession</code> objects that are added to rule session
52: * state are identified using a Drools-supplied <code>Handle</code>
53: * implementation.
54: * <p/>
55: * <code>Handle</code>s are used to unambigiously identify objects within the
56: * rule session state and should not suffer many of the object identity issues
57: * that arise when using muliple class loaders, serializing
58: * <code>StatefulRuleSessions</code>, or using <code>Object.equals</code> or
59: * <code>object1 == object2</code> reference equality.
60: */
61: public class Jsr94FactHandle extends DefaultFactHandle implements
62: Handle {
63: /**
64: * Constructs a new <code>Handle</code>.
65: *
66: * @param id A unique <code>Handle</code> id.
67: * @param recency A value indicating the recency of this <code>Handle</code>
68: * (more recently created <code>Handle</code>s have greater values
69: * than <code>Handle</code>s created further in the past)
70: *
71: * @see org.drools.conflict.RecencyConflictResolver
72: */
73: Jsr94FactHandle(final long id, final Object object,
74: final long recency) {
75: super(id, object, recency);
76: }
77: }
|