Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

Source code: org/objectstyle/cayenne/map/event/RelationshipEvent.java


1   /* ====================================================================
2    * 
3    * The ObjectStyle Group Software License, Version 1.0 
4    *
5    * Copyright (c) 2002-2003 The ObjectStyle Group 
6    * and individual authors of the software.  All rights reserved.
7    *
8    * Redistribution and use in source and binary forms, with or without
9    * modification, are permitted provided that the following conditions
10   * are met:
11   *
12   * 1. Redistributions of source code must retain the above copyright
13   *    notice, this list of conditions and the following disclaimer. 
14   *
15   * 2. Redistributions in binary form must reproduce the above copyright
16   *    notice, this list of conditions and the following disclaimer in
17   *    the documentation and/or other materials provided with the
18   *    distribution.
19   *
20   * 3. The end-user documentation included with the redistribution, if
21   *    any, must include the following acknowlegement:  
22   *       "This product includes software developed by the 
23   *        ObjectStyle Group (http://objectstyle.org/)."
24   *    Alternately, this acknowlegement may appear in the software itself,
25   *    if and wherever such third-party acknowlegements normally appear.
26   *
27   * 4. The names "ObjectStyle Group" and "Cayenne" 
28   *    must not be used to endorse or promote products derived
29   *    from this software without prior written permission. For written 
30   *    permission, please contact andrus@objectstyle.org.
31   *
32   * 5. Products derived from this software may not be called "ObjectStyle"
33   *    nor may "ObjectStyle" appear in their names without prior written
34   *    permission of the ObjectStyle Group.
35   *
36   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39   * DISCLAIMED.  IN NO EVENT SHALL THE OBJECTSTYLE GROUP OR
40   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
42   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
43   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
44   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
45   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
46   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
47   * SUCH DAMAGE.
48   * ====================================================================
49   *
50   * This software consists of voluntary contributions made by many
51   * individuals on behalf of the ObjectStyle Group.  For more
52   * information on the ObjectStyle Group, please see
53   * <http://objectstyle.org/>.
54   *
55   */
56  package org.objectstyle.cayenne.map.event;
57  
58  import org.objectstyle.cayenne.map.Entity;
59  import org.objectstyle.cayenne.map.Relationship;
60  
61  /** 
62   * Represents events resulted from Relationship changes 
63   * in CayenneModeler. This event is used for both ObjRelationships
64   * and DbRelationships.
65   * 
66   * 
67   * @author Misha Shengaout
68   * @author Andrei Adamchik
69   */
70  public class RelationshipEvent extends EntityEvent {
71    protected Relationship relationship;
72  
73    /** Creates a Relationship change event. */
74    public RelationshipEvent(Object src, Relationship rel, Entity entity) {
75      super(src, entity);
76      setRelationship(rel);
77    }
78  
79    /** Creates a Relationship event of a specified type. */
80    public RelationshipEvent(
81      Object src,
82      Relationship rel,
83      Entity entity,
84      int id) {
85  
86      this(src, rel, entity);
87      setId(id);
88    }
89  
90    /** Creates a Relationship name change event. */
91    public RelationshipEvent(
92      Object src,
93      Relationship rel,
94      Entity entity,
95      String oldName) {
96        
97      this(src, rel, entity);
98          setOldName(oldName);
99    }
100 
101   /** Returns relationship associated with this event. */
102   public Relationship getRelationship() {
103     return relationship;
104   }
105 
106   /**
107    * Sets relationship associated with this event.
108    * 
109    * @param relationship The relationship to set
110    */
111   public void setRelationship(Relationship relationship) {
112     this.relationship = relationship;
113   }
114   
115   public String getNewName() {
116     return (relationship != null) ? relationship.getName() : null;
117   }
118 }