blob: c0f04d362f82d559aefcaf1c4886748c751c0929 (
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
67
68
69
70
71
72
73
74
75
|
/*
@VaadinApache2LicenseForJavaFiles@
*/
/**
*
*/
package com.vaadin.event.dd.acceptcriteria;
import java.io.Serializable;
import com.vaadin.event.Transferable;
import com.vaadin.event.dd.DragAndDropEvent;
import com.vaadin.event.dd.DropHandler;
import com.vaadin.terminal.PaintException;
import com.vaadin.terminal.PaintTarget;
/**
* Criterion that can be used create policy to accept/discard dragged content
* (presented by {@link Transferable}).
*
* The drag and drop mechanism will verify the criteria returned by
* {@link DropHandler#getAcceptCriterion()} before calling
* {@link DropHandler#drop(DragAndDropEvent)}.
*
* The criteria can be evaluated either on the client (browser - see
* {@link ClientSideCriterion}) or on the server (see
* {@link ServerSideCriterion}). If no constraints are needed, an
* {@link AcceptAll} can be used.
*
* In addition to accepting or rejecting a possible drop, criteria can provide
* additional hints for client side painting.
*
* @see DropHandler
* @see ClientSideCriterion
* @see ServerSideCriterion
*
* @since 6.3
*/
public interface AcceptCriterion extends Serializable {
/**
* Returns whether the criteria can be checked on the client or whether a
* server request is needed to check the criteria.
*
* This requirement may depend on the state of the criterion (e.g. logical
* operations between criteria), so this cannot be based on a marker
* interface.
*/
public boolean isClientSideVerifiable();
public void paint(PaintTarget target) throws PaintException;
/**
* This needs to be implemented iff criterion does some lazy server side
* initialization. The UIDL painted in this method will be passed to client
* side drop handler implementation. Implementation can assume that
* {@link #accept(DragAndDropEvent)} is called before this method.
*
* @param target
* @throws PaintException
*/
public void paintResponse(PaintTarget target) throws PaintException;
/**
* Validates the data in event to be appropriate for the
* {@link DropHandler#drop(DragAndDropEvent)} method.
* <p>
* Note that even if your criterion is validated on client side, you should
* always validate the data on server side too.
*
* @param dragEvent
* @return
*/
public boolean accept(DragAndDropEvent dragEvent);
}
|
