com.vaadin.v7.event.ItemClickEvent Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of vaadin-compatibility-server Show documentation
Vaadin 7 compatibility package for Vaadin 8
The newest version!
/*
 * Copyright (C) 2000-2024 Vaadin Ltd
 *
 * This program is available under Vaadin Commercial License and Service Terms.
 *
 * See  for the full
 * license.
 */
package com.vaadin.v7.event;

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

import com.vaadin.event.MouseEvents.ClickEvent;
import com.vaadin.event.SerializableEventListener;
import com.vaadin.shared.MouseEventDetails;
import com.vaadin.ui.Component;
import com.vaadin.v7.data.Container;
import com.vaadin.v7.data.Item;
import com.vaadin.v7.data.Property;

/**
 *
 * Click event fired by a {@link Component} implementing {@link Container}
 * interface. ItemClickEvents happens on an {@link Item} rendered somehow on
 * terminal. Event may also contain a specific {@link Property} on which the
 * click event happened.
 *
 * @since 5.3
 *
 * @deprecated As of 8.0, see component-specific click events.
 */
@SuppressWarnings("serial")
@Deprecated
public class ItemClickEvent extends ClickEvent {
    private Item item;
    private Object itemId;
    private Object propertyId;

    public ItemClickEvent(Component source, Item item, Object itemId,
            Object propertyId, MouseEventDetails details) {
        super(source, details);
        this.item = item;
        this.itemId = itemId;
        this.propertyId = propertyId;
    }

    /**
     * Gets the item on which the click event occurred.
     *
     * @return item which was clicked
     */
    public Item getItem() {
        return item;
    }

    /**
     * Gets a possible identifier in source for clicked Item.
     *
     * @return
     */
    public Object getItemId() {
        return itemId;
    }

    /**
     * Returns property on which click event occurred. Returns null if source
     * cannot be resolved at property level. For example if clicked a cell in
     * table, the "column id" is returned.
     *
     * @return a property id of clicked property or null if click didn't occur
     *         on any distinct property.
     */
    public Object getPropertyId() {
        return propertyId;
    }

    public static final Method ITEM_CLICK_METHOD;

    static {
        try {
            ITEM_CLICK_METHOD = ItemClickListener.class.getDeclaredMethod(
                    "itemClick", new Class[] { ItemClickEvent.class });
        } catch (final NoSuchMethodException e) {
            // This should never happen
            throw new RuntimeException();
        }
    }

    @Deprecated
    public interface ItemClickListener extends SerializableEventListener {
        public void itemClick(ItemClickEvent event);
    }

    /**
     * The interface for adding and removing ItemClickEvent
     * listeners. By implementing this interface a class explicitly announces
     * that it will generate an ItemClickEvent when one of its
     * items is clicked.
     * 
     * Note: The general Java convention is not to explicitly declare that a
     * class generates events, but to directly define the
     * addListener and removeListener methods. That
     * way the caller of these methods has no real way of finding out if the
     * class really will send the events, or if it just defines the methods to
     * be able to implement an interface.
     * 
     *
     * @since 6.5
     * @see ItemClickListener
     * @see ItemClickEvent
     */
    @Deprecated
    public interface ItemClickNotifier extends Serializable {
        /**
         * Register a listener to handle {@link ItemClickEvent}s.
         *
         * @param listener
         *            ItemClickListener to be registered
         */
        public void addItemClickListener(ItemClickListener listener);

        /**
         * @deprecated As of 7.0, replaced by
         *             {@link #addItemClickListener(ItemClickListener)}
         */
        @Deprecated
        public void addListener(ItemClickListener listener);

        /**
         * Removes an ItemClickListener.
         *
         * @param listener
         *            ItemClickListener to be removed
         */
        public void removeItemClickListener(ItemClickListener listener);

        /**
         * @deprecated As of 7.0, replaced by
         *             {@link #removeItemClickListener(ItemClickListener)}
         */
        @Deprecated
        public void removeListener(ItemClickListener listener);
    }

}