net.fortuna.ical4j.model.property.CalendarAddress Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of ical4j Show documentation
Show all versions of ical4j Show documentation
A Java library for reading and writing iCalendar (*.ics) files
/**
* Copyright (c) 2012, Ben Fortuna
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* o Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* o 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.
*
* o Neither the name of Ben Fortuna nor the names of any other contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* 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.
*/
package net.fortuna.ical4j.model.property;
import net.fortuna.ical4j.model.Content;
import net.fortuna.ical4j.model.Parameter;
import net.fortuna.ical4j.model.ParameterList;
import net.fortuna.ical4j.model.Property;
import net.fortuna.ical4j.model.PropertyFactory;
import net.fortuna.ical4j.util.Strings;
import net.fortuna.ical4j.util.Uris;
import net.fortuna.ical4j.validate.ParameterValidator;
import net.fortuna.ical4j.validate.ValidationException;
import java.io.IOException;
import java.net.URI;
import java.net.URISyntaxException;
import java.text.ParseException;
import java.util.Arrays;
/**
* $Id$
*
* Created: [Apr 6, 2004]
*
* Defines a CALENDAR-ADDRESS iCalendar component property.
*
* @author benf
*/
public class CalendarAddress extends Property {
private static final long serialVersionUID = 8430929418723298803L;
private URI calAddress;
/**
* Default constructor.
*/
public CalendarAddress() {
super(CALENDAR_ADDRESS, new Factory());
}
/**
* @param aValue a value string for this property
* @throws URISyntaxException where the specified value string is not a valid uri
*/
public CalendarAddress(final String aValue) throws URISyntaxException {
super(CALENDAR_ADDRESS, new Factory());
setValue(aValue);
}
/**
* @param aList a list of parameters for this property
* @param aValue a value string for this property
* @throws URISyntaxException where the specified value string is not a valid uri
*/
public CalendarAddress(final ParameterList aList, final String aValue)
throws URISyntaxException {
super(CALENDAR_ADDRESS, aList, new Factory());
setValue(aValue);
}
/**
* @param aUri a URI
*/
public CalendarAddress(final URI aUri) {
super(CALENDAR_ADDRESS, new Factory());
calAddress = aUri;
}
/**
* @param aList a list of parameters for this component
* @param aUri a URI
*/
public CalendarAddress(final ParameterList aList, final URI aUri) {
super(CALENDAR_ADDRESS, aList, new Factory());
calAddress = aUri;
}
/**
* {@inheritDoc}
*/
public final void setValue(final String aValue) throws URISyntaxException {
calAddress = Uris.create(aValue);
}
/**
* {@inheritDoc}
*/
public final void validate() throws ValidationException {
/*
* ; the following are optional, ; but MUST NOT occur more than once (";" cutypeparam) / (";"memberparam) / (";"
* roleparam) / (";" partstatparam) / (";" rsvpparam) / (";" deltoparam) / (";" delfromparam) / (";"
* sentbyparam) / (";"cnparam) / (";" dirparam) / (";" languageparam) /
*/
Arrays.asList(Parameter.CUTYPE, Parameter.MEMBER, Parameter.ROLE, Parameter.PARTSTAT,
Parameter.RSVP, Parameter.DELEGATED_TO, Parameter.DELEGATED_FROM, Parameter.SENT_BY, Parameter.CN,
Parameter.DIR, Parameter.LANGUAGE).forEach(parameter -> ParameterValidator.assertOneOrLess(parameter, getParameters()));
/* scheduleagent and schedulestatus added for CalDAV scheduling
*/
ParameterValidator.assertOneOrLess(Parameter.SCHEDULE_AGENT,
getParameters());
ParameterValidator.assertOneOrLess(Parameter.SCHEDULE_STATUS,
getParameters());
ParameterValidator.assertOneOrLess(Parameter.PUBLIC_COMMENT,
getParameters());
/*
* ; the following is optional, ; and MAY occur more than once (";" xparam)
*/
}
/**
* @return Returns the calAddress.
*/
public final URI getCalAddress() {
return calAddress;
}
/**
* {@inheritDoc}
*/
public final String getValue() {
return Uris.decode(Strings.valueOf(getCalAddress()));
}
/**
* @param calAddress The calAddress to set.
*/
public final void setCalAddress(final URI calAddress) {
this.calAddress = calAddress;
}
/**
* {@inheritDoc}
*/
public final Property copy() throws IOException, URISyntaxException, ParseException {
// URI are immutable
return new CalendarAddress(new ParameterList(getParameters(), false), calAddress);
}
public static class Factory extends Content.Factory implements PropertyFactory {
private static final long serialVersionUID = 1L;
public Factory() {
super(CALENDAR_ADDRESS);
}
public CalendarAddress createProperty(final ParameterList parameters, final String value)
throws IOException, URISyntaxException, ParseException {
return new CalendarAddress(parameters, value);
}
public CalendarAddress createProperty() {
return new CalendarAddress();
}
}
}