Package org.exoplatform.caldav.service

Class CaldavOutboundService

java.lang.Object

org.exoplatform.caldav.service.CaldavOutboundService

@Service
public class CaldavOutboundService
extends Object

Gives each of a user's eXo personal calendars a collection of its own on the remote server.

This is the first code that creates collections in the customer's own calendar space. Until now eXo only ever wrote into a collection it had made for itself, and everything here is shaped by that difference.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	COLLECTION_PREFIX	Every collection this service creates is named from this prefix.

Constructor Summary

Constructors

Constructor	Description
CaldavOutboundService()

Method Summary

Modifier and Type	Method	Description
List<org.exoplatform.caldav.model.CalendarSync>	bindPersonalCalendars(long userIdentityId, String username)	Binds every personal calendar of a user to a collection on their server, creating what does not exist yet.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

COLLECTION_PREFIX

public static final String COLLECTION_PREFIX

Every collection this service creates is named from this prefix.

See Also:

• Constant Field Values

Constructor Details

CaldavOutboundService

public CaldavOutboundService()

Method Details

bindPersonalCalendars

public List<org.exoplatform.caldav.model.CalendarSync> bindPersonalCalendars(long userIdentityId,
 String username)

Binds every personal calendar of a user to a collection on their server, creating what does not exist yet.

This is the first step that talks to the server in both sequences that reach it — a connection and a synchronisation pass — so what it does with a failure decides how many credential-bearing requests the whole sequence makes. Two failures are re-thrown rather than absorbed, because they are properties of the server and are settled after one attempt: CalDavAuthenticationException (a person must act) and CalDavUnreachableException (nothing is there). Letting the caller continue past either of them buys nothing and costs four more authenticated requests against a server that may be counting them (EXO-89806).

Anything else stays absorbed exactly as before: a home this account cannot be read out of, an answer that is not DAV XML, a quirk on one account — those say nothing about the rest of the pass, whose later steps ask the server different questions and may well be answered.

Parameters:

userIdentityId - identity of the user

username - the user's login, which agenda's ACL reads

Returns:

the pairs, bound or refused, one per personal calendar

Throws:

CalDavAuthenticationException - when the server refused the stored credentials

CalDavUnreachableException - when the server could not be reached