NAME

       Net::DRI::Data::Contact - Handle contact data, modeled from EPP for Net::DRI

DESCRIPTION

       This base class encapsulates all data for a contact as defined in EPP (RFC4933).  It can
       (and should) be subclassed for TLDs needing to store other data for a contact.  All
       subclasses must have a validate() method that takes care of verifying contact data, and an
       id() method returning an opaque value, unique per contact (in a given registry).

       The following methods are both accessors and mutators : as mutators, they can be called in
       chain, as they all return the object itself.

       Postal information through name() org() street() city() sp() pc() cc() can be provided
       twice.  EPP allows a localized form (content is in unrestricted UTF-8) and
       internationalized form (content MUST be represented in a subset of UTF-8 that can be
       represented in the 7-bit US-ASCII character set). Not all registries support both forms.

       When setting values, you pass one element if both forms are equal or two elements as a
       list (first the localized form, then the internationalized one).  When getting values, in
       list context you get back both values, in scalar context you get back the first one, that
       is the localized form.

       You can also use methods int2loc() and loc2int() to create one version from the other.

METHODS

   loid()
       local object ID for this contact, never sent to registry (can be used to track the local
       db id of this object)

   srid()
       server ID, ID of the object as known by the registry in which it was created

   id()
       an alias (needed for Net::DRI::Data::ContactSet) of the previous method

   roid()
       registry/remote object id (internal to a registry)

   name()
       name of the contact

   org()
       organization of the contact

   street()
       street address of the contact (ref array of up to 3 elements)

   city()
       city of the contact

   sp()
       state/province of the contact

   pc()
       postal code of the contact

   cc()
       alpha2 country code of the contact (will be verified against list of valid country codes)

   email()
       email address of the contact

   voice()
       voice number of the contact (in the form +CC.NNNNNNNNxEEE)

   fax()
       fax number of the contact (same form as above)

   auth()
       authentication for this contact (hash ref with a key 'pw' and a value being the password)

   disclose()
       privacy settings related to this contact (see RFC)

   int2loc()
       create the localized part from the internationalized part ; existing internationalized
       data is overwritten

   loc2int()
       create the internationalized part from the localized part ; existing localized data is
       overwritten ; as the internationalized part must be a subset of UTF-8 when the localized
       one can be the full UTF-8, this operation may creates undefined characters (?) as result

   as_string()
       return a string formed with all data contained in this contact object ; this is mostly
       useful for debugging and logging, this string should not be parsed as its format is not
       guaranteed to remain stable, you should use the above accessors

   attributes()
       return an array of attributes name available in this contact object (taking into account
       any subclass specific attribute)

SUPPORT

       For now, support questions should be sent to:

       <netdri@dotandco.com>

       Please also see the SUPPORT file in the distribution.

SEE ALSO

       http://www.dotandco.com/services/software/Net-DRI/

AUTHOR

       Patrick Mevzek, <netdri@dotandco.com>

COPYRIGHT

       Copyright (c) 2005-2010 Patrick Mevzek <netdri@dotandco.com>.  All rights reserved.

       This program is free software; you can redistribute it and/or modify it under the terms of
       the GNU General Public License as published by the Free Software Foundation; either
       version 2 of the License, or (at your option) any later version.

       See the LICENSE file that comes with this distribution for more details.