Resource

一种资源，包括位置和我们检索它或创建派生资源所需的任何其他参数。它还提供了重试请求的能力。

new Resource(options)

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。

Example

function refreshTokenRetryCallback(resource, error) {
  if (error.statusCode === 403) {
    // 403 status code means a new token should be generated
    return getNewAccessToken()
      .then(function(token) {
        resource.queryParameters.access_token = token;
        return true;
      })
      .otherwise(function() {
        return false;
      });
  }

  return false;
}

var resource = new Resource({
   url: 'http://server.com/path/to/resource.json',
   proxy: new DefaultProxy('/proxy/'),
   headers: {
     'X-My-Header': 'valueOfHeader'
   },
   queryParameters: {
     'access_token': '123-435-456-000'
   },
   retryCallback: refreshTokenRetryCallback,
   retryAttempts: 1
});

Members

(static, constant) DEFAULT : Resource

初始化到当前浏览器位置的资源实例

(static, readonly) isBlobSupported : Boolean

如果支持blob，则返回true。

(readonly) extension : String

资源的文件扩展名。

hasHeaders : Boolean

如果资源具有请求头，则为true。这相当于检查headers属性是否有任何键。

headers : Object

将随请求一起发送的其他HTTP头。

isBlobUri : Boolean

如果资源引用blob uri，则为true。

isCrossOriginUrl : Boolean

如果资源引用跨源URL，则为true。

isDataUri : Boolean

如果资源引用数据URI，则为true。

proxy : DefaultProxy

加载资源时要使用的代理。

(readonly) queryParameters : Object

附加到URL的查询参数。

request : Request

将要使用的请求对象。仅供内部使用。

retryAttempts : Number

放弃前应调用RetryCallback的次数。

retryCallback : function

当请求此资源失败时调用的函数。如果返回“真”或解析为“真”的承诺，将重试请求。

(readonly) templateValues : Object

用于替换URL中模板参数的键/值对。

url : String

替换模板值、追加查询字符串并由代理（如果设置了）编码的资源的URL。

Methods

(static) delete(options) → {Promise.<Object>|undefined}

从URL创建资源并对其调用delete（）。

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.data `Object`	与资源一起发布的数据。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。
options.responseType `String`	响应类型。这控制返回的项的类型。
options.overrideMimeType `String`	重写服务器返回的mime类型。

(static) fetch(options) → {Promise.<Object>|undefined}

从URL创建资源并对其调用fetch（）。

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。
options.responseType `String`	响应类型。这控制返回的项的类型。
options.overrideMimeType `String`	重写服务器返回的mime类型。

(static) fetchArrayBuffer(options) → {Promise.<ArrayBuffer>|undefined}

创建资源并对其调用fetcharrayBuffer（）。

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。

(static) fetchBlob(options) → {Promise.<Blob>|undefined}

创建资源并对其调用fetchblob（）。

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。

(static) fetchImage(options) → {Promise.<ImageBitmap>|Promise.<Image>|undefined}

创建资源并对其调用fetchImage（）。

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.flipY `Boolean` default `false`	在提取和解码期间是否垂直翻转图像。仅在请求图像时适用，并且浏览器支持`createImageBitmap`。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。
options.preferBlob `Boolean` default `false`	如果为真，我们将通过blob加载图像。
options.preferImageBitmap `Boolean` default `false`	如果为真，则图像将在提取期间解码，并返回`ImageBitmap`。

(static) fetchJson(options) → {Promise.<Object>|undefined}

创建资源并对其调用fetchjson（）。

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。

(static) fetchJsonp(options) → {Promise.<Object>|undefined}

从URL创建资源并对其调用fetchjsonp（）。

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。
options.callbackParameterName `String` default `'callback'`	服务器需要的回调参数名。

(static) fetchText(options) → {Promise.<String>|undefined}

创建资源并对其调用fetchText（）。

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。

(static) fetchXML(options) → {Promise.<XMLDocument>|undefined}

创建资源并对其调用fetchxml（）。

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。

(static) head(options) → {Promise.<Object>|undefined}

从URL创建资源并对其调用head（）。

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。
options.responseType `String`	响应类型。这控制返回的项的类型。
options.overrideMimeType `String`	重写服务器返回的mime类型。

(static) options(options) → {Promise.<Object>|undefined}

从URL创建资源并对其调用options（）。

Parameters:

options ((String | Object)) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。
options.responseType `String`	响应类型。这控制返回的项的类型。
options.overrideMimeType `String`	重写服务器返回的mime类型。

(static) patch(options) → {Promise.<Object>|undefined}

从URL创建资源并对其调用patch（）。

Parameters:

options (Object) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.data `Object`	与资源一起发布的数据。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。
options.responseType `String`	响应类型。这控制返回的项的类型。
options.overrideMimeType `String`	重写服务器返回的mime类型。

(static) post(options) → {Promise.<Object>|undefined}

从URL创建资源并对其调用post（）。

Parameters:

options (Object) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.data `Object`	与资源一起发布的数据。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。
options.responseType `String`	响应类型。这控制返回的项的类型。
options.overrideMimeType `String`	重写服务器返回的mime类型。

(static) put(options) → {Promise.<Object>|undefined}

从URL创建资源并调用Put（）。

Parameters:

options (Object) 具有以下属性的URL或对象

Name	Description
options.url `String`	资源的URL。
options.data `Object`	与资源一起发布的数据。
options.queryParameters `Object`	包含检索资源时将发送的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	请求此资源失败时要调用的函数。如果返回true，将重试请求。
options.retryAttempts `Number` default `0`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。
options.responseType `String`	响应类型。这控制返回的项的类型。
options.overrideMimeType `String`	重写服务器返回的mime类型。

appendForwardSlash()

向URL追加正斜杠。

appendQueryParameters(params)

组合指定的对象和现有查询参数。这允许您一次添加多个参数，而不是一次将它们添加到QueryParameters属性中。

Parameters:

params (Object) 查询参数

clone(result) → {Resource}

复制资源实例。

Parameters:

result (Resource) 存储结果的对象。

delete(options) → {Promise.<Object>|undefined}

异步删除给定的资源。返回一个承诺，该承诺将在加载后解析为结果，或者在资源加载失败时拒绝。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。

Parameters:

options (Object)

Name	Description
options.responseType `String`	响应类型。这控制返回的项的类型。
options.headers `Object`	与请求一起发送的附加HTTP头（如果有）。
options.overrideMimeType `String`	重写服务器返回的mime类型。

Example

resource.delete()
  .then(function(body) {
      // use the data
  }).otherwise(function(error) {
      // an error occurred
  });

See:

fetch(options) → {Promise.<Object>|undefined}

异步加载给定的资源。返回一个承诺，该承诺将在加载后解析为结果，或者在资源加载失败时拒绝。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。建议您使用更具体的函数，如fetchjson、fetchblob等。

Parameters:

options (Object)

Name	Description
options.responseType `String`	响应类型。这控制返回的项的类型。
options.headers `Object`	与请求一起发送的附加HTTP头（如果有）。
options.overrideMimeType `String`	重写服务器返回的mime类型。

Example

resource.fetch()
  .then(function(body) {
      // use the data
  }).otherwise(function(error) {
      // an error occurred
  });

See:

fetchArrayBuffer() → {Promise.<ArrayBuffer>|undefined}

异步加载资源作为原始二进制数据。返回将在加载后解析为ArrayBuffer的承诺，或者在资源加载失败时拒绝该承诺。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。

Example

// load a single URL asynchronously
resource.fetchArrayBuffer().then(function(arrayBuffer) {
    // use the data
}).otherwise(function(error) {
    // an error occurred
});

See:

fetchBlob() → {Promise.<Blob>|undefined}

以blob的形式异步加载给定的资源。返回一个承诺，该承诺将在加载后解析为blob，或者在资源加载失败时拒绝。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。

Example

// load a single URL asynchronously
resource.fetchBlob().then(function(blob) {
    // use the data
}).otherwise(function(error) {
    // an error occurred
});

See:

fetchImage(options) → {Promise.<ImageBitmap>|Promise.<Image>|undefined}

异步加载给定的映像资源。返回一个承诺，如果preferImageBitmap为真且浏览器支持createImageBitmap或加载后的Image将解析为ImageBitmap，如果图像加载失败则拒绝。

Parameters:

options (Object) 具有以下属性的对象。

Name	Description
options.preferBlob `Boolean` default `false`	如果为真，我们将通过blob加载图像。
options.preferImageBitmap `Boolean` default `false`	如果为真，则图像将在提取期间解码，并返回`ImageBitmap`。
options.flipY `Boolean` default `false`	如果为真，则图像将在解码过程中垂直翻转。仅当浏览器支持`createImageBitmap`时适用。

Example

// load a single image asynchronously
resource.fetchImage().then(function(image) {
    // use the loaded image
}).otherwise(function(error) {
    // an error occurred
});

// load several images in parallel
when.all([resource1.fetchImage(), resource2.fetchImage()]).then(function(images) {
    // images is an array containing all the loaded images
});

See:

fetchJson() → {Promise.<Object>|undefined}

以JSON的形式异步加载给定的资源。返回一个承诺，该承诺将在加载后解析为JSON对象，或者在资源加载失败时拒绝。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。此函数将“accept:application/json，*；/；*；；q=0.01”添加到请求头（如果尚未指定）。

Example

resource.fetchJson().then(function(jsonData) {
    // Do something with the JSON object
}).otherwise(function(error) {
    // an error occurred
});

See:

fetchJsonp(callbackParameterName) → {Promise.<Object>|undefined}

使用JSONP请求资源。

Parameters:

callbackParameterName (String) (default 'callback') 服务器需要的回调参数名。

Example

// load a data asynchronously
resource.fetchJsonp().then(function(data) {
    // use the loaded data
}).otherwise(function(error) {
    // an error occurred
});

See:

CommonJS Promises/A

fetchText() → {Promise.<String>|undefined}

以文本形式异步加载给定资源。返回将在加载后解析为字符串的承诺，或者在资源加载失败时拒绝该承诺。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。

Example

// load text from a URL, setting a custom header
var resource = new Resource({
  url: 'http://someUrl.com/someJson.txt',
  headers: {
    'X-Custom-Header' : 'some value'
  }
});
resource.fetchText().then(function(text) {
    // Do something with the text
}).otherwise(function(error) {
    // an error occurred
});

See:

fetchXML() → {Promise.<XMLDocument>|undefined}

以XML的形式异步加载给定的资源。返回一个承诺，该承诺将在加载后解析为XML文档，或者在资源加载失败时拒绝。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。

Example

// load XML from a URL, setting a custom header
bmgl.loadXML('http://someUrl.com/someXML.xml', {
  'X-Custom-Header' : 'some value'
}).then(function(document) {
    // Do something with the document
}).otherwise(function(error) {
    // an error occurred
});

See:

getBaseUri(includeQuery) → {String}

返回资源的基本路径。

Parameters:

includeQuery (Boolean) (default false) 是否包含来自URI的查询字符串和片段

getDerivedResource(options) → {Resource}

返回相对于当前实例的资源。除非在选项中被重写，否则所有属性与当前实例保持相同。

Parameters:

options (Object) 具有以下属性的对象

Name	Description
options.url `String`	将相对于当前实例的URL解析的URL。
options.queryParameters `Object`	包含将与当前实例的查询参数组合的查询参数的对象。
options.templateValues `Object`	用于替换模板值的键/值对（例如{x}）。这些将与当前实例的合并。
options.headers `Object` default `{}`	将发送的其他HTTP头。
options.proxy `DefaultProxy`	加载资源时要使用的代理。
options.retryCallback `Resource~RetryCallback`	加载资源失败时要调用的函数。
options.retryAttempts `Number`	放弃前应调用RetryCallback的次数。
options.request `Request`	将要使用的请求对象。仅供内部使用。
options.preserveQueryParameters `Boolean` default `false`	如果为true，则将保留当前资源和派生资源中的所有查询参数。如果为false，派生参数将替换当前资源的参数。

getUrlComponent(query, proxy) → {String}

返回由代理处理的、查询字符串可选的URL。

Parameters:

query (Boolean) (default false) 如果为true，则包含查询字符串。

proxy (Boolean) (default false) 如果为true，则在定义代理对象时处理该URL。

head(options) → {Promise.<Object>|undefined}

异步获取给定资源的头。返回一个承诺，该承诺将在加载后解析为结果，或者在资源加载失败时拒绝。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。

Parameters:

options (Object)

Name	Description
options.responseType `String`	响应类型。这控制返回的项的类型。
options.headers `Object`	与请求一起发送的附加HTTP头（如果有）。
options.overrideMimeType `String`	重写服务器返回的mime类型。

Example

resource.head()
  .then(function(headers) {
      // use the data
  }).otherwise(function(error) {
      // an error occurred
  });

See:

options(options) → {Promise.<Object>|undefined}

异步获取给定资源的选项。返回一个承诺，该承诺将在加载后解析为结果，或者在资源加载失败时拒绝。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。

Parameters:

options (Object)

Name	Description
options.responseType `String`	响应类型。这控制返回的项的类型。
options.headers `Object`	与请求一起发送的附加HTTP头（如果有）。
options.overrideMimeType `String`	重写服务器返回的mime类型。

Example

resource.options()
  .then(function(headers) {
      // use the data
  }).otherwise(function(error) {
      // an error occurred
  });

See:

patch(data, options) → {Promise.<Object>|undefined}

异步地将数据修补到给定的资源。返回一个承诺，该承诺将在加载后解析为结果，或者在资源加载失败时拒绝。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。

Parameters:

data (Object) 与资源一起发布的数据。

options (Object)

Name	Description
options.responseType `String`	响应类型。这控制返回的项的类型。
options.headers `Object`	与请求一起发送的附加HTTP头（如果有）。
options.overrideMimeType `String`	重写服务器返回的mime类型。

Example

resource.patch(data)
  .then(function(result) {
      // use the result
  }).otherwise(function(error) {
      // an error occurred
  });

See:

post(data, options) → {Promise.<Object>|undefined}

异步地将数据发布到给定的资源。返回一个承诺，该承诺将在加载后解析为结果，或者在资源加载失败时拒绝。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。

Parameters:

data (Object) 与资源一起发布的数据。

options (Object)

Name	Description
options.data `Object`	与资源一起发布的数据。
options.responseType `String`	响应类型。这控制返回的项的类型。
options.headers `Object`	与请求一起发送的附加HTTP头（如果有）。
options.overrideMimeType `String`	重写服务器返回的mime类型。

Example

resource.post(data)
  .then(function(result) {
      // use the result
  }).otherwise(function(error) {
      // an error occurred
  });

See:

put(data, options) → {Promise.<Object>|undefined}

异步地将数据放入给定的资源。返回一个承诺，该承诺将在加载后解析为结果，或者在资源加载失败时拒绝。使用xmlhttpRequest加载数据，这意味着为了向另一个来源发出请求，服务器必须启用跨来源资源共享（cors）头。

Parameters:

data (Object) 与资源一起发布的数据。

options (Object)

Name	Description
options.responseType `String`	响应类型。这控制返回的项的类型。
options.headers `Object`	与请求一起发送的附加HTTP头（如果有）。
options.overrideMimeType `String`	重写服务器返回的mime类型。

Example

resource.put(data)
  .then(function(result) {
      // use the result
  }).otherwise(function(error) {
      // an error occurred
  });

See:

setQueryParameters(params, useAsDefault)

组合指定的对象和现有查询参数。这允许您一次添加多个参数，而不是一次将它们添加到QueryParameters属性中。如果已经设置了一个值，它将被替换为新值。

Parameters:

params (Object) 查询参数

useAsDefault (Boolean) (default false) 如果为真，参数将用作默认值，因此只有在未定义参数时才会设置这些参数。

setTemplateValues(template, useAsDefault)

组合指定的对象和现有模板值。这允许您一次添加多个值，而不是一次将它们添加到TemplateValues属性。如果已经设置了一个值，它将成为一个数组，并附加新的值。

Parameters:

template (Object) 模板值

useAsDefault (Boolean) (default false) 如果为真，这些值将用作默认值，因此只有在未定义的情况下才会设置这些值。

Type Definitions

RetryCallback(resource, error) → {Boolean|Promise.<Boolean>}

返回属性值的函数。

Parameters:

resource (Resource) 加载失败的资源。

error (Error) 加载资源时发生的错误。