google-nomulus/java/google/registry/xml/DateAdapter.java
Michael Muller c458c05801 Rename Java packages to use the .google TLD
The dark lord Gosling designed the Java package naming system so that
ownership flows from the DNS system. Since we own the domain name
registry.google, it seems only appropriate that we should use
google.registry as our package name.
2016-05-13 20:04:42 -04:00

69 lines
2.5 KiB
Java

// Copyright 2016 The Domain Registry Authors. All Rights Reserved.
//
// 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 google.registry.xml;
import static com.google.common.base.Strings.isNullOrEmpty;
import static org.joda.time.DateTimeZone.UTC;
import org.joda.time.LocalDate;
import org.joda.time.format.DateTimeFormatter;
import org.joda.time.format.ISODateTimeFormat;
import javax.annotation.CheckForNull;
import javax.annotation.Nullable;
import javax.xml.bind.annotation.adapters.XmlAdapter;
/**
* Adapter to use Joda {@link LocalDate} when marshalling the XML Schema {@code date} type.
*
* <p>Dates are represented as midnight in UTC. The parser aims to be permissive in what it accepts.
* Timestamps are converted to UTC if a zone is specified and then the time section is truncated.
* This can lead to unexpected behavior, but it will be your fault.
*/
public class DateAdapter extends XmlAdapter<String, LocalDate> {
/** @see ISODateTimeFormat#date */
private static final DateTimeFormatter MARSHAL_FORMAT = ISODateTimeFormat.date();
/** @see ISODateTimeFormat#dateTimeParser */
private static final DateTimeFormatter UNMARSHAL_FORMAT = ISODateTimeFormat.dateTimeParser();
/**
* Parses an ISO timestamp string into a UTC {@link LocalDate} object, converting timezones
* and truncating time to midnight if necessary. If {@code timestamp} is empty or {@code null}
* then {@code null} is returned.
*/
@Nullable
@CheckForNull
@Override
public LocalDate unmarshal(@Nullable String timestamp) {
if (isNullOrEmpty(timestamp)) {
return null;
}
return UNMARSHAL_FORMAT.parseDateTime(timestamp).withZone(UTC).toLocalDate();
}
/**
* Converts {@link LocalDate} to UTC and returns it as an RFC3339 string. If {@code timestamp}
* is {@code null} then an empty string is returned.
*/
@Override
public String marshal(@Nullable LocalDate date) {
if (date == null) {
return "";
}
return MARSHAL_FORMAT.print(date.toDateTimeAtStartOfDay(UTC));
}
}