mv com/google/domain/registry google/registry

This change renames directories in preparation for the great package
rename. The repository is now in a broken state because the code
itself hasn't been updated. However this should ensure that git
correctly preserves history for each file.

java/google/registry/model/common/TimeOfYear.java

@@ -0,0 +1,93 @@
+// 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 com.google.domain.registry.model.common;
+
+import static com.google.domain.registry.util.DateTimeUtils.isAtOrAfter;
+import static com.google.domain.registry.util.DateTimeUtils.isBeforeOrAt;
+
+import com.google.common.base.Splitter;
+import com.google.domain.registry.model.ImmutableObject;
+
+import com.googlecode.objectify.annotation.Embed;
+import com.googlecode.objectify.annotation.Index;
+
+import org.joda.time.DateTime;
+
+import java.util.List;
+
+/**
+ * A time of year (month, day, millis of day) that can be stored in a sort-friendly format.
+ * <p>
+ * This is conceptually similar to {@code MonthDay} in Joda or more generally to Joda's
+ * {@code Partial}, but the parts we need are too simple to justify a full implementation of
+ * {@code Partial}.
+ * <p>
+ * For simplicity, the native representation of this class's data is its stored format. This allows
+ * it to be embeddable with no translation needed and also delays parsing of the string on load
+ * until it's actually needed.
+ */
+@Embed
+public class TimeOfYear extends ImmutableObject {
+
+  /**
+   * The time as "month day millis" with all fields left-padded with zeroes so that lexographic
+   * sorting will do the right thing.
+   */
+  @Index
+  String timeString;
+
+  /**
+   * Constructs a {@link TimeOfYear} from a {@link DateTime}.
+   * <p>
+   * This handles leap years in an intentionally peculiar way by always treating February 29 as
+   * February 28. It is impossible to construct a {@link TimeOfYear} for February 29th.
+   */
+  public static TimeOfYear fromDateTime(DateTime dateTime) {
+    DateTime nextYear = dateTime.plusYears(1);  // This turns February 29 into February 28.
+    TimeOfYear instance = new TimeOfYear();
+    instance.timeString = String.format(
+        "%02d %02d %08d",
+        nextYear.getMonthOfYear(),
+        nextYear.getDayOfMonth(),
+        nextYear.getMillisOfDay());
+    return instance;
+  }
+
+  /** Get the first {@link DateTime} with this month/day/millis that is at or after the start. */
+  public DateTime atOrAfter(DateTime start) {
+    DateTime withSameYear = getDateTimeWithSameYear(start);
+    return isAtOrAfter(withSameYear, start) ? withSameYear : withSameYear.plusYears(1);
+  }
+
+  /** Get the first {@link DateTime} with this month/day/millis that is at or before the end. */
+  public DateTime beforeOrAt(DateTime end) {
+    DateTime withSameYear = getDateTimeWithSameYear(end);
+    return isBeforeOrAt(withSameYear, end) ? withSameYear : withSameYear.minusYears(1);
+  }
+
+  /**
+   * Return a new datetime with the same year as the parameter but projected to the month, day, and
+   * time of day of this object.
+   */
+  private DateTime getDateTimeWithSameYear(DateTime date) {
+    List<String> monthDayMillis = Splitter.on(' ').splitToList(timeString);
+    // Do not be clever and use Ints.stringConverter here. That does radix guessing, and bad things
+    // will happen because of the leading zeroes.
+    return date
+        .withMonthOfYear(Integer.parseInt(monthDayMillis.get(0)))
+        .withDayOfMonth(Integer.parseInt(monthDayMillis.get(1)))
+        .withMillisOfDay(Integer.parseInt(monthDayMillis.get(2)));
+  }
+}