summaryrefslogtreecommitdiff
path: root/projects/net.wotonomy.persistence/src/main/java/net/wotonomy/control/EORelationshipManipulation.java
blob: 4b8845be8930277ea5d4e3fa15968a5fb46cd16e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
/*
Wotonomy: OpenStep design patterns for pure Java applications.
Copyright (C) 2001 Michael Powers

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, see http://www.gnu.org
*/

package net.wotonomy.control;

/**
 * EORelationshipManipulation provides methods for generically adding and
 * removing relationships between objects, handling both one-way and reciprocal
 * relationships.
 *
 * @author michael@mpowers.net
 * @author $Author: cgruber $
 * @version $Revision: 893 $
 */
public interface EORelationshipManipulation {
	/**
	 * Adds the specified object to the relationship on this object specified by the
	 * key. For to-one relationships, this operation is the same as valueForKey.
	 */
	void addObjectToPropertyWithKey(Object anObject, String aKey);

	/**
	 * Removes the specified object from the relationship on this object specified
	 * by the key. For to-one relationships, this operation is the same as
	 * takeValueForKey with a null value.
	 */
	void removeObjectFromPropertyWithKey(Object anObject, String aKey);

	/**
	 * As addObjectToProperty with key, but also performs the reciprocal operation
	 * on the other side of the relationship.
	 */
	void addObjectToBothSidesOfRelationshipWithKey(EORelationshipManipulation anObject, String aKey);

	/**
	 * As removeObjectFromPropertyWithKey with key, but also performs the reciprocal
	 * operation on the other side of the relationship.
	 */
	void removeObjectFromBothSidesOfRelationshipWithKey(EORelationshipManipulation anObject, String aKey);

}

/*
 * $Log$ Revision 1.1 2006/02/16 13:19:57 cgruber Check in all sources in
 * eclipse-friendly maven-enabled packages.
 *
 * Revision 1.1 2001/11/13 04:13:59 mpowers Added interfaces needed to begin
 * work on EOCustomObject.
 *
 *
 */