// Copyright 2017 The Nomulus 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.model.poll; import static google.registry.model.ofy.ObjectifyService.ofy; import com.google.common.base.Splitter; import com.google.common.collect.ImmutableBiMap; import com.googlecode.objectify.Key; import google.registry.model.EppResource; import google.registry.model.contact.ContactResource; import google.registry.model.domain.DomainBase; import google.registry.model.host.HostResource; import google.registry.model.reporting.HistoryEntry; import java.util.List; /** * A converter between external key strings for {@link PollMessage}s (i.e. what registrars use to * identify and ACK them) and Datastore keys to the resource. * *
The format of the key string is A-B-C-D-E-F as follows: * *
* A = EppResource.typeId (decimal) * B = EppResource.repoId prefix (STRING) * C = EppResource.repoId suffix (STRING) * D = HistoryEntry.id (decimal) * E = PollMessage.id (decimal) * F = PollMessage.eventTime (decimal, year only) ** *
A typical poll message ID might thus look like: 1-FE0F22-TLD-10071463070-10072612074-2018
*/
public class PollMessageExternalKeyConverter {
/** An exception thrown when an external key cannot be parsed. */
public static class PollMessageExternalKeyParseException extends RuntimeException {}
/**
* A map of IDs used in external keys corresponding to which EppResource class the poll message
* belongs to.
*/
public static final ImmutableBiMap Note that the year field that is included at the end of the poll message isn't actually
* used for anything; it exists solely to create unique externally visible IDs for autorenews. We
* thus ignore it (for now) for backwards compatibility reasons, so that registrars can still ACK
* existing poll message IDs they may have lying around.
*
* @throws PollMessageExternalKeyParseException if the external key has an invalid format.
*/
public static Key