Fix stale documentation on {ForeignKeyed,}DesignatedContact

Noticed that this is a bit out-out-date ever since these were
split into two types versus using the converters.

-------------
Created by MOE: https://github.com/google/moe
MOE_MIGRATED_REVID=150352102
This commit is contained in:
nickfelt 2017-03-16 12:18:10 -07:00 committed by Ben McIlwain
parent 2d3e77ebee
commit bd6a2d02dd
2 changed files with 16 additions and 6 deletions

View file

@ -20,14 +20,22 @@ import com.googlecode.objectify.annotation.Embed;
import com.googlecode.objectify.annotation.Index;
import google.registry.model.ImmutableObject;
import google.registry.model.contact.ContactResource;
import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlEnumValue;
/**
* XML type for contact identifiers associated with a domain.
* Persisted type for storing a domain's contact associations.
*
* <p>A contact association on a domain consists of the contact key and the contact "type", which is
* the designated role of this contact with respect to this domain. When converting to and from
* EPP XML, we use {@link ForeignKeyedDesignatedContact} to replace the contact's Datastore key
* with its foreign key, since that is what EPP exposes.
*
* <p>Note one could in principle store contact foreign keys here in addition to keys, unlike the
* situation with hosts where client-side renames would make that data stale. However, we sometimes
* rename contacts internally ourselves, and it's easier to use the same model for both cases.
*
* @see <a href="http://tools.ietf.org/html/rfc5731#section-2.2">
* RFC 5731 - EPP Domain Name Mapping- Contact and Client Identifiers</a>
* RFC 5731 - EPP Domain Name Mapping - Contact and Client Identifiers</a>
*/
@Embed
public class DesignatedContact extends ImmutableObject {
@ -55,7 +63,6 @@ public class DesignatedContact extends ImmutableObject {
return instance;
}
@XmlAttribute(required = true)
Type type;
@Index