aboutsummaryrefslogtreecommitdiffstats
path: root/src/com/vaadin/data/Item.java
diff options
context:
space:
mode:
authorArtur Signell <artur@vaadin.com>2012-08-13 18:34:33 +0300
committerArtur Signell <artur@vaadin.com>2012-08-13 19:18:33 +0300
commite85d933b25cc3c5cc85eb7eb4b13b950fd8e1569 (patch)
tree9ab6f13f7188cab44bbd979b1cf620f15328a03f /src/com/vaadin/data/Item.java
parent14dd4d0b28c76eb994b181a4570f3adec53342e6 (diff)
downloadvaadin-framework-e85d933b25cc3c5cc85eb7eb4b13b950fd8e1569.tar.gz
vaadin-framework-e85d933b25cc3c5cc85eb7eb4b13b950fd8e1569.zip
Moved server files to a server src folder (#9299)
Diffstat (limited to 'src/com/vaadin/data/Item.java')
-rw-r--r--src/com/vaadin/data/Item.java180
1 files changed, 0 insertions, 180 deletions
diff --git a/src/com/vaadin/data/Item.java b/src/com/vaadin/data/Item.java
deleted file mode 100644
index 98b95aecff..0000000000
--- a/src/com/vaadin/data/Item.java
+++ /dev/null
@@ -1,180 +0,0 @@
-/*
-@VaadinApache2LicenseForJavaFiles@
- */
-
-package com.vaadin.data;
-
-import java.io.Serializable;
-import java.util.Collection;
-
-/**
- * <p>
- * Provides a mechanism for handling a set of Properties, each associated to a
- * locally unique non-null identifier. The interface is split into subinterfaces
- * to enable a class to implement only the functionalities it needs.
- * </p>
- *
- * @author Vaadin Ltd
- * @version
- * @VERSION@
- * @since 3.0
- */
-public interface Item extends Serializable {
-
- /**
- * Gets the Property corresponding to the given Property ID stored in the
- * Item. If the Item does not contain the Property, <code>null</code> is
- * returned.
- *
- * @param id
- * identifier of the Property to get
- * @return the Property with the given ID or <code>null</code>
- */
- public Property<?> getItemProperty(Object id);
-
- /**
- * Gets the collection of IDs of all Properties stored in the Item.
- *
- * @return unmodifiable collection containing IDs of the Properties stored
- * the Item
- */
- public Collection<?> getItemPropertyIds();
-
- /**
- * Tries to add a new Property into the Item.
- *
- * <p>
- * This functionality is optional.
- * </p>
- *
- * @param id
- * ID of the new Property
- * @param property
- * the Property to be added and associated with the id
- * @return <code>true</code> if the operation succeeded, <code>false</code>
- * if not
- * @throws UnsupportedOperationException
- * if the operation is not supported.
- */
- public boolean addItemProperty(Object id, Property property)
- throws UnsupportedOperationException;
-
- /**
- * Removes the Property identified by ID from the Item.
- *
- * <p>
- * This functionality is optional.
- * </p>
- *
- * @param id
- * ID of the Property to be removed
- * @return <code>true</code> if the operation succeeded
- * @throws UnsupportedOperationException
- * if the operation is not supported. <code>false</code> if not
- */
- public boolean removeItemProperty(Object id)
- throws UnsupportedOperationException;
-
- /**
- * Interface implemented by viewer classes capable of using an Item as a
- * data source.
- */
- public interface Viewer extends Serializable {
-
- /**
- * Sets the Item that serves as the data source of the viewer.
- *
- * @param newDataSource
- * The new data source Item
- */
- public void setItemDataSource(Item newDataSource);
-
- /**
- * Gets the Item serving as the data source of the viewer.
- *
- * @return data source Item
- */
- public Item getItemDataSource();
- }
-
- /**
- * Interface implemented by the <code>Editor</code> classes capable of
- * editing the Item. Implementing this interface means that the Item serving
- * as the data source of the editor can be modified through it.
- * <p>
- * Note : Not implementing the <code>Item.Editor</code> interface does not
- * restrict the class from editing the contents of an internally.
- * </p>
- */
- public interface Editor extends Item.Viewer, Serializable {
-
- }
-
- /* Property set change event */
-
- /**
- * An <code>Event</code> object specifying the Item whose contents has been
- * changed through the <code>Property</code> interface.
- * <p>
- * Note: The values stored in the Properties may change without triggering
- * this event.
- * </p>
- */
- public interface PropertySetChangeEvent extends Serializable {
-
- /**
- * Retrieves the Item whose contents has been modified.
- *
- * @return source Item of the event
- */
- public Item getItem();
- }
-
- /**
- * The listener interface for receiving <code>PropertySetChangeEvent</code>
- * objects.
- */
- public interface PropertySetChangeListener extends Serializable {
-
- /**
- * Notifies this listener that the Item's property set has changed.
- *
- * @param event
- * Property set change event object
- */
- public void itemPropertySetChange(Item.PropertySetChangeEvent event);
- }
-
- /**
- * The interface for adding and removing <code>PropertySetChangeEvent</code>
- * listeners. By implementing this interface a class explicitly announces
- * that it will generate a <code>PropertySetChangeEvent</code> when its
- * Property set is modified.
- * <p>
- * Note : The general Java convention is not to explicitly declare that a
- * class generates events, but to directly define the
- * <code>addListener</code> and <code>removeListener</code> 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.
- * </p>
- */
- public interface PropertySetChangeNotifier extends Serializable {
-
- /**
- * Registers a new property set change listener for this Item.
- *
- * @param listener
- * The new Listener to be registered.
- */
- public void addListener(Item.PropertySetChangeListener listener);
-
- /**
- * Removes a previously registered property set change listener.
- *
- * @param listener
- * Listener to be removed.
- */
- public void removeListener(Item.PropertySetChangeListener listener);
- }
-}