View Javadoc

1   /**
2    * Copyright 2005-2014 The Kuali Foundation
3    *
4    * Licensed under the Educational Community License, Version 2.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/ecl2.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.datadictionary.validation.processor;
17  
18  import org.kuali.rice.core.api.uif.DataType;
19  import org.kuali.rice.core.api.util.RiceKeyConstants;
20  import org.kuali.rice.krad.datadictionary.exception.AttributeValidationException;
21  import org.kuali.rice.krad.datadictionary.validation.AttributeValueReader;
22  import org.kuali.rice.krad.datadictionary.validation.ValidationUtils;
23  import org.kuali.rice.krad.datadictionary.validation.ValidationUtils.Result;
24  import org.kuali.rice.krad.datadictionary.validation.constraint.Constraint;
25  import org.kuali.rice.krad.datadictionary.validation.constraint.LengthConstraint;
26  import org.kuali.rice.krad.datadictionary.validation.result.ConstraintValidationResult;
27  import org.kuali.rice.krad.datadictionary.validation.result.DictionaryValidationResult;
28  import org.kuali.rice.krad.datadictionary.validation.result.ProcessorResult;
29  
30  /**
31   * @author Kuali Rice Team (rice.collab@kuali.org)
32   */
33  public class LengthConstraintProcessor extends MandatoryElementConstraintProcessor<LengthConstraint> {
34  
35      private static final String MIN_LENGTH_KEY = "validation.minLengthConditional";
36      private static final String MAX_LENGTH_KEY = "validation.maxLengthConditional";
37      private static final String RANGE_KEY = "validation.lengthRange";
38  
39      private static final String CONSTRAINT_NAME = "length constraint";
40  
41      /**
42       * @see org.kuali.rice.krad.datadictionary.validation.processor.ConstraintProcessor#process(org.kuali.rice.krad.datadictionary.validation.result.DictionaryValidationResult,
43       *      Object, org.kuali.rice.krad.datadictionary.validation.constraint.Constraint,
44       *      org.kuali.rice.krad.datadictionary.validation.AttributeValueReader)
45       */
46      @Override
47      public ProcessorResult process(DictionaryValidationResult result, Object value, LengthConstraint constraint,
48              AttributeValueReader attributeValueReader) throws AttributeValidationException {
49  
50          // To accommodate the needs of other processors, the ConstraintProcessor.process() method returns a list of ConstraintValidationResult objects
51          // but since a definition that is length constrained only constrains a single field, there is effectively always a single constraint
52          // being imposed
53          return new ProcessorResult(processSingleLengthConstraint(result, value, constraint, attributeValueReader));
54      }
55  
56      @Override
57      public String getName() {
58          return CONSTRAINT_NAME;
59      }
60  
61      /**
62       * @see org.kuali.rice.krad.datadictionary.validation.processor.ConstraintProcessor#getConstraintType()
63       */
64      @Override
65      public Class<? extends Constraint> getConstraintType() {
66          return LengthConstraint.class;
67      }
68  
69      protected ConstraintValidationResult processSingleLengthConstraint(DictionaryValidationResult result, Object value,
70              LengthConstraint constraint,
71              AttributeValueReader attributeValueReader) throws AttributeValidationException {
72          // Can't process any range constraints on null values
73          if (ValidationUtils.isNullOrEmpty(value)) {
74              return result.addSkipped(attributeValueReader, CONSTRAINT_NAME);
75          }
76  
77          DataType dataType = constraint.getDataType();
78          Object typedValue = value;
79  
80          if (dataType != null) {
81              typedValue = ValidationUtils.convertToDataType(value, dataType, dateTimeService);
82          }
83  
84          // The only thing that can have a length constraint currently is a string.
85          if (typedValue instanceof String) {
86              return validateLength(result, (String) typedValue, constraint, attributeValueReader);
87          }
88  
89          return result.addSkipped(attributeValueReader, CONSTRAINT_NAME);
90      }
91  
92      protected ConstraintValidationResult validateLength(DictionaryValidationResult result, String value,
93              LengthConstraint constraint, AttributeValueReader attributeValueReader) throws IllegalArgumentException {
94          Integer valueLength = Integer.valueOf(value.length());
95  
96          Integer maxLength = constraint.getMaxLength();
97          Integer minLength = constraint.getMinLength();
98  
99          Result lessThanMax = ValidationUtils.isLessThanOrEqual(valueLength, maxLength);
100         Result greaterThanMin = ValidationUtils.isGreaterThanOrEqual(valueLength, minLength);
101 
102         // It's okay for one end of the range to be undefined - that's not an error. It's only an error if one of them is invalid 
103         if (lessThanMax != Result.INVALID && greaterThanMin != Result.INVALID) {
104             // Of course, if they're both undefined then we didn't actually have a real constraint
105             if (lessThanMax == Result.UNDEFINED && greaterThanMin == Result.UNDEFINED) {
106                 return result.addNoConstraint(attributeValueReader, CONSTRAINT_NAME);
107             }
108 
109             // In this case, we've succeeded
110             return result.addSuccess(attributeValueReader, CONSTRAINT_NAME);
111         }
112 
113         String maxErrorParameter = maxLength != null ? maxLength.toString() : null;
114         String minErrorParameter = minLength != null ? minLength.toString() : null;
115 
116         // If both comparisons happened then if either comparison failed we can show the end user the expected range on both sides.
117         if (lessThanMax != Result.UNDEFINED && greaterThanMin != Result.UNDEFINED) {
118             return result.addError(RANGE_KEY, attributeValueReader, CONSTRAINT_NAME,
119                     RiceKeyConstants.ERROR_OUT_OF_RANGE, minErrorParameter, maxErrorParameter);
120         }
121         // If it's the max comparison that fails, then just tell the end user what the max can be
122         else if (lessThanMax == Result.INVALID) {
123             return result.addError(MAX_LENGTH_KEY, attributeValueReader, CONSTRAINT_NAME,
124                     RiceKeyConstants.ERROR_INCLUSIVE_MAX, maxErrorParameter);
125         }
126         // Otherwise, just tell them what the min can be
127         else {
128             return result.addError(MIN_LENGTH_KEY, attributeValueReader, CONSTRAINT_NAME,
129                     RiceKeyConstants.ERROR_EXCLUSIVE_MIN, minErrorParameter);
130         }
131 
132     }
133 
134 }