使用HTML5开发离线应用 - cache manifest(3)

下面说明书写 cache manifest 文件需要遵循的格式。

1. 首行必须是 CACHE MANIFEST。

 

1. 其后，每一行列出一个需要缓存的资源文件名。

 

1. 可根据需要列出在线访问的白名单。白名单中的所有资源不会被缓存，在使用时将直接在线访问。声明白名单使用 NETWORK：标识符。

 

1. 如果在白名单后还要补充需要缓存的资源，可以使用 CACHE：标识符。

 

1. 如果要声明某 URI 不能访问时的替补 URI，可以使用 FALLBACK：标识符。其后的每一行包含两个 URI，当第一个 URI
   不可访问时，浏览器将尝试使用第二个 URI。

 

1. 注释要另起一行，以 # 号开头。

 

清单 4 的代码中给出了 cache manifest 中各类标识符的使用示例。

清单 4.
cache manifest 示例代码

				 
 CACHE MANIFEST 
 # 上一行是必须书写的。

 images/sound-icon.png 
 images/background.png 

 NETWORK: 
 comm.cgi 

# 下面是另一些需要缓存的资源，在这个示例中只有一个 css 文件。

 CACHE: 
 style/default.css 

 FALLBACK: 
 /files/projects /projects 

更新缓存

 

应用程序可以等待浏览器自动更新缓存，也可以使用 Javascript 接口手动触发更新。

1. 自动更新
   

   浏览器除了在第一次访问 Web 应用时缓存资源外，只会在 cache manifest 文件本身发生变化时更新缓存。而 cache manifest
   中的资源文件发生变化并不会触发更新。

 

1. 手动更新
   

   开发者也可以使用 window.applicationCache 的接口更新缓存。方法是检测 window.applicationCache.status
   的值，如果是 UPDATEREADY，那么可以调用 window.applicationCache.update()
   更新缓存。示范代码如下。

   
   
   清单 5 手动更新缓存
   
   
   
   
   

   				 
    if (window.applicationCache.status == window.applicationCache.UPDATEREADY) 
   ｛
    window.applicationCache.update(); 
   ｝