Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||
FieldBase |
|
| 1.6875;1.688 |
1 | /* | |
2 | * Copyright 2007 The Kuali Foundation | |
3 | * | |
4 | * Licensed under the Educational Community License, Version 1.0 (the "License"); | |
5 | * you may not use this file except in compliance with the License. | |
6 | * You may obtain a copy of the License at | |
7 | * | |
8 | * http://www.opensource.org/licenses/ecl1.php | |
9 | * | |
10 | * Unless required by applicable law or agreed to in writing, software | |
11 | * distributed under the License is distributed on an "AS IS" BASIS, | |
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
13 | * See the License for the specific language governing permissions and | |
14 | * limitations under the License. | |
15 | */ | |
16 | package org.kuali.rice.krad.uif.field; | |
17 | ||
18 | import org.apache.commons.lang.StringUtils; | |
19 | import org.kuali.rice.krad.uif.UifConstants.Position; | |
20 | import org.kuali.rice.krad.uif.container.View; | |
21 | import org.kuali.rice.krad.uif.core.Component; | |
22 | import org.kuali.rice.krad.uif.core.ComponentBase; | |
23 | import org.kuali.rice.krad.uif.util.ComponentFactory; | |
24 | ||
25 | import java.util.List; | |
26 | ||
27 | /** | |
28 | * Base class for <code>Field</code> implementations | |
29 | * | |
30 | * <p> | |
31 | * Sets the component type name so that all field templates have a fixed | |
32 | * contract | |
33 | * </p> | |
34 | * | |
35 | * <p> | |
36 | * Holds a nested <code>LabelField</code> with configuration for rendering the | |
37 | * label and configuration on label placement. | |
38 | * </p> | |
39 | * | |
40 | * @author Kuali Rice Team (rice.collab@kuali.org) | |
41 | */ | |
42 | public class FieldBase extends ComponentBase implements Field { | |
43 | private static final long serialVersionUID = -5888414844802862760L; | |
44 | ||
45 | private String shortLabel; | |
46 | ||
47 | private LabelField labelField; | |
48 | ||
49 | private String labelPlacement; | |
50 | private boolean labelFieldRendered; | |
51 | ||
52 | 0 | public FieldBase() { |
53 | 0 | labelFieldRendered = false; |
54 | ||
55 | 0 | labelPlacement = Position.LEFT; |
56 | 0 | } |
57 | ||
58 | /** | |
59 | * The following initialization is performed: | |
60 | * | |
61 | * <ul> | |
62 | * </ul> | |
63 | * | |
64 | * @see org.kuali.rice.krad.uif.core.ComponentBase#performInitialization(org.kuali.rice.krad.uif.container.View) | |
65 | */ | |
66 | @Override | |
67 | public void performInitialization(View view) { | |
68 | 0 | super.performInitialization(view); |
69 | 0 | } |
70 | ||
71 | /** | |
72 | * The following finalization is performed: | |
73 | * | |
74 | * <ul> | |
75 | * <li>Set the labelForComponentId to this component id</li> | |
76 | * <li>Set the label text on the label field from the field's label property | |
77 | * </li> | |
78 | * <li>Set the render property on the label's required message field if this | |
79 | * field is marked as required</li> | |
80 | * <li>If label placement is right, set render colon to false</li> | |
81 | * </ul> | |
82 | * | |
83 | * @see org.kuali.rice.krad.uif.core.ComponentBase#performFinalize(org.kuali.rice.krad.uif.container.View, | |
84 | * java.lang.Object, org.kuali.rice.krad.uif.core.Component) | |
85 | */ | |
86 | @Override | |
87 | public void performFinalize(View view, Object model, Component parent) { | |
88 | 0 | super.performFinalize(view, model, parent); |
89 | ||
90 | 0 | if (labelField != null) { |
91 | 0 | labelField.setLabelForComponentId(this.getId()); |
92 | ||
93 | 0 | if ((getRequired() != null) && getRequired().booleanValue()) { |
94 | 0 | labelField.getRequiredMessageField().setRender(true); |
95 | } | |
96 | else { | |
97 | 0 | setRequired(new Boolean(false)); |
98 | 0 | labelField.getRequiredMessageField().setRender(true); |
99 | 0 | String prefixStyle = ""; |
100 | 0 | if(StringUtils.isNotBlank(labelField.getRequiredMessageField().getStyle())){ |
101 | 0 | prefixStyle = labelField.getRequiredMessageField().getStyle(); |
102 | } | |
103 | 0 | labelField.getRequiredMessageField().setStyle(prefixStyle + ";" + "display: none;"); |
104 | } | |
105 | ||
106 | 0 | if (StringUtils.equals(labelPlacement, Position.RIGHT)) { |
107 | 0 | labelField.setRenderColon(false); |
108 | } | |
109 | } | |
110 | 0 | } |
111 | ||
112 | /** | |
113 | * @see org.kuali.rice.krad.uif.core.Component#getComponentTypeName() | |
114 | */ | |
115 | @Override | |
116 | public final String getComponentTypeName() { | |
117 | 0 | return "field"; |
118 | } | |
119 | ||
120 | /** | |
121 | * @see org.kuali.rice.krad.uif.core.ComponentBase#getNestedComponents() | |
122 | */ | |
123 | @Override | |
124 | public List<Component> getNestedComponents() { | |
125 | 0 | List<Component> components = super.getNestedComponents(); |
126 | ||
127 | 0 | components.add(labelField); |
128 | ||
129 | 0 | return components; |
130 | } | |
131 | ||
132 | /** | |
133 | * @see org.kuali.rice.krad.uif.field.Field#getLabel() | |
134 | */ | |
135 | public String getLabel() { | |
136 | 0 | if (labelField != null) { |
137 | 0 | return labelField.getLabelText(); |
138 | } | |
139 | ||
140 | 0 | return null; |
141 | } | |
142 | ||
143 | /** | |
144 | * @see org.kuali.rice.krad.uif.field.Field#setLabel(java.lang.String) | |
145 | */ | |
146 | public void setLabel(String label) { | |
147 | 0 | if (StringUtils.isNotBlank(label) && labelField == null) { |
148 | 0 | labelField = ComponentFactory.getLabelField(); |
149 | } | |
150 | ||
151 | 0 | if (labelField != null) { |
152 | 0 | labelField.setLabelText(label); |
153 | } | |
154 | 0 | } |
155 | ||
156 | /** | |
157 | * @see org.kuali.rice.krad.uif.field.Field#getShortLabel() | |
158 | */ | |
159 | public String getShortLabel() { | |
160 | 0 | return this.shortLabel; |
161 | } | |
162 | ||
163 | /** | |
164 | * @see org.kuali.rice.krad.uif.field.Field#setShortLabel(java.lang.String) | |
165 | */ | |
166 | public void setShortLabel(String shortLabel) { | |
167 | 0 | this.shortLabel = shortLabel; |
168 | 0 | } |
169 | ||
170 | /** | |
171 | * Sets whether the label should be displayed | |
172 | * | |
173 | * <p> | |
174 | * Convenience method for configuration that sets the render indicator on | |
175 | * the fields <code>LabelField</code> instance | |
176 | * </p> | |
177 | * | |
178 | * @param showLabel | |
179 | * boolean true if label should be displayed, false if the label | |
180 | * should not be displayed | |
181 | */ | |
182 | public void setShowLabel(boolean showLabel) { | |
183 | 0 | if (labelField != null) { |
184 | 0 | labelField.setRender(showLabel); |
185 | } | |
186 | 0 | } |
187 | ||
188 | /** | |
189 | * @see org.kuali.rice.krad.uif.field.Field#getLabelField() | |
190 | */ | |
191 | public LabelField getLabelField() { | |
192 | 0 | return this.labelField; |
193 | } | |
194 | ||
195 | /** | |
196 | * @see org.kuali.rice.krad.uif.field.Field#setLabelField(org.kuali.rice.krad.uif.field.LabelField) | |
197 | */ | |
198 | public void setLabelField(LabelField labelField) { | |
199 | 0 | this.labelField = labelField; |
200 | 0 | } |
201 | ||
202 | public String getLabelPlacement() { | |
203 | 0 | return this.labelPlacement; |
204 | } | |
205 | ||
206 | public void setLabelPlacement(String labelPlacement) { | |
207 | 0 | this.labelPlacement = labelPlacement; |
208 | 0 | } |
209 | ||
210 | /** | |
211 | * @see org.kuali.rice.krad.uif.field.Field#isLabelFieldRendered() | |
212 | */ | |
213 | public boolean isLabelFieldRendered() { | |
214 | 0 | return this.labelFieldRendered; |
215 | } | |
216 | ||
217 | /** | |
218 | * @see org.kuali.rice.krad.uif.field.Field#setLabelFieldRendered(boolean) | |
219 | */ | |
220 | public void setLabelFieldRendered(boolean labelFieldRendered) { | |
221 | 0 | this.labelFieldRendered = labelFieldRendered; |
222 | 0 | } |
223 | } |