org.bedework.carddav.server.SysIntf Maven / Gradle / Ivy
/* ********************************************************************
Licensed to Jasig under one or more contributor license
agreements. See the NOTICE file distributed with this work
for additional information regarding copyright ownership.
Jasig licenses this file to you under the Apache License,
Version 2.0 (the "License"); you may not use this file
except in compliance with the License. You may obtain a
copy of the License at:
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on
an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
*/
package org.bedework.carddav.server;
import org.bedework.access.AccessPrincipal;
import org.bedework.access.Acl;
import org.bedework.access.CurrentAccess;
import org.bedework.carddav.common.CarddavCollection;
import org.bedework.carddav.common.GetLimits;
import org.bedework.carddav.common.GetResult;
import org.bedework.carddav.common.filter.Filter;
import org.bedework.carddav.common.vcard.Card;
import org.bedework.carddav.server.PropertyHandler.PropertyType;
import org.bedework.carddav.server.config.CardDAVConfig;
import org.bedework.carddav.server.config.CardDAVContextConfig;
import org.bedework.webdav.servlet.shared.PrincipalPropertySearch;
import org.bedework.webdav.servlet.shared.WdCollection;
import org.bedework.webdav.servlet.shared.WdSysIntf;
import org.bedework.webdav.servlet.shared.WebdavException;
import java.io.Serializable;
import java.util.Collection;
import javax.servlet.http.HttpServletRequest;
/** All interactions with the underlying calendar system are made via this
* interface.
*
* We're using the bedework object classes here. To simplify matters (a little)
* we don't have distinct event, todo and journal classes. They are all currently
* the BwEvent class with an entityType defining what the object represents.
*
* @author Mike Douglass douglm at rpi.edu
*/
public interface SysIntf extends WdSysIntf {
/** Called before any other method is called to allow initialisation to
* take place at the first or subsequent requests
*
* @param req
* @param account
* @param conf global service configuration
* @param ctxConf per application type configuration
*/
public void init(HttpServletRequest req,
String account,
CardDAVConfig conf,
CardDAVContextConfig ctxConf);
/** Return the current principal
*
* @return String
* @throws WebdavException
*/
public AccessPrincipal getPrincipal();
/** Get a property handler
*
* @param ptype
* @return PropertyHandler
*/
public PropertyHandler getPropertyHandler(PropertyType ptype);
/* *
* @return String url prefix derived from request.
* /
public String getUrlPrefix();
/* *
* @return boolean - true if using relative urls for broken clients
* /
public boolean getRelativeUrls();*/
/** Does the value appear to represent a valid principal?
*
* @param val
* @return true if it's a (possible) principal
*/
public boolean isPrincipal(String val);
/** Return principal information for the given href. Also tests for a valid
* principal.
*
* @param href
* @return AccessPrincipal
*/
public AccessPrincipal getPrincipal(String href);
/**
* @param p
* @return String href
*/
public String makeHref(AccessPrincipal p);
/** The urls should be principal urls. principalUrl can null for the current user.
* The result is a collection of principal urls of which the given url is a
* member, based upon rootUrl. For example, if rootUrl points to the base of
* the user principal hierarchy, then the rsult should be at least the current
* user's principal url, remembering that user principals are themselves groups
* and the user is considered a member of their own group.
*
* @param rootUrl - url to base search on.
* @param principalUrl - url of principal or null for current user
* @return Collection of urls - always non-null
*/
public CollectiongetGroups(String rootUrl,
String principalUrl);
/** Do we allow browsing of directories?
*
* @return boolean true if browsing disallowed
* @throws WebdavException for errors
*/
public boolean getDirectoryBrowsingDisallowed();
/**
* @author Mike Douglass
*/
public static class PrincipalInfo implements Serializable {
/** account as returned by caladdrToUser
*
* Currently tail end of principal path
*/
public String account;
/** principal path prefix
*/
public String principalPathPrefix;
/** Path to user home
*/
public String userHomePath;
/** Path to default address book
*/
public String defaultAddressbookPath;
/** Path to card for principal
*/
public String principalCardPath;
/** Some directory information for the user.
*/
public Card directoryInfo;
/**
* @param account
* @param principalPathPrefix
* @param userHomePath
* @param defaultAddressbookPath
* @param principalCardPath
* @param directoryInfo
*/
public PrincipalInfo(final String account, final String principalPathPrefix,
final String userHomePath,
final String defaultAddressbookPath,
final String principalCardPath,
final Card directoryInfo) {
this.account = account;
this.principalPathPrefix = principalPathPrefix;
this.userHomePath = userHomePath;
this.defaultAddressbookPath = defaultAddressbookPath;
this.principalCardPath = principalCardPath;
this.directoryInfo = directoryInfo;
}
}
/** Given a valid principal return the associated information
* needed for carddav interactions.
*
* @param pcpl the principal
* @param getDirInfo get directory info if true and available.
* @return PrincipalInfo or null
* @throws WebdavException for errors
*/
public PrincipalInfo getPrincipalInfo(AccessPrincipal pcpl,
boolean getDirInfo);
/** Given a uri returns a Collection of uris that allow search operations on
* principals for that resource.
*
* @param resourceUri
* @return Collection of String
*/
public Collection getPrincipalCollectionSet(String resourceUri)
throws WebdavException;
/** Given a PrincipalPropertySearch returns a Collection of matching principals.
*
* @param resourceUri
* @param pps Collection of PrincipalPropertySearch
* @return Collection of CalUserInfo
*/
public Collection getPrincipals(String resourceUri,
PrincipalPropertySearch pps)
throws WebdavException;
/* ====================================================================
* Cards
* ==================================================================== */
/** Add a card.
*
* @param path to collection
* @param card Object to be added
*/
public void addCard(String path,
Card card);
/** Update a card.
*
* @param path to collection
* @param card Object to be updated
*/
public void updateCard(String path,
Card card);
/** Return the cards for the current user in the given collection using the
* supplied filter.
*
* @param col collection
* @param filter - if non-null defines a search filter
* @param limits - applied to this query
* @return Collection populated card objects
*/
public GetResult getCards(CarddavCollection col,
Filter filter,
GetLimits limits);
/** Get card given the collection and String name.
*
* @param path to collection
* @param name String possible name
* @return Vcard or null
*/
public Card getCard(String path, String name)
throws WebdavException;
/**
* @param card
*/
public void deleteCard(CarddavCardNode card);
/**
* @param card
* @param acl
*/
public void updateAccess(CarddavCardNode card,
Acl acl);
/** Check the access for the given entity. Returns the current access
* or null or optionally throws a no access exception.
*
* @param ent
* @param desiredAccess
* @param returnResult
* @return CurrentAccess
* @throws WebdavException if returnResult false and no access
*/
public CurrentAccess checkAccess(CarddavCollection ent,
int desiredAccess,
boolean returnResult)
throws WebdavException;
/**
* @param col
* @param acl
*/
public void updateAccess(CarddavColNode col,
Acl acl);
/**
* @param col Initialised collection object
* @param parentPath
* @return int status
*/
public int makeCollection(CarddavCollection col,
String parentPath);
/**
* @param cal
*/
public void deleteCollection(WdCollection cal);
/** Copy or move the collection to another location.
* Status is set on return
*
* @param from Source collection
* @param to Destination collection
* @param copy true for copying
* @param overwrite destination exists
*/
public void copyMove(WdCollection from,
WdCollection to,
boolean copy,
boolean overwrite);
/** Copy or move the given entity to the destination collection with the given name.
* Status is set on return
*
* @param from Source entity
* @param to Destination collection
* @param name String name of new entity
* @param copy true for copying
* @param overwrite destination exists
* @return true if destination created (i.e. not updated)
*/
public boolean copyMove(Card from,
WdCollection to,
String name,
boolean copy,
boolean overwrite);
/** Get a collection given the path
*
* @param path String path of collection
* @return WdCollection null for unknown collection
*/
public CarddavCollection getCollection(String path);
/** Update a collection.
*
* @param val updated WdCollection object
*/
public void updateCollection(WdCollection val);
/** Returns children of the given collection to which the current user has
* some access.
*
* @param col parent collection
* @param limits
* @return GetResult with collection of WdCollection
*/
public GetResult getCollections(CarddavCollection col,
GetLimits limits)
throws WebdavException;
/* ====================================================================
* Files
* ==================================================================== */
/** PUT a file.
*
* @param coll WdCollection defining recipient collection
* @param val BwResource
*/
public void putFile(WdCollection coll,
CarddavResource val);
/** GET a file.
*
* @param coll WdCollection containing file
* @param name
* @return BwResource
*/
public CarddavResource getFile(WdCollection coll,
String name);
/** Get resource content given the resource. It will be set in the resource
* object
*
* @param val BwResource
*/
public void getFileContent(CarddavResource val);
/** Get the files in a collection.
*
* @param coll WdCollection containing file
* @return Collection of BwResource
*/
public Collection getFiles(WdCollection coll);
/** Update a file.
*
* @param val BwResource
* @param updateContent if true we also update the content
*/
public void updateFile(CarddavResource val,
boolean updateContent);
/** Delete a file.
*
* @param val BwResource
*/
public void deleteFile(CarddavResource val);
/** Copy or move the given file to the destination collection with the given name.
* Status is set on return
*
* @param from Source resource
* @param to Destination collection
* @param name String name of new entity
* @param copy true for copying
* @param overwrite destination exists
* @return true if destination created (i.e. not updated)
*/
public boolean copyMoveFile(CarddavResource from,
WdCollection to,
String name,
boolean copy,
boolean overwrite);
/** Max size for an entity
*
* @return int
*/
public int getMaxUserEntitySize();
/** End any transactions.
*
*/
public void close();
}