blob: 6f742e68d3a37acc749963d0d9e4bff53387b9a8 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
/*
@VaadinApache2LicenseForJavaFiles@
*/
package com.vaadin.event;
import java.util.Map;
import com.vaadin.data.Container;
import com.vaadin.ui.Component;
/**
* Parent class for {@link Transferable} implementations that have a Vaadin
* container as a data source. The transfer is associated with an item
* (identified by its Id) and optionally also a property identifier (e.g. a
* table column identifier when transferring a single table cell).
*
* The component must implement the interface
* {@link com.vaadin.data.Container.Viewer}.
*
* In most cases, receivers of data transfers should depend on this class
* instead of its concrete subclasses.
*
* @since 6.3
*/
public abstract class DataBoundTransferable extends TransferableImpl {
public DataBoundTransferable(Component sourceComponent,
Map<String, Object> rawVariables) {
super(sourceComponent, rawVariables);
}
/**
* Returns the identifier of the item being transferred.
*
* @return item identifier
*/
public abstract Object getItemId();
/**
* Returns the optional property identifier that the transfer concerns.
*
* This can be e.g. the table column from which a drag operation originated.
*
* @return property identifier
*/
public abstract Object getPropertyId();
/**
* Returns the container data source from which the transfer occurs.
*
* {@link com.vaadin.data.Container.Viewer#getContainerDataSource()} is used
* to obtain the underlying container of the source component.
*
* @return Container
*/
public Container getSourceContainer() {
Component sourceComponent = getSourceComponent();
if (sourceComponent instanceof Container.Viewer) {
return ((Container.Viewer) sourceComponent)
.getContainerDataSource();
} else {
// this should not happen
return null;
}
}
}
|