/*
 * Copyright DataStax, 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 com.datastax.oss.driver.internal.core.type.codec.extras.time;

import com.datastax.oss.driver.api.core.type.codec.MappingCodec;
import com.datastax.oss.driver.api.core.type.reflect.GenericType;
import com.datastax.oss.driver.internal.core.type.codec.TimestampCodec;
import edu.umd.cs.findbugs.annotations.NonNull;
import edu.umd.cs.findbugs.annotations.Nullable;
import java.time.Instant;
import java.time.ZoneId;
import java.time.ZonedDateTime;
import java.util.Objects;
import net.jcip.annotations.ThreadSafe;

A codec that handles Apache Cassandra(R)'s timestamp type and maps it to Java's ZonedDateTime, using the ZoneId supplied at instantiation. 
Note that Apache Cassandra(R)'s timestamp type does not store any time zone; this codec is provided merely as a convenience for users that need to deal with zoned timestamps in their applications. If you need to persist the time zone in the database, consider using PersistentZonedTimestampCodec instead. 
This codec shares its logic with TimestampCodec. See the javadocs of this codec for important remarks about implementation notes and accepted timestamp formats. 
See Also:
TimestampCodec/**
 * A codec that handles Apache Cassandra(R)'s timestamp type and maps it to Java's {@link
 * ZonedDateTime}, using the {@link ZoneId} supplied at instantiation.
 *
 * <p>Note that Apache Cassandra(R)'s timestamp type does not store any time zone; this codec is
 * provided merely as a convenience for users that need to deal with zoned timestamps in their
 * applications. If you need to persist the time zone in the database, consider using {@link
 * PersistentZonedTimestampCodec} instead.
 *
 * <p>This codec shares its logic with {@link TimestampCodec}. See the javadocs of this codec for
 * important remarks about implementation notes and accepted timestamp formats.
 *
 * @see TimestampCodec
 */
@ThreadSafe
public class ZonedTimestampCodec extends MappingCodec<Instant, ZonedDateTime> {

  private final ZoneId timeZone;

  
Creates a new ZonedTimestampCodec that converts CQL timestamps into ZonedDateTime instances using the system's default time
zone as their time zone. The supplied timeZone will also be used to parse CQL timestamp literals that do not include any time zone information. /**
   * Creates a new {@code ZonedTimestampCodec} that converts CQL timestamps into {@link
   * ZonedDateTime} instances using the system's {@linkplain ZoneId#systemDefault() default time
   * zone} as their time zone. The supplied {@code timeZone} will also be used to parse CQL
   * timestamp literals that do not include any time zone information.
   */
  public ZonedTimestampCodec() {
    this(ZoneId.systemDefault());
  }

  
Creates a new ZonedTimestampCodec that converts CQL timestamps into ZonedDateTime instances using the given ZoneId as their time zone. The supplied 
timeZone will also be used to parse CQL timestamp literals that do not include any time zone information. /**
   * Creates a new {@code ZonedTimestampCodec} that converts CQL timestamps into {@link
   * ZonedDateTime} instances using the given {@link ZoneId} as their time zone. The supplied {@code
   * timeZone} will also be used to parse CQL timestamp literals that do not include any time zone
   * information.
   */
  public ZonedTimestampCodec(ZoneId timeZone) {
    super(
        new TimestampCodec(Objects.requireNonNull(timeZone, "timeZone cannot be null")),
        GenericType.ZONED_DATE_TIME);
    this.timeZone = timeZone;
  }

  @Override
  public boolean accepts(@NonNull Object value) {
    Objects.requireNonNull(value);
    return value instanceof ZonedDateTime;
  }

  @Nullable
  @Override
  protected ZonedDateTime innerToOuter(@Nullable Instant value) {
    return value == null ? null : value.atZone(timeZone);
  }

  @Nullable
  @Override
  protected Instant outerToInner(@Nullable ZonedDateTime value) {
    return value == null ? null : value.toInstant();
  }
}