/*
 *                 Sun Public License Notice
 * 
 * The contents of this file are subject to the Sun Public License
 * Version 1.0 (the "License"). You may not use this file except in
 * compliance with the License. A copy of the License is available at
 * http://www.sun.com/
 * 
 * The Original Code is NetBeans. The Initial Developer of the Original
 * Code is Sun Microsystems, Inc. Portions Copyright 1997-2003 Sun
 * Microsystems, Inc. All Rights Reserved.
 */

package org.netbeans.api.registry;


/** An event from context indicating that binding was modified, 
 * added or removed. The event intentionally does not pass value of 
 * the object because in some situation it could result in unnecessary 
 * creation of the object. The client receiving this event can retrieve
 * the value by regular Context methods. The {@link #getType} 
 * can be used to distinguish type of the change.
 *
 * @author  David Konecny
 */
public final class BindingEvent extends ContextEvent {

    /** This event type is for added binding. */
    public static final int BINDING_ADDED = 1;

    /** This event type is for removed binding. */
    public static final int BINDING_REMOVED = 2;
    
    /** This event type is for modified binding. */
    public static final int BINDING_MODIFIED = 3;
    
    private String bindingName;
    private int type;

    BindingEvent(Context source, String bindingName, int type) {
        super(source);
        this.bindingName = bindingName;
        this.type = type;
    }

    /**
     * Name of the binding. It can be null what means
     * that concrete source of the change was not clear and that
     * client should reexamine whole context.
     *
     * @return binding name; can be null
     */
    public String getBindingName() {
        return bindingName;
    }
    
    public int getType() {
        return type;
    }

    public String toString() {
        return "BindingEvent: [bindingName="+bindingName+", type="+type+"] " + super.toString(); // NOI18N
    }
}