com.datastax.driver.extras.codecs.joda.InstantCodec Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of driver-cql-shaded Show documentation
A Shaded CQL ActivityType driver for http://nosqlbench.io/
There is a newer version: 4.15.102
/*
 * Copyright DataStax, Inc.
 *
 * This software can be used solely with DataStax Enterprise. Please consult the license at
 * http://www.datastax.com/terms/datastax-dse-driver-license-terms
 */
package com.datastax.driver.extras.codecs.joda;

import static com.datastax.driver.core.ParseUtils.*;
import static java.lang.Long.parseLong;

import com.datastax.driver.core.DataType;
import com.datastax.driver.core.ProtocolVersion;
import com.datastax.driver.core.TypeCodec;
import com.datastax.driver.core.exceptions.InvalidTypeException;
import java.nio.ByteBuffer;
import org.joda.time.Instant;
import org.joda.time.format.DateTimeFormat;
import org.joda.time.format.DateTimeFormatter;
import org.joda.time.format.DateTimeFormatterBuilder;
import org.joda.time.format.ISODateTimeFormat;

/**
 * {@link TypeCodec} that maps {@link Instant} to CQL {@code timestamp} allowing the setting and
 * retrieval of {@code timestamp} columns as {@link Instant} instances.
 *
 * Since C* timestamp columns do not preserve timezones any attached timezone
 * information will be lost.
 *
 * IMPORTANT: this codec's {@link #format(Instant) format} method formats
 * timestamps using an ISO-8601 format that includes milliseconds. This format is
 * incompatible with Cassandra versions < 2.0.9.
 *
 * @see DateTimeCodec
 * @see 'Working with
 *     timestamps' section of CQL specification
 */
public class InstantCodec extends TypeCodec {

  public static final InstantCodec instance = new InstantCodec();

  /** A {@link DateTimeFormatter} that parses (most) of the ISO formats accepted in CQL. */
  private static final DateTimeFormatter PARSER =
      new DateTimeFormatterBuilder()
          .append(ISODateTimeFormat.dateOptionalTimeParser().getParser())
          .appendOptional(
              new DateTimeFormatterBuilder().appendTimeZoneOffset("Z", true, 2, 4).toParser())
          .toFormatter()
          .withZoneUTC();

  private static final DateTimeFormatter FORMATTER =
      DateTimeFormat.forPattern("yyyy-MM-dd'T'HH:mm:ss.SSSZZ").withZoneUTC();

  private InstantCodec() {
    super(DataType.timestamp(), Instant.class);
  }

  @Override
  public ByteBuffer serialize(Instant value, ProtocolVersion protocolVersion) {
    return value == null ? null : bigint().serializeNoBoxing(value.getMillis(), protocolVersion);
  }

  @Override
  public Instant deserialize(ByteBuffer bytes, ProtocolVersion protocolVersion) {
    if (bytes == null || bytes.remaining() == 0) return null;
    long millis = bigint().deserializeNoBoxing(bytes, protocolVersion);
    return new Instant(millis);
  }

  @Override
  public String format(Instant value) {
    if (value == null) return "NULL";
    return quote(FORMATTER.print(value));
  }

  @Override
  public Instant parse(String value) {
    if (value == null || value.isEmpty() || value.equalsIgnoreCase("NULL")) return null;
    // strip enclosing single quotes, if any
    if (isQuoted(value)) value = unquote(value);
    if (isLongLiteral(value)) {
      try {
        return new Instant(parseLong(value));
      } catch (NumberFormatException e) {
        throw new InvalidTypeException(
            String.format("Cannot parse timestamp value from \"%s\"", value));
      }
    }
    try {
      return new Instant(PARSER.parseMillis(value));
    } catch (RuntimeException e) {
      throw new InvalidTypeException(
          String.format("Cannot parse timestamp value from \"%s\"", value));
    }
  }
}