/*
 * Copyright 2013-2020 the original author or authors.
 *
 * 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
 *
 *      https://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 org.springframework.data.convert;

import static java.time.Instant.*;
import static java.time.LocalDateTime.*;
import static java.time.ZoneId.*;

import java.time.Duration;
import java.time.Instant;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.Period;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.Date;
import java.util.List;

import javax.annotation.Nonnull;

import org.springframework.core.convert.converter.Converter;
import org.springframework.lang.NonNull;
import org.springframework.util.ClassUtils;

Helper class to register JSR-310 specific Converter implementations in case the we're running on Java 8.
Author:Oliver Gierke, Barak Schoster, Christoph Strobl, Jens Schauder, Mark Paluch
/** * Helper class to register JSR-310 specific {@link Converter} implementations in case the we're running on Java 8. * * @author Oliver Gierke * @author Barak Schoster * @author Christoph Strobl * @author Jens Schauder * @author Mark Paluch */
public abstract class Jsr310Converters { private static final boolean JAVA_8_IS_PRESENT = ClassUtils.isPresent("java.time.LocalDateTime", Jsr310Converters.class.getClassLoader());
Returns the converters to be registered. Will only return converters in case we're running on Java 8.
Returns:
/** * Returns the converters to be registered. Will only return converters in case we're running on Java 8. * * @return */
public static Collection<Converter<?, ?>> getConvertersToRegister() { if (!JAVA_8_IS_PRESENT) { return Collections.emptySet(); } List<Converter<?, ?>> converters = new ArrayList<>(); converters.add(DateToLocalDateTimeConverter.INSTANCE); converters.add(LocalDateTimeToDateConverter.INSTANCE); converters.add(DateToLocalDateConverter.INSTANCE); converters.add(LocalDateToDateConverter.INSTANCE); converters.add(DateToLocalTimeConverter.INSTANCE); converters.add(LocalTimeToDateConverter.INSTANCE); converters.add(DateToInstantConverter.INSTANCE); converters.add(InstantToDateConverter.INSTANCE); converters.add(LocalDateTimeToInstantConverter.INSTANCE); converters.add(InstantToLocalDateTimeConverter.INSTANCE); converters.add(ZoneIdToStringConverter.INSTANCE); converters.add(StringToZoneIdConverter.INSTANCE); converters.add(DurationToStringConverter.INSTANCE); converters.add(StringToDurationConverter.INSTANCE); converters.add(PeriodToStringConverter.INSTANCE); converters.add(StringToPeriodConverter.INSTANCE); converters.add(StringToLocalDateConverter.INSTANCE); converters.add(StringToLocalDateTimeConverter.INSTANCE); converters.add(StringToInstantConverter.INSTANCE); return converters; } public static boolean supports(Class<?> type) { if (!JAVA_8_IS_PRESENT) { return false; } return Arrays.<Class<?>> asList(LocalDateTime.class, LocalDate.class, LocalTime.class, Instant.class) .contains(type); } @ReadingConverter public static enum DateToLocalDateTimeConverter implements Converter<Date, LocalDateTime> { INSTANCE; @Nonnull @Override public LocalDateTime convert(Date source) { return ofInstant(source.toInstant(), systemDefault()); } } @WritingConverter public static enum LocalDateTimeToDateConverter implements Converter<LocalDateTime, Date> { INSTANCE; @Nonnull @Override public Date convert(LocalDateTime source) { return Date.from(source.atZone(systemDefault()).toInstant()); } } @ReadingConverter public static enum DateToLocalDateConverter implements Converter<Date, LocalDate> { INSTANCE; @Nonnull @Override public LocalDate convert(Date source) { return ofInstant(ofEpochMilli(source.getTime()), systemDefault()).toLocalDate(); } } @WritingConverter public static enum LocalDateToDateConverter implements Converter<LocalDate, Date> { INSTANCE; @Nonnull @Override public Date convert(LocalDate source) { return Date.from(source.atStartOfDay(systemDefault()).toInstant()); } } @ReadingConverter public static enum DateToLocalTimeConverter implements Converter<Date, LocalTime> { INSTANCE; @Nonnull @Override public LocalTime convert(Date source) { return ofInstant(ofEpochMilli(source.getTime()), systemDefault()).toLocalTime(); } } @WritingConverter public static enum LocalTimeToDateConverter implements Converter<LocalTime, Date> { INSTANCE; @Nonnull @Override public Date convert(LocalTime source) { return Date.from(source.atDate(LocalDate.now()).atZone(systemDefault()).toInstant()); } } @ReadingConverter public static enum DateToInstantConverter implements Converter<Date, Instant> { INSTANCE; @Nonnull @Override public Instant convert(Date source) { return source.toInstant(); } } @WritingConverter public static enum InstantToDateConverter implements Converter<Instant, Date> { INSTANCE; @Nonnull @Override public Date convert(Instant source) { return Date.from(source.atZone(systemDefault()).toInstant()); } } @ReadingConverter public static enum LocalDateTimeToInstantConverter implements Converter<LocalDateTime, Instant> { INSTANCE; @Nonnull @Override public Instant convert(LocalDateTime source) { return source.atZone(systemDefault()).toInstant(); } } @ReadingConverter public static enum InstantToLocalDateTimeConverter implements Converter<Instant, LocalDateTime> { INSTANCE; @Nonnull @Override public LocalDateTime convert(Instant source) { return LocalDateTime.ofInstant(source, systemDefault()); } } @WritingConverter public static enum ZoneIdToStringConverter implements Converter<ZoneId, String> { INSTANCE; @Nonnull @Override public String convert(ZoneId source) { return source.toString(); } } @ReadingConverter public static enum StringToZoneIdConverter implements Converter<String, ZoneId> { INSTANCE; @Nonnull @Override public ZoneId convert(String source) { return ZoneId.of(source); } } @WritingConverter public static enum DurationToStringConverter implements Converter<Duration, String> { INSTANCE; @Nonnull @Override public String convert(Duration duration) { return duration.toString(); } } @ReadingConverter public static enum StringToDurationConverter implements Converter<String, Duration> { INSTANCE; @Nonnull @Override public Duration convert(String s) { return Duration.parse(s); } } @WritingConverter public static enum PeriodToStringConverter implements Converter<Period, String> { INSTANCE; @Nonnull @Override public String convert(Period period) { return period.toString(); } } @ReadingConverter public static enum StringToPeriodConverter implements Converter<String, Period> { INSTANCE; @Nonnull @Override public Period convert(String s) { return Period.parse(s); } } @ReadingConverter public static enum StringToLocalDateConverter implements Converter<String, LocalDate> { INSTANCE; /* * (non-Javadoc) * @see org.springframework.core.convert.converter.Converter#convert(java.lang.Object) */ @NonNull @Override public LocalDate convert(String source) { return LocalDate.parse(source, DateTimeFormatter.ISO_DATE); } } @ReadingConverter public static enum StringToLocalDateTimeConverter implements Converter<String, LocalDateTime> { INSTANCE; /* * (non-Javadoc) * @see org.springframework.core.convert.converter.Converter#convert(java.lang.Object) */ @NonNull @Override public LocalDateTime convert(String source) { return LocalDateTime.parse(source, DateTimeFormatter.ISO_DATE_TIME); } } @ReadingConverter public static enum StringToInstantConverter implements Converter<String, Instant> { INSTANCE; /* * (non-Javadoc) * @see org.springframework.core.convert.converter.Converter#convert(java.lang.Object) */ @NonNull @Override public Instant convert(String source) { return Instant.parse(source); } } }