alvinalexander.com | career | drupal | java | mac | mysql | perl | scala | uml | unix  

What this is

This file is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Other links

The source code

// $Id: TargetEvent.java,v 1.8 2004/08/29 19:40:55 mvw Exp $
// Copyright (c) 2002-2003 The Regents of the University of California. All
// Rights Reserved. Permission to use, copy, modify, and distribute this
// software and its documentation without fee, and without a written
// agreement is hereby granted, provided that the above copyright notice
// and this paragraph appear in all copies.  This software program and
// documentation are copyrighted by The Regents of the University of
// California. The software program and documentation are supplied "AS
// IS", without any accompanying services from The Regents. The Regents
// does not warrant that the operation of the program will be
// uninterrupted or error-free. The end-user understands that the program
// was developed for research purposes and is advised not to rely
// exclusively on the program for any reason.  IN NO EVENT SHALL THE
// UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,
// SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS,
// ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF
// THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF
// SUCH DAMAGE. THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY
// WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE
// PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE UNIVERSITY OF
// CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT,
// UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
package org.argouml.ui.targetmanager;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.EventObject;
import java.util.Iterator;
import java.util.List;

/**
 * A targetevent indicating that the target of ArgoUML has changed 
 * from the _oldTargets to _newTargets.
 * @author jaap.branderhorst@xs4all.nl
 */
public class TargetEvent extends EventObject {

    /**
     * Indicates that a total new set of targets is set
     */
    public static final String TARGET_SET = "set";

    /**
     * Indicates that a target is being added to the list of targets
     */
    public static final String TARGET_ADDED = "added";

    /**
     * Indicates that a target is being removed from the list of targets
     */
    public static final String TARGET_REMOVED = "removed";

    /**
     * The name of the event
     */
    private String theEventName;

    /**
     * The old targets before the change took place
     */
    private Object[] theOldTargets;

    /**
     * The new targets after the change took place
     */
    private Object[] theNewTargets;

    /**
     * Constructs a new TargetEvent
     * @param source The source that fired the TargetEvent, will
     * allways be the TargetManager
     * @param tEName The name of the TargetEvent, can be TARGET_SET,
     * TARGET_REMOVED or TARGET_ADDED
     * @param oldTargets The old targets before the change took place
     * @param newTargets The new targets after the change took place
     */
    public TargetEvent(Object source, String tEName,
		       Object[] oldTargets, Object[] newTargets)
    {
	super(source);
	theEventName = tEName;
        theOldTargets = oldTargets;
        theNewTargets = newTargets;
    }

    /**
     * Getter for the name
     * @return the name of the event
     */
    public String getName() {
	return theEventName;
    }

    /**
     * Getter for the old targets
     * @return an object array with the old targets
     */
    public Object[] getOldTargets() {
	return theOldTargets == null ? new Object[] {} : theOldTargets;
    }

    /**
     * Getter for the new targets
     * @return an object array with the new targets
     */
    public Object[] getNewTargets() {
        return theNewTargets == null ? new Object[] {} : theNewTargets;
    }

    /**
     * Helper for getting the new target
     * @return the zero'th element in _newTargets, or null
     */
    public Object getNewTarget() {
        return theNewTargets == null 
            || theNewTargets.length < 1 ? null : theNewTargets[0];
    }
    
    /**
     * Gets the targets that are removed from the selection
     * @return the removed targets
     */
    public Object[] getRemovedTargets() {
        List removedTargets = new ArrayList();
        List oldTargets = Arrays.asList(theOldTargets);
        List newTargets = Arrays.asList(theNewTargets);
        Iterator it = oldTargets.iterator();
        while (it.hasNext()) {
            Object o = it.next();
            if (!newTargets.contains(o)) {
                removedTargets.add(o);
            }
        }
        return removedTargets.toArray();
    }
    
    /**
     * Returns the targets that are added to the selection
     * @return the added targets
     */
    public Object[] getAddedTargets() {
        List addedTargets = new ArrayList();
        List oldTargets = Arrays.asList(theOldTargets);
        List newTargets = Arrays.asList(theNewTargets);
        Iterator it = newTargets.iterator();
        while (it.hasNext()) {
            Object o = it.next();
            if (!oldTargets.contains(o)) {
                addedTargets.add(o);
            }
        }
        return addedTargets.toArray();
    }
}

... this post is sponsored by my books ...

#1 New Release!

FP Best Seller

 

new blog posts

 

Copyright 1998-2024 Alvin Alexander, alvinalexander.com
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.