01: /* ====================================================================
02: * The Jcorporate Apache Style Software License, Version 1.2 05-07-2002
03: *
04: * Copyright (c) 1995-2003 Jcorporate Ltd. All rights reserved.
05: *
06: * Redistribution and use in source and binary forms, with or without
07: * modification, are permitted provided that the following conditions
08: * are met:
09: *
10: * 1. Redistributions of source code must retain the above copyright
11: * notice, this list of conditions and the following disclaimer.
12: *
13: * 2. Redistributions in binary form must reproduce the above copyright
14: * notice, this list of conditions and the following disclaimer in
15: * the documentation and/or other materials provided with the
16: * distribution.
17: *
18: * 3. The end-user documentation included with the redistribution,
19: * if any, must include the following acknowledgment:
20: * "This product includes software developed by Jcorporate Ltd.
21: * (http://www.jcorporate.com/)."
22: * Alternately, this acknowledgment may appear in the software itself,
23: * if and wherever such third-party acknowledgments normally appear.
24: *
25: * 4. "Jcorporate" and product names such as "Expresso" must
26: * not be used to endorse or promote products derived from this
27: * software without prior written permission. For written permission,
28: * please contact info@jcorporate.com.
29: *
30: * 5. Products derived from this software may not be called "Expresso",
31: * or other Jcorporate product names; nor may "Expresso" or other
32: * Jcorporate product names appear in their name, without prior
33: * written permission of Jcorporate Ltd.
34: *
35: * 6. No product derived from this software may compete in the same
36: * market space, i.e. framework, without prior written permission
37: * of Jcorporate Ltd. For written permission, please contact
38: * partners@jcorporate.com.
39: *
40: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
41: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
42: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
43: * DISCLAIMED. IN NO EVENT SHALL JCORPORATE LTD OR ITS CONTRIBUTORS
44: * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
45: * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
46: * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
47: * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
48: * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
49: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
50: * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51: * SUCH DAMAGE.
52: * ====================================================================
53: *
54: * This software consists of voluntary contributions made by many
55: * individuals on behalf of the Jcorporate Ltd. Contributions back
56: * to the project(s) are encouraged when you make modifications.
57: * Please send them to support@jcorporate.com. For more information
58: * on Jcorporate Ltd. and its products, please see
59: * <http://www.jcorporate.com/>.
60: *
61: * Portions of this software are based upon other open source
62: * products and are subject to their respective licenses.
63: */
64: package com.jcorporate.expresso.core.dataobjects;
65:
66: /**
67: * Context nested represents any object that can be retrieved or set to any
68: * specific data context. The classic example of this is the DBObject where
69: * we call setDataContext() with every instantiation. Other examples include
70: * c.j.e.core.security.User
71: *
72: * @author Michael Rimov
73: * @since Expresso 5.1
74: */
75:
76: public interface ContextNested {
77:
78: /**
79: * Sets the data context for this particular object implementation.
80: *
81: * @param newContext the new Data context.
82: * @throws IllegalArgumentException if the data context is null.
83: */
84: public void setDataContext(String newContext);
85:
86: /**
87: * Retrieve the data context for this particular object implementation
88: *
89: * @return java.lang.String. Should never be null.
90: */
91: public String getDataContext();
92: }
|