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