Annotation of libwww/Library/src/HTAnchor.c, revision 1.70
1.14 frystyk 1: /* HTAnchor.c
2: ** HYPERTEXT "ANCHOR" OBJECT
1.1 timbl 3: **
1.22 frystyk 4: ** (c) COPYRIGHT MIT 1995.
1.14 frystyk 5: ** Please first read the full copyright statement in the file COPYRIGH.
1.70 ! frystyk 6: ** @(#) $Id: HTAnchor.c,v 1.69 1997/12/16 21:09:02 frystyk Exp $
1.14 frystyk 7: **
8: ** An anchor represents a region of a hypertext document which is
9: ** linked to another anchor in the same or a different document.
1.1 timbl 10: **
11: ** History
12: ** Nov 1990 Written in Objective-C for the NeXT browser (TBL)
13: ** 24-Oct-1991 (JFG), written in C, browser-independant
14: ** 21-Nov-1991 (JFG), first complete version
1.41 frystyk 15: ** 3-May-1995 (HF), Added a lot of methods and other stuff made an object
1.54 frystyk 16: ** July 1996 Patch for adding hash of children Michael Farrar
1.1 timbl 17: */
18:
1.16 frystyk 19: /* Library include files */
1.46 frystyk 20: #include "sysdep.h"
1.50 frystyk 21: #include "WWWUtil.h"
1.7 luotonen 22: #include "HTFormat.h"
1.1 timbl 23: #include "HTParse.h"
1.24 frystyk 24: #include "HTMethod.h"
1.63 frystyk 25: #include "HTWWWStr.h"
1.41 frystyk 26: #include "HTAncMan.h" /* Implemented here */
1.11 frystyk 27:
1.70 ! frystyk 28: #define HASH_SIZE 599 /* Arbitrary prime. Memory/speed tradeoff */
! 29: #define CHILD_HASH_SIZE 97 /* Often smaller than hash of parents */
1.1 timbl 30:
31: PRIVATE HTList **adult_table=0; /* Point to table of lists of all parents */
32:
1.17 frystyk 33: /* ------------------------------------------------------------------------- */
34: /* Creation Methods */
35: /* ------------------------------------------------------------------------- */
36:
37: /*
1.1 timbl 38: ** Do not use "new" by itself outside this module. In order to enforce
39: ** consistency, we insist that you furnish more information about the
40: ** anchor you are creating : use newWithParent or newWithAddress.
41: */
1.35 frystyk 42: PRIVATE HTParentAnchor * HTParentAnchor_new (void)
1.1 timbl 43: {
1.43 frystyk 44: HTParentAnchor *newAnchor;
1.54 frystyk 45: if ((newAnchor = (HTParentAnchor *) HT_CALLOC(1, sizeof (HTParentAnchor))) == NULL)
1.43 frystyk 46: HT_OUTOFMEM("HTParentAnchor_new");
1.16 frystyk 47: newAnchor->parent = newAnchor;
1.17 frystyk 48: newAnchor->content_type = WWW_UNKNOWN;
1.24 frystyk 49: newAnchor->mainLink.method = METHOD_INVALID;
1.41 frystyk 50: newAnchor->content_length = -1; /* howcome 6 dec 95 */
1.28 frystyk 51: newAnchor->date = (time_t) -1;
52: newAnchor->expires = (time_t) -1;
53: newAnchor->last_modified = (time_t) -1;
1.59 frystyk 54: newAnchor->age = (time_t) -1;
1.16 frystyk 55: return newAnchor;
1.1 timbl 56: }
57:
1.16 frystyk 58:
1.35 frystyk 59: PRIVATE HTChildAnchor * HTChildAnchor_new (void)
1.1 timbl 60: {
1.43 frystyk 61: HTChildAnchor *child;
62: if ((child = (HTChildAnchor *) HT_CALLOC(1, sizeof(HTChildAnchor))) == NULL)
63: HT_OUTOFMEM("HTChildAnchor_new");
1.33 frystyk 64: return child;
1.1 timbl 65: }
66:
1.17 frystyk 67: /* Create new or find old child anchor
68: ** -----------------------------------
1.1 timbl 69: **
1.3 timbl 70: ** Me one is for a new anchor being edited into an existing
1.17 frystyk 71: ** document. The parent anchor must already exist. All
72: ** children without tags (no NAME attribut) points to the same NULL
73: ** child.
1.54 frystyk 74: ** Children are now hashed for performance reasons. Thanks to
75: ** Michael Farrar
1.1 timbl 76: */
1.35 frystyk 77: PUBLIC HTChildAnchor * HTAnchor_findChild (HTParentAnchor * parent,
1.46 frystyk 78: const char * tag)
1.1 timbl 79: {
1.54 frystyk 80: HTChildAnchor * child = NULL;
81: HTList * kids = NULL;
1.17 frystyk 82: if (!parent) {
1.54 frystyk 83: if (ANCH_TRACE) HTTrace("Child Anchor Bad argument\n");
1.17 frystyk 84: return NULL;
85: }
1.1 timbl 86:
1.54 frystyk 87: /* Find a hash for this tag (if any) */
88: {
89: int hash = 0;
90: /*
91: ** If tag is empty then use hash value 0
92: */
93: if (tag) {
94: const char * ptr = tag;
95: for(; *ptr; ptr++)
96: hash = (int) ((hash*3 + (*(unsigned char*)ptr)) % CHILD_HASH_SIZE);
97: }
1.55 frystyk 98: if (!parent->children) {
99: if (!(parent->children = (HTList **)
1.54 frystyk 100: HT_CALLOC(CHILD_HASH_SIZE, sizeof(HTList *))))
101: HT_OUTOFMEM("HTAnchor_findChild");
102: }
1.55 frystyk 103: if (!parent->children[hash]) parent->children[hash] = HTList_new();
104: kids = parent->children[hash];
1.54 frystyk 105: }
106:
1.17 frystyk 107: /* First search list of children to see if tag is already there */
1.54 frystyk 108: if (tag && *tag) {
109: HTList * cur = kids;
110: while ((child = (HTChildAnchor *) HTList_nextObject(cur))) {
1.56 frystyk 111: if (child->tag && !strcmp(child->tag, tag)) {
1.54 frystyk 112: if (ANCH_TRACE)
113: HTTrace("Child Anchor %p of parent %p with name `%s' already exists.\n",
114: (void *) child, (void *) parent, tag);
115: return child;
1.1 timbl 116: }
117: }
1.54 frystyk 118: }
119:
120: /* If not found then create a new child anchor */
1.17 frystyk 121: child = HTChildAnchor_new();
1.54 frystyk 122: HTList_addObject(kids, (void *) child);
1.17 frystyk 123: child->parent = parent;
1.54 frystyk 124: if (tag) StrAllocCopy(child->tag, tag);
1.17 frystyk 125: if (ANCH_TRACE)
1.54 frystyk 126: HTTrace("Child Anchor New Anchor %p named `%s' is child of %p\n",
1.46 frystyk 127: (void *) child, tag ? tag : (const char *) "", (void *)parent);
1.17 frystyk 128: return child;
1.1 timbl 129: }
130:
131:
132: /* Create new or find old named anchor
133: ** -----------------------------------
134: **
1.3 timbl 135: ** Me one is for a reference which is found in a document, and might
1.1 timbl 136: ** not be already loaded.
137: ** Note: You are not guaranteed a new anchor -- you might get an old one,
138: ** like with fonts.
139: */
1.46 frystyk 140: PUBLIC HTAnchor * HTAnchor_findAddress (const char * address)
1.1 timbl 141: {
1.16 frystyk 142: char *tag = HTParse (address, "", PARSE_ANCHOR); /* Any tags? */
1.1 timbl 143:
1.16 frystyk 144: /* If the address represents a sub-anchor, we recursively load its parent,
145: then we create a child anchor within that document. */
146: if (*tag) {
1.34 frystyk 147: char *addr = HTParse(address, "", PARSE_ACCESS | PARSE_HOST |
148: PARSE_PATH | PARSE_PUNCTUATION);
149: HTParentAnchor * parent = (HTParentAnchor*) HTAnchor_findAddress(addr);
150: HTChildAnchor * child = HTAnchor_findChild(parent, tag);
1.43 frystyk 151: HT_FREE(addr);
152: HT_FREE(tag);
1.34 frystyk 153: return (HTAnchor *) child;
1.16 frystyk 154: } else { /* Else check whether we have this node */
155: int hash;
1.46 frystyk 156: const char *p;
1.16 frystyk 157: HTList * adults;
158: HTList *grownups;
159: HTParentAnchor * foundAnchor;
1.34 frystyk 160: char *newaddr = NULL;
161: StrAllocCopy(newaddr, address); /* Get our own copy */
1.43 frystyk 162: HT_FREE(tag);
1.38 frystyk 163: newaddr = HTSimplify(&newaddr);
1.34 frystyk 164:
1.16 frystyk 165: /* Select list from hash table */
166: for(p=newaddr, hash=0; *p; p++)
167: hash = (int) ((hash * 3 + (*(unsigned char*)p)) % HASH_SIZE);
1.33 frystyk 168: if (!adult_table) {
1.43 frystyk 169: if ((adult_table = (HTList* *) HT_CALLOC(HASH_SIZE, sizeof(HTList*))) == NULL)
170: HT_OUTOFMEM("HTAnchor_findAddress");
1.33 frystyk 171: }
1.16 frystyk 172: if (!adult_table[hash]) adult_table[hash] = HTList_new();
173: adults = adult_table[hash];
174:
175: /* Search list for anchor */
176: grownups = adults;
177: while ((foundAnchor = (HTParentAnchor *) HTList_nextObject(grownups))){
1.33 frystyk 178: if (!strcmp(foundAnchor->address, newaddr)) {
1.16 frystyk 179: if (ANCH_TRACE)
1.44 eric 180: HTTrace("Find Parent. %p with address `%s' already exists.\n",
1.16 frystyk 181: (void*) foundAnchor, newaddr);
1.43 frystyk 182: HT_FREE(newaddr); /* We already have it */
1.16 frystyk 183: return (HTAnchor *) foundAnchor;
184: }
185: }
186:
187: /* Node not found : create new anchor. */
188: foundAnchor = HTParentAnchor_new();
189: foundAnchor->address = newaddr; /* Remember our copy */
190: HTList_addObject (adults, foundAnchor);
1.44 eric 191: if (ANCH_TRACE) HTTrace("Find Parent. %p with hash %d and address `%s' created\n", (void*)foundAnchor, hash, newaddr);
1.1 timbl 192: return (HTAnchor *) foundAnchor;
193: }
194: }
195:
1.17 frystyk 196: /* Create or find a child anchor with a possible link
197: ** --------------------------------------------------
198: **
199: ** Create new anchor with a given parent and possibly
200: ** a name, and possibly a link to a _relatively_ named anchor.
1.34 frystyk 201: ** All parameters EXCEPT parent can be NULL
1.17 frystyk 202: */
1.34 frystyk 203: PUBLIC HTChildAnchor * HTAnchor_findChildAndLink (HTParentAnchor * parent,
1.46 frystyk 204: const char * tag,
205: const char * href,
1.41 frystyk 206: HTLinkType ltype)
1.17 frystyk 207: {
1.34 frystyk 208: HTChildAnchor * child = HTAnchor_findChild(parent, tag);
1.54 frystyk 209: if (child && href && *href) {
1.53 frystyk 210: char * relative_to = HTAnchor_expandedAddress((HTAnchor *) parent);
1.34 frystyk 211: char * parsed_address = HTParse(href, relative_to, PARSE_ALL);
212: HTAnchor * dest = HTAnchor_findAddress(parsed_address);
1.52 frystyk 213: HTLink_add((HTAnchor *) child, dest, ltype, METHOD_INVALID);
1.43 frystyk 214: HT_FREE(parsed_address);
215: HT_FREE(relative_to);
1.34 frystyk 216: }
217: return child;
1.17 frystyk 218: }
219:
1.52 frystyk 220: /* ------------------------------------------------------------------------- */
221: /* Link Methods */
222: /* ------------------------------------------------------------------------- */
1.28 frystyk 223:
1.41 frystyk 224: /*
225: ** Upgrade the link to the main destination and and downgrade the
226: ** current main link to the list
227: */
228: PUBLIC HTLink * HTAnchor_mainLink (HTAnchor * me)
229: {
230: return me ? &(me->mainLink) : NULL;
231: }
1.28 frystyk 232:
1.41 frystyk 233: PUBLIC BOOL HTAnchor_setMainLink (HTAnchor * me, HTLink * movingLink)
1.28 frystyk 234: {
1.41 frystyk 235: if (!(me && me->links && movingLink &&
236: HTList_removeObject(me->links, movingLink)))
237: return NO;
238: else {
239: /* First push current main link onto top of links list */
1.52 frystyk 240: HTLink * newLink = HTLink_new();
1.42 frystyk 241: memcpy ((void *) newLink, & me->mainLink, sizeof (HTLink));
1.41 frystyk 242: HTList_addObject (me->links, newLink);
243:
1.52 frystyk 244: /* Now make movingLink the new main link, and delete it */
1.42 frystyk 245: memcpy ((void *) &me->mainLink, movingLink, sizeof (HTLink));
1.52 frystyk 246: HTLink_delete(movingLink);
1.28 frystyk 247: return YES;
248: }
249: }
250:
251: /*
1.41 frystyk 252: ** Handling sub links
1.24 frystyk 253: */
1.41 frystyk 254: PUBLIC HTList * HTAnchor_subLinks (HTAnchor * anchor)
1.24 frystyk 255: {
1.41 frystyk 256: return anchor ? anchor->links : NULL;
1.24 frystyk 257: }
258:
1.41 frystyk 259: PUBLIC BOOL HTAnchor_setSubLinks (HTAnchor * anchor, HTList * list)
260: {
261: if (anchor) {
262: anchor->links = list;
263: return YES;
264: }
265: return NO;
266: }
1.24 frystyk 267:
268: /*
1.41 frystyk 269: ** Returns the main destination of this anchor
270: */
271: PUBLIC HTAnchor * HTAnchor_followMainLink (HTAnchor * me)
272: {
1.52 frystyk 273: return me ? HTLink_destination(&me->mainLink) : NULL;
1.17 frystyk 274: }
275:
276: /* ------------------------------------------------------------------------- */
277: /* Deletion Methods */
278: /* ------------------------------------------------------------------------- */
1.1 timbl 279:
280: /* Delete an anchor and possibly related things (auto garbage collection)
281: ** --------------------------------------------
282: **
283: ** The anchor is only deleted if the corresponding document is not loaded.
1.10 frystyk 284: ** All outgoing links from parent and children are deleted, and this
285: ** anchor is removed from the sources list of all its targets.
1.1 timbl 286: ** We also try to delete the targets whose documents are not loaded.
287: ** If this anchor's source list is empty, we delete it and its children.
288: */
289:
1.41 frystyk 290: /* Deletes all the memory allocated in a parent anchor and returns any
291: ** hyperdoc object hanging of this anchor
1.19 frystyk 292: */
1.41 frystyk 293: PRIVATE void * delete_parent (HTParentAnchor * me)
1.19 frystyk 294: {
1.41 frystyk 295: void * doc = me->document;
1.19 frystyk 296:
297: /* Remove link and address information */
1.26 frystyk 298: if (me->links) {
299: HTList *cur = me->links;
300: HTLink *pres;
301: while ((pres = (HTLink *) HTList_nextObject(cur)))
1.52 frystyk 302: HTLink_delete(pres);
1.26 frystyk 303: HTList_delete(me->links);
304: }
1.54 frystyk 305:
306: /* Remove children */
307: if (me->children) {
308: int cnt = 0;
309: for (; cnt<CHILD_HASH_SIZE; cnt++) {
310: if (me->children[cnt]) HTList_delete(me->children[cnt]);
311: }
312: HT_FREE(me->children);
313: }
314:
1.19 frystyk 315: HTList_delete (me->sources);
1.52 frystyk 316: HTList_delete (me->variants);
1.43 frystyk 317: HT_FREE(me->physical);
318: HT_FREE(me->address);
1.19 frystyk 319:
320: /* Then remove entity header information (metainformation) */
1.59 frystyk 321: HTAnchor_clearHeader(me);
1.57 frystyk 322:
1.43 frystyk 323: HT_FREE(me);
1.19 frystyk 324: return doc;
325: }
326:
327:
1.41 frystyk 328: /* Delete a parent anchor and all its children. If a hyperdoc object
329: ** is found hanging off the parent anchor then this is returned
1.19 frystyk 330: */
1.41 frystyk 331: PRIVATE void * delete_family (HTAnchor * me)
1.19 frystyk 332: {
1.64 frystyk 333: HTParentAnchor * parent = NULL;
1.19 frystyk 334: if (!me) {
1.64 frystyk 335: if (ANCH_TRACE) HTTrace("AnchorDelete No anchor found\n");
1.19 frystyk 336: return NULL;
337: }
1.64 frystyk 338: parent = me->parent;
339: if (ANCH_TRACE)
340: HTTrace("AnchorDelete Remove parent %p and children\n", parent);
1.19 frystyk 341:
342: /* Delete children */
343: if (parent->children) {
1.54 frystyk 344: int cnt = 0;
345: for (; cnt<CHILD_HASH_SIZE; cnt++) {
346: HTList * kids = parent->children[cnt];
347: if (kids) {
348: HTChildAnchor * child;
349: while ((child=(HTChildAnchor*)HTList_removeLastObject(kids))) {
350: HT_FREE(child->tag);
351: if (child->links) {
352: HTList * cur = child->links;
353: HTLink * pres;
354: while ((pres = (HTLink *) HTList_nextObject(cur)))
355: HTLink_delete(pres);
356: HTList_delete(child->links);
357: }
358: HT_FREE(child);
359: }
360: HTList_delete(kids);
361: parent->children[cnt] = NULL;
1.26 frystyk 362: }
1.19 frystyk 363: }
364: }
365: return delete_parent(parent);
366: }
367:
368:
369: /* DELETE ALL ANCHORS
370: ** ------------------
371: ** Deletes all anchors and return a list of all the HyperDocs found.
372: ** It is for the application to delete any HyperDocs.
1.39 frystyk 373: ** If NULL then no hyperdocs are returned
1.19 frystyk 374: ** Return YES if OK, else NO
375: */
1.35 frystyk 376: PUBLIC BOOL HTAnchor_deleteAll (HTList * documents)
1.19 frystyk 377: {
378: int cnt;
379: HTList *cur;
1.39 frystyk 380: if (!adult_table)
1.19 frystyk 381: return NO;
382: for (cnt=0; cnt<HASH_SIZE; cnt++) {
383: if ((cur = adult_table[cnt])) {
384: HTParentAnchor *pres;
385: while ((pres = (HTParentAnchor *) HTList_nextObject(cur)) != NULL){
1.41 frystyk 386: void * doc = delete_family((HTAnchor *) pres);
387: if (doc && documents) HTList_addObject(documents, doc);
1.19 frystyk 388: }
389: }
390: HTList_delete(adult_table[cnt]);
391: }
1.43 frystyk 392: HT_FREE(adult_table);
1.19 frystyk 393: return YES;
394: }
395:
396:
1.54 frystyk 397: PRIVATE void delete_links (HTAnchor * me)
1.1 timbl 398: {
1.3 timbl 399: if (! me)
1.1 timbl 400: return;
401:
402: /* Recursively try to delete target anchors */
1.3 timbl 403: if (me->mainLink.dest) {
404: HTParentAnchor *parent = me->mainLink.dest->parent;
405: HTList_removeObject (parent->sources, me);
1.1 timbl 406: if (! parent->document) /* Test here to avoid calling overhead */
407: HTAnchor_delete (parent);
408: }
1.3 timbl 409: if (me->links) { /* Extra destinations */
1.1 timbl 410: HTLink *target;
1.12 frystyk 411: while ((target = (HTLink *) HTList_removeLastObject (me->links))) {
1.1 timbl 412: HTParentAnchor *parent = target->dest->parent;
1.3 timbl 413: HTList_removeObject (parent->sources, me);
1.1 timbl 414: if (! parent->document) /* Test here to avoid calling overhead */
415: HTAnchor_delete (parent);
416: }
417: }
418: }
419:
1.35 frystyk 420: PUBLIC BOOL HTAnchor_delete (HTParentAnchor * me)
1.1 timbl 421: {
1.54 frystyk 422: /* Don't delete if document is loaded */
423: if (!me || me->document) {
424: if (ANCH_TRACE) HTTrace("Anchor...... Not deleted\n");
425: return NO;
426: }
427:
428: /* Recursively try to delete target anchors */
429: delete_links ((HTAnchor *) me);
1.1 timbl 430:
1.54 frystyk 431: if (!HTList_isEmpty(me->sources)) { /* There are still incoming links */
432:
433: /*
434: ** Delete all outgoing links from children, if any
435: */
436: if (me->children) {
437: int cnt = 0;
438: for (; cnt<CHILD_HASH_SIZE; cnt++) {
439: HTList * kids = me->children[cnt];
440: if (kids) {
441: HTChildAnchor * child;
442: while ((child = (HTChildAnchor *) HTList_nextObject(kids)))
443: delete_links((HTAnchor *) child);
444: return NO; /* Parent not deleted */
445: }
446: }
447: }
1.1 timbl 448:
1.54 frystyk 449: /*
450: ** No more incoming links : kill everything
451: ** First, recursively delete children
452: */
453: if (me->children) {
454: int cnt = 0;
455: for (; cnt<CHILD_HASH_SIZE; cnt++) {
456: HTList * kids = me->children[cnt];
457: if (kids) {
458: HTChildAnchor * child;
459: while ((child=(HTChildAnchor *) HTList_removeLastObject(kids)))
460: delete_links((HTAnchor *) child);
461: HT_FREE(child->tag);
462: HT_FREE(child);
463: }
464: }
465: }
466: }
1.1 timbl 467:
1.54 frystyk 468: /* Now kill myself */
469: delete_parent(me);
470: return YES; /* Parent deleted */
471: #if 0
1.3 timbl 472: if (! HTList_isEmpty (me->sources)) { /* There are still incoming links */
1.1 timbl 473: /* Delete all outgoing links from children, if any */
1.3 timbl 474: HTList *kids = me->children;
1.12 frystyk 475: while ((child = (HTChildAnchor *) HTList_nextObject (kids)))
1.54 frystyk 476: delete_links ((HTAnchor *) child);
1.1 timbl 477: return NO; /* Parent not deleted */
478: }
479:
480: /* No more incoming links : kill everything */
481: /* First, recursively delete children */
1.12 frystyk 482: while ((child = (HTChildAnchor *) HTList_removeLastObject (me->children))) {
1.54 frystyk 483: delete_links ((HTAnchor *) child);
1.43 frystyk 484: HT_FREE(child->tag);
485: HT_FREE(child);
1.1 timbl 486: }
1.54 frystyk 487: #endif
1.69 frystyk 488: }
489:
490: /* FLATTEN ALL ANCHORS
491: ** -------------------
492: ** Flattens the anchor web structure into an array.
493: ** This is useful for calculating statistics, sorting
494: ** the parent anchors etc.
495: **
496: ** The caller can indicate the size of the array (total
497: ** number of anchors if known - otherwise 0).
498: **
499: ** Return an array that must be freed by the caller or
500: ** NULL if no anchors.
501: */
502: PUBLIC HTArray * HTAnchor_getArray (int growby)
503: {
504: int cnt;
505: HTArray * array = NULL;
506: HTList * cur = NULL;
507: if (!adult_table) return NULL;
508:
509: /* Allocate an array for the anchors */
510: if (!growby) growby = HASH_SIZE;
511: array = HTArray_new(growby);
512:
513: /* Traverse anchor structure */
514: for (cnt=0; cnt<HASH_SIZE; cnt++) {
515: if ((cur = adult_table[cnt])) {
516: HTParentAnchor * pres = NULL;
517: while ((pres = (HTParentAnchor *) HTList_nextObject(cur)) != NULL) {
518: if (HTArray_addObject(array, pres) == NO) {
519: if (ANCH_TRACE)
520: HTTrace("Anchor...... Can't add object %p to array %p\n",
521: pres, array);
522: break;
523: }
524: }
525: }
526: }
527: return array;
1.1 timbl 528: }
529:
1.17 frystyk 530: /* ------------------------------------------------------------------------- */
531: /* Data Access Methods */
532: /* ------------------------------------------------------------------------- */
1.1 timbl 533:
1.35 frystyk 534: PUBLIC HTParentAnchor * HTAnchor_parent (HTAnchor * me)
1.1 timbl 535: {
1.17 frystyk 536: return me ? me->parent : NULL;
1.1 timbl 537: }
538:
1.41 frystyk 539: PUBLIC void HTAnchor_setDocument (HTParentAnchor * me, void * doc)
1.1 timbl 540: {
1.41 frystyk 541: if (me) me->document = doc;
1.1 timbl 542: }
543:
1.41 frystyk 544: PUBLIC void * HTAnchor_document (HTParentAnchor * me)
1.1 timbl 545: {
1.17 frystyk 546: return me ? me->document : NULL;
1.1 timbl 547: }
548:
1.53 frystyk 549: PUBLIC char * HTAnchor_address (HTAnchor * me)
550: {
551: char *addr = NULL;
552: if (me) {
553: if (((HTParentAnchor *) me == me->parent) ||
554: !((HTChildAnchor *) me)->tag) { /* it's an adult or no tag */
555: StrAllocCopy (addr, me->parent->address);
556: }
557: else { /* it's a named child */
558: if ((addr = (char *) HT_MALLOC(2 + strlen (me->parent->address) + \
559: strlen (((HTChildAnchor *) me)->tag))) == NULL)
560: HT_OUTOFMEM("HTAnchor_address");
561: sprintf (addr, "%s#%s", me->parent->address,
562: ((HTChildAnchor *) me)->tag);
563: }
564: }
565: return addr;
566: }
567:
1.51 frystyk 568: /*
1.53 frystyk 569: ** We resolve the child address with respect to either a base URL,
570: ** a content-location, or to the request-URI
1.51 frystyk 571: */
1.53 frystyk 572: PUBLIC char * HTAnchor_expandedAddress (HTAnchor * me)
1.1 timbl 573: {
1.17 frystyk 574: char *addr = NULL;
575: if (me) {
1.53 frystyk 576: HTParentAnchor * parent = me->parent;
1.63 frystyk 577: char * base = HTAnchor_base(parent);
1.17 frystyk 578: if (((HTParentAnchor *) me == me->parent) ||
579: !((HTChildAnchor *) me)->tag) { /* it's an adult or no tag */
1.52 frystyk 580: StrAllocCopy(addr, base);
1.51 frystyk 581: } else { /* it's a named child */
1.52 frystyk 582: if ((addr = (char *) HT_MALLOC(2 + strlen(base) + strlen(((HTChildAnchor *) me)->tag))) == NULL)
1.43 frystyk 583: HT_OUTOFMEM("HTAnchor_address");
1.52 frystyk 584: sprintf (addr, "%s#%s", base, ((HTChildAnchor *) me)->tag);
1.17 frystyk 585: }
1.1 timbl 586: }
1.17 frystyk 587: return addr;
1.1 timbl 588: }
589:
1.52 frystyk 590: /* Physical Address
591: ** ----------------
592: */
593: PUBLIC char * HTAnchor_physical (HTParentAnchor * me)
594: {
1.53 frystyk 595: return me ? me->physical ? me->physical : me->address : NULL;
1.52 frystyk 596: }
597:
1.53 frystyk 598: PUBLIC void HTAnchor_setPhysical (HTParentAnchor * me, char * physical)
1.52 frystyk 599: {
600: if (!me || !physical) {
601: if (ANCH_TRACE)
602: HTTrace("HTAnchor.... setPhysical, called with null argument\n");
603: return;
604: }
605: StrAllocCopy(me->physical, physical);
606: }
607:
1.53 frystyk 608: PUBLIC void HTAnchor_clearPhysical(HTParentAnchor * me)
609: {
610: if (me) HT_FREE(me->physical);
611: }
612:
613: /*
614: ** Children information
615: */
1.35 frystyk 616: PUBLIC BOOL HTAnchor_hasChildren (HTParentAnchor * me)
1.17 frystyk 617: {
1.54 frystyk 618: return (me && me->children);
1.17 frystyk 619: }
1.1 timbl 620:
1.63 frystyk 621: /* ------------------------------------------------------------------------- */
622: /* Entity Header Information */
623: /* ------------------------------------------------------------------------- */
624:
1.59 frystyk 625: /*
1.63 frystyk 626: ** Take the relevant infomration from the response object and cache it
627: ** in the anchor object. We inherit the information that is already
628: ** parsed in the response along with the unparsed headers.
1.52 frystyk 629: */
1.63 frystyk 630: PUBLIC BOOL HTAnchor_update (HTParentAnchor * me, HTResponse * response)
1.52 frystyk 631: {
1.63 frystyk 632: if (me && response) {
1.59 frystyk 633:
1.63 frystyk 634: if (ANCH_TRACE)
635: HTTrace("HTAnchor.... Updating metainformation for %p\n", me);
1.59 frystyk 636:
1.63 frystyk 637: /*
638: ** The content length and type is already parsed at this point
639: ** in time. We also check for format parameters like charset etc.
640: ** and copy the contents in the anchor object
641: */
642: me->content_length = HTResponse_length(response);
643: me->content_type = HTResponse_format(response);
644: me->type_parameters = HTResponse_formatParam(response);
645:
646: /*
647: ** Inherit all the unparsed headers - we may need them later!
648: */
1.68 frystyk 649: me->headers = HTResponse_handOverHeader(response);
1.59 frystyk 650:
651: /*
1.63 frystyk 652: ** Notifify the response object not to delete the lists that we
653: ** have inherited in the anchor object
1.59 frystyk 654: */
1.63 frystyk 655: HTResponse_isCached(response, YES);
1.59 frystyk 656:
657: return YES;
658: }
659: return NO;
1.52 frystyk 660: }
661:
662: /*
663: ** Variants. If this anchor has any variants then keep them in a list
664: ** so that we can find them later. The list is simply a list of
665: ** parent anchors.
666: */
667: PUBLIC HTList * HTAnchor_variants (HTParentAnchor * me)
1.17 frystyk 668: {
1.52 frystyk 669: return me ? me->variants : NULL;
1.17 frystyk 670: }
1.1 timbl 671:
1.52 frystyk 672: PUBLIC BOOL HTAnchor_addVariant (HTParentAnchor * me,
673: HTParentAnchor * variant)
1.1 timbl 674: {
1.52 frystyk 675: if (me && variant) {
676: if (!me->variants) me->variants = HTList_new();
677: return HTList_addObject(me->variants, variant);
678: }
679: return NO;
1.17 frystyk 680: }
681:
1.52 frystyk 682: PUBLIC BOOL HTAnchor_deleteVariant (HTParentAnchor * me,
683: HTParentAnchor * variant)
1.17 frystyk 684: {
1.52 frystyk 685: return (me && variant) ? HTList_removeObject(me->variants, variant) : NO;
1.9 frystyk 686: }
1.1 timbl 687:
1.52 frystyk 688: /*
689: ** Is this resource an index?
1.17 frystyk 690: */
1.52 frystyk 691: PUBLIC void HTAnchor_clearIndex (HTParentAnchor * me)
692: {
693: if (me) me->isIndex = NO;
694: }
1.17 frystyk 695:
1.52 frystyk 696: PUBLIC void HTAnchor_setIndex (HTParentAnchor * me)
1.1 timbl 697: {
1.52 frystyk 698: if (me) me->isIndex = YES;
1.1 timbl 699: }
700:
1.52 frystyk 701: PUBLIC BOOL HTAnchor_isIndex (HTParentAnchor * me)
1.1 timbl 702: {
1.52 frystyk 703: return me ? me->isIndex : NO;
1.27 frystyk 704: }
705:
1.52 frystyk 706: /* Content Base
1.51 frystyk 707: ** ------------
708: */
709: PUBLIC char * HTAnchor_base (HTParentAnchor * me)
710: {
1.63 frystyk 711: if (me) {
712: if (me->content_base) return me->content_base;
713: if (me->headers) {
714: char * base = HTAssocList_findObject(me->headers, "content-base");
715: /*
716: ** If no base is found then take the content-location if this
717: ** is present and is absolute, else use the Request-URI.
718: */
1.66 frystyk 719: if (base) StrAllocCopy(me->content_base, HTStrip(base));
1.63 frystyk 720: }
1.66 frystyk 721:
722: /*
723: ** Try the content location if any
724: */
725: {
726: char * location = HTAnchor_location(me);
727: StrAllocCopy(me->content_base,
728: (location && HTURL_isAbsolute(location)) ?
729: location : me->address);
730: }
731: return me->content_base;
1.63 frystyk 732: }
733: return NULL;
1.51 frystyk 734: }
735:
736: PUBLIC BOOL HTAnchor_setBase (HTParentAnchor * me, char * base)
737: {
1.63 frystyk 738: if (me && base) {
739: StrAllocCopy(me->content_base, base);
740: return YES;
1.51 frystyk 741: }
1.63 frystyk 742: return NO;
1.51 frystyk 743: }
744:
1.52 frystyk 745: /* Content Location
746: ** ----------------
1.27 frystyk 747: */
1.52 frystyk 748: PUBLIC char * HTAnchor_location (HTParentAnchor * me)
1.27 frystyk 749: {
1.63 frystyk 750: if (me) {
751: if (me->content_location)
752: return *me->content_location ? me->content_location : NULL;
753: if (me->headers) {
754: char * location = HTAssocList_findObject(me->headers, "content-location");
755: StrAllocCopy(me->content_location, location ? HTStrip(location) : "");
756: return me->content_location;
757: }
758: }
759: return NULL;
1.27 frystyk 760: }
761:
1.53 frystyk 762: /*
763: ** Expand the location relative to the base URL if any, otherwise the
764: ** anchor address it self
765: */
1.52 frystyk 766: PUBLIC BOOL HTAnchor_setLocation (HTParentAnchor * me, char * location)
1.27 frystyk 767: {
1.53 frystyk 768: if (me && location) {
1.63 frystyk 769: char * base = HTAnchor_base(me);
770: if (!base) base = me->address;
1.53 frystyk 771: me->content_location = HTParse(location, base, PARSE_ALL);
772: return YES;
1.52 frystyk 773: }
1.53 frystyk 774: return NO;
1.1 timbl 775: }
776:
1.52 frystyk 777: /* Content-Type
778: ** ------------
1.17 frystyk 779: */
1.35 frystyk 780: PUBLIC HTFormat HTAnchor_format (HTParentAnchor * me)
1.17 frystyk 781: {
782: return me ? me->content_type : NULL;
783: }
1.1 timbl 784:
1.35 frystyk 785: PUBLIC void HTAnchor_setFormat (HTParentAnchor * me, HTFormat form)
1.1 timbl 786: {
1.17 frystyk 787: if (me) me->content_type = form;
1.1 timbl 788: }
789:
1.52 frystyk 790: PUBLIC HTAssocList * HTAnchor_formatParam (HTParentAnchor * me)
791: {
792: return me ? me->type_parameters : NULL;
793: }
794:
795: PUBLIC BOOL HTAnchor_addFormatParam (HTParentAnchor * me,
796: const char * name, const char * value)
797: {
798: if (me) {
799: if (!me->type_parameters) me->type_parameters = HTAssocList_new();
800: return HTAssocList_replaceObject(me->type_parameters, name, value);
801: }
802: return NO;
803: }
804:
1.17 frystyk 805: /*
806: ** Charset parameter to Content-Type
1.1 timbl 807: */
1.35 frystyk 808: PUBLIC HTCharset HTAnchor_charset (HTParentAnchor * me)
1.1 timbl 809: {
1.52 frystyk 810: if (me && me->type_parameters) {
811: char * charset = HTAssocList_findObject(me->type_parameters,"charset");
812: return HTAtom_for(charset);
813: }
814: return NULL;
1.1 timbl 815: }
816:
1.52 frystyk 817: PUBLIC BOOL HTAnchor_setCharset (HTParentAnchor * me, HTCharset charset)
1.1 timbl 818: {
1.52 frystyk 819: return HTAnchor_addFormatParam(me, "charset", HTAtom_name(charset));
1.1 timbl 820: }
821:
1.17 frystyk 822: /*
1.20 frystyk 823: ** Level parameter to Content-Type
824: */
1.35 frystyk 825: PUBLIC HTLevel HTAnchor_level (HTParentAnchor * me)
1.20 frystyk 826: {
1.52 frystyk 827: if (me && me->type_parameters) {
828: char * level = HTAssocList_findObject(me->type_parameters, "level");
829: return HTAtom_for(level);
830: }
831: return NULL;
1.20 frystyk 832: }
833:
1.52 frystyk 834: PUBLIC BOOL HTAnchor_setLevel (HTParentAnchor * me, HTLevel level)
1.20 frystyk 835: {
1.52 frystyk 836: return HTAnchor_addFormatParam(me, "level", HTAtom_name(level));
1.20 frystyk 837: }
838:
839: /*
1.17 frystyk 840: ** Content Encoding
841: */
1.47 frystyk 842: PUBLIC HTList * HTAnchor_encoding (HTParentAnchor * me)
1.1 timbl 843: {
1.17 frystyk 844: return me ? me->content_encoding : NULL;
1.1 timbl 845: }
846:
1.63 frystyk 847: PUBLIC BOOL HTAnchor_addEncoding (HTParentAnchor * me, HTEncoding encoding)
1.17 frystyk 848: {
1.47 frystyk 849: if (me && encoding) {
850: if (!me->content_encoding) me->content_encoding = HTList_new();
851: return HTList_addObject(me->content_encoding, encoding);
852: }
853: return NO;
1.17 frystyk 854: }
855:
1.67 frystyk 856: PUBLIC BOOL HTAnchor_removeEncoding (HTParentAnchor * me, HTEncoding encoding)
857: {
858: return (me && me->content_encoding && encoding) ?
859: HTList_removeObject(me->content_encoding, encoding) : NO;
860: }
861:
1.17 frystyk 862: /*
1.21 frystyk 863: ** Content Language
864: */
1.47 frystyk 865: PUBLIC HTList * HTAnchor_language (HTParentAnchor * me)
1.21 frystyk 866: {
1.63 frystyk 867: if (me) {
868: if (me->content_language == NULL && me->headers) {
869: char * value = HTAssocList_findObject(me->headers, "content-language");
870: char * field;
871: if (!me->content_language) me->content_language = HTList_new();
872: while ((field = HTNextField(&value)) != NULL) {
873: char * lc = field;
874: while ((*lc = TOLOWER(*lc))) lc++;
875: HTList_addObject(me->content_language, HTAtom_for(field));
876: }
877: }
878: return me->content_language;
879: }
880: return NULL;
1.21 frystyk 881: }
882:
1.63 frystyk 883: PUBLIC BOOL HTAnchor_addLanguage (HTParentAnchor * me, HTLanguage language)
1.21 frystyk 884: {
1.47 frystyk 885: if (me && language) {
886: if (!me->content_language) me->content_language = HTList_new();
887: return HTList_addObject(me->content_language, language);
888: }
889: return NO;
1.21 frystyk 890: }
891:
892: /*
1.17 frystyk 893: ** Content Length
894: */
1.35 frystyk 895: PUBLIC long int HTAnchor_length (HTParentAnchor * me)
1.1 timbl 896: {
1.17 frystyk 897: return me ? me->content_length : -1;
1.1 timbl 898: }
899:
1.35 frystyk 900: PUBLIC void HTAnchor_setLength (HTParentAnchor * me, long int length)
1.17 frystyk 901: {
902: if (me) me->content_length = length;
903: }
1.1 timbl 904:
1.49 frystyk 905: PUBLIC void HTAnchor_addLength (HTParentAnchor * me, long int deltalength)
906: {
907: if (me) {
908: if (me->content_length < 0)
909: me->content_length = deltalength;
910: else
911: me->content_length += deltalength;
912: }
913: }
914:
1.17 frystyk 915: /*
1.63 frystyk 916: ** Content Transfer Encoding
917: */
918: PUBLIC HTEncoding HTAnchor_transfer (HTParentAnchor * me)
919: {
920: return me ? me->transfer : NULL;
921: }
922:
923: PUBLIC void HTAnchor_setTransfer (HTParentAnchor * me, HTEncoding transfer)
924: {
925: if (me) me->transfer = transfer;
926: }
927:
928: /*
1.17 frystyk 929: ** Allowed methods (Allow)
1.1 timbl 930: */
1.63 frystyk 931: PUBLIC HTMethod HTAnchor_allow (HTParentAnchor * me)
1.17 frystyk 932: {
1.63 frystyk 933: if (me) {
934: if (me->allow == 0 && me->headers) {
935: char * value = HTAssocList_findObject(me->headers, "allow");
936: char * field;
937:
938: /*
939: ** We treat methods allowed on this object as case insensitive
940: ** in case we receive the information over the net - that is -
941: ** in the Allow header.
942: */
943: while ((field = HTNextField(&value)) != NULL) {
944: HTMethod new_method;
945: if ((new_method = HTMethod_enum(field)) != METHOD_INVALID)
946: me->allow |= new_method;
947: }
948: }
949: return me->allow;
950: }
951: return METHOD_INVALID;
1.17 frystyk 952: }
1.1 timbl 953:
1.63 frystyk 954: PUBLIC void HTAnchor_setAllow (HTParentAnchor * me, HTMethod methodset)
1.1 timbl 955: {
1.63 frystyk 956: if (me) me->allow = methodset;
1.1 timbl 957: }
958:
1.63 frystyk 959: PUBLIC void HTAnchor_appendAllow (HTParentAnchor * me, HTMethod methodset)
1.1 timbl 960: {
1.63 frystyk 961: if (me) me->allow |= methodset;
1.1 timbl 962: }
963:
1.17 frystyk 964: /*
965: ** Title
1.2 timbl 966: */
1.46 frystyk 967: PUBLIC const char * HTAnchor_title (HTParentAnchor * me)
1.1 timbl 968: {
1.63 frystyk 969: if (me) {
970: if (me->title)
971: return *me->title ? me->title : NULL;
972: if (me->headers) {
973: char * value = HTAssocList_findObject(me->headers, "title");
974: char * title;
975: if ((title = HTNextField(&value))) StrAllocCopy(me->title, title);
976: return me->title;
977: }
978: }
979: return NULL;
1.17 frystyk 980: }
1.1 timbl 981:
1.46 frystyk 982: PUBLIC void HTAnchor_setTitle (HTParentAnchor * me, const char * title)
1.17 frystyk 983: {
984: if (me && title) StrAllocCopy(me->title, title);
1.2 timbl 985: }
986:
1.46 frystyk 987: PUBLIC void HTAnchor_appendTitle (HTParentAnchor * me, const char * title)
1.17 frystyk 988: {
989: if (me && title) StrAllocCat(me->title, title);
990: }
1.2 timbl 991:
1.17 frystyk 992: /*
993: ** Version
1.2 timbl 994: */
1.41 frystyk 995: PUBLIC char * HTAnchor_version (HTParentAnchor * me)
1.17 frystyk 996: {
1.63 frystyk 997: if (me) {
998: if (me->version)
999: return *me->version ? me->version : NULL;
1000: if (me->headers) {
1001: char * value = HTAssocList_findObject(me->headers, "version");
1002: char * version;
1003: if ((version = HTNextField(&value)))
1004: StrAllocCopy(me->version, version);
1005: return me->version;
1006: }
1007: }
1008: return NULL;
1.17 frystyk 1009: }
1.2 timbl 1010:
1.46 frystyk 1011: PUBLIC void HTAnchor_setVersion (HTParentAnchor * me, const char * version)
1.2 timbl 1012: {
1.17 frystyk 1013: if (me && version) StrAllocCopy(me->version, version);
1.2 timbl 1014: }
1015:
1.17 frystyk 1016: /*
1017: ** Derived from
1.2 timbl 1018: */
1.41 frystyk 1019: PUBLIC char * HTAnchor_derived (HTParentAnchor * me)
1.17 frystyk 1020: {
1.63 frystyk 1021: if (me) {
1022: if (me->derived_from)
1023: return *me->derived_from ? me->derived_from : NULL;
1024: if (me->headers) {
1025: char * value = HTAssocList_findObject(me->headers, "derived-from");
1026: char * derived_from;
1027: if ((derived_from = HTNextField(&value)))
1028: StrAllocCopy(me->derived_from, derived_from);
1029: return me->derived_from;
1030: }
1031: }
1032: return NULL;
1.17 frystyk 1033: }
1034:
1.46 frystyk 1035: PUBLIC void HTAnchor_setDerived (HTParentAnchor * me, const char *derived_from)
1.17 frystyk 1036: {
1037: if (me && derived_from) StrAllocCopy(me->derived_from, derived_from);
1038: }
1.2 timbl 1039:
1.17 frystyk 1040: /*
1.52 frystyk 1041: ** Content MD5
1042: */
1043: PUBLIC char * HTAnchor_md5 (HTParentAnchor * me)
1044: {
1.63 frystyk 1045: if (me) {
1046: if (me->content_md5)
1047: return *me->content_md5 ? me->content_md5 : NULL;
1048: if (me->headers) {
1049: char * value = HTAssocList_findObject(me->headers, "content-md5");
1050: char * md5;
1051: if ((md5 = HTNextField(&value))) StrAllocCopy(me->content_md5,md5);
1052: return me->content_md5;
1053: }
1054: }
1055: return NULL;
1.52 frystyk 1056: }
1057:
1.63 frystyk 1058: PUBLIC BOOL HTAnchor_setMd5 (HTParentAnchor * me, const char * hash)
1.52 frystyk 1059: {
1.63 frystyk 1060: if (me && hash) {
1061: StrAllocCopy(me->content_md5, hash);
1062: return YES;
1063: }
1064: return NO;
1.52 frystyk 1065: }
1066:
1067: /*
1.28 frystyk 1068: ** Date
1069: */
1.41 frystyk 1070: PUBLIC time_t HTAnchor_date (HTParentAnchor * me)
1071: {
1.63 frystyk 1072: if (me) {
1073: if (me->date == (time_t) -1 && me->headers) {
1074: char * value = HTAssocList_findObject(me->headers, "date");
1075: if (value) me->date = HTParseTime(value, NULL, YES);
1076: }
1077: return me->date;
1078: }
1079: return (time_t) -1;
1.41 frystyk 1080: }
1081:
1.46 frystyk 1082: PUBLIC void HTAnchor_setDate (HTParentAnchor * me, const time_t date)
1.28 frystyk 1083: {
1.41 frystyk 1084: if (me) me->date = date;
1.28 frystyk 1085: }
1086:
1087: /*
1088: ** Expires
1089: */
1.41 frystyk 1090: PUBLIC time_t HTAnchor_expires (HTParentAnchor * me)
1091: {
1.63 frystyk 1092: if (me) {
1093: if (me->expires == (time_t) -1 && me->headers) {
1094: char * value = HTAssocList_findObject(me->headers, "expires");
1095: if (value) me->expires = HTParseTime(value, NULL, YES);
1096: }
1097: return me->expires;
1098: }
1099: return (time_t) -1;
1.41 frystyk 1100: }
1101:
1.46 frystyk 1102: PUBLIC void HTAnchor_setExpires (HTParentAnchor * me, const time_t expires)
1.28 frystyk 1103: {
1.41 frystyk 1104: if (me) me->expires = expires;
1.28 frystyk 1105: }
1106:
1107: /*
1108: ** Last Modified
1109: */
1.41 frystyk 1110: PUBLIC time_t HTAnchor_lastModified (HTParentAnchor * me)
1111: {
1.63 frystyk 1112: if (me) {
1113: if (me->last_modified == (time_t) -1 && me->headers) {
1114: char * value = HTAssocList_findObject(me->headers,"last-modified");
1115: if (value) me->last_modified = HTParseTime(value, NULL, YES);
1116: }
1117: return me->last_modified;
1118: }
1119: return (time_t) -1;
1.41 frystyk 1120: }
1121:
1.46 frystyk 1122: PUBLIC void HTAnchor_setLastModified (HTParentAnchor * me, const time_t lm)
1.28 frystyk 1123: {
1.41 frystyk 1124: if (me) me->last_modified = lm;
1.28 frystyk 1125: }
1126:
1127: /*
1.59 frystyk 1128: ** Age
1129: */
1130: PUBLIC time_t HTAnchor_age (HTParentAnchor * me)
1131: {
1.63 frystyk 1132: if (me) {
1133: if (me->age == (time_t) -1 && me->headers) {
1134: char * value = HTAssocList_findObject(me->headers, "age");
1135: if (value) me->age = atol(value);
1136: }
1137: return me->age;
1138: }
1139: return (time_t) -1;
1.59 frystyk 1140: }
1141:
1142: PUBLIC void HTAnchor_setAge (HTParentAnchor * me, const time_t age)
1143: {
1144: if (me) me->age = age;
1145: }
1146:
1147: /*
1.52 frystyk 1148: ** Entity Tag
1149: */
1150: PUBLIC char * HTAnchor_etag (HTParentAnchor * me)
1151: {
1.63 frystyk 1152: if (me) {
1153: if (me->etag)
1154: return *me->etag ? me->etag : NULL;
1155: if (me->headers) {
1156: char * value = HTAssocList_findObject(me->headers, "etag");
1157: char * etag;
1158: if ((etag = HTNextField(&value))) StrAllocCopy(me->etag, etag);
1159: return me->etag;
1160: }
1161: }
1162:
1.52 frystyk 1163: return me ? me->etag : NULL;
1164: }
1165:
1166: PUBLIC void HTAnchor_setEtag (HTParentAnchor * me, const char * etag)
1167: {
1168: if (me && etag) StrAllocCopy(me->etag, etag);
1169: }
1170:
1171: PUBLIC BOOL HTAnchor_isEtagWeak (HTParentAnchor * me)
1172: {
1173: return (me && me->etag && !strncasecomp(me->etag, "W/", 2));
1174: }
1175:
1176: /*
1.63 frystyk 1177: ** Original headers (if any)
1.17 frystyk 1178: */
1.63 frystyk 1179: PUBLIC HTAssocList * HTAnchor_header (HTParentAnchor * me)
1.2 timbl 1180: {
1.63 frystyk 1181: return me ? me->headers : NULL;
1.2 timbl 1182: }
1183:
1.63 frystyk 1184: PUBLIC BOOL HTAnchor_setHeader (HTParentAnchor * me, HTAssocList * headers)
1.2 timbl 1185: {
1.17 frystyk 1186: if (me) {
1.63 frystyk 1187: me->headers = headers;
1188: return YES;
1.17 frystyk 1189: }
1.63 frystyk 1190: return NO;
1.2 timbl 1191: }
1192:
1.23 frystyk 1193: /*
1.59 frystyk 1194: ** Validate anchor values and finish up parsing
1.2 timbl 1195: */
1.59 frystyk 1196: PUBLIC void HTAnchor_setHeaderParsed (HTParentAnchor * me)
1.2 timbl 1197: {
1.59 frystyk 1198: if (me) {
1199:
1200: /*
1201: ** If the server did not send a date then use the current time
1202: */
1203: if (me->date < 0) me->date = time(NULL);
1204:
1205: /*
1206: ** If we don't get a Last-Modified header then set it to date
1207: */
1.62 frystyk 1208: if (ANCH_TRACE) HTTrace("HTAnchor.... Anchor is parsed\n");
1.59 frystyk 1209: me->header_parsed = YES;
1210: }
1.23 frystyk 1211: }
1212:
1.59 frystyk 1213: PUBLIC BOOL HTAnchor_headerParsed (HTParentAnchor * me)
1.23 frystyk 1214: {
1.59 frystyk 1215: return (me ? me->header_parsed : NO);
1.2 timbl 1216: }
1217:
1.17 frystyk 1218: /* Clear Header Information
1219: ** ------------------------
1220: */
1.35 frystyk 1221: PUBLIC void HTAnchor_clearHeader (HTParentAnchor * me)
1.2 timbl 1222: {
1.63 frystyk 1223: if (ANCH_TRACE) HTTrace("HTAnchor.... Clear all header information\n");
1224: me->allow = METHOD_INVALID;
1.48 frystyk 1225: if (me->content_encoding) {
1226: HTList_delete(me->content_encoding);
1.65 frystyk 1227: me->content_encoding = NULL;
1.48 frystyk 1228: }
1.17 frystyk 1229: if (me->content_language) {
1230: HTList_delete(me->content_language);
1.65 frystyk 1231: me->content_language = NULL;
1.9 frystyk 1232: }
1.51 frystyk 1233: HT_FREE(me->content_base);
1234: HT_FREE(me->content_location);
1.17 frystyk 1235: me->content_length = -1; /* Invalid */
1.57 frystyk 1236:
1.59 frystyk 1237: /* Delete the title */
1238: HT_FREE(me->title);
1239:
1.57 frystyk 1240: /* Clear the content type */
1.17 frystyk 1241: me->content_type = WWW_UNKNOWN;
1.52 frystyk 1242: if (me->type_parameters) {
1243: HTAssocList_delete(me->type_parameters);
1244: me->type_parameters = NULL;
1245: }
1.57 frystyk 1246:
1247: /* Dates etc. */
1.28 frystyk 1248: me->date = (time_t) -1;
1249: me->expires = (time_t) -1;
1250: me->last_modified = (time_t) -1;
1.59 frystyk 1251: me->age = (time_t) -1;
1.17 frystyk 1252:
1.43 frystyk 1253: HT_FREE(me->derived_from);
1254: HT_FREE(me->version);
1.58 frystyk 1255: HT_FREE(me->etag);
1.63 frystyk 1256:
1257: /* Delete any original headers */
1258: if (me->headers) HTAssocList_delete(me->headers);
1259: me->headers = NULL;
1.18 frystyk 1260:
1.62 frystyk 1261: /* Anchor is cleared */
1262: me->header_parsed = NO;
1.1 timbl 1263: }
Webmaster