01: /*
02: * Copyright 2001-2005 Stephen Colebourne
03: *
04: * Licensed under the Apache License, Version 2.0 (the "License");
05: * you may not use this file except in compliance with the License.
06: * You may obtain a copy of the License at
07: *
08: * http://www.apache.org/licenses/LICENSE-2.0
09: *
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(this, value,
68: getMinimumValue(instant), getMaximumValue(instant));
69: return super.set(instant, value);
70: }
71: }
|