2 * Entry point for GroupDAV functions
4 * Copyright (c) 2005-2010 by the citadel.org team
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 3 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 #include "webserver.h"
25 extern HashList *HandlerHash;
27 HashList *DavNamespaces = NULL;
30 * Output HTTP headers which are common to all requests.
32 * Please observe that we don't use the usual output_headers()
33 * and wDumpContent() functions in the GroupDAV subsystem, so we
34 * do our own header stuff here.
37 void groupdav_common_headers(void) {
40 "Connection: close\r\n",
41 PACKAGE_STRING, ChrPtr(WC->serv_info->serv_software)
48 * string conversion function
50 void euid_escapize(char *target, const char *source) {
52 int target_length = 0;
56 for (i=0; i<len; ++i) {
57 if ( (isalnum(source[i])) || (source[i]=='-') || (source[i]=='_') ) {
58 target[target_length] = source[i];
59 target[++target_length] = 0;
62 sprintf(&target[target_length], "=%02X", (0xFF & source[i]));
69 * string conversion function
71 void euid_unescapize(char *target, const char *source) {
74 int target_length = 0;
79 for (a = 0; a < len; ++a) {
80 if (source[a] == '=') {
81 hex[0] = source[a + 1];
82 hex[1] = source[a + 2];
86 target[target_length] = b;
87 target[++target_length] = 0;
91 target[target_length] = source[a];
92 target[++target_length] = 0;
101 * Main entry point for GroupDAV requests
103 void groupdav_main(void)
108 StrBufUnescape(WCC->Hdr->HR.ReqLine, 0);
110 StrBufStripSlashes(WCC->Hdr->HR.ReqLine, 0);
113 * If there's an If-Match: header, strip out the quotes if present, and
114 * then if all that's left is an asterisk, make it go away entirely.
116 len = StrLength(WCC->Hdr->HR.dav_ifmatch);
118 StrBufTrim(WCC->Hdr->HR.dav_ifmatch);
119 if (ChrPtr(WCC->Hdr->HR.dav_ifmatch)[0] == '\"') {
120 StrBufCutLeft(WCC->Hdr->HR.dav_ifmatch, 1);
122 for (i=0; i<len; ++i) {
123 if (ChrPtr(WCC->Hdr->HR.dav_ifmatch)[i] == '\"') {
124 StrBufCutAt(WCC->Hdr->HR.dav_ifmatch, i, NULL);
125 len = StrLength(WCC->Hdr->HR.dav_ifmatch);
129 if (!strcmp(ChrPtr(WCC->Hdr->HR.dav_ifmatch), "*")) {
130 FlushStrBuf(WCC->Hdr->HR.dav_ifmatch);
134 switch (WCC->Hdr->HR.eReqType)
137 * The OPTIONS method is not required by GroupDAV. This is an
138 * experiment to determine what might be involved in supporting
139 * other variants of DAV in the future.
147 * The PROPFIND method is basically used to list all objects in a
148 * room, or to list all relevant rooms on the server.
155 * The GET method is used for fetching individual items.
162 * The PUT method is used to add or modify items.
169 * The DELETE method kills, maims, and destroys.
177 * Couldn't find what we were looking for. Die in a car fire.
179 hprintf("HTTP/1.1 501 Method not implemented\r\n");
180 groupdav_common_headers();
181 hprintf("Content-Type: text/plain\r\n");
182 wc_printf("GroupDAV method \"%s\" is not implemented.\r\n",
183 ReqStrs[WCC->Hdr->HR.eReqType]);
190 * Output our host prefix for globally absolute URL's.
192 void groupdav_identify_host(void) {
195 if (StrLength(WCC->Hdr->HR.http_host)!=0) {
197 (is_https ? "https" : "http"),
198 ChrPtr(WCC->Hdr->HR.http_host));
203 void tmplput_GROUPDAV_HOSTNAME(StrBuf *Target, WCTemplputParams *TP)
207 if (StrLength(WCC->Hdr->HR.http_host)!=0) {
208 StrBufAppendPrintf(Target,
210 (is_https ? "https" : "http"),
211 ChrPtr(WCC->Hdr->HR.http_host));
216 * Output our host prefix for globally absolute URL's.
218 void groupdav_identify_hosthdr(void) {
221 if (StrLength(WCC->Hdr->HR.http_host)!=0) {
223 (is_https ? "https" : "http"),
224 ChrPtr(WCC->Hdr->HR.http_host));
229 void Header_HandleIfMatch(StrBuf *Line, ParsedHttpHdrs *hdr)
231 hdr->HR.dav_ifmatch = Line;
234 void Header_HandleDepth(StrBuf *Line, ParsedHttpHdrs *hdr)
236 if (!strcasecmp(ChrPtr(Line), "infinity")) {
237 hdr->HR.dav_depth = 32767;
239 else if (strcmp(ChrPtr(Line), "0") == 0) {
240 hdr->HR.dav_depth = 0;
242 else if (strcmp(ChrPtr(Line), "1") == 0) {
243 hdr->HR.dav_depth = 1;
246 int Conditional_DAV_DEPTH(StrBuf *Target, WCTemplputParams *TP)
248 return WC->Hdr->HR.dav_depth == GetTemplateTokenNumber(Target, TP, 2, 0);
252 void RegisterDAVNamespace(const char * UrlString,
254 const char *DisplayName,
257 WebcitRESTDispatchID RID,
262 /* first put it in... */
263 WebcitAddUrlHandler(UrlString, UrlSLen, DisplayName, dslen, F, Flags|PARSE_REST_URL);
264 /* get it out again... */
265 GetHash(HandlerHash, UrlString, UrlSLen, &vHandler);
266 ((WebcitHandler*)vHandler)->RID = RID;
267 /* and keep a copy of it, so we can compare it later */
268 Put(DavNamespaces, UrlString, UrlSLen, vHandler, reference_free_handler);
271 int Conditional_DAV_NS(StrBuf *Target, WCTemplputParams *TP)
278 GetTemplateTokenString(NULL, TP, 2, &NS, &NSLen);
279 GetHash(HandlerHash, NS, NSLen, &vHandler);
280 return WCC->Hdr->HR.Handler == vHandler;
284 int Conditional_DAV_NSCURRENT(StrBuf *Target, WCTemplputParams *TP)
290 return WCC->Hdr->HR.Handler == vHandler;
293 void tmplput_DAV_NAMESPACE(StrBuf *Target, WCTemplputParams *TP)
297 if (TP->Filter.ContextType == CTX_DAVNS) {
299 H = (WebcitHandler*) CTX;
300 StrBufAppendTemplate(Target, TP, H->Name, 0);
302 else if (WCC->Hdr->HR.Handler != NULL) {
303 StrBufAppendTemplate(Target, TP, WCC->Hdr->HR.Handler->Name, 0);
307 int GroupdavDispatchREST(RESTDispatchID WhichAction, int IgnoreFloor)
314 GetHash(WCC->Directory, IKEY(WCC->ThisRoom->nRoomNameParts + 1), &vDir);
315 return locate_message_by_uid(ChrPtr((StrBuf*)vDir)) != -1;
316 /* TODO: remember euid */
328 ServerStartModule_DAV
332 DavNamespaces = NewHash(1, NULL);
337 ServerShutdownModule_DAV
340 DeleteHash(&DavNamespaces);
350 // WebcitAddUrlHandler(HKEY("groupdav"), "", 0, groupdav_main, XHTTP_COMMANDS|COOKIEUNNEEDED|FORCE_SESSIONCLOSE);
351 RegisterDAVNamespace(HKEY("groupdav"), HKEY("GroupDAV"),
352 groupdav_main, GroupdavDispatchREST,
353 XHTTP_COMMANDS|COOKIEUNNEEDED|FORCE_SESSIONCLOSE);
355 RegisterNamespace("DAV:HOSTNAME", 0, 0, tmplput_GROUPDAV_HOSTNAME, NULL, CTX_NONE);
357 RegisterConditional(HKEY("COND:DAV:NS"), 0, Conditional_DAV_NS, CTX_NONE);
359 RegisterIterator("DAV:NS", 0, DavNamespaces, NULL,
360 NULL, NULL, CTX_DAVNS, CTX_NONE, IT_NOFLAG);
363 RegisterConditional(HKEY("COND:DAV:NSCURRENT"), 0, Conditional_DAV_NSCURRENT, CTX_DAVNS);
364 RegisterNamespace("DAV:NAMESPACE", 0, 1, tmplput_DAV_NAMESPACE, NULL, CTX_NONE);
366 RegisterHeaderHandler(HKEY("IF-MATCH"), Header_HandleIfMatch);
367 RegisterHeaderHandler(HKEY("DEPTH"), Header_HandleDepth);
368 RegisterConditional(HKEY("COND:DAV:DEPTH"), 1, Conditional_DAV_DEPTH, CTX_NONE);