nodeselectionevent.java

一个完整的XACML工程,学习XACML技术的好例子!

/*
* Copyright (c) 2006, University of Kent
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without 
* modification, are permitted provided that the following conditions are met:
*
* Redistributions of source code must retain the above copyright notice, this 
* list of conditions and the following disclaimer.
* 
* Redistributions in binary form must reproduce the above copyright notice, 
* this list of conditions and the following disclaimer in the documentation 
* and/or other materials provided with the distribution. 
*
* 1. Neither the name of the University of Kent nor the names of its 
* contributors may be used to endorse or promote products derived from this 
* software without specific prior written permission. 
*
* 2. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS  
* IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
* PURPOSE ARE DISCLAIMED. 
*
* 3. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
* POSSIBILITY OF SUCH DAMAGE.
*
* 4. YOU AGREE THAT THE EXCLUSIONS IN PARAGRAPHS 2 AND 3 ABOVE ARE REASONABLE
* IN THE CIRCUMSTANCES.  IN PARTICULAR, YOU ACKNOWLEDGE (1) THAT THIS
* SOFTWARE HAS BEEN MADE AVAILABLE TO YOU FREE OF CHARGE, (2) THAT THIS
* SOFTWARE IS NOT "PRODUCT" QUALITY, BUT HAS BEEN PRODUCED BY A RESEARCH
* GROUP WHO DESIRE TO MAKE THIS SOFTWARE FREELY AVAILABLE TO PEOPLE WHO WISH
* TO USE IT, AND (3) THAT BECAUSE THIS SOFTWARE IS NOT OF "PRODUCT" QUALITY
* IT IS INEVITABLE THAT THERE WILL BE BUGS AND ERRORS, AND POSSIBLY MORE
* SERIOUS FAULTS, IN THIS SOFTWARE.
*
* 5. This license is governed, except to the extent that local laws
* necessarily apply, by the laws of England and Wales.
*/

/*
 * NodeSelectionEvent.java - 14/11/05
 */
package issrg.utils.xml;

import org.w3c.dom.*;
import java.awt.AWTEvent;

/**
 * An event which indicates that Selection has occured in a listbox.
 * This is event generated when a user performs his selection in the 
 * NodeItemList, Listbox Component. 
 * <p> 
 * This is useful as the Listbox only stores strings, and not the desired
 * string labels of XML Elements. Therefore when a selection occurs in a 
 * listbox, the event is fired to update the corresponding XML Element Selection.
 * <p>
 * The event is passed to every <code>NodeSelectionListener</code> object
 * that is registered to receive such events using the component's
 * <code>addNodeChangeListener</code> method. 
 * <p>
 * The object that implements the <code>NodeSelectionListener</code> interface
 * gets this <code>NodeSelectionEvent</code> when the event occurs.
 *
 * @see NodeSelectionListener
 *
 * @author Christian Azzopardi
 */
public class NodeSelectionEvent extends AWTEvent
{   
    /**
     * The XML Editor Reference
     */
    XMLEditor xmlED;
    
    /**
     *  The currently Selected Node in the List
     */
    private Node selectedNode;
    
    /**
     * Constructs an <code>NodeSelectionEvent</code> object.
     *
     * @param xmlED         the xml Editor reference from which event has occured
     * @param source        the object where the event originated
     * @param selectedNode  the newly selected Node
     */
    public NodeSelectionEvent(XMLEditor xmlED, Object source, Node selectedNode) 
    {
        super(source,1);
        this.xmlED = xmlED;
        setSelectedNode(selectedNode);
    }
    
    /**
     * Sets the newly selected node.     
     *
     * @param selNode   the newly Selected Node to set
     */
    public void setSelectedNode(Node selNode)
    {
        selectedNode = selNode;
    }
    
    /**
     * Returns the currently selected Node 
     *
     * @return the currently selected Node
     */
    public Node getSelectedNode()
    {
        return selectedNode;
    }   
}