Statistics
| Revision:

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 40559 jjdelcerro
/**
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 40435 jjdelcerro
package org.gvsig.fmap.dal.feature;
25
26
import org.gvsig.fmap.dal.exception.DataException;
27 44871 jjdelcerro
import org.gvsig.tools.persistence.Persistent;
28 40435 jjdelcerro
29
/**
30
 * Represents a Feature validation rule. These rules are used to
31
 * check Feature state integrity in editing mode.
32 41341 jjdelcerro
 *
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 40435 jjdelcerro
 *
38
 */
39 44871 jjdelcerro
public interface FeatureRule extends Persistent{
40 40435 jjdelcerro
41 47378 jjdelcerro
        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 40435 jjdelcerro
        /**
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 45739 jjdelcerro
        public void validate(EditableFeature feature, FeatureStore featureStore)
71 40435 jjdelcerro
                        throws DataException;
72
73
        /**
74
         * Indicates whether this rule should be checked at update.
75
         *
76 41341 jjdelcerro
         * Only in this rules can be updated the feature in the store.
77
         *
78 40435 jjdelcerro
         * @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 41341 jjdelcerro
         * In this rules, can't be updated any feature in the store.
87
         *
88 40435 jjdelcerro
         * @return
89
         *                 true if this rule should be applied when editing is being finished, otherwise false.
90
         */
91
        public boolean checkAtFinishEditing();
92 47378 jjdelcerro
93
        public boolean checkWhen(int mask);
94 40435 jjdelcerro
}