123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862 |
- /**
- * @license AngularJS v1.6.5
- * (c) 2010-2017 Google, Inc. http://angularjs.org
- * License: MIT
- */
- (function (window, angular) {
- 'use strict';
- var $resourceMinErr = angular.$$minErr('$resource');
- // Helper functions and regex to lookup a dotted path on an object
- // stopping at undefined/null. The path must be composed of ASCII
- // identifiers (just like $parse)
- var MEMBER_NAME_REGEX = /^(\.[a-zA-Z_$@][0-9a-zA-Z_$@]*)+$/;
- function isValidDottedPath(path) {
- return (path != null && path !== '' && path !== 'hasOwnProperty' &&
- MEMBER_NAME_REGEX.test('.' + path));
- }
- function lookupDottedPath(obj, path) {
- if (!isValidDottedPath(path)) {
- throw $resourceMinErr('badmember', 'Dotted member path "@{0}" is invalid.', path);
- }
- var keys = path.split('.');
- for (var i = 0, ii = keys.length; i < ii && angular.isDefined(obj); i++) {
- var key = keys[i];
- obj = (obj !== null) ? obj[key] : undefined;
- }
- return obj;
- }
- /**
- * Create a shallow copy of an object and clear other fields from the destination
- */
- function shallowClearAndCopy(src, dst) {
- dst = dst || {};
- angular.forEach(dst, function (value, key) {
- delete dst[key];
- });
- for (var key in src) {
- if (src.hasOwnProperty(key) && !(key.charAt(0) === '$' && key.charAt(1) === '$')) {
- dst[key] = src[key];
- }
- }
- return dst;
- }
- /**
- * @ngdoc module
- * @name ngResource
- * @description
- *
- * # ngResource
- *
- * The `ngResource` module provides interaction support with RESTful services
- * via the $resource service.
- *
- *
- * <div doc-module-components="ngResource"></div>
- *
- * See {@link ngResource.$resourceProvider} and {@link ngResource.$resource} for usage.
- */
- /**
- * @ngdoc provider
- * @name $resourceProvider
- *
- * @description
- *
- * Use `$resourceProvider` to change the default behavior of the {@link ngResource.$resource}
- * service.
- *
- * ## Dependencies
- * Requires the {@link ngResource } module to be installed.
- *
- */
- /**
- * @ngdoc service
- * @name $resource
- * @requires $http
- * @requires ng.$log
- * @requires $q
- * @requires ng.$timeout
- *
- * @description
- * A factory which creates a resource object that lets you interact with
- * [RESTful](http://en.wikipedia.org/wiki/Representational_State_Transfer) server-side data sources.
- *
- * The returned resource object has action methods which provide high-level behaviors without
- * the need to interact with the low level {@link ng.$http $http} service.
- *
- * Requires the {@link ngResource `ngResource`} module to be installed.
- *
- * By default, trailing slashes will be stripped from the calculated URLs,
- * which can pose problems with server backends that do not expect that
- * behavior. This can be disabled by configuring the `$resourceProvider` like
- * this:
- *
- * ```js
- app.config(['$resourceProvider', function($resourceProvider) {
- // Don't strip trailing slashes from calculated URLs
- $resourceProvider.defaults.stripTrailingSlashes = false;
- }]);
- * ```
- *
- * @param {string} url A parameterized URL template with parameters prefixed by `:` as in
- * `/user/:username`. If you are using a URL with a port number (e.g.
- * `http://example.com:8080/api`), it will be respected.
- *
- * If you are using a url with a suffix, just add the suffix, like this:
- * `$resource('http://example.com/resource.json')` or `$resource('http://example.com/:id.json')`
- * or even `$resource('http://example.com/resource/:resource_id.:format')`
- * If the parameter before the suffix is empty, :resource_id in this case, then the `/.` will be
- * collapsed down to a single `.`. If you need this sequence to appear and not collapse then you
- * can escape it with `/\.`.
- *
- * @param {Object=} paramDefaults Default values for `url` parameters. These can be overridden in
- * `actions` methods. If a parameter value is a function, it will be called every time
- * a param value needs to be obtained for a request (unless the param was overridden). The function
- * will be passed the current data value as an argument.
- *
- * Each key value in the parameter object is first bound to url template if present and then any
- * excess keys are appended to the url search query after the `?`.
- *
- * Given a template `/path/:verb` and parameter `{verb:'greet', salutation:'Hello'}` results in
- * URL `/path/greet?salutation=Hello`.
- *
- * If the parameter value is prefixed with `@`, then the value for that parameter will be
- * extracted from the corresponding property on the `data` object (provided when calling actions
- * with a request body).
- * For example, if the `defaultParam` object is `{someParam: '@someProp'}` then the value of
- * `someParam` will be `data.someProp`.
- * Note that the parameter will be ignored, when calling a "GET" action method (i.e. an action
- * method that does not accept a request body)
- *
- * @param {Object.<Object>=} actions Hash with declaration of custom actions that will be available
- * in addition to the default set of resource actions (see below). If a custom action has the same
- * key as a default action (e.g. `save`), then the default action will be *overwritten*, and not
- * extended.
- *
- * The declaration should be created in the format of {@link ng.$http#usage $http.config}:
- *
- * {action1: {method:?, params:?, isArray:?, headers:?, ...},
- * action2: {method:?, params:?, isArray:?, headers:?, ...},
- * ...}
- *
- * Where:
- *
- * - **`action`** – {string} – The name of action. This name becomes the name of the method on
- * your resource object.
- * - **`method`** – {string} – Case insensitive HTTP method (e.g. `GET`, `POST`, `PUT`,
- * `DELETE`, `JSONP`, etc).
- * - **`params`** – {Object=} – Optional set of pre-bound parameters for this action. If any of
- * the parameter value is a function, it will be called every time when a param value needs to
- * be obtained for a request (unless the param was overridden). The function will be passed the
- * current data value as an argument.
- * - **`url`** – {string} – action specific `url` override. The url templating is supported just
- * like for the resource-level urls.
- * - **`isArray`** – {boolean=} – If true then the returned object for this action is an array,
- * see `returns` section.
- * - **`transformRequest`** –
- * `{function(data, headersGetter)|Array.<function(data, headersGetter)>}` –
- * transform function or an array of such functions. The transform function takes the http
- * request body and headers and returns its transformed (typically serialized) version.
- * By default, transformRequest will contain one function that checks if the request data is
- * an object and serializes it using `angular.toJson`. To prevent this behavior, set
- * `transformRequest` to an empty array: `transformRequest: []`
- * - **`transformResponse`** –
- * `{function(data, headersGetter, status)|Array.<function(data, headersGetter, status)>}` –
- * transform function or an array of such functions. The transform function takes the http
- * response body, headers and status and returns its transformed (typically deserialized)
- * version.
- * By default, transformResponse will contain one function that checks if the response looks
- * like a JSON string and deserializes it using `angular.fromJson`. To prevent this behavior,
- * set `transformResponse` to an empty array: `transformResponse: []`
- * - **`cache`** – `{boolean|Cache}` – If true, a default $http cache will be used to cache the
- * GET request, otherwise if a cache instance built with
- * {@link ng.$cacheFactory $cacheFactory} is supplied, this cache will be used for
- * caching.
- * - **`timeout`** – `{number}` – timeout in milliseconds.<br />
- * **Note:** In contrast to {@link ng.$http#usage $http.config}, {@link ng.$q promises} are
- * **not** supported in $resource, because the same value would be used for multiple requests.
- * If you are looking for a way to cancel requests, you should use the `cancellable` option.
- * - **`cancellable`** – `{boolean}` – if set to true, the request made by a "non-instance" call
- * will be cancelled (if not already completed) by calling `$cancelRequest()` on the call's
- * return value. Calling `$cancelRequest()` for a non-cancellable or an already
- * completed/cancelled request will have no effect.<br />
- * - **`withCredentials`** - `{boolean}` - whether to set the `withCredentials` flag on the
- * XHR object. See
- * [requests with credentials](https://developer.mozilla.org/en/http_access_control#section_5)
- * for more information.
- * - **`responseType`** - `{string}` - see
- * [requestType](https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest#responseType).
- * - **`interceptor`** - `{Object=}` - The interceptor object has two optional methods -
- * `response` and `responseError`. Both `response` and `responseError` interceptors get called
- * with `http response` object. See {@link ng.$http $http interceptors}.
- * - **`hasBody`** - `{boolean}` - allows to specify if a request body should be included or not.
- * If not specified only POST, PUT and PATCH requests will have a body.
- *
- * @param {Object} options Hash with custom settings that should extend the
- * default `$resourceProvider` behavior. The supported options are:
- *
- * - **`stripTrailingSlashes`** – {boolean} – If true then the trailing
- * slashes from any calculated URL will be stripped. (Defaults to true.)
- * - **`cancellable`** – {boolean} – If true, the request made by a "non-instance" call will be
- * cancelled (if not already completed) by calling `$cancelRequest()` on the call's return value.
- * This can be overwritten per action. (Defaults to false.)
- *
- * @returns {Object} A resource "class" object with methods for the default set of resource actions
- * optionally extended with custom `actions`. The default set contains these actions:
- * ```js
- * { 'get': {method:'GET'},
- * 'save': {method:'POST'},
- * 'query': {method:'GET', isArray:true},
- * 'remove': {method:'DELETE'},
- * 'delete': {method:'DELETE'} };
- * ```
- *
- * Calling these methods invoke an {@link ng.$http} with the specified http method,
- * destination and parameters. When the data is returned from the server then the object is an
- * instance of the resource class. The actions `save`, `remove` and `delete` are available on it
- * as methods with the `$` prefix. This allows you to easily perform CRUD operations (create,
- * read, update, delete) on server-side data like this:
- * ```js
- * var User = $resource('/user/:userId', {userId:'@id'});
- * var user = User.get({userId:123}, function() {
- * user.abc = true;
- * user.$save();
- * });
- * ```
- *
- * It is important to realize that invoking a $resource object method immediately returns an
- * empty reference (object or array depending on `isArray`). Once the data is returned from the
- * server the existing reference is populated with the actual data. This is a useful trick since
- * usually the resource is assigned to a model which is then rendered by the view. Having an empty
- * object results in no rendering, once the data arrives from the server then the object is
- * populated with the data and the view automatically re-renders itself showing the new data. This
- * means that in most cases one never has to write a callback function for the action methods.
- *
- * The action methods on the class object or instance object can be invoked with the following
- * parameters:
- *
- * - "class" actions without a body: `Resource.action([parameters], [success], [error])`
- * - "class" actions with a body: `Resource.action([parameters], postData, [success], [error])`
- * - instance actions: `instance.$action([parameters], [success], [error])`
- *
- *
- * When calling instance methods, the instance itself is used as the request body (if the action
- * should have a body). By default, only actions using `POST`, `PUT` or `PATCH` have request
- * bodies, but you can use the `hasBody` configuration option to specify whether an action
- * should have a body or not (regardless of its HTTP method).
- *
- *
- * Success callback is called with (value (Object|Array), responseHeaders (Function),
- * status (number), statusText (string)) arguments, where the value is the populated resource
- * instance or collection object. The error callback is called with (httpResponse) argument.
- *
- * Class actions return empty instance (with additional properties below).
- * Instance actions return promise of the action.
- *
- * The Resource instances and collections have these additional properties:
- *
- * - `$promise`: the {@link ng.$q promise} of the original server interaction that created this
- * instance or collection.
- *
- * On success, the promise is resolved with the same resource instance or collection object,
- * updated with data from server. This makes it easy to use in
- * {@link ngRoute.$routeProvider resolve section of $routeProvider.when()} to defer view
- * rendering until the resource(s) are loaded.
- *
- * On failure, the promise is rejected with the {@link ng.$http http response} object, without
- * the `resource` property.
- *
- * If an interceptor object was provided, the promise will instead be resolved with the value
- * returned by the interceptor.
- *
- * - `$resolved`: `true` after first server interaction is completed (either with success or
- * rejection), `false` before that. Knowing if the Resource has been resolved is useful in
- * data-binding.
- *
- * The Resource instances and collections have these additional methods:
- *
- * - `$cancelRequest`: If there is a cancellable, pending request related to the instance or
- * collection, calling this method will abort the request.
- *
- * The Resource instances have these additional methods:
- *
- * - `toJSON`: It returns a simple object without any of the extra properties added as part of
- * the Resource API. This object can be serialized through {@link angular.toJson} safely
- * without attaching Angular-specific fields. Notice that `JSON.stringify` (and
- * `angular.toJson`) automatically use this method when serializing a Resource instance
- * (see [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#toJSON%28%29_behavior)).
- *
- * @example
- *
- * # Credit card resource
- *
- * ```js
- // Define CreditCard class
- var CreditCard = $resource('/user/:userId/card/:cardId',
- {userId:123, cardId:'@id'}, {
- charge: {method:'POST', params:{charge:true}}
- });
- // We can retrieve a collection from the server
- var cards = CreditCard.query(function() {
- // GET: /user/123/card
- // server returns: [ {id:456, number:'1234', name:'Smith'} ];
- var card = cards[0];
- // each item is an instance of CreditCard
- expect(card instanceof CreditCard).toEqual(true);
- card.name = "J. Smith";
- // non GET methods are mapped onto the instances
- card.$save();
- // POST: /user/123/card/456 {id:456, number:'1234', name:'J. Smith'}
- // server returns: {id:456, number:'1234', name: 'J. Smith'};
- // our custom method is mapped as well.
- card.$charge({amount:9.99});
- // POST: /user/123/card/456?amount=9.99&charge=true {id:456, number:'1234', name:'J. Smith'}
- });
- // we can create an instance as well
- var newCard = new CreditCard({number:'0123'});
- newCard.name = "Mike Smith";
- newCard.$save();
- // POST: /user/123/card {number:'0123', name:'Mike Smith'}
- // server returns: {id:789, number:'0123', name: 'Mike Smith'};
- expect(newCard.id).toEqual(789);
- * ```
- *
- * The object returned from this function execution is a resource "class" which has "static" method
- * for each action in the definition.
- *
- * Calling these methods invoke `$http` on the `url` template with the given `method`, `params` and
- * `headers`.
- *
- * @example
- *
- * # User resource
- *
- * When the data is returned from the server then the object is an instance of the resource type and
- * all of the non-GET methods are available with `$` prefix. This allows you to easily support CRUD
- * operations (create, read, update, delete) on server-side data.
- ```js
- var User = $resource('/user/:userId', {userId:'@id'});
- User.get({userId:123}, function(user) {
- user.abc = true;
- user.$save();
- });
- ```
- *
- * It's worth noting that the success callback for `get`, `query` and other methods gets passed
- * in the response that came from the server as well as $http header getter function, so one
- * could rewrite the above example and get access to http headers as:
- *
- ```js
- var User = $resource('/user/:userId', {userId:'@id'});
- User.get({userId:123}, function(user, getResponseHeaders){
- user.abc = true;
- user.$save(function(user, putResponseHeaders) {
- //user => saved user object
- //putResponseHeaders => $http header getter
- });
- });
- ```
- *
- * You can also access the raw `$http` promise via the `$promise` property on the object returned
- *
- ```
- var User = $resource('/user/:userId', {userId:'@id'});
- User.get({userId:123})
- .$promise.then(function(user) {
- $scope.user = user;
- });
- ```
- *
- * @example
- *
- * # Creating a custom 'PUT' request
- *
- * In this example we create a custom method on our resource to make a PUT request
- * ```js
- * var app = angular.module('app', ['ngResource', 'ngRoute']);
- *
- * // Some APIs expect a PUT request in the format URL/object/ID
- * // Here we are creating an 'update' method
- * app.factory('Notes', ['$resource', function($resource) {
- * return $resource('/notes/:id', null,
- * {
- * 'update': { method:'PUT' }
- * });
- * }]);
- *
- * // In our controller we get the ID from the URL using ngRoute and $routeParams
- * // We pass in $routeParams and our Notes factory along with $scope
- * app.controller('NotesCtrl', ['$scope', '$routeParams', 'Notes',
- function($scope, $routeParams, Notes) {
- * // First get a note object from the factory
- * var note = Notes.get({ id:$routeParams.id });
- * $id = note.id;
- *
- * // Now call update passing in the ID first then the object you are updating
- * Notes.update({ id:$id }, note);
- *
- * // This will PUT /notes/ID with the note object in the request payload
- * }]);
- * ```
- *
- * @example
- *
- * # Cancelling requests
- *
- * If an action's configuration specifies that it is cancellable, you can cancel the request related
- * to an instance or collection (as long as it is a result of a "non-instance" call):
- *
- ```js
- // ...defining the `Hotel` resource...
- var Hotel = $resource('/api/hotel/:id', {id: '@id'}, {
- // Let's make the `query()` method cancellable
- query: {method: 'get', isArray: true, cancellable: true}
- });
- // ...somewhere in the PlanVacationController...
- ...
- this.onDestinationChanged = function onDestinationChanged(destination) {
- // We don't care about any pending request for hotels
- // in a different destination any more
- this.availableHotels.$cancelRequest();
- // Let's query for hotels in '<destination>'
- // (calls: /api/hotel?location=<destination>)
- this.availableHotels = Hotel.query({location: destination});
- };
- ```
- *
- */
- angular.module('ngResource', ['ng']).info({angularVersion: '1.6.5'}).provider('$resource', function ResourceProvider() {
- var PROTOCOL_AND_IPV6_REGEX = /^https?:\/\/\[[^\]]*][^/]*/;
- var provider = this;
- /**
- * @ngdoc property
- * @name $resourceProvider#defaults
- * @description
- * Object containing default options used when creating `$resource` instances.
- *
- * The default values satisfy a wide range of usecases, but you may choose to overwrite any of
- * them to further customize your instances. The available properties are:
- *
- * - **stripTrailingSlashes** – `{boolean}` – If true, then the trailing slashes from any
- * calculated URL will be stripped.<br />
- * (Defaults to true.)
- * - **cancellable** – `{boolean}` – If true, the request made by a "non-instance" call will be
- * cancelled (if not already completed) by calling `$cancelRequest()` on the call's return
- * value. For more details, see {@link ngResource.$resource}. This can be overwritten per
- * resource class or action.<br />
- * (Defaults to false.)
- * - **actions** - `{Object.<Object>}` - A hash with default actions declarations. Actions are
- * high-level methods corresponding to RESTful actions/methods on resources. An action may
- * specify what HTTP method to use, what URL to hit, if the return value will be a single
- * object or a collection (array) of objects etc. For more details, see
- * {@link ngResource.$resource}. The actions can also be enhanced or overwritten per resource
- * class.<br />
- * The default actions are:
- * ```js
- * {
- * get: {method: 'GET'},
- * save: {method: 'POST'},
- * query: {method: 'GET', isArray: true},
- * remove: {method: 'DELETE'},
- * delete: {method: 'DELETE'}
- * }
- * ```
- *
- * #### Example
- *
- * For example, you can specify a new `update` action that uses the `PUT` HTTP verb:
- *
- * ```js
- * angular.
- * module('myApp').
- * config(['$resourceProvider', function ($resourceProvider) {
- * $resourceProvider.defaults.actions.update = {
- * method: 'PUT'
- * };
- * });
- * ```
- *
- * Or you can even overwrite the whole `actions` list and specify your own:
- *
- * ```js
- * angular.
- * module('myApp').
- * config(['$resourceProvider', function ($resourceProvider) {
- * $resourceProvider.defaults.actions = {
- * create: {method: 'POST'},
- * get: {method: 'GET'},
- * getAll: {method: 'GET', isArray:true},
- * update: {method: 'PUT'},
- * delete: {method: 'DELETE'}
- * };
- * });
- * ```
- *
- */
- this.defaults = {
- // Strip slashes by default
- stripTrailingSlashes: true,
- // Make non-instance requests cancellable (via `$cancelRequest()`)
- cancellable: false,
- // Default actions configuration
- actions: {
- 'get': {method: 'GET'},
- 'save': {method: 'POST'},
- 'query': {method: 'GET', isArray: true},
- 'remove': {method: 'DELETE'},
- 'delete': {method: 'DELETE'}
- }
- };
- this.$get = ['$http', '$log', '$q', '$timeout', function ($http, $log, $q, $timeout) {
- var noop = angular.noop,
- forEach = angular.forEach,
- extend = angular.extend,
- copy = angular.copy,
- isArray = angular.isArray,
- isDefined = angular.isDefined,
- isFunction = angular.isFunction,
- isNumber = angular.isNumber,
- encodeUriQuery = angular.$$encodeUriQuery,
- encodeUriSegment = angular.$$encodeUriSegment;
- function Route(template, defaults) {
- this.template = template;
- this.defaults = extend({}, provider.defaults, defaults);
- this.urlParams = {};
- }
- Route.prototype = {
- setUrlParams: function (config, params, actionUrl) {
- var self = this,
- url = actionUrl || self.template,
- val,
- encodedVal,
- protocolAndIpv6 = '';
- var urlParams = self.urlParams = Object.create(null);
- forEach(url.split(/\W/), function (param) {
- if (param === 'hasOwnProperty') {
- throw $resourceMinErr('badname', 'hasOwnProperty is not a valid parameter name.');
- }
- if (!(new RegExp('^\\d+$').test(param)) && param &&
- (new RegExp('(^|[^\\\\]):' + param + '(\\W|$)').test(url))) {
- urlParams[param] = {
- isQueryParamValue: (new RegExp('\\?.*=:' + param + '(?:\\W|$)')).test(url)
- };
- }
- });
- url = url.replace(/\\:/g, ':');
- url = url.replace(PROTOCOL_AND_IPV6_REGEX, function (match) {
- protocolAndIpv6 = match;
- return '';
- });
- params = params || {};
- forEach(self.urlParams, function (paramInfo, urlParam) {
- val = params.hasOwnProperty(urlParam) ? params[urlParam] : self.defaults[urlParam];
- if (isDefined(val) && val !== null) {
- if (paramInfo.isQueryParamValue) {
- encodedVal = encodeUriQuery(val, true);
- } else {
- encodedVal = encodeUriSegment(val);
- }
- url = url.replace(new RegExp(':' + urlParam + '(\\W|$)', 'g'), function (match, p1) {
- return encodedVal + p1;
- });
- } else {
- url = url.replace(new RegExp('(/?):' + urlParam + '(\\W|$)', 'g'), function (match,
- leadingSlashes, tail) {
- if (tail.charAt(0) === '/') {
- return tail;
- } else {
- return leadingSlashes + tail;
- }
- });
- }
- });
- // strip trailing slashes and set the url (unless this behavior is specifically disabled)
- if (self.defaults.stripTrailingSlashes) {
- url = url.replace(/\/+$/, '') || '/';
- }
- // Collapse `/.` if found in the last URL path segment before the query.
- // E.g. `http://url.com/id/.format?q=x` becomes `http://url.com/id.format?q=x`.
- url = url.replace(/\/\.(?=\w+($|\?))/, '.');
- // Replace escaped `/\.` with `/.`.
- // (If `\.` comes from a param value, it will be encoded as `%5C.`.)
- config.url = protocolAndIpv6 + url.replace(/\/(\\|%5C)\./, '/.');
- // set params - delegate param encoding to $http
- forEach(params, function (value, key) {
- if (!self.urlParams[key]) {
- config.params = config.params || {};
- config.params[key] = value;
- }
- });
- }
- };
- function resourceFactory(url, paramDefaults, actions, options) {
- var route = new Route(url, options);
- actions = extend({}, provider.defaults.actions, actions);
- function extractParams(data, actionParams) {
- var ids = {};
- actionParams = extend({}, paramDefaults, actionParams);
- forEach(actionParams, function (value, key) {
- if (isFunction(value)) {
- value = value(data);
- }
- ids[key] = value && value.charAt && value.charAt(0) === '@' ?
- lookupDottedPath(data, value.substr(1)) : value;
- });
- return ids;
- }
- function defaultResponseInterceptor(response) {
- return response.resource;
- }
- function Resource(value) {
- shallowClearAndCopy(value || {}, this);
- }
- Resource.prototype.toJSON = function () {
- var data = extend({}, this);
- delete data.$promise;
- delete data.$resolved;
- delete data.$cancelRequest;
- return data;
- };
- forEach(actions, function (action, name) {
- var hasBody = action.hasBody === true || (action.hasBody !== false && /^(POST|PUT|PATCH)$/i.test(action.method));
- var numericTimeout = action.timeout;
- var cancellable = isDefined(action.cancellable) ?
- action.cancellable : route.defaults.cancellable;
- if (numericTimeout && !isNumber(numericTimeout)) {
- $log.debug('ngResource:\n' +
- ' Only numeric values are allowed as `timeout`.\n' +
- ' Promises are not supported in $resource, because the same value would ' +
- 'be used for multiple requests. If you are looking for a way to cancel ' +
- 'requests, you should use the `cancellable` option.');
- delete action.timeout;
- numericTimeout = null;
- }
- Resource[name] = function (a1, a2, a3, a4) {
- var params = {}, data, success, error;
- switch (arguments.length) {
- case 4:
- error = a4;
- success = a3;
- // falls through
- case 3:
- case 2:
- if (isFunction(a2)) {
- if (isFunction(a1)) {
- success = a1;
- error = a2;
- break;
- }
- success = a2;
- error = a3;
- // falls through
- } else {
- params = a1;
- data = a2;
- success = a3;
- break;
- }
- // falls through
- case 1:
- if (isFunction(a1)) success = a1;
- else if (hasBody) data = a1;
- else params = a1;
- break;
- case 0:
- break;
- default:
- throw $resourceMinErr('badargs',
- 'Expected up to 4 arguments [params, data, success, error], got {0} arguments',
- arguments.length);
- }
- var isInstanceCall = this instanceof Resource;
- var value = isInstanceCall ? data : (action.isArray ? [] : new Resource(data));
- var httpConfig = {};
- var responseInterceptor = action.interceptor && action.interceptor.response ||
- defaultResponseInterceptor;
- var responseErrorInterceptor = action.interceptor && action.interceptor.responseError ||
- undefined;
- var hasError = !!error;
- var hasResponseErrorInterceptor = !!responseErrorInterceptor;
- var timeoutDeferred;
- var numericTimeoutPromise;
- forEach(action, function (value, key) {
- switch (key) {
- default:
- httpConfig[key] = copy(value);
- break;
- case 'params':
- case 'isArray':
- case 'interceptor':
- case 'cancellable':
- break;
- }
- });
- if (!isInstanceCall && cancellable) {
- timeoutDeferred = $q.defer();
- httpConfig.timeout = timeoutDeferred.promise;
- if (numericTimeout) {
- numericTimeoutPromise = $timeout(timeoutDeferred.resolve, numericTimeout);
- }
- }
- if (hasBody) httpConfig.data = data;
- route.setUrlParams(httpConfig,
- extend({}, extractParams(data, action.params || {}), params),
- action.url);
- var promise = $http(httpConfig).then(function (response) {
- var data = response.data;
- if (data) {
- // Need to convert action.isArray to boolean in case it is undefined
- if (isArray(data) !== (!!action.isArray)) {
- throw $resourceMinErr('badcfg',
- 'Error in resource configuration for action `{0}`. Expected response to ' +
- 'contain an {1} but got an {2} (Request: {3} {4})', name, action.isArray ? 'array' : 'object',
- isArray(data) ? 'array' : 'object', httpConfig.method, httpConfig.url);
- }
- if (action.isArray) {
- value.length = 0;
- forEach(data, function (item) {
- if (typeof item === 'object') {
- value.push(new Resource(item));
- } else {
- // Valid JSON values may be string literals, and these should not be converted
- // into objects. These items will not have access to the Resource prototype
- // methods, but unfortunately there
- value.push(item);
- }
- });
- } else {
- var promise = value.$promise; // Save the promise
- shallowClearAndCopy(data, value);
- value.$promise = promise; // Restore the promise
- }
- }
- response.resource = value;
- return response;
- });
- promise = promise['finally'](function () {
- value.$resolved = true;
- if (!isInstanceCall && cancellable) {
- value.$cancelRequest = noop;
- $timeout.cancel(numericTimeoutPromise);
- timeoutDeferred = numericTimeoutPromise = httpConfig.timeout = null;
- }
- });
- promise = promise.then(
- function (response) {
- var value = responseInterceptor(response);
- (success || noop)(value, response.headers, response.status, response.statusText);
- return value;
- },
- (hasError || hasResponseErrorInterceptor) ?
- function (response) {
- if (hasError && !hasResponseErrorInterceptor) {
- // Avoid `Possibly Unhandled Rejection` error,
- // but still fulfill the returned promise with a rejection
- promise.catch(noop);
- }
- if (hasError) error(response);
- return hasResponseErrorInterceptor ?
- responseErrorInterceptor(response) :
- $q.reject(response);
- } :
- undefined);
- if (!isInstanceCall) {
- // we are creating instance / collection
- // - set the initial promise
- // - return the instance / collection
- value.$promise = promise;
- value.$resolved = false;
- if (cancellable) value.$cancelRequest = cancelRequest;
- return value;
- }
- // instance call
- return promise;
- function cancelRequest(value) {
- promise.catch(noop);
- timeoutDeferred.resolve(value);
- }
- };
- Resource.prototype['$' + name] = function (params, success, error) {
- if (isFunction(params)) {
- error = success;
- success = params;
- params = {};
- }
- var result = Resource[name].call(this, params, this, success, error);
- return result.$promise || result;
- };
- });
- Resource.bind = function (additionalParamDefaults) {
- var extendedParamDefaults = extend({}, paramDefaults, additionalParamDefaults);
- return resourceFactory(url, extendedParamDefaults, actions, options);
- };
- return Resource;
- }
- return resourceFactory;
- }];
- });
- })(window, window.angular);
|