package biweekly.property;

import java.util.List;

import biweekly.ICalVersion;
import biweekly.Warning;
import biweekly.component.ICalComponent;
import biweekly.component.VAlarm;
import biweekly.parameter.CalendarUserType;
import biweekly.parameter.ParticipationLevel;
import biweekly.parameter.ParticipationStatus;
import biweekly.parameter.Role;

/*
 Copyright (c) 2013-2015, Michael Angstadt
 All rights reserved.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met: 

 1. Redistributions of source code must retain the above copyright notice, this
 list of conditions and the following disclaimer. 
 2. Redistributions in binary form must reproduce the above copyright notice,
 this list of conditions and the following disclaimer in the documentation
 and/or other materials provided with the distribution. 

 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
 ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

/**
 * <p>
 * Defines an attendee (such as a person attending an event). This property has
 * different meanings depending on the component that it belongs to:
 * <ul>
 * <li>{@link VAlarm} (with "EMAIL" action) - An email address that is to
 * receive the alarm.</li>
 * <li>All others - An attendee of the calendar entity.</li>
 * </ul>
 * </p>
 * 
 * <p>
 * <b>Code sample:</b>
 * 
 * <pre class="brush:java">
 * VEvent event = new VEvent();
 * 
 * Attendee attendee = Attendee.email("johndoe@example.com")
 * attendee.setCommonName("John Doe");
 * attendee.setRsvp(true);
 * attendee.setRole(Role.CHAIR);
 * attendee.setParticipationStatus(ParticipationStatus.ACCEPTED);
 * event.addAttendee(attendee);
 * </pre>
 * 
 * </p>
 * @author Michael Angstadt
 * @see <a href="http://tools.ietf.org/html/rfc5545#page-107">RFC 5545
 * p.107-9</a>
 * @see <a href="http://tools.ietf.org/html/rfc2445#page-102">RFC 2445
 * p.102-4</a>
 * @see <a href="http://www.imc.org/pdi/vcal-10.doc">vCal 1.0 p.25-7</a>
 */
public class Attendee extends ICalProperty {
        private String name, email, uri;
        private Role role;
        private ParticipationLevel participationLevel;
        private ParticipationStatus status;
        private Boolean rsvp;

        /**
         * Creates an attendee property.
         * @param name the attendee's name (e.g. "John Doe")
         * @param email the attendee's email (e.g. "jdoe@example.com")
         */
        public Attendee(String name, String email) {
                this.name = name;
                this.email = email;
        }

        /**
         * Creates an attendee property.
         * @param uri a URI representing the attendee (typically, an email address,
         * e.g. "mailto:johndoe@example.com")
         */
        public Attendee(String uri) {
                this.uri = uri;
        }

        /**
         * Gets the attendee's email
         * @return the email (e.g. "jdoe@company.com")
         */
        public String getEmail() {
                return email;
        }

        /**
         * Sets the attendee's email
         * @param email the email (e.g. "jdoe@company.com")
         */
        public void setEmail(String email) {
                this.email = email;
        }

        /**
         * Gets a URI representing the attendee.
         * @return the URI (e.g. "mailto:jdoe@company.com")
         */
        public String getUri() {
                return uri;
        }

        /**
         * Sets a URI representing the attendee.
         * @param uri the URI (e.g. "mailto:jdoe@company.com")
         */
        public void setUri(String uri) {
                this.uri = uri;
        }

        /**
         * <p>
         * Gets the type of user the attendee is (for example, an "individual" or a
         * "room").
         * </p>
         * <p>
         * <b>Supported versions:</b> {@code 2.0}
         * </p>
         * @return the calendar user type or null if not set
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-16">RFC 5545
         * p.16</a>
         */
        public CalendarUserType getCalendarUserType() {
                return parameters.getCalendarUserType();
        }

        /**
         * <p>
         * Sets the type of user the attendee is (for example, an "individual" or a
         * "room").
         * </p>
         * <p>
         * <b>Supported versions:</b> {@code 2.0}
         * </p>
         * @param cutype the calendar user type or null to remove
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-16">RFC 5545
         * p.16</a>
         */
        public void setCalendarUserType(CalendarUserType cutype) {
                parameters.setCalendarUserType(cutype);
        }

        /**
         * <p>
         * Gets the groups that the attendee is a member of.
         * </p>
         * <p>
         * <b>Supported versions:</b> {@code 2.0}
         * </p>
         * @return the group URIs (typically, these are email address URIs, e.g.
         * "mailto:mailinglist@example.com")
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-21">RFC 5545
         * p.21-2</a>
         */
        public List<String> getMembers() {
                return parameters.getMembers();
        }

        /**
         * <p>
         * Adds a group that the attendee is a member of.
         * </p>
         * <p>
         * <b>Supported versions:</b> {@code 2.0}
         * </p>
         * @param uri the group URI (typically, an email address URI, e.g.
         * "mailto:mailinglist@example.com")
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-21">RFC 5545
         * p.21-2</a>
         */
        public void addMember(String uri) {
                parameters.addMember(uri);
        }

        /**
         * Gets an attendee's role (for example, "chair" or "attendee").
         * @return the role or null if not set
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-25">RFC 5545
         * p.25-6</a>
         * @see <a href="http://www.imc.org/pdi/vcal-10.doc">vCal 1.0 p.25</a>
         */
        public Role getRole() {
                return role;
        }

        /**
         * Sets an attendee's role (for example, "chair" or "attendee").
         * @param role the role or null to remove
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-25">RFC 5545
         * p.25-6</a>
         * @see <a href="http://www.imc.org/pdi/vcal-10.doc">vCal 1.0 p.25</a>
         */
        public void setRole(Role role) {
                this.role = role;
        }

        /**
         * Gets an attendee's level of participation.
         * @return the participation level or null if not set
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-25">RFC 5545
         * p.25-6</a>
         * @see <a href="http://www.imc.org/pdi/vcal-10.doc">vCal 1.0 p.26-7</a>
         */
        public ParticipationLevel getParticipationLevel() {
                return participationLevel;
        }

        /**
         * Sets an attendee's level of participation.
         * @param level the participation level or null to remove
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-25">RFC 5545
         * p.25-6</a>
         * @see <a href="http://www.imc.org/pdi/vcal-10.doc">vCal 1.0 p.26-7</a>
         */
        public void setParticipationLevel(ParticipationLevel level) {
                this.participationLevel = level;
        }

        /**
         * Gets an attendee's participation status
         * @return the participation status or null if not set
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-22">RFC 5545
         * p.22-3</a>
         * @see <a href="http://www.imc.org/pdi/vcal-10.doc">vCal 1.0 p.25-6</a>
         */
        public ParticipationStatus getParticipationStatus() {
                return status;
        }

        /**
         * Sets an attendee's participation status.
         * @param status the participation status or null to remove
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-22">RFC 5545
         * p.22-3</a>
         * @see <a href="http://www.imc.org/pdi/vcal-10.doc">vCal 1.0 p.25-6</a>
         */
        public void setParticipationStatus(ParticipationStatus status) {
                this.status = status;
        }

        /**
         * Gets whether the organizer requests a response from the attendee.
         * @return true if an RSVP is requested, false if not, null if not set
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-26">RFC 5545
         * p.26-7</a>
         */
        public Boolean getRsvp() {
                return rsvp;
        }

        /**
         * Sets whether the organizer requests a response from the attendee.
         * @param rsvp true if an RSVP has been requested, false if not, null to
         * remove
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-26">RFC 5545
         * p.26-7</a>
         */
        public void setRsvp(Boolean rsvp) {
                this.rsvp = rsvp;
        }

        /**
         * <p>
         * Gets the people who have delegated their responsibility to the attendee.
         * @return the delegators (typically email URIs, e.g.
         * "mailto:janedoe@example.com")
         * </p>
         * <p>
         * <b>Supported versions:</b> {@code 2.0}
         * </p>
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-17">RFC 5545
         * p.17</a>
         */
        public List<String> getDelegatedFrom() {
                return parameters.getDelegatedFrom();
        }

        /**
         * <p>
         * Adds a person who has delegated his or her responsibility to the
         * attendee.
         * </p>
         * <p>
         * <b>Supported versions:</b> {@code 2.0}
         * </p>
         * @param uri the delegator (typically an email URI, e.g.
         * "mailto:janedoe@example.com")
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-17">RFC 5545
         * p.17</a>
         */
        public void addDelegatedFrom(String uri) {
                parameters.addDelegatedFrom(uri);
        }

        /**
         * <p>
         * Gets the people to which the attendee has delegated his or her
         * responsibility.
         * </p>
         * <p>
         * <b>Supported versions:</b> {@code 2.0}
         * </p>
         * @return the delegatees (typically email URIs, e.g.
         * "mailto:janedoe@example.com")
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-17">RFC 5545
         * p.17-8</a>
         */
        public List<String> getDelegatedTo() {
                return parameters.getDelegatedTo();
        }

        /**
         * <p>
         * Adds a person to which the attendee has delegated his or her
         * responsibility.
         * </p>
         * <p>
         * <b>Supported versions:</b> {@code 2.0}
         * </p>
         * @param uri the delegatee (typically an email URI, e.g.
         * "mailto:janedoe@example.com")
         * @see <a href="http://tools.ietf.org/html/rfc5545#page-17">RFC 5545
         * p.17-8</a>
         */
        public void addDelegatedTo(String uri) {
                parameters.addDelegatedTo(uri);
        }

        @Override
        public String getSentBy() {
                return super.getSentBy();
        }

        @Override
        public void setSentBy(String uri) {
                super.setSentBy(uri);
        }

        @Override
        public String getCommonName() {
                return name;
        }

        @Override
        public void setCommonName(String commonName) {
                this.name = commonName;
        }

        @Override
        public String getDirectoryEntry() {
                return super.getDirectoryEntry();
        }

        @Override
        public void setDirectoryEntry(String uri) {
                super.setDirectoryEntry(uri);
        }

        /**
         * Gets the language that the common name is written in.
         */
        @Override
        public String getLanguage() {
                return super.getLanguage();
        }

        /**
         * Sets the language that the common name is written in.
         */
        @Override
        public void setLanguage(String language) {
                super.setLanguage(language);
        }

        @Override
        protected void validate(List<ICalComponent> components, ICalVersion version, List<Warning> warnings) {
                //TODO
        }
}