Package com.qiniu.storage

Class Configuration

  • All Implemented Interfaces:
    java.lang.Cloneable
    public final class Configuration
extends java.lang.Object
implements java.lang.Cloneable
    该类封装了SDK相关配置参数

    • Field Summary

      Fields 
      Modifier and Type Field Description
      boolean accUpHostFirst
      空间相关上传管理操作是否使用代理加速上传，默认 是
      int connectionPoolMaxIdleCount
      底层HTTP库中复用连接对象的最大空闲数量
      int connectionPoolMaxIdleMinutes
      底层HTTP库中复用连接对象的回收周期（单位分钟）
      int connectTimeout
      连接超时时间 单位秒(默认10s)
      static java.lang.String defaultApiHost  
      static java.lang.String defaultRsHost
      特殊默认域名
      static java.lang.String defaultUcHost  
      int dispatcherMaxRequests
      底层HTTP库所有的并发执行的请求数量
      int dispatcherMaxRequestsPerHost
      底层HTTP库对每个独立的Host进行并发请求的数量
      Dns dns
      外部dns
      ProxyConfiguration proxy
      代理对象
      int putThreshold
      如果文件大小大于此值则使用断点上传, 否则使用Form上传
      int readTimeout
      回复超时时间 单位秒(默认30s)
      Region region
      使用的Region
      int resumableUploadAPIV2BlockSize
      使用分片 V2 上传时的分片大小 范围为：1M ~ 1GB， 注：每个文件最大分片数量为 10000
      Configuration.ResumableUploadAPIVersion resumableUploadAPIVersion
      分片上传的版本
      java.util.concurrent.ExecutorService resumableUploadConcurrentTaskExecutorService
      分片上传并发任务的 ExecutorService 当 resumableUploadMaxConcurrentTaskCount 小于或等于 1，此设置无效； 当 resumableUploadMaxConcurrentTaskCount 大于 1 且 resumableUploadConcurrentTaskExecutorService 为空，则会创建 Executors.newFixedThreadPool(maxConcurrentTaskCount) 当 resumableUploadMaxConcurrentTaskCount 大于 1 且 resumableUploadConcurrentTaskExecutorService 不为空，则直接使用 resumableUploadConcurrentTaskExecutorService
      int resumableUploadMaxConcurrentTaskCount
      分片上传每个文件传时的最大并发任务数，并发数量会影响内存使用，请合理配置 当 resumableUploadMaxConcurrentTaskCount 小于或等于 1 时，使用同步上传，resumableUploadConcurrentTaskExecutorService 不被使用 当 resumableUploadMaxConcurrentTaskCount 大于 1 时，使用并发上传
      int retryMax
      上传失败重试次数
      boolean useDefaultUpHostIfNone
      使用 AutoRegion 时，如果从区域信息得到上传 host 失败，使用默认的上传域名上传，默认 是 upload.qiniup.com, upload-z1.qiniup.com, upload-z2.qiniup.com, upload-na0.qiniup.com, upload-as0.qiniup.com
      boolean useDnsHostFirst
      Deprecated.
      boolean useHttpsDomains
      空间相关上传管理操作是否使用 https , 默认 是
      int writeTimeout
      写超时时间 单位秒(默认 0 , 不超时)
      Zone zone
      Deprecated.

    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      java.lang.String apiHost()
      Deprecated.
      java.lang.String apiHost​(java.lang.String ak, java.lang.String bucket)
      Deprecated.
      Configuration clone()  
      java.lang.String ioHost​(java.lang.String ak, java.lang.String bucket)
      Deprecated.
      java.lang.String rsfHost​(java.lang.String ak, java.lang.String bucket)
      Deprecated.
      java.lang.String rsHost()
      Deprecated.
      java.lang.String rsHost​(java.lang.String ak, java.lang.String bucket)
      Deprecated.
      java.lang.String ucHost()
      Deprecated.
      java.lang.String upHost​(java.lang.String upToken)
      Deprecated.
      java.lang.String upHostBackup​(java.lang.String upToken)
      Deprecated.

      • Methods inherited from class java.lang.Object

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

    • Field Detail

      • defaultRsHost

        public static java.lang.String defaultRsHost
        特殊默认域名

      • defaultApiHost

        public static java.lang.String defaultApiHost

      • defaultUcHost

        public static java.lang.String defaultUcHost

      • region

        public Region region
        使用的Region

      • zone

        @Deprecated
public Zone zone
        Deprecated.
        使用的Zone

      • useHttpsDomains

        public boolean useHttpsDomains
        空间相关上传管理操作是否使用 https , 默认 是

      • accUpHostFirst

        public boolean accUpHostFirst
        空间相关上传管理操作是否使用代理加速上传，默认 是

      • useDefaultUpHostIfNone

        public boolean useDefaultUpHostIfNone
        使用 AutoRegion 时，如果从区域信息得到上传 host 失败，使用默认的上传域名上传，默认 是 upload.qiniup.com, upload-z1.qiniup.com, upload-z2.qiniup.com, upload-na0.qiniup.com, upload-as0.qiniup.com

      • resumableUploadAPIV2BlockSize

        public int resumableUploadAPIV2BlockSize
        使用分片 V2 上传时的分片大小 范围为：1M ~ 1GB， 注：每个文件最大分片数量为 10000

      • resumableUploadMaxConcurrentTaskCount

        public int resumableUploadMaxConcurrentTaskCount
        分片上传每个文件传时的最大并发任务数，并发数量会影响内存使用，请合理配置 当 resumableUploadMaxConcurrentTaskCount 小于或等于 1 时，使用同步上传，resumableUploadConcurrentTaskExecutorService 不被使用 当 resumableUploadMaxConcurrentTaskCount 大于 1 时，使用并发上传

        分片上传，每个上传操作会占用 blockSize 大小内存，blockSize 也即分片大小， 在分片 v1 中 blockSize 为 4M； 分片 v2 可自定义，定义方式为：Configuration.resumableUploadAPIV2BlockSize，范围为：1M ~ 1GB，分片 v2 需要注意每个文件最大分片数量为 10000； 当采用并发分片时，占用内存大小和当时启用并发任务数量有关，即：blockSize * 并发数量， 并发任务数量配置方式：Configuration.resumableUploadMaxConcurrentTaskCount

      • resumableUploadConcurrentTaskExecutorService

        public java.util.concurrent.ExecutorService resumableUploadConcurrentTaskExecutorService
        分片上传并发任务的 ExecutorService 当 resumableUploadMaxConcurrentTaskCount 小于或等于 1，此设置无效； 当 resumableUploadMaxConcurrentTaskCount 大于 1 且 resumableUploadConcurrentTaskExecutorService 为空，则会创建 Executors.newFixedThreadPool(maxConcurrentTaskCount) 当 resumableUploadMaxConcurrentTaskCount 大于 1 且 resumableUploadConcurrentTaskExecutorService 不为空，则直接使用 resumableUploadConcurrentTaskExecutorService

      • putThreshold

        public int putThreshold
        如果文件大小大于此值则使用断点上传, 否则使用Form上传

      • connectTimeout

        public int connectTimeout
        连接超时时间 单位秒(默认10s)

      • writeTimeout

        public int writeTimeout
        写超时时间 单位秒(默认 0 , 不超时)

      • readTimeout

        public int readTimeout
        回复超时时间 单位秒(默认30s)

      • dispatcherMaxRequests

        public int dispatcherMaxRequests
        底层HTTP库所有的并发执行的请求数量

      • dispatcherMaxRequestsPerHost

        public int dispatcherMaxRequestsPerHost
        底层HTTP库对每个独立的Host进行并发请求的数量

      • connectionPoolMaxIdleCount

        public int connectionPoolMaxIdleCount
        底层HTTP库中复用连接对象的最大空闲数量

      • connectionPoolMaxIdleMinutes

        public int connectionPoolMaxIdleMinutes
        底层HTTP库中复用连接对象的回收周期（单位分钟）

      • retryMax

        public int retryMax
        上传失败重试次数

      • dns

        public Dns dns
        外部dns

      • useDnsHostFirst

        @Deprecated
public boolean useDnsHostFirst
        Deprecated.

    • Constructor Detail

      • Configuration

        public Configuration()

      • Configuration

        public Configuration​(Region region)

      • Configuration

        @Deprecated
public Configuration​(Zone zone)
        Deprecated.

    • Method Detail

      • upHost

        @Deprecated
public java.lang.String upHost​(java.lang.String upToken)
                        throws QiniuException
        Deprecated.
        Throws:
        QiniuException

      • upHostBackup

        @Deprecated
public java.lang.String upHostBackup​(java.lang.String upToken)
                              throws QiniuException
        Deprecated.
        Throws:
        QiniuException

      • ioHost

        @Deprecated
public java.lang.String ioHost​(java.lang.String ak,
                               java.lang.String bucket)
        Deprecated.

      • apiHost

        @Deprecated
public java.lang.String apiHost​(java.lang.String ak,
                                java.lang.String bucket)
        Deprecated.

      • rsHost

        @Deprecated
public java.lang.String rsHost​(java.lang.String ak,
                               java.lang.String bucket)
        Deprecated.

      • rsfHost

        @Deprecated
public java.lang.String rsfHost​(java.lang.String ak,
                                java.lang.String bucket)
        Deprecated.

      • rsHost

        @Deprecated
public java.lang.String rsHost()
        Deprecated.

      • apiHost

        @Deprecated
public java.lang.String apiHost()
        Deprecated.

      • ucHost

        @Deprecated
public java.lang.String ucHost()
        Deprecated.