Annotation of libwww/Library/src/WWWCache.html, revision 2.2

2.1       frystyk     1: <HTML>
                      2: <HEAD>
2.2     ! frystyk     3: <TITLE>W3C Reference Library libwww PERSISTENT CACHE</TITLE>
2.1       frystyk     4: <!-- Changed by: Henrik Frystyk Nielsen,  1-Feb-1996 -->
                      5: <NEXTID N="z11">
                      6: </HEAD>
                      7: <BODY>
                      8: 
                      9: <H1>Declaration of W3C Reference PERSISTENT CACHE MODULE</H1>
                     10: 
                     11: <PRE>
                     12: /*
                     13: **     (c) COPYRIGHT MIT 1995.
                     14: **     Please first read the full copyright statement in the file COPYRIGH.
                     15: */
                     16: </PRE>
                     17: 
                     18: <H3>Cache Manager</H3>
                     19: 
                     20: Caching is a required part of any efficient Internet access
                     21: applications as it saves bandwidth and improves access performance
                     22: significantly in almost all types of accesses.  The Library supports
                     23: two different types of cache: The memory cache and the file cache. The
                     24: two types differ in several ways which reflects their two main
                     25: purposes: The memory cache is for short term storage of graphic
                     26: objects whereas the file cache is for intermediate term storage of
                     27: data objects. Often it is desirable to have both a memory and a file
                     28: version of a cached document, so the two types do not exclude each
                     29: other. <P>
                     30: 
                     31: The cache contains details of temporary disk files which contain the
                     32: contents of remote documents.  There is also a <A
                     33: HREF="HTAnchor.html#z1">list of cache items for each URL</A> in its
                     34: anchor object. <P>
                     35: 
                     36: There are various ways of handling Expires header when met in a
                     37: history list. Either it can be ignored all together, the user can be
                     38: notified with a warning, or the document can be reloaded
                     39: automatically. This flag decides what action to be taken. The default
                     40: action is HT_EXPIRES_IGNORE. In HT_EXPIRES_NOTIFY mode you can specify
                     41: a message to tell the user (NULL is valid in which case my own message
                     42: pops up - watch out it might be in Danish ;-)) <P>
                     43: 
                     44: The Library has two notions of a local cache: a file cache and a
                     45: memory cache. The memory cache is handled by the client and the file
                     46: cache is handled by the Library. Often the format of a object cached
                     47: in memory is in the form of a hypertext object ready to be displayed
                     48: (that is, it's already parsed).
                     49: 
                     50: <PRE>
                     51: #ifndef WWWCACHE_H
                     52: #define WWWCACHE_H
                     53: </PRE>
                     54: 
                     55: <H2>Library Includes</H2>
                     56: 
                     57: <PRE>
                     58: #ifdef __cplusplus
                     59: extern "C" { 
                     60: #endif
                     61: </PRE>
                     62: 
                     63: <PRE>
                     64: #include "HTCache.h"
                     65: </PRE>
                     66: 
                     67: End of CACHE module
                     68: 
                     69: <PRE>
                     70: #ifdef __cplusplus
                     71: } /* end extern C definitions */
                     72: #endif
                     73: 
                     74: #endif
                     75: </PRE>
                     76: 
                     77: End of WWWCACHE API definition
                     78: 
                     79: </BODY>
                     80: </HTML>

Webmaster