From ae7933da571cff275799424c900ece534d04a9c2 Mon Sep 17 00:00:00 2001 From: ctingue Date: Thu, 20 Oct 2016 12:43:42 -0700 Subject: [PATCH] Add RFC references to EppResource Javadoc ------------- Created by MOE: https://github.com/google/moe MOE_MIGRATED_REVID=136747145 --- java/google/registry/model/EppResource.java | 3 ++- java/google/registry/model/contact/ContactResource.java | 6 +++++- java/google/registry/model/domain/DomainResource.java | 6 +++++- java/google/registry/model/host/HostResource.java | 2 ++ 4 files changed, 14 insertions(+), 3 deletions(-) diff --git a/java/google/registry/model/EppResource.java b/java/google/registry/model/EppResource.java index e71d88957..8468ebeb8 100644 --- a/java/google/registry/model/EppResource.java +++ b/java/google/registry/model/EppResource.java @@ -37,7 +37,7 @@ import javax.xml.bind.annotation.XmlElement; import javax.xml.bind.annotation.XmlTransient; import org.joda.time.DateTime; -/** An Epp entity object such as a contact or a host. */ +/** An EPP entity object (i.e. a domain, application, contact, or host). */ @XmlTransient public abstract class EppResource extends BackupGroupRoot implements Buildable, ResponseData { @@ -45,6 +45,7 @@ public abstract class EppResource extends BackupGroupRoot implements Buildable, * Unique identifier in the registry for this resource. * *

This is in the (\w|_){1,80}-\w{1,8} format specified by RFC 5730 for roidType. + * @see RFC 5730 */ @Id @XmlElement(name = "roid") diff --git a/java/google/registry/model/contact/ContactResource.java b/java/google/registry/model/contact/ContactResource.java index 90f72b541..385d49560 100644 --- a/java/google/registry/model/contact/ContactResource.java +++ b/java/google/registry/model/contact/ContactResource.java @@ -40,7 +40,11 @@ import javax.xml.bind.annotation.adapters.CollapsedStringAdapter; import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter; import org.joda.time.DateTime; -/** A persistable Contact resource including mutable and non-mutable fields. */ +/** + * A persistable contact resource including mutable and non-mutable fields. + * + * @see RFC 5733 + */ @XmlRootElement(name = "infData") @XmlType(propOrder = { "contactId", diff --git a/java/google/registry/model/domain/DomainResource.java b/java/google/registry/model/domain/DomainResource.java index 7a1353546..c11137af0 100644 --- a/java/google/registry/model/domain/DomainResource.java +++ b/java/google/registry/model/domain/DomainResource.java @@ -50,7 +50,11 @@ import javax.xml.bind.annotation.XmlType; import org.joda.time.DateTime; import org.joda.time.Interval; -/** A persistable domain resource including mutable and non-mutable fields. */ +/** + * A persistable domain resource including mutable and non-mutable fields. + * + * @see RFC 5731 + */ @XmlRootElement(name = "infData") @XmlType(propOrder = { "fullyQualifiedDomainName", diff --git a/java/google/registry/model/host/HostResource.java b/java/google/registry/model/host/HostResource.java index 703afa9ff..61a7b3ae1 100644 --- a/java/google/registry/model/host/HostResource.java +++ b/java/google/registry/model/host/HostResource.java @@ -50,6 +50,8 @@ import org.joda.time.DateTime; * *

A host's {@link TransferData} is stored on the superordinate domain. Non-subordinate hosts * don't carry a full set of TransferData; all they have is lastTransferTime. + * + * @see RFC 5732 */ @XmlRootElement(name = "infData") @XmlType(propOrder = {