PutPolicy (java-sdk 6.1.2 API)

java.lang.Object
- com.qiniu.api.rs.PutPolicy

```
public class PutPolicy
extends Object
```
The PutPolicy class used to generate a upload token. To upload a file, you should obtain upload authorization from Qiniu cloud strage platform. By a pair of valid accesskey and secretkey, we generate a upload token. When upload a file, the upload token is transmissed as a part of the file stream, or as an accessory part of the HTTP Headers.

字段概要

字段
限定符和类型	字段和说明
`String`	`asyncOps` 可选
`String`	`callbackBody` 可选
`String`	`callbackUrl` 可选
`long`	`deadline`
`int`	`detectMime` 可选。
`String`	`endUser` 可选
`long`	`expires` 可选
`long`	`fopTimeout` 单位：秒文件变换操作执行的超时时间（单位：秒），上传和转码操作是同步进行的，先上传后转码，这个时间只是转码所需时间，不包括上传文件所需时间。
`long`	`fsizeLimit` 可选
`int`	`insertOnly` 可选。
`String`	`persistentNotifyUrl` 可选
`String`	`persistentOps` 可选
`String`	`returnBody` 可选
`String`	`returnUrl` 可选
`String`	`saveKey` 可选
`String`	`scope` 必选。
`String`	`transform` 对文件先进行一次变换操作（比如将音频统一转为某种码率的mp3）再进行存储。

构造器概要

构造器
构造器和说明

PutPolicy(String scope)

构造器
构造器和说明
`PutPolicy(String scope)`

方法概要

方法
限定符和类型方法和说明

String marshal()

String token(Mac mac)
makes an upload token.
- 从类继承的方法 java.lang.Object
  clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法
限定符和类型	方法和说明
`String`	`marshal()`
`String`	`token(Mac mac)` makes an upload token.

- 字段详细资料
  - scope
```
public String scope
```
    必选。可以是 bucketName 或者 bucketName:key
  - callbackUrl
```
public String callbackUrl
```
    可选
  - callbackBody
```
public String callbackBody
```
    可选
  - returnUrl
```
public String returnUrl
```
    可选
  - returnBody
```
public String returnBody
```
    可选
  - asyncOps
```
public String asyncOps
```
    可选
  - endUser
```
public String endUser
```
    可选
  - expires
```
public long expires
```
    可选
  - saveKey
```
public String saveKey
```
    可选
  - insertOnly
```
public int insertOnly
```
    可选。若非0, 即使Scope为 Bucket:Key 的形式也是insert only
  - detectMime
```
public int detectMime
```
    可选。若非0, 则服务端根据内容自动确定 MimeType
  - fsizeLimit
```
public long fsizeLimit
```
    可选
  - persistentNotifyUrl
```
public String persistentNotifyUrl
```
    可选
  - persistentOps
```
public String persistentOps
```
    可选
  - deadline
```
public long deadline
```
  - transform
```
public String transform
```
    对文件先进行一次变换操作（比如将音频统一转为某种码率的mp3）再进行存储。 transform的值就是一个fop指令，比如 "avthumb/mp3"。其含义是对上传的文件执行这个 fop 指令，然后把结果保存到七牛。最后保存的是经过处理过的文件，而不是用户上传的原始文件。
  - fopTimeout
```
public long fopTimeout
```
    单位：秒文件变换操作执行的超时时间（单位：秒），上传和转码操作是同步进行的，先上传后转码，这个时间只是转码所需时间，不包括上传文件所需时间。这个值太小可能会导致误判（最终存储成功了但客户端得到超时的错误），但太大可能会导致服务端将其判断为低优先级任务。建议取一个相对准确的时间估计值*N（N不要超过5）。
- 构造器详细资料
  - PutPolicy
```
public PutPolicy(String scope)
```
- 方法详细资料
  - marshal
```
public String marshal()
               throws org.json.JSONException
```
    抛出:
    
    org.json.JSONException
  - token
```
public String token(Mac mac)
             throws AuthException,
                    org.json.JSONException
```
    makes an upload token.
    
    参数:
    mac -
    
    返回:
    
    抛出:
    
    AuthException
    
    org.json.JSONException

类 PutPolicy

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

scope

callbackUrl

callbackBody

returnUrl

returnBody

asyncOps

endUser

expires

saveKey

insertOnly

detectMime

fsizeLimit

persistentNotifyUrl

persistentOps

deadline

transform

fopTimeout

构造器详细资料

PutPolicy

方法详细资料

marshal

token