com.vaadin.event.MethodEventSource Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of vaadin Show documentation
Vaadin is a web application framework for Rich Internet Applications (RIA). Vaadin enables easy development and maintenance of fast and secure rich web applications with a stunning look and feel and a wide browser support. It features a server-side architecture with the majority of the logic running on the server. Ajax technology is used at the browser-side to ensure a rich and interactive user experience.
The newest version!
/* 
 * Copyright 2011 Vaadin Ltd.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */

package com.vaadin.event;

import java.io.Serializable;
import java.lang.reflect.Method;

/**
 * 
 * Interface for classes supporting registration of methods as event receivers.
 * 
 * 
 * 
 * For more information on the inheritable event mechanism see the
 * {@link com.vaadin.event com.vaadin.event package documentation}.
 * 
 * 
 * @author Vaadin Ltd.
 * @version
 * 7.0.0.alpha3
 * @since 3.0
 */
public interface MethodEventSource extends Serializable {

    /**
     * 
     * Registers a new event listener with the specified activation method to
     * listen events generated by this component. If the activation method does
     * not have any arguments the event object will not be passed to it when
     * it's called.
     * 
     * 
     * 
     * For more information on the inheritable event mechanism see the
     * {@link com.vaadin.event com.vaadin.event package documentation}.
     * 
     * 
     * @param eventType
     *            the type of the listened event. Events of this type or its
     *            subclasses activate the listener.
     * @param object
     *            the object instance who owns the activation method.
     * @param method
     *            the activation method.
     * @throws java.lang.IllegalArgumentException
     *             unless method has exactly one match in
     *             object
     */
    public void addListener(Class eventType, Object object, Method method);

    /**
     * 
     * Registers a new listener with the specified activation method to listen
     * events generated by this component. If the activation method does not
     * have any arguments the event object will not be passed to it when it's
     * called.
     * 
     * 
     * 
     * This version of addListener gets the name of the activation
     * method as a parameter. The actual method is reflected from
     * object, and unless exactly one match is found,
     * java.lang.IllegalArgumentException is thrown.
     * 
     * 
     * 
     * For more information on the inheritable event mechanism see the
     * {@link com.vaadin.event com.vaadin.event package documentation}.
     * 
     * 
     * @param eventType
     *            the type of the listened event. Events of this type or its
     *            subclasses activate the listener.
     * @param object
     *            the object instance who owns the activation method.
     * @param methodName
     *            the name of the activation method.
     * @throws java.lang.IllegalArgumentException
     *             unless method has exactly one match in
     *             object
     */
    public void addListener(Class eventType, Object object, String methodName);

    /**
     * Removes all registered listeners matching the given parameters. Since
     * this method receives the event type and the listener object as
     * parameters, it will unregister all object's methods that are
     * registered to listen to events of type eventType generated
     * by this component.
     * 
     * 
     * For more information on the inheritable event mechanism see the
     * {@link com.vaadin.event com.vaadin.event package documentation}.
     * 
     * 
     * @param eventType
     *            the exact event type the object listens to.
     * @param target
     *            the target object that has registered to listen to events of
     *            type eventType with one or more methods.
     */
    public void removeListener(Class eventType, Object target);

    /**
     * Removes one registered listener method. The given method owned by the
     * given object will no longer be called when the specified events are
     * generated by this component.
     * 
     * 
     * For more information on the inheritable event mechanism see the
     * {@link com.vaadin.event com.vaadin.event package documentation}.
     * 
     * 
     * @param eventType
     *            the exact event type the object listens to.
     * @param target
     *            the target object that has registered to listen to events of
     *            type eventType with one or more methods.
     * @param method
     *            the method owned by the target that's registered to listen to
     *            events of type eventType.
     */
    public void removeListener(Class eventType, Object target, Method method);

    /**
     * 
     * Removes one registered listener method. The given method owned by the
     * given object will no longer be called when the specified events are
     * generated by this component.
     * 
     * 
     * 
     * This version of removeListener gets the name of the
     * activation method as a parameter. The actual method is reflected from the
     * target, and unless exactly one match is found,
     * java.lang.IllegalArgumentException is thrown.
     * 
     * 
     * 
     * For more information on the inheritable event mechanism see the
     * {@link com.vaadin.event com.vaadin.event package documentation}.
     * 
     * 
     * @param eventType
     *            the exact event type the object listens to.
     * @param target
     *            the target object that has registered to listen to events of
     *            type eventType with one or more methods.
     * @param methodName
     *            the name of the method owned by target that's
     *            registered to listen to events of type eventType.
     */
    public void removeListener(Class eventType, Object target,
            String methodName);
}