1 /* 2 * Copyright 2001-2005 Stephen Colebourne 3 * 4 * Licensed under the Apache 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.apache.org/licenses/LICENSE-2.0 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.joda.time.field; 17 18 import org.joda.time.DateTimeField; 19 20 /** 21 * Converts a lenient DateTimeField into a strict one. By being strict, the set 22 * throws an IllegalArgumentException if the value is out of bounds. 23 * <p> 24 * StrictDateTimeField is thread-safe and immutable. 25 * 26 * @author Brian S O'Neill 27 * @see org.joda.time.chrono.StrictChronology 28 * @see LenientDateTimeField 29 * @since 1.0 30 */ 31 public class StrictDateTimeField extends DelegatedDateTimeField { 32 33 private static final long serialVersionUID = 3154803964207950910L; 34 35 /** 36 * Returns a strict version of the given field. If it is already strict, 37 * then it is returned as-is. Otherwise, a new StrictDateTimeField is 38 * returned. 39 */ 40 public static DateTimeField getInstance(DateTimeField field) { 41 if (field == null) { 42 return null; 43 } 44 if (field instanceof LenientDateTimeField) { 45 field = ((LenientDateTimeField)field).getWrappedField(); 46 } 47 if (!field.isLenient()) { 48 return field; 49 } 50 return new StrictDateTimeField(field); 51 } 52 53 protected StrictDateTimeField(DateTimeField field) { 54 super(field); 55 } 56 57 public final boolean isLenient() { 58 return false; 59 } 60 61 /** 62 * Does a bounds check before setting the value. 63 * 64 * @throws IllegalArgumentException if the value is invalid 65 */ 66 public long set(long instant, int value) { 67 FieldUtils.verifyValueBounds 68 (this, value, getMinimumValue(instant), getMaximumValue(instant)); 69 return super.set(instant, value); 70 } 71 }