webcit/dav_main.c

   1 /*
   2  * Entry point for GroupDAV functions
   3  *
   4  * Copyright (c) 2005-2010 by the citadel.org team
   5  *
   6  * This program is open source 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.
  10  *
  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.
  15  *
  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
  19  */
  20
  21 #include "webcit.h"
  22 #include "webserver.h"
  23 #include "dav.h"
  24
  25 extern HashList *HandlerHash;
  26
  27 HashList *DavNamespaces = NULL;
  28
  29 /*
  30  * Output HTTP headers which are common to all requests.
  31  *
  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.
  35  *
  36  */
  37 void groupdav_common_headers(void) {
  38         hprintf(
  39                 "Server: %s / %s\r\n"
  40                 "Connection: close\r\n",
  41                 PACKAGE_STRING, ChrPtr(WC->serv_info->serv_software)
  42         );
  43 }
  44
  45
  46
  47 /*
  48  * string conversion function
  49  */
  50 void euid_escapize(char *target, const char *source) {
  51         int i, len;
  52         int target_length = 0;
  53
  54         strcpy(target, "");
  55         len = strlen(source);
  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;
  60                 }
  61                 else {
  62                         sprintf(&target[target_length], "=%02X", (0xFF & source[i]));
  63                         target_length += 3;
  64                 }
  65         }
  66 }
  67
  68 /*
  69  * string conversion function
  70  */
  71 void euid_unescapize(char *target, const char *source) {
  72         int a, b, len;
  73         char hex[3];
  74         int target_length = 0;
  75
  76         strcpy(target, "");
  77
  78         len = strlen(source);
  79         for (a = 0; a < len; ++a) {
  80                 if (source[a] == '=') {
  81                         hex[0] = source[a + 1];
  82                         hex[1] = source[a + 2];
  83                         hex[2] = 0;
  84                         b = 0;
  85                         b = decode_hex(hex);
  86                         target[target_length] = b;
  87                         target[++target_length] = 0;
  88                         a += 2;
  89                 }
  90                 else {
  91                         target[target_length] = source[a];
  92                         target[++target_length] = 0;
  93                 }
  94         }
  95 }
  96
  97
  98
  99
 100 /*
 101  * Main entry point for GroupDAV requests
 102  */
 103 void groupdav_main(void)
 104 {
 105         wcsession *WCC = WC;
 106         int i, len;
 107
 108         StrBufUnescape(WCC->Hdr->HR.ReqLine, 0);
 109
 110         StrBufStripSlashes(WCC->Hdr->HR.ReqLine, 0);
 111
 112         /*
 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.
 115          */
 116         len = StrLength(WCC->Hdr->HR.dav_ifmatch);
 117         if (len > 0) {
 118                 StrBufTrim(WCC->Hdr->HR.dav_ifmatch);
 119                 if (ChrPtr(WCC->Hdr->HR.dav_ifmatch)[0] == '\"') {
 120                         StrBufCutLeft(WCC->Hdr->HR.dav_ifmatch, 1);
 121                         len --;
 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);
 126                                 }
 127                         }
 128                 }
 129                 if (!strcmp(ChrPtr(WCC->Hdr->HR.dav_ifmatch), "*")) {
 130                         FlushStrBuf(WCC->Hdr->HR.dav_ifmatch);
 131                 }
 132         }
 133
 134         switch (WCC->Hdr->HR.eReqType)
 135         {
 136         /*
 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.
 140          */
 141         case eOPTIONS:
 142                 groupdav_options();
 143                 break;
 144
 145
 146         /*
 147          * The PROPFIND method is basically used to list all objects in a
 148          * room, or to list all relevant rooms on the server.
 149          */
 150         case ePROPFIND:
 151                 groupdav_propfind();
 152                 break;
 153
 154         /*
 155          * The GET method is used for fetching individual items.
 156          */
 157         case eGET:
 158                 groupdav_get();
 159                 break;
 160
 161         /*
 162          * The PUT method is used to add or modify items.
 163          */
 164         case ePUT:
 165                 groupdav_put();
 166                 break;
 167
 168         /*
 169          * The DELETE method kills, maims, and destroys.
 170          */
 171         case eDELETE:
 172                 groupdav_delete();
 173                 break;
 174         default:
 175
 176         /*
 177          * Couldn't find what we were looking for.  Die in a car fire.
 178          */
 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]);
 184                 end_burst();
 185         }
 186 }
 187
 188
 189 /*
 190  * Output our host prefix for globally absolute URL's.
 191  */
 192 void groupdav_identify_host(void) {
 193         wc_printf("%s", ChrPtr(site_prefix));
 194 }
 195
 196
 197 void tmplput_dav_HOSTNAME(StrBuf *Target, WCTemplputParams *TP)
 198 {
 199         StrBufAppendPrintf(Target, "%s", ChrPtr(site_prefix));
 200 }
 201
 202 /*
 203  * Output our host prefix for globally absolute URL's.
 204  */
 205 void groupdav_identify_hosthdr(void) {
 206         hprintf("%s", ChrPtr(site_prefix));
 207 }
 208
 209
 210 void Header_HandleIfMatch(StrBuf *Line, ParsedHttpHdrs *hdr)
 211 {
 212         hdr->HR.dav_ifmatch = Line;
 213 }
 214
 215 void Header_HandleDepth(StrBuf *Line, ParsedHttpHdrs *hdr)
 216 {
 217         if (!strcasecmp(ChrPtr(Line), "infinity")) {
 218                 hdr->HR.dav_depth = 32767;
 219         }
 220         else if (strcmp(ChrPtr(Line), "0") == 0) {
 221                 hdr->HR.dav_depth = 0;
 222         }
 223         else if (strcmp(ChrPtr(Line), "1") == 0) {
 224                 hdr->HR.dav_depth = 1;
 225         }
 226 }
 227 int Conditional_DAV_DEPTH(StrBuf *Target, WCTemplputParams *TP)
 228 {
 229         return WC->Hdr->HR.dav_depth == GetTemplateTokenNumber(Target, TP, 2, 0);
 230 }
 231
 232
 233 void RegisterDAVNamespace(const char * UrlString,
 234                           long UrlSLen,
 235                           const char *DisplayName,
 236                           long dslen,
 237                           WebcitHandlerFunc F,
 238                           WebcitRESTDispatchID RID,
 239                           long Flags)
 240 {
 241         void *vHandler;
 242
 243         /* first put it in... */
 244         WebcitAddUrlHandler(UrlString, UrlSLen, DisplayName, dslen, F, Flags|PARSE_REST_URL);
 245         /* get it out again... */
 246         GetHash(HandlerHash, UrlString, UrlSLen, &vHandler);
 247         ((WebcitHandler*)vHandler)->RID = RID;
 248         /* and keep a copy of it, so we can compare it later */
 249         Put(DavNamespaces, UrlString, UrlSLen, vHandler, reference_free_handler);
 250 }
 251
 252 int Conditional_DAV_NS(StrBuf *Target, WCTemplputParams *TP)
 253 {
 254         wcsession *WCC = WC;
 255         void *vHandler;
 256         const char *NS;
 257         long NSLen;
 258
 259         GetTemplateTokenString(NULL, TP, 2, &NS, &NSLen);
 260         GetHash(HandlerHash, NS, NSLen, &vHandler);
 261         return WCC->Hdr->HR.Handler == vHandler;
 262 }
 263
 264
 265 int Conditional_DAV_NSCURRENT(StrBuf *Target, WCTemplputParams *TP)
 266 {
 267         wcsession *WCC = WC;
 268         void *vHandler;
 269
 270         vHandler = CTX;
 271         return WCC->Hdr->HR.Handler == vHandler;
 272 }
 273
 274 void tmplput_DAV_NAMESPACE(StrBuf *Target, WCTemplputParams *TP)
 275 {
 276         wcsession *WCC = WC;
 277
 278         if (TP->Filter.ContextType == CTX_DAVNS) {
 279                 WebcitHandler *H;
 280                 H = (WebcitHandler*) CTX;
 281                 StrBufAppendTemplate(Target, TP, H->Name, 0);
 282         }
 283         else if (WCC->Hdr->HR.Handler != NULL) {
 284                 StrBufAppendTemplate(Target, TP, WCC->Hdr->HR.Handler->Name, 0);
 285         }
 286 }
 287
 288 int GroupdavDispatchREST(RESTDispatchID WhichAction, int IgnoreFloor)
 289 {
 290         wcsession *WCC = WC;
 291         void *vDir;
 292
 293         switch(WhichAction){
 294         case ExistsID:
 295                 GetHash(WCC->Directory, IKEY(WCC->ThisRoom->nRoomNameParts + 1), &vDir);
 296                 return locate_message_by_uid(ChrPtr((StrBuf*)vDir)) != -1;
 297                 /* TODO: remember euid */
 298         case PutID:
 299         case DeleteID:
 300                 break;
 301
 302
 303         }
 304         return 0;
 305 }
 306
 307
 308 void
 309 ServerStartModule_DAV
 310 (void)
 311 {
 312
 313         DavNamespaces = NewHash(1, NULL);
 314
 315 }
 316
 317 void
 318 ServerShutdownModule_DAV
 319 (void)
 320 {
 321         DeleteHash(&DavNamespaces);
 322 }
 323
 324
 325
 326
 327 void
 328 InitModule_GROUPDAV
 329 (void)
 330 {
 331 /*
 332         WebcitAddUrlHandler(HKEY("groupdav"), "", 0, groupdav_main, XHTTP_COMMANDS|COOKIEUNNEEDED|FORCE_SESSIONCLOSE);
 333  */
 334         RegisterDAVNamespace(HKEY("groupdav"), HKEY("GroupDAV"),
 335                              groupdav_main, GroupdavDispatchREST,
 336                              XHTTP_COMMANDS|COOKIEUNNEEDED|FORCE_SESSIONCLOSE);
 337
 338         RegisterNamespace("DAV:HOSTNAME", 0, 0, tmplput_davHOSTNAME, NULL, CTX_NONE);
 339
 340         RegisterConditional(HKEY("COND:DAV:NS"), 0, Conditional_DAV_NS,  CTX_NONE);
 341
 342         RegisterIterator("DAV:NS", 0, DavNamespaces, NULL,
 343                          NULL, NULL, CTX_DAVNS, CTX_NONE, IT_NOFLAG);
 344
 345
 346         RegisterConditional(HKEY("COND:DAV:NSCURRENT"), 0, Conditional_DAV_NSCURRENT,  CTX_DAVNS);
 347         RegisterNamespace("DAV:NAMESPACE", 0, 1, tmplput_DAV_NAMESPACE, NULL, CTX_NONE);
 348
 349         RegisterHeaderHandler(HKEY("IF-MATCH"), Header_HandleIfMatch);
 350         RegisterHeaderHandler(HKEY("DEPTH"), Header_HandleDepth);
 351         RegisterConditional(HKEY("COND:DAV:DEPTH"), 1, Conditional_DAV_DEPTH,  CTX_NONE);
 352
 353 }