Annotation of libwww/Library/src/WWWCache.html, revision 2.1
2.1 ! frystyk 1: <HTML>
! 2: <HEAD>
! 3: <TITLE>Declaration of W3C Reference PERSISTENT CACHE MODULE</TITLE>
! 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