svn-gvsig-desktop / trunk / org.gvsig.desktop / org.gvsig.desktop.compat.cdc / org.gvsig.fmap.dal / org.gvsig.fmap.dal.api / src / main / java / org / gvsig / fmap / dal / feature / FeatureRule.java @ 47378
History | View | Annotate | Download (3.04 KB)
1 |
/**
|
---|---|
2 |
* gvSIG. Desktop Geographic Information System.
|
3 |
*
|
4 |
* Copyright (C) 2007-2013 gvSIG Association.
|
5 |
*
|
6 |
* This program is free software; you can redistribute it and/or
|
7 |
* modify it under the terms of the GNU General Public License
|
8 |
* as published by the Free Software Foundation; either version 3
|
9 |
* of the License, or (at your option) any later version.
|
10 |
*
|
11 |
* This program is distributed in the hope that it will be useful,
|
12 |
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13 |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14 |
* GNU General Public License for more details.
|
15 |
*
|
16 |
* You should have received a copy of the GNU General Public License
|
17 |
* along with this program; if not, write to the Free Software
|
18 |
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
|
19 |
* MA 02110-1301, USA.
|
20 |
*
|
21 |
* For any additional information, do not hesitate to contact us
|
22 |
* at info AT gvsig.com, or visit our website www.gvsig.com.
|
23 |
*/
|
24 |
package org.gvsig.fmap.dal.feature; |
25 |
|
26 |
import org.gvsig.fmap.dal.exception.DataException; |
27 |
import org.gvsig.tools.persistence.Persistent; |
28 |
|
29 |
/**
|
30 |
* Represents a Feature validation rule. These rules are used to
|
31 |
* check Feature state integrity in editing mode.
|
32 |
*
|
33 |
* Desde una rule que se ejecuta en el UPDATE podemos ejecutar un
|
34 |
* update de esta feature en el store. Pero si la rule se ejecuta
|
35 |
* en el FINISH_EDITING no es posible hacer update de ninguna feature
|
36 |
* del store.
|
37 |
*
|
38 |
*/
|
39 |
public interface FeatureRule extends Persistent{ |
40 |
|
41 |
public static final int CHECK_WHEN_FINISH_EDITING = 1; |
42 |
public static final int CHECK_WHEN_INSERT_OR_UPDATE_FEATURE = 2; |
43 |
public static final int CHECK_WHEN_USER_EDIT_FEATURE = 4; |
44 |
|
45 |
/**
|
46 |
* Returns the rule name
|
47 |
*
|
48 |
* @return
|
49 |
* the rule name
|
50 |
*/
|
51 |
public String getName(); |
52 |
|
53 |
/**
|
54 |
* Returns the rule description
|
55 |
*
|
56 |
* @return
|
57 |
* the rule description
|
58 |
*/
|
59 |
public String getDescription(); |
60 |
|
61 |
/**
|
62 |
* This is the method that applies this rule to the {@link Feature}, given also its associated {@link FeatureStore}.
|
63 |
* @param feature
|
64 |
* Feature to which apply the rule
|
65 |
* @param featureStore
|
66 |
* FeatureStore to which the Feature belongs
|
67 |
* @throws DataException
|
68 |
* if an error occurs during validation
|
69 |
*/
|
70 |
public void validate(EditableFeature feature, FeatureStore featureStore) |
71 |
throws DataException;
|
72 |
|
73 |
/**
|
74 |
* Indicates whether this rule should be checked at update.
|
75 |
*
|
76 |
* Only in this rules can be updated the feature in the store.
|
77 |
*
|
78 |
* @return
|
79 |
* true if this rule should be checked at update, otherwise false.
|
80 |
*/
|
81 |
public boolean checkAtUpdate(); |
82 |
|
83 |
/**
|
84 |
* Returns true if this rule should be applied just when editing is being finished.
|
85 |
*
|
86 |
* In this rules, can't be updated any feature in the store.
|
87 |
*
|
88 |
* @return
|
89 |
* true if this rule should be applied when editing is being finished, otherwise false.
|
90 |
*/
|
91 |
public boolean checkAtFinishEditing(); |
92 |
|
93 |
public boolean checkWhen(int mask); |
94 |
} |