1 /*
2  * JasperReports - Free Java Reporting Library.
3  * Copyright (C) 2001 - 2019 TIBCO Software Inc. All rights reserved.
4  * http://www.jaspersoft.com
5  *
6  * Unless you have purchased a commercial license agreement from Jaspersoft,
7  * the following license terms apply:
8  *
9  * This program is part of JasperReports.
10  *
11  * JasperReports is free software: you can redistribute it and/or modify
12  * it under the terms of the GNU Lesser General Public License as published by
13  * the Free Software Foundation, either version 3 of the License, or
14  * (at your option) any later version.
15  *
16  * JasperReports is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19  * GNU Lesser General Public License for more details.
20  *
21  * You should have received a copy of the GNU Lesser General Public License
22  * along with JasperReports. If not, see <http://www.gnu.org/licenses/>.
23  */
24 package net.sf.jasperreports.engine.type;
25
26 import net.sf.jasperreports.annotations.properties.Property;
27 import net.sf.jasperreports.annotations.properties.PropertyScope;
28 import net.sf.jasperreports.engine.JRParameter;
29 import net.sf.jasperreports.engine.JRPropertiesUtil;
30 import net.sf.jasperreports.properties.PropertyConstants;
31
32 /**
33  * Defines specific moments in time when the default value expression of a parameter is supposed to be evaluated.
34  * @author Teodor Danciu (teodord@users.sourceforge.net)
35  */
36 public enum ParameterEvaluationTimeEnum implements NamedEnum
37 {
38     /**
39      * Evaluate the parameter default value expression before parameter contributors.
40      */
41     EARLY("Early"),
42     /**
43      * Evaluate the parameter default value expression after parameter contributors.
44      */
45     LATE("Late");
46     
47     /**
48      * Provides a default value for the {@link JRParameter#getEvaluationTime()} property of parameters and can be set either globally or at dataset level.
49      */
50     @Property(
51             category = PropertyConstants.CATEGORY_FILL,
52             defaultValue = "Late",
53             scopes = {PropertyScope.CONTEXT, PropertyScope.DATASET},
54             sinceVersion = PropertyConstants.VERSION_6_3_1,
55             valueType = ParameterEvaluationTimeEnum.class
56             )
57     public static final String PROPERTY_EVALUATION_TIME = JRPropertiesUtil.PROPERTY_PREFIX + "parameter.evaluation.time";
58
59     private final String name;
60     
61     private ParameterEvaluationTimeEnum(String name)
62     {
63         this.name = name;
64     }
65
66     @Override
67     public String getName()
68     {
69         return name;
70     }
71
72     public static ParameterEvaluationTimeEnum byName(String name)
73     {
74         return EnumUtil.getEnumByName(values(), name);
75     }
76 }
77