io.guise.framework.converter.DateStringLiteralConverter Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of guise-framework Show documentation

Guise™ Internet application framework.

There is a newer version: 0.5.3

/*
 * Copyright © 2005-2008 GlobalMentor, Inc. 
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package io.guise.framework.converter;

import java.text.*;
import java.util.*;

/**
 * An object that can convert a date/time from and to a string. This implementation caches a date format and only creates a new one if the locale has changed.
 * This implementation synchronizes all conversions on the {@link DateFormat} object.
 * @author Garret Wilson
 */
public class DateStringLiteralConverter extends AbstractDateStringLiteralConverter {

	/**
	 * Date style constructor with no time style.
	 * @param dateStyle The date representation style, or null if the date should not be represented.
	 * @throws NullPointerException if the given date style is null.
	 */
	public DateStringLiteralConverter(final DateStringLiteralStyle dateStyle) {
		this(dateStyle, null); //construct the class with no time style
	}

	/**
	 * Date style and time style constructor.
	 * @param dateStyle The date representation style, or null if the date should not be represented.
	 * @param timeStyle The time representation style, or null if the time should not be represented.
	 * @throws NullPointerException if both the given date style and time style are null.
	 */
	public DateStringLiteralConverter(final DateStringLiteralStyle dateStyle, final TimeStringLiteralStyle timeStyle) {
		super(dateStyle, timeStyle); //construct the parent class
	}

	/**
	 * {@inheritDoc}
	 * 
	 * This implementation converts the value using the date format object. This implementation synchronizes on the {@link DateFormat} instance.
	 * 
	 * @see #getDateFormat()
	 */
	@Override
	public String convertValue(final Date value) throws ConversionException {
		return convertDateValue(value); //convert the date to a string
	}

	/**
	 * {@inheritDoc}
	 * 
	 * This implementation converts the empty string to a null value.
	 * 
	 */
	@Override
	public Date convertLiteral(final String literal) throws ConversionException {
		return convertDateLiteral(literal); //convert the string to a date
	}
}