org.milyn.javabean.decoders.DateDecoder Maven / Gradle / Ivy
The newest version!
/*
Milyn - Copyright (C) 2006 - 2010
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License (version 2.1) as published by the Free Software
Foundation.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Lesser General Public License for more details:
http://www.gnu.org/licenses/lgpl.txt
*/
package org.milyn.javabean.decoders;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import org.milyn.assertion.AssertArgument;
import org.milyn.javabean.DataDecodeException;
import org.milyn.javabean.DataDecoder;
import org.milyn.javabean.DataEncoder;
import org.milyn.javabean.DecodeType;
/**
* {@link java.util.Date} data decoder.
*
* Decodes the supplied string into a {@link java.util.Date} value
* based on the supplied "{@link java.text.SimpleDateFormat format}" parameter, or the default (see below).
*
* The default date format used is "yyyy-MM-dd'T'HH:mm:ss" (see {@link SimpleDateFormat}).
* This format is based on the ISO 8601
* standard as used by the XML Schema type "dateTime".
*
* This decoder is synchronized on its underlying {@link SimpleDateFormat} instance.
* @see LocaleAwareDateDecoder
*
* @author [email protected]
*/
@DecodeType(Date.class)
public class DateDecoder extends LocaleAwareDateDecoder implements DataDecoder, DataEncoder {
public Object decode(String data) throws DataDecodeException {
try {
// Must be sync'd - DateFormat is not synchronized.
synchronized(decoder) {
return decoder.parse(data.trim());
}
} catch (ParseException e) {
throw new DataDecodeException("Error decoding Date data value '" + data + "' with decode format '" + format + "'.", e);
}
}
public String encode(Object date) throws DataDecodeException {
AssertArgument.isNotNull(date, "date");
if(!(date instanceof Date)) {
throw new DataDecodeException("Cannot encode Object type '" + date.getClass().getName() + "'. Must be type '" + Date.class.getName() + "'.");
}
// Must be sync'd - DateFormat is not synchronized.
synchronized(decoder) {
return decoder.format((Date) date);
}
}
}