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/flows/contact/ContactCheckFlow.java

@@ -0,0 +1,45 @@
+// 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.flows.contact;
+
+import static com.google.domain.registry.model.EppResourceUtils.checkResourcesExist;
+
+import com.google.common.collect.ImmutableList;
+import com.google.domain.registry.flows.ResourceCheckFlow;
+import com.google.domain.registry.model.contact.ContactCommand.Check;
+import com.google.domain.registry.model.contact.ContactResource;
+import com.google.domain.registry.model.eppoutput.CheckData;
+import com.google.domain.registry.model.eppoutput.CheckData.ContactCheck;
+import com.google.domain.registry.model.eppoutput.CheckData.ContactCheckData;
+
+import java.util.Set;
+
+/**
+ * An EPP flow that checks whether a contact can be provisioned.
+ *
+ * @error {@link com.google.domain.registry.flows.ResourceCheckFlow.TooManyResourceChecksException}
+ */
+public class ContactCheckFlow extends ResourceCheckFlow<ContactResource, Check> {
+  @Override
+  protected CheckData getCheckData() {
+    Set<String> existingIds = checkResourcesExist(resourceClass, targetIds, now);
+    ImmutableList.Builder<ContactCheck> checks = new ImmutableList.Builder<>();
+    for (String id : targetIds) {
+      boolean unused = !existingIds.contains(id);
+      checks.add(ContactCheck.create(unused, id, unused ? null : "In use"));
+    }
+    return ContactCheckData.create(checks.build());
+  }
+}

java/google/registry/flows/contact/ContactCreateFlow.java

@@ -0,0 +1,65 @@
+// 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.flows.contact;
+
+import static com.google.domain.registry.flows.contact.ContactFlowUtils.validateAsciiPostalInfo;
+import static com.google.domain.registry.flows.contact.ContactFlowUtils.validateContactAgainstPolicy;
+import static com.google.domain.registry.model.EppResourceUtils.createContactHostRoid;
+import static com.google.domain.registry.model.eppoutput.Result.Code.Success;
+
+import com.google.domain.registry.flows.EppException;
+import com.google.domain.registry.flows.ResourceCreateFlow;
+import com.google.domain.registry.model.contact.ContactCommand.Create;
+import com.google.domain.registry.model.contact.ContactResource;
+import com.google.domain.registry.model.contact.ContactResource.Builder;
+import com.google.domain.registry.model.eppoutput.CreateData.ContactCreateData;
+import com.google.domain.registry.model.eppoutput.EppOutput;
+import com.google.domain.registry.model.ofy.ObjectifyService;
+import com.google.domain.registry.model.reporting.HistoryEntry;
+
+/**
+ * An EPP flow that creates a new contact resource.
+ *
+ * @error {@link com.google.domain.registry.flows.ResourceCreateFlow.ResourceAlreadyExistsException}
+ * @error {@link ContactFlowUtils.BadInternationalizedPostalInfoException}
+ * @error {@link ContactFlowUtils.DeclineContactDisclosureFieldDisallowedPolicyException}
+ */
+public class ContactCreateFlow extends ResourceCreateFlow<ContactResource, Builder, Create> {
+  @Override
+  protected EppOutput getOutput() {
+    return createOutput(Success, ContactCreateData.create(newResource.getContactId(), now));
+  }
+
+  @Override
+  protected String createFlowRepoId() {
+    return createContactHostRoid(ObjectifyService.allocateId());
+  }
+
+  @Override
+  protected void verifyNewStateIsAllowed() throws EppException {
+    validateAsciiPostalInfo(newResource.getInternationalizedPostalInfo());
+    validateContactAgainstPolicy(newResource);
+  }
+
+  @Override
+  protected boolean storeXmlInHistoryEntry() {
+    return false;
+  }
+
+  @Override
+  protected final HistoryEntry.Type getHistoryEntryType() {
+    return HistoryEntry.Type.CONTACT_CREATE;
+  }
+}

java/google/registry/flows/contact/ContactDeleteFlow.java

@@ -0,0 +1,87 @@
+// 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.flows.contact;
+
+import static com.google.domain.registry.model.EppResourceUtils.queryDomainsUsingResource;
+import static com.google.domain.registry.model.ofy.ObjectifyService.ofy;
+
+import com.google.common.base.Predicate;
+import com.google.common.collect.ImmutableMap;
+import com.google.common.collect.Iterables;
+import com.google.domain.registry.config.RegistryEnvironment;
+import com.google.domain.registry.flows.EppException;
+import com.google.domain.registry.flows.ResourceAsyncDeleteFlow;
+import com.google.domain.registry.flows.async.AsyncFlowUtils;
+import com.google.domain.registry.flows.async.DeleteContactResourceAction;
+import com.google.domain.registry.flows.async.DeleteEppResourceAction;
+import com.google.domain.registry.model.contact.ContactCommand.Delete;
+import com.google.domain.registry.model.contact.ContactResource;
+import com.google.domain.registry.model.contact.ContactResource.Builder;
+import com.google.domain.registry.model.domain.DomainBase;
+import com.google.domain.registry.model.domain.ReferenceUnion;
+import com.google.domain.registry.model.reporting.HistoryEntry;
+
+import com.googlecode.objectify.Key;
+
+/**
+ * An EPP flow that deletes a contact resource.
+ *
+ * @error {@link com.google.domain.registry.flows.ResourceAsyncDeleteFlow.ResourceToDeleteIsReferencedException}
+ * @error {@link com.google.domain.registry.flows.ResourceFlowUtils.ResourceNotOwnedException}
+ * @error {@link com.google.domain.registry.flows.ResourceMutateFlow.ResourceToMutateDoesNotExistException}
+ * @error {@link com.google.domain.registry.flows.SingleResourceFlow.ResourceStatusProhibitsOperationException}
+ */
+public class ContactDeleteFlow extends ResourceAsyncDeleteFlow<ContactResource, Builder, Delete> {
+
+  /** In {@link #isLinkedForFailfast}, check this (arbitrary) number of resources from the query. */
+  private static final int FAILFAST_CHECK_COUNT = 5;
+
+  @Override
+  protected boolean isLinkedForFailfast(final ReferenceUnion<ContactResource> ref) {
+    // Query for the first few linked domains, and if found, actually load them. The query is
+    // eventually consistent and so might be very stale, but the direct load will not be stale,
+    // just non-transactional. If we find at least one actual reference then we can reliably
+    // fail. If we don't find any, we can't trust the query and need to do the full mapreduce.
+    return Iterables.any(
+        ofy().load().keys(
+            queryDomainsUsingResource(
+                  ContactResource.class, ref.getLinked(), now, FAILFAST_CHECK_COUNT)).values(),
+        new Predicate<DomainBase>() {
+            @Override
+            public boolean apply(DomainBase domain) {
+              return domain.getReferencedContacts().contains(ref);
+            }});
+  }
+
+  /** Enqueues a contact resource deletion on the mapreduce queue. */
+  @Override
+  protected final void enqueueTasks() throws EppException {
+    AsyncFlowUtils.enqueueMapreduceAction(
+        DeleteContactResourceAction.class,
+        ImmutableMap.of(
+            DeleteEppResourceAction.PARAM_RESOURCE_KEY,
+            Key.create(existingResource).getString(),
+            DeleteEppResourceAction.PARAM_REQUESTING_CLIENT_ID,
+            getClientId(),
+            DeleteEppResourceAction.PARAM_IS_SUPERUSER,
+            Boolean.toString(superuser)),
+        RegistryEnvironment.get().config().getAsyncDeleteFlowMapreduceDelay());
+  }
+
+  @Override
+  protected final HistoryEntry.Type getHistoryEntryType() {
+    return HistoryEntry.Type.CONTACT_PENDING_DELETE;
+  }
+}

java/google/registry/flows/contact/ContactFlowUtils.java

@@ -0,0 +1,77 @@
+// 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.flows.contact;
+
+import static com.google.domain.registry.model.contact.PostalInfo.Type.INTERNATIONALIZED;
+
+import com.google.common.base.CharMatcher;
+import com.google.common.base.Preconditions;
+import com.google.common.collect.Sets;
+import com.google.domain.registry.flows.EppException;
+import com.google.domain.registry.flows.EppException.ParameterValuePolicyErrorException;
+import com.google.domain.registry.flows.EppException.ParameterValueSyntaxErrorException;
+import com.google.domain.registry.model.contact.ContactAddress;
+import com.google.domain.registry.model.contact.ContactResource;
+import com.google.domain.registry.model.contact.PostalInfo;
+
+import java.util.Set;
+
+import javax.annotation.Nullable;
+
+/** Static utility functions for contact flows. */
+public class ContactFlowUtils {
+  /** Check that an internationalized postal info has only ascii characters. */
+  static void validateAsciiPostalInfo(@Nullable PostalInfo internationalized) throws EppException {
+    if (internationalized != null) {
+      Preconditions.checkState(INTERNATIONALIZED.equals(internationalized.getType()));
+      ContactAddress address = internationalized.getAddress();
+      Set<String> fields = Sets.newHashSet(
+          internationalized.getName(),
+          internationalized.getOrg(),
+          address.getCity(),
+          address.getCountryCode(),
+          address.getState(),
+          address.getZip());
+      fields.addAll(address.getStreet());
+      for (String field : fields) {
+        if (field != null && !CharMatcher.ascii().matchesAllOf(field)) {
+          throw new BadInternationalizedPostalInfoException();
+        }
+      }
+    }
+  }
+  
+  /** Check contact's state against server policy. */
+  static void validateContactAgainstPolicy(ContactResource contact) throws EppException {
+    if (contact.getDisclose() != null && !contact.getDisclose().getFlag()) {
+      throw new DeclineContactDisclosureFieldDisallowedPolicyException();
+    }
+  }
+
+  /** Declining contact disclosure is disallowed by server policy. */
+  static class DeclineContactDisclosureFieldDisallowedPolicyException
+      extends ParameterValuePolicyErrorException {
+    public DeclineContactDisclosureFieldDisallowedPolicyException() {
+      super("Declining contact disclosure is disallowed by server policy.");
+    }
+  }
+  
+  /** Internationalized postal infos can only contain ASCII characters. */
+  static class BadInternationalizedPostalInfoException extends ParameterValueSyntaxErrorException {
+    public BadInternationalizedPostalInfoException() {
+      super("Internationalized postal infos can only contain ASCII characters");
+    }
+  }
+}

java/google/registry/flows/contact/ContactInfoFlow.java

@@ -0,0 +1,27 @@
+// 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.flows.contact;
+
+import com.google.domain.registry.flows.ResourceInfoFlow;
+import com.google.domain.registry.model.contact.ContactCommand.Info;
+import com.google.domain.registry.model.contact.ContactResource;
+
+/**
+ * An EPP flow that reads a contact.
+ *
+ * @error {@link com.google.domain.registry.flows.ResourceQueryFlow.ResourceToQueryDoesNotExistException}
+ */
+public class ContactInfoFlow extends ResourceInfoFlow<ContactResource, Info> {}
+

java/google/registry/flows/contact/ContactTransferApproveFlow.java

@@ -0,0 +1,37 @@
+// 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.flows.contact;
+
+import com.google.domain.registry.flows.ResourceTransferApproveFlow;
+import com.google.domain.registry.model.contact.ContactCommand.Transfer;
+import com.google.domain.registry.model.contact.ContactResource;
+import com.google.domain.registry.model.contact.ContactResource.Builder;
+import com.google.domain.registry.model.reporting.HistoryEntry;
+
+/**
+ * An EPP flow that approves a pending transfer on a {@link ContactResource}.
+ *
+ * @error {@link com.google.domain.registry.flows.ResourceFlowUtils.BadAuthInfoForResourceException}
+ * @error {@link com.google.domain.registry.flows.ResourceFlowUtils.ResourceNotOwnedException}
+ * @error {@link com.google.domain.registry.flows.ResourceMutateFlow.ResourceToMutateDoesNotExistException}
+ * @error {@link com.google.domain.registry.flows.ResourceMutatePendingTransferFlow.NotPendingTransferException}
+ */
+public class ContactTransferApproveFlow
+    extends ResourceTransferApproveFlow<ContactResource, Builder, Transfer> {
+  @Override
+  protected final HistoryEntry.Type getHistoryEntryType() {
+    return HistoryEntry.Type.CONTACT_TRANSFER_APPROVE;
+  }
+}

java/google/registry/flows/contact/ContactTransferCancelFlow.java

@@ -0,0 +1,37 @@
+// 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.flows.contact;
+
+import com.google.domain.registry.flows.ResourceTransferCancelFlow;
+import com.google.domain.registry.model.contact.ContactCommand.Transfer;
+import com.google.domain.registry.model.contact.ContactResource;
+import com.google.domain.registry.model.contact.ContactResource.Builder;
+import com.google.domain.registry.model.reporting.HistoryEntry;
+
+/**
+ * An EPP flow that cancels a pending transfer on a {@link ContactResource}.
+ *
+ * @error {@link com.google.domain.registry.flows.ResourceFlowUtils.BadAuthInfoForResourceException}
+ * @error {@link com.google.domain.registry.flows.ResourceMutateFlow.ResourceToMutateDoesNotExistException}
+ * @error {@link com.google.domain.registry.flows.ResourceMutatePendingTransferFlow.NotPendingTransferException}
+ * @error {@link com.google.domain.registry.flows.ResourceTransferCancelFlow.NotTransferInitiatorException}
+ */
+public class ContactTransferCancelFlow
+    extends ResourceTransferCancelFlow<ContactResource, Builder, Transfer> {
+  @Override
+  protected final HistoryEntry.Type getHistoryEntryType() {
+    return HistoryEntry.Type.CONTACT_TRANSFER_CANCEL;
+  }
+}

java/google/registry/flows/contact/ContactTransferQueryFlow.java

@@ -0,0 +1,30 @@
+// 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.flows.contact;
+
+import com.google.domain.registry.flows.ResourceTransferQueryFlow;
+import com.google.domain.registry.model.contact.ContactCommand.Transfer;
+import com.google.domain.registry.model.contact.ContactResource;
+
+/**
+ * An EPP flow that queries a pending transfer on a {@link ContactResource}.
+ *
+ * @error {@link com.google.domain.registry.flows.ResourceFlowUtils.BadAuthInfoForResourceException}
+ * @error {@link com.google.domain.registry.flows.ResourceQueryFlow.ResourceToQueryDoesNotExistException}
+ * @error {@link com.google.domain.registry.flows.ResourceTransferQueryFlow.NoTransferHistoryToQueryException}
+ * @error {@link com.google.domain.registry.flows.ResourceTransferQueryFlow.NotAuthorizedToViewTransferException}
+ */
+public class ContactTransferQueryFlow extends ResourceTransferQueryFlow<ContactResource, Transfer> {
+}

java/google/registry/flows/contact/ContactTransferRejectFlow.java

@@ -0,0 +1,37 @@
+// 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.flows.contact;
+
+import com.google.domain.registry.flows.ResourceTransferRejectFlow;
+import com.google.domain.registry.model.contact.ContactCommand.Transfer;
+import com.google.domain.registry.model.contact.ContactResource;
+import com.google.domain.registry.model.contact.ContactResource.Builder;
+import com.google.domain.registry.model.reporting.HistoryEntry;
+
+/**
+ * An EPP flow that rejects a pending transfer on a {@link ContactResource}.
+ *
+ * @error {@link com.google.domain.registry.flows.ResourceFlowUtils.BadAuthInfoForResourceException}
+ * @error {@link com.google.domain.registry.flows.ResourceFlowUtils.ResourceNotOwnedException}
+ * @error {@link com.google.domain.registry.flows.ResourceMutateFlow.ResourceToMutateDoesNotExistException}
+ * @error {@link com.google.domain.registry.flows.ResourceMutatePendingTransferFlow.NotPendingTransferException}
+ */
+public class ContactTransferRejectFlow
+    extends ResourceTransferRejectFlow<ContactResource, Builder, Transfer> {
+  @Override
+  protected final HistoryEntry.Type getHistoryEntryType() {
+    return HistoryEntry.Type.CONTACT_TRANSFER_REJECT;
+  }
+}

java/google/registry/flows/contact/ContactTransferRequestFlow.java

@@ -0,0 +1,46 @@
+// 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.flows.contact;
+
+import com.google.domain.registry.config.RegistryEnvironment;
+import com.google.domain.registry.flows.ResourceTransferRequestFlow;
+import com.google.domain.registry.model.contact.ContactCommand.Transfer;
+import com.google.domain.registry.model.contact.ContactResource;
+import com.google.domain.registry.model.reporting.HistoryEntry;
+
+import org.joda.time.Duration;
+
+/**
+ * An EPP flow that requests a transfer on a {@link ContactResource}.
+ *
+ * @error {@link com.google.domain.registry.flows.ResourceFlowUtils.BadAuthInfoForResourceException}
+ * @error {@link com.google.domain.registry.flows.ResourceMutateFlow.ResourceToMutateDoesNotExistException}
+ * @error {@link com.google.domain.registry.flows.ResourceTransferRequestFlow.AlreadyPendingTransferException}
+ * @error {@link com.google.domain.registry.flows.ResourceTransferRequestFlow.MissingTransferRequestAuthInfoException}
+ * @error {@link com.google.domain.registry.flows.ResourceTransferRequestFlow.ObjectAlreadySponsoredException}
+ */
+public class ContactTransferRequestFlow
+    extends ResourceTransferRequestFlow<ContactResource, Transfer> {
+
+  @Override
+  protected final HistoryEntry.Type getHistoryEntryType() {
+    return HistoryEntry.Type.CONTACT_TRANSFER_REQUEST;
+  }
+
+  @Override
+  protected Duration getAutomaticTransferLength() {
+    return RegistryEnvironment.get().config().getContactAutomaticTransferLength();
+  }
+}

java/google/registry/flows/contact/ContactUpdateFlow.java

@@ -0,0 +1,54 @@
+// 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.flows.contact;
+
+import static com.google.domain.registry.flows.contact.ContactFlowUtils.validateAsciiPostalInfo;
+import static com.google.domain.registry.flows.contact.ContactFlowUtils.validateContactAgainstPolicy;
+
+import com.google.domain.registry.flows.EppException;
+import com.google.domain.registry.flows.ResourceUpdateFlow;
+import com.google.domain.registry.model.contact.ContactCommand.Update;
+import com.google.domain.registry.model.contact.ContactResource;
+import com.google.domain.registry.model.contact.ContactResource.Builder;
+import com.google.domain.registry.model.reporting.HistoryEntry;
+
+/**
+ * An EPP flow that updates a contact resource.
+ *
+ * @error {@link com.google.domain.registry.flows.ResourceFlowUtils.ResourceNotOwnedException}
+ * @error {@link com.google.domain.registry.flows.ResourceMutateFlow.ResourceToMutateDoesNotExistException}
+ * @error {@link com.google.domain.registry.flows.ResourceUpdateFlow.ResourceHasClientUpdateProhibitedException}
+ * @error {@link com.google.domain.registry.flows.ResourceUpdateFlow.StatusNotClientSettableException}
+ * @error {@link com.google.domain.registry.flows.SingleResourceFlow.ResourceStatusProhibitsOperationException}
+ * @error {@link ContactFlowUtils.BadInternationalizedPostalInfoException}
+ * @error {@link ContactFlowUtils.DeclineContactDisclosureFieldDisallowedPolicyException}
+ */
+public class ContactUpdateFlow extends ResourceUpdateFlow<ContactResource, Builder, Update> {
+  @Override
+  protected void verifyNewUpdatedStateIsAllowed() throws EppException {
+    validateAsciiPostalInfo(newResource.getInternationalizedPostalInfo());
+    validateContactAgainstPolicy(newResource);
+  }
+
+  @Override
+  protected boolean storeXmlInHistoryEntry() {
+    return false;
+  }
+
+  @Override
+  protected final HistoryEntry.Type getHistoryEntryType() {
+    return HistoryEntry.Type.CONTACT_UPDATE;
+  }
+}