@@ -1102,6 +1102,34 @@ utils.addHiddenPropsToTarget(HttpAdapter.prototype, {
1102
1102
/**
1103
1103
* Add an Http actions to a mapper.
1104
1104
*
1105
+ * @example
1106
+ * // CommonJS
1107
+ * var JSData = require('js-data')
1108
+ * // It is recommended to use DataStore in the browser
1109
+ * var DataStore = JSData.DataStore
1110
+ *
1111
+ * var JSDataHttp = require('js-data-http')
1112
+ * var HttpAdapter = JSDataHttp.HttpAdapter
1113
+ * var addAction = JSDataHttp.addAction
1114
+ *
1115
+ * var adapter = new HttpAdapter()
1116
+ * var store = new DataStore()
1117
+ *
1118
+ * store.registerAdapter('http', adapter, { default: true })
1119
+ * store.defineMapper('school')
1120
+ *
1121
+ * // GET /reports/schools/:school_id/teachers
1122
+ * addAction('getTeacherReports', {
1123
+ * basePath: 'reports/schools',
1124
+ * pathname: 'teachers',
1125
+ * method: 'GET'
1126
+ * })(store.getMapper('school'))
1127
+ *
1128
+ * // /reports/schools/1234/teachers
1129
+ * store.getMapper('school').getTeacherReports(1234).then(function (response) {
1130
+ * // ...
1131
+ * })
1132
+ *
1105
1133
* @name module:js-data-http.addAction
1106
1134
* @method
1107
1135
* @param {string } name Name of the new action.
@@ -1152,7 +1180,7 @@ exports.addAction = function addAction (name, opts) {
1152
1180
}
1153
1181
config . method = config . method || 'GET'
1154
1182
config . mapper = self . name
1155
- utils . deepMixIn ( config ) ( _opts )
1183
+ utils . deepMixIn ( config , _opts )
1156
1184
return utils . resolve ( config )
1157
1185
. then ( _opts . request || opts . request )
1158
1186
. then ( function ( config ) { return adapter . HTTP ( config ) } )
@@ -1172,6 +1200,36 @@ exports.addAction = function addAction (name, opts) {
1172
1200
* Add multiple Http actions to a mapper. See {@link HttpAdapter.addAction} for
1173
1201
* action configuration options.
1174
1202
*
1203
+ * @example
1204
+ * // CommonJS
1205
+ * var JSData = require('js-data')
1206
+ * // It is recommended to use DataStore in the browser
1207
+ * var DataStore = JSData.DataStore
1208
+ *
1209
+ * var JSDataHttp = require('js-data-http')
1210
+ * var HttpAdapter = JSDataHttp.HttpAdapter
1211
+ * var addActions = JSDataHttp.addActions
1212
+ *
1213
+ * var adapter = new HttpAdapter()
1214
+ * var store = new DataStore()
1215
+ *
1216
+ * store.registerAdapter('http', adapter, { default: true })
1217
+ * store.defineMapper('school')
1218
+ *
1219
+ * addActions({
1220
+ * // GET /reports/schools/:school_id/teachers
1221
+ * getTeacherReports: {
1222
+ * basePath: 'reports/schools',
1223
+ * pathname: 'teachers',
1224
+ * method: 'GET'
1225
+ * }
1226
+ * })(store.getMapper('school'))
1227
+ *
1228
+ * // /reports/schools/1234/teachers
1229
+ * store.getMapper('school').getTeacherReports(1234).then(function (response) {
1230
+ * // ...
1231
+ * })
1232
+ *
1175
1233
* @name module:js-data-http.addActions
1176
1234
* @method
1177
1235
* @param {Object.<string, Object> } opts Object where the key is an action name
@@ -1182,7 +1240,7 @@ exports.addAction = function addAction (name, opts) {
1182
1240
exports . addActions = function addActions ( opts ) {
1183
1241
opts || ( opts = { } )
1184
1242
return function ( mapper ) {
1185
- utils . forOwn ( mapper , function ( value , key ) {
1243
+ utils . forOwn ( opts , function ( value , key ) {
1186
1244
exports . addAction ( key , value ) ( mapper )
1187
1245
} )
1188
1246
return mapper
@@ -1211,22 +1269,25 @@ exports.version = '<%= version %>'
1211
1269
* of `js-data-http` that does not bundle `axios` is registered in NPM and Bower
1212
1270
* as `js-data-fetch`.
1213
1271
*
1214
- * __Script tag__:
1215
- * ```javascript
1216
- * window.HttpAdapter
1217
- * ```
1218
- * __CommonJS__:
1219
- * ```javascript
1220
- * var HttpAdapter = require('js-data-http')
1221
- * ```
1222
- * __ES6 Modules__:
1223
- * ```javascript
1224
- * import HttpAdapter from 'js-data-http'
1225
- * ```
1226
- * __AMD__:
1227
- * ```javascript
1228
- * define('myApp', ['js-data-http'], function (HttpAdapter) { ... })
1229
- * ```
1272
+ * @example <caption>Script tag</caption>
1273
+ * var HttpAdapter = window.JSDataHttp.HttpAdapter
1274
+ * var adapter = new HttpAdapter()
1275
+ *
1276
+ * @example <caption>CommonJS</caption>
1277
+ * var HttpAdapter = require('js-data-Http').HttpAdapter
1278
+ * var adapter = new HttpAdapter()
1279
+ *
1280
+ * @example <caption>ES2015 Modules</caption>
1281
+ * import {HttpAdapter} from 'js-data-Http'
1282
+ * const adapter = new HttpAdapter()
1283
+ *
1284
+ * @example <caption>AMD</caption>
1285
+ * define('myApp', ['js-data-Http'], function (JSDataHttp) {
1286
+ * var HttpAdapter = JSDataHttp.HttpAdapter
1287
+ * var adapter = new HttpAdapter()
1288
+ *
1289
+ * // ...
1290
+ * })
1230
1291
*
1231
1292
* @module js-data-http
1232
1293
*/
0 commit comments