Package com.qiniu.storage

Class DownloadUrl

  • Direct Known Subclasses:
    DownloadPrivateCloudUrl
    public class DownloadUrl
extends java.lang.Object
    公有云下载 URL 类

    • Constructor Summary

      Constructors 
      Constructor Description
      DownloadUrl​(java.lang.String domain, boolean useHttps, java.lang.String key)
      构造器

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      DownloadUrl addCustomQuery​(java.lang.String queryName, java.lang.String queryValue)
      URL 增加 query 信息 【可选】 query 信息必须为七牛云支持的，否则会被视为无效
      java.lang.String buildURL()
      构建资源下载 URL 字符串
      java.lang.String buildURL​(Auth auth, long deadline)
      构建带有有效期的下载 URL 字符串 一般构建私有资源的下载 URL 字符串；公开资源可以直接使用 buildURL(com.qiniu.util.Auth, long)
      DownloadUrl setAttname​(java.lang.String attname)
      浏览器访问时指定下载文件名【可选】 默认情况下，如果在浏览器中访问一个资源URL，浏览器都会试图直接在浏览器中打开这个资源，例如一张图片。 如果希望浏览器的动作是下载而不是打开，可以给该资源URL添加参数 attname 来指定文件名
      DownloadUrl setFop​(java.lang.String fop)
      配置 fop【可选】 开发者可以在访问资源时制定执行一个或多个数据处理指令，以直接获取经过处理后的结果。比较典型的一个场景是图片查看，客户端可以上传一 张高精度的图片，然后在查看图片的时候根据屏幕规格生成一张大小适宜的缩略图。这样既可以明显降低网络流量，而且可以提高图片显示速度， 还能降低移动设备的内存占用.
      DownloadUrl setStyle​(java.lang.String style, java.lang.String styleSeparator, java.lang.String styleParam)
      配置 style【可选】 如果觉得 fop 这样的形式够冗长，还可以为这些串行的 fop 集合定义一个友好别名。如此一来，就可以用友好URL风格进行访问，这个别名就是 style 。 eg: 对 userBucket 的 fop（imageView2/2/w/320/h/480） 使用 style 的方式, 分隔符为 "-" 使用 qrsctl 命令定义 style: （qrsctl separator [bucket] [styleSeparator]） qrsctl separator userBucket - 定义数据处理的别名为 aliasName: (qrsctl style [bucket] [aliasName] [fop]) qrsctl style userBucket iphone imageView2/2/w/320/h/480

      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • DownloadUrl

        public DownloadUrl​(java.lang.String domain,
                   boolean useHttps,
                   java.lang.String key)
        构造器
        Parameters:
        domain - 下载 domain, eg: qiniu.com【必须】
        useHttps - 是否使用 https【必须】
        key - 下载资源在七牛云存储的 key【必须】

    • Method Detail

      • setAttname

        public DownloadUrl setAttname​(java.lang.String attname)
        浏览器访问时指定下载文件名【可选】 默认情况下，如果在浏览器中访问一个资源URL，浏览器都会试图直接在浏览器中打开这个资源，例如一张图片。 如果希望浏览器的动作是下载而不是打开，可以给该资源URL添加参数 attname 来指定文件名
        Parameters:
        attname - 文件名
        Returns:
        DownloadUrl

      • setFop

        public DownloadUrl setFop​(java.lang.String fop)
        配置 fop【可选】 开发者可以在访问资源时制定执行一个或多个数据处理指令，以直接获取经过处理后的结果。比较典型的一个场景是图片查看，客户端可以上传一 张高精度的图片，然后在查看图片的时候根据屏幕规格生成一张大小适宜的缩略图。这样既可以明显降低网络流量，而且可以提高图片显示速度， 还能降低移动设备的内存占用. eg: 针对该原图生成一张480x320大小的缩略图:imageView2/2/w/320/h/480 https://developer.qiniu.com/dora/6217/directions-for-use-pfop
        Parameters:
        fop - fop
        Returns:
        DownloadUrl

      • setStyle

        public DownloadUrl setStyle​(java.lang.String style,
                            java.lang.String styleSeparator,
                            java.lang.String styleParam)
        配置 style【可选】 如果觉得 fop 这样的形式够冗长，还可以为这些串行的 fop 集合定义一个友好别名。如此一来，就可以用友好URL风格进行访问，这个别名就是 style 。 eg: 对 userBucket 的 fop（imageView2/2/w/320/h/480） 使用 style 的方式, 分隔符为 "-" 使用 qrsctl 命令定义 style: （qrsctl separator [bucket] [styleSeparator]） qrsctl separator userBucket - 定义数据处理的别名为 aliasName: (qrsctl style [bucket] [aliasName] [fop]) qrsctl style userBucket iphone imageView2/2/w/320/h/480

        相关链接

        Parameters:
        style - style 名【必须】
        styleSeparator - url 和数据处理之间的分隔符【必须】
        styleParam - style 参数【可选】
        Returns:
        DownloadUrl

      • addCustomQuery

        public DownloadUrl addCustomQuery​(java.lang.String queryName,
                                  java.lang.String queryValue)
        URL 增加 query 信息 【可选】 query 信息必须为七牛云支持的，否则会被视为无效
        Parameters:
        queryName - query 名
        queryValue - query 值
        Returns:
        DownloadUrl

      • buildURL

        public java.lang.String buildURL​(Auth auth,
                                 long deadline)
                          throws QiniuException
        构建带有有效期的下载 URL 字符串 一般构建私有资源的下载 URL 字符串；公开资源可以直接使用 buildURL(com.qiniu.util.Auth, long)
        Parameters:
        auth - 凭证信息【必须】
        deadline - 有效期时间戳，单位：秒 【必须】
        Returns:
        下载 URL 字符串
        Throws:
        QiniuException - 构建异常，一般为参数缺失

      • buildURL

        public java.lang.String buildURL()
                          throws QiniuException
        构建资源下载 URL 字符串
        Returns:
        下载 URL 字符串
        Throws:
        QiniuException - 构建异常，一般为参数缺失