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.core.api.criteria;
17  
18  import org.kuali.rice.core.api.CoreConstants;
19  import org.w3c.dom.Element;
20  
21  import javax.xml.bind.annotation.XmlAccessType;
22  import javax.xml.bind.annotation.XmlAccessorType;
23  import javax.xml.bind.annotation.XmlAnyElement;
24  import javax.xml.bind.annotation.XmlAttribute;
25  import javax.xml.bind.annotation.XmlElement;
26  import javax.xml.bind.annotation.XmlElements;
27  import javax.xml.bind.annotation.XmlRootElement;
28  import javax.xml.bind.annotation.XmlType;
29  
30  import java.util.Collection;
31  
32  /**
33   * An immutable predicate which represents a "greater than" statement which is
34   * evaluated the {@link CriteriaValue} of this predicate.
35   * 
36   * @see PredicateFactory for a convenient way to construct this class.
37   * 
38   * @author Kuali Rice Team (rice.collab@kuali.org)
39   * 
40   */
41  @XmlRootElement(name = GreaterThanPredicate.Constants.ROOT_ELEMENT_NAME)
42  @XmlAccessorType(XmlAccessType.NONE)
43  @XmlType(name = GreaterThanPredicate.Constants.TYPE_NAME, propOrder = {
44      CriteriaSupportUtils.PropertyConstants.VALUE,
45      CoreConstants.CommonElements.FUTURE_ELEMENTS
46  })
47  public final class GreaterThanPredicate extends AbstractPredicate implements SingleValuedPredicate {
48  	    
49  	private static final long serialVersionUID = 2576163857285296720L;
50  	
51  	@XmlAttribute(name = CriteriaSupportUtils.PropertyConstants.PROPERTY_PATH)
52  	private final String propertyPath;
53  
54  	@XmlElements(value = {
55              @XmlElement(name = CriteriaStringValue.Constants.ROOT_ELEMENT_NAME, type = CriteriaStringValue.class, required = true),
56              @XmlElement(name = CriteriaPropertyPathValue.Constants.ROOT_ELEMENT_NAME, type = CriteriaPropertyPathValue.class, required = true),
57  			@XmlElement(name = CriteriaDecimalValue.Constants.ROOT_ELEMENT_NAME, type = CriteriaDecimalValue.class, required = true),
58              @XmlElement(name = CriteriaKualiDecimalValue.Constants.ROOT_ELEMENT_NAME, type = CriteriaKualiDecimalValue.class, required = true),
59              @XmlElement(name = CriteriaKualiPercentValue.Constants.ROOT_ELEMENT_NAME, type = CriteriaKualiPercentValue.class, required = true),
60              @XmlElement(name = CriteriaKualiIntegerValue.Constants.ROOT_ELEMENT_NAME, type = CriteriaKualiIntegerValue.class, required = true),
61              @XmlElement(name = CriteriaIntegerValue.Constants.ROOT_ELEMENT_NAME, type = CriteriaIntegerValue.class, required = true),
62              @XmlElement(name = CriteriaDateTimeValue.Constants.ROOT_ELEMENT_NAME, type = CriteriaDateTimeValue.class, required = true)
63      })
64  	private final CriteriaValue<?> value;
65  
66      @SuppressWarnings("unused")
67      @XmlAnyElement
68      private final Collection<Element> _futureElements = null;
69  
70  	/**
71       * Should only be invoked by JAXB.
72       */
73      @SuppressWarnings("unused")
74      private GreaterThanPredicate() {
75          this.propertyPath = null;
76          this.value = null;
77      }
78      
79      /**
80  	 * Constructs a GreaterThanPredicate for the given path and value.  GreaterThanPredicate supports the following {@link CriteriaValue}:
81  	 * 
82  	 * <ul>
83  	 *   <li>{@link CriteriaDateTimeValue}</li>
84  	 *   <li>{@link CriteriaDecimalValue}</li>
85  	 *   <li>{@link CriteriaIntegerValue}</li>
86  	 * </ul>
87  	 * 
88  	 * @param propertyPath the property path for the predicate, must not be null or blank
89  	 * @param value the value to evaluation the path against, must not be null.
90  	 * 
91  	 * @throws IllegalArgumentException if the propertyPath is null or blank
92  	 * @throws IllegalArgumentException if the value is null
93  	 * @throws IllegalArgumentException if this predicate does not support the given type of {@link CriteriaValue}
94  	 */
95      GreaterThanPredicate(String propertyPath, CriteriaValue<?> value) {
96      	CriteriaSupportUtils.validateValuedConstruction(getClass(), propertyPath, value);
97  		this.propertyPath = propertyPath;
98  		this.value = value;
99      }
100     
101     @Override
102     public String getPropertyPath() {
103     	return propertyPath;
104     }
105     
106 	@Override
107 	public CriteriaValue<?> getValue() {
108 		return value;
109 	}
110     
111 	/**
112      * Defines some internal constants used on this class.
113      */
114     static class Constants {
115         final static String ROOT_ELEMENT_NAME = "greaterThan";
116         final static String TYPE_NAME = "GreaterThanType";
117     }
118 
119     @Override
120     public String toString() {
121         return CriteriaSupportUtils.toString(this);
122     }
123 }