本文介绍如何使用限定条件下载OSS文件。

    下载文件时，可以指定一个或多个限定条件。满足限定条件则下载，不满足则返回错误，不下载。可以使用的限定条件如下：

    参数描述如何设置
    IfModifiedSince如果指定的时间早于实际修改时间，则正常传输文件，否则返回错误（304 Not modified）。oss.IfModifiedSince
    IfUnmodifiedSince如果指定的时间等于或者晚于文件实际修改时间，则正常传输文件，否则返回错误（412 Precondition failed）。oss.IfUnmodifiedSince
    IfMatch如果指定的ETag和OSS文件的ETag匹配，则正常传输文件，否则返回错误（412 Precondition failed）。oss.IfMatch
    IfNoneMatch如果指定的ETag和OSS文件的ETag不匹配，则正常传输文件，否则返回错误（304 Not modified）。oss.IfNoneMatch

    IfModifiedSince和IfUnmodifiedSince可以同时存在。IfMatch和IfNoneMatch可以同时存在。

    ETag可以通过Bucket.GetObjectDetailedMeta方法获取。

    1. package main
    3. import (
    4.     "fmt"
    5.     "os"
    6.     "time"
    7.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
    8. )
    10. func main() {
    11.     // 创建OSSClient实例。
    12.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
    13.     if err != nil {
    14.         fmt.Println("Error:", err)
    15.         os.Exit(-1)
    16.     }
    18.     // 获取存储空间。
    19.     bucket, err := client.Bucket("<yourBucketName>")
    20.     if err != nil {
    21.         fmt.Println("Error:", err)
    22.         os.Exit(-1)
    23.     }
    25.     // 设置时间限定条件。
    26.     date := time.Date(2015, time.November, 10, 23, 0, 0, 0, time.UTC)
    28.     // 限定条件不满足，不下载文件。
    29.     err = bucket.GetObjectToFile("<yourObjectName>", "LocalFile", oss.IfModifiedSince(date))
    30.     if err == nil {
    31.         fmt.Println("Error:", err)
    32.         os.Exit(-1)
    33.     }
    35.     // 满足限定条件，下载文件。
    36.     err = bucket.GetObjectToFile("<yourObjectName>", "LocalFile", oss.IfUnmodifiedSince(date))
    37.     if err != nil {
    38.         fmt.Println("Error:", err)
    39.         os.Exit(-1)
    40.     }
    41. }