new RedisAdapter(opts)
RedisAdapter class.
Parameters:
Name | Type | Argument | Description | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
opts |
Object |
<optional> |
Configuration opts. Properties
|
Example
// Use Container instead of DataStore on the server import {Container} from 'js-data' import RedisAdapter from 'js-data-redis' // Create a store to hold your Mappers const store = new Container() // Create an instance of RedisAdapter with default settings const adapter = new RedisAdapter() // Mappers in "store" will use the Redis adapter by default store.registerAdapter('redis', adapter, { default: true }) // Create a Mapper that maps to a "user" table store.defineMapper('user')
Extends
Members
-
client :Object
-
The Redis client used by this adapter. Use this directly when you need to write custom queries.
Type:
- Object
-
debug :boolean
-
Whether to log debugging information.
Type:
- boolean
- Inherited From:
- Default Value:
-
- false
-
host :string
-
Redis host.
Type:
- string
- Default Value:
-
- "127.0.0.1"
-
port :number
-
Redis port.
Type:
- number
- Default Value:
-
- 6379
-
raw :boolean
-
Whether to return a more detailed response object.
Type:
- boolean
- Inherited From:
- Default Value:
-
- false
Methods
-
<static> extend(instanceProps, classProps)
-
Alternative to ES6 class syntax for extending
RedisAdapter
.Parameters:
Name Type Argument Description instanceProps
Object <optional>
Properties that will be added to the prototype of the RedisAdapter.
classProps
Object <optional>
Properties that will be added as static properties to the RedisAdapter itself.
Returns:
RedisAdapter of
RedisAdapter
.- Type
- Object
-
afterCount(mapper, props, opts, response)
-
Lifecycle method method called by count.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes count to wait for the Promise to resolve before continuing.
If
opts.raw
istrue
thenresponse
will be a detailed response object, otherwiseresponse
will be the count.response
may be modified. You can also re-assignresponse
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by count.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to count.props
Object The
props
argument passed to count.opts
Object The
opts
argument passed to count.response
Object | Response Count or Response, depending on the value of
opts.raw
.- Inherited From:
Properties:
Name Type Description opts.op
string afterCount
-
afterCreate(mapper, props, opts, response)
-
Lifecycle method method called by create.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes create to wait for the Promise to resolve before continuing.
If
opts.raw
istrue
thenresponse
will be a detailed response object, otherwiseresponse
will be the created record.response
may be modified. You can also re-assignresponse
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by create.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to create.props
Object The
props
argument passed to create.opts
Object The
opts
argument passed to create.response
Object | Response Created record or Response, depending on the value of
opts.raw
.- Inherited From:
- Overrides:
Properties:
Name Type Description opts.op
string afterCreate
-
afterDestroy(mapper, id, opts, response)
-
Lifecycle method method called by destroy.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes destroy to wait for the Promise to resolve before continuing.
If
opts.raw
istrue
thenresponse
will be a detailed response object, otherwiseresponse
will beundefined
.response
may be modified. You can also re-assignresponse
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by destroy.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to destroy.id
string | number The
id
argument passed to destroy.opts
Object The
opts
argument passed to destroy.response
undefined | Response undefined
or Response, depending on the value ofopts.raw
.- Inherited From:
Properties:
Name Type Description opts.op
string afterDestroy
-
afterDestroyAll(mapper, query, opts, response)
-
Lifecycle method method called by destroyAll.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes destroyAll to wait for the Promise to resolve before continuing.
If
opts.raw
istrue
thenresponse
will be a detailed response object, otherwiseresponse
will beundefined
.response
may be modified. You can also re-assignresponse
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by destroyAll.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to destroyAll.query
Object The
query
argument passed to destroyAll.opts
Object The
opts
argument passed to destroyAll.response
undefined | Response undefined
or Response, depending on the value ofopts.raw
.- Inherited From:
Properties:
Name Type Description opts.op
string afterDestroyAll
-
afterFind(mapper, id, opts, response)
-
Lifecycle method method called by find.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes find to wait for the Promise to resolve before continuing.
If
opts.raw
istrue
thenresponse
will be a detailed response object, otherwiseresponse
will be the found record, if any.response
may be modified. You can also re-assignresponse
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by find.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to find.id
string | number The
id
argument passed to find.opts
Object The
opts
argument passed to find.response
Object | Response The found record or Response, depending on the value of
opts.raw
.- Inherited From:
Properties:
Name Type Description opts.op
string afterFind
-
afterFindAll(mapper, query, opts, response)
-
Lifecycle method method called by findAll.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes findAll to wait for the Promise to resolve before continuing.
If
opts.raw
istrue
thenresponse
will be a detailed response object, otherwiseresponse
will be the found records, if any.response
may be modified. You can also re-assignresponse
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by findAll.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to findAll.query
Object The
query
argument passed to findAll.opts
Object The
opts
argument passed to findAll.response
Array.<Object> | Response The found records or Response, depending on the value of
opts.raw
.- Inherited From:
Properties:
Name Type Description opts.op
string afterFindAll
-
afterSum(mapper, props, opts, response)
-
Lifecycle method method called by sum.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes sum to wait for the Promise to resolve before continuing.
If
opts.raw
istrue
thenresponse
will be a detailed response object, otherwiseresponse
will be the sum.response
may be modified. You can also re-assignresponse
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by sum.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to sum.props
Object The
props
argument passed to sum.opts
Object The
opts
argument passed to sum.response
Object | Response Count or Response, depending on the value of
opts.raw
.- Inherited From:
Properties:
Name Type Description opts.op
string afterSum
-
afterUpdate(mapper, id, props, opts, response)
-
Lifecycle method method called by update.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes update to wait for the Promise to resolve before continuing.
If
opts.raw
istrue
thenresponse
will be a detailed response object, otherwiseresponse
will be the updated record.response
may be modified. You can also re-assignresponse
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by update.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to update.id
string | number The
id
argument passed to update.props
Object The
props
argument passed to update.opts
Object The
opts
argument passed to update.response
Object | Response The updated record or Response, depending on the value of
opts.raw
.- Inherited From:
Properties:
Name Type Description opts.op
string afterUpdate
-
afterUpdateAll(mapper, props, query, opts, response)
-
Lifecycle method method called by updateAll.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes updateAll to wait for the Promise to resolve before continuing.
If
opts.raw
istrue
thenresponse
will be a detailed response object, otherwiseresponse
will be the updated records, if any.response
may be modified. You can also re-assignresponse
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by updateAll.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to updateAll.props
Object The
props
argument passed to updateAll.query
Object The
query
argument passed to updateAll.opts
Object The
opts
argument passed to updateAll.response
Array.<Object> | Response The updated records or Response, depending on the value of
opts.raw
.- Inherited From:
Properties:
Name Type Description opts.op
string afterUpdateAll
-
afterUpdateMany(mapper, records, opts, response)
-
Lifecycle method method called by updateMany.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes updateMany to wait for the Promise to resolve before continuing.
If
opts.raw
istrue
thenresponse
will be a detailed response object, otherwiseresponse
will be the updated records, if any.response
may be modified. You can also re-assignresponse
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by updateMany.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to updateMany.records
Array.<Object> The
records
argument passed to updateMany.opts
Object The
opts
argument passed to updateMany.response
Array.<Object> | Response The updated records or Response, depending on the value of
opts.raw
.- Inherited From:
Properties:
Name Type Description opts.op
string afterUpdateMany
-
beforeCount(mapper, query, opts)
-
Lifecycle method method called by count.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes count to wait for the Promise to resolve before continuing.
A thrown error or rejected Promise will bubble up and reject the Promise returned by count.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to count.query
Object The
query
argument passed to count.opts
Object The
opts
argument passed to count.- Inherited From:
Properties:
Name Type Description opts.op
string beforeCount
-
beforeCreate(mapper, props, opts)
-
Lifecycle method method called by create.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes create to wait for the Promise to resolve before continuing.
props
may be modified. You can also re-assignprops
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by create.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to create.props
Object The
props
argument passed to create.opts
Object The
opts
argument passed to create.- Inherited From:
Properties:
Name Type Description opts.op
string beforeCreate
-
beforeCreateMany(mapper, props, opts)
-
Lifecycle method method called by createMany.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes createMany to wait for the Promise to resolve before continuing.
props
may be modified. You can also re-assignprops
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by createMany.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to createMany.props
Array.<Object> The
props
argument passed to createMany.opts
Object The
opts
argument passed to createMany.- Inherited From:
Properties:
Name Type Description opts.op
string beforeCreateMany
-
beforeDestroy(mapper, id, opts)
-
Lifecycle method method called by destroy.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes destroy to wait for the Promise to resolve before continuing.
A thrown error or rejected Promise will bubble up and reject the Promise returned by destroy.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to destroy.id
string | number The
id
argument passed to destroy.opts
Object The
opts
argument passed to destroy.- Inherited From:
Properties:
Name Type Description opts.op
string beforeDestroy
-
beforeDestroyAll(mapper, query, opts)
-
Lifecycle method method called by destroyAll.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes destroyAll to wait for the Promise to resolve before continuing.
A thrown error or rejected Promise will bubble up and reject the Promise returned by destroyAll.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to destroyAll.query
Object The
query
argument passed to destroyAll.opts
Object The
opts
argument passed to destroyAll.- Inherited From:
Properties:
Name Type Description opts.op
string beforeDestroyAll
-
beforeFind(mapper, id, opts)
-
Lifecycle method method called by find.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes find to wait for the Promise to resolve before continuing.
A thrown error or rejected Promise will bubble up and reject the Promise returned by find.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to find.id
string | number The
id
argument passed to find.opts
Object The
opts
argument passed to find.- Inherited From:
Properties:
Name Type Description opts.op
string beforeFind
-
beforeFindAll(mapper, query, opts)
-
Lifecycle method method called by findAll.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes findAll to wait for the Promise to resolve before continuing.
A thrown error or rejected Promise will bubble up and reject the Promise returned by findAll.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to findAll.query
Object The
query
argument passed to findAll.opts
Object The
opts
argument passed to findAll.- Inherited From:
Properties:
Name Type Description opts.op
string beforeFindAll
-
beforeSum(mapper, query, opts)
-
Lifecycle method method called by sum.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes sum to wait for the Promise to resolve before continuing.
A thrown error or rejected Promise will bubble up and reject the Promise returned by sum.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to sum.query
Object The
query
argument passed to sum.opts
Object The
opts
argument passed to sum.- Inherited From:
Properties:
Name Type Description opts.op
string beforeSum
-
beforeUpdate(mapper, id, props, opts)
-
Lifecycle method method called by update.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes update to wait for the Promise to resolve before continuing.
props
may be modified. You can also re-assignprops
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by update.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to update.id
string | number The
id
argument passed to update.props
Object The
props
argument passed to update.opts
Object The
opts
argument passed to update.- Inherited From:
Properties:
Name Type Description opts.op
string beforeUpdate
-
beforeUpdateAll(mapper, props, query, opts)
-
Lifecycle method method called by updateAll.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes updateAll to wait for the Promise to resolve before continuing.
props
may be modified. You can also re-assignprops
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by updateAll.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to updateAll.props
Object The
props
argument passed to updateAll.query
Object The
query
argument passed to updateAll.opts
Object The
opts
argument passed to updateAll.- Inherited From:
Properties:
Name Type Description opts.op
string beforeUpdateAll
-
beforeUpdateMany(mapper, props, opts)
-
Lifecycle method method called by updateMany.
Override this method to add custom behavior for this lifecycle hook.
Returning a Promise causes updateMany to wait for the Promise to resolve before continuing.
props
may be modified. You can also re-assignprops
to another value by returning a different value or a Promise that resolves to a different value.A thrown error or rejected Promise will bubble up and reject the Promise returned by updateMany.
Parameters:
Name Type Description mapper
Object The
mapper
argument passed to updateMany.props
Array.<Object> The
props
argument passed to updateMany.opts
Object The
opts
argument passed to updateMany.- Inherited From:
Properties:
Name Type Description opts.op
string beforeUpdateMany
-
count(mapper, query, opts)
-
Retrieve the number of records that match the selection query. Called by
Mapper#count
.Parameters:
Name Type Argument Description mapper
Object The mapper.
query
Object <optional>
Selection query.
Properties
Name Type Argument Description where
Object <optional>
Filtering criteria.
orderBy
string | Array <optional>
Sorting criteria.
sort
string | Array <optional>
Same as
query.sort
.limit
number <optional>
Limit results.
skip
number <optional>
Offset results.
offset
number <optional>
Same as
query.skip
.opts
Object <optional>
Configuration options.
Properties
Name Type Argument Default Description raw
boolean <optional>
false Whether to return a more detailed response object.
- Inherited From:
Returns:
- Type
- Promise
-
create(mapper, props, opts)
-
Create a new record. Called by
Mapper#create
.Parameters:
Name Type Argument Description mapper
Object The mapper.
props
Object The record to be created.
opts
Object <optional>
Configuration options.
Properties
Name Type Argument Default Description raw
boolean <optional>
false Whether to return a more detailed response object.
- Inherited From:
Returns:
- Type
- Promise
-
createMany(mapper, props, opts)
-
Create multiple records in a single batch. Called by
Mapper#createMany
.Parameters:
Name Type Argument Description mapper
Object The mapper.
props
Object The records to be created.
opts
Object <optional>
Configuration options.
Properties
Name Type Argument Default Description raw
boolean <optional>
false Whether to return a more detailed response object.
- Inherited From:
Returns:
- Type
- Promise
-
dbg()
-
Shortcut for
#log('debug'[, arg1[, arg2[, argn]]])
.- Inherited From:
-
destroy(mapper, id, opts)
-
Destroy the record with the given primary key. Called by
Mapper#destroy
.Parameters:
Name Type Argument Description mapper
Object The mapper.
id
string | number Primary key of the record to destroy.
opts
Object <optional>
Configuration options.
Properties
Name Type Argument Default Description raw
boolean <optional>
false Whether to return a more detailed response object.
- Inherited From:
Returns:
- Type
- Promise
-
destroyAll(mapper, query, opts)
-
Destroy the records that match the selection query. Called by
Mapper#destroyAll
.Parameters:
Name Type Argument Description mapper
Object the mapper.
query
Object <optional>
Selection query.
Properties
Name Type Argument Description where
Object <optional>
Filtering criteria.
orderBy
string | Array <optional>
Sorting criteria.
sort
string | Array <optional>
Same as
query.sort
.limit
number <optional>
Limit results.
skip
number <optional>
Offset results.
offset
number <optional>
Same as
query.skip
.opts
Object <optional>
Configuration options.
Properties
Name Type Argument Default Description raw
boolean <optional>
false Whether to return a more detailed response object.
- Inherited From:
Returns:
- Type
- Promise
-
find(mapper, id, opts)
-
Retrieve the record with the given primary key. Called by
Mapper#find
.Parameters:
Name Type Argument Description mapper
Object The mapper.
id
string | number Primary key of the record to retrieve.
opts
Object <optional>
Configuration options.
Properties
Name Type Argument Default Description raw
boolean <optional>
false Whether to return a more detailed response object.
with
Array.<string> <optional>
[] Relations to eager load.
- Inherited From:
Returns:
- Type
- Promise
-
findAll(mapper, query, opts)
-
Retrieve the records that match the selection query.
Parameters:
Name Type Argument Description mapper
Object The mapper.
query
Object <optional>
Selection query.
Properties
Name Type Argument Description where
Object <optional>
Filtering criteria.
orderBy
string | Array <optional>
Sorting criteria.
sort
string | Array <optional>
Same as
query.sort
.limit
number <optional>
Limit results.
skip
number <optional>
Offset results.
offset
number <optional>
Same as
query.skip
.opts
Object <optional>
Configuration options.
Properties
Name Type Argument Default Description raw
boolean <optional>
false Whether to return a more detailed response object.
with
Array.<string> <optional>
[] Relations to eager load.
- Inherited From:
Returns:
- Type
- Promise
-
getOpt(opt, opts)
-
Resolve the value of the specified option based on the given options and this adapter's settings. Override with care.
Parameters:
Name Type Argument Description opt
string The name of the option.
opts
Object <optional>
Configuration options.
- Inherited From:
Returns:
The value of the specified option.
- Type
- *
-
loadBelongsTo()
-
Load a belongsTo relationship.
Override with care.
- Inherited From:
Returns:
- Type
- Promise
-
loadHasMany()
-
Load a hasMany relationship.
Override with care.
- Inherited From:
Returns:
- Type
- Promise
-
loadHasOne()
-
Load a hasOne relationship.
Override with care.
- Inherited From:
Returns:
- Type
- Promise
-
log(level, values)
-
Logging utility method. Override this method if you want to send log messages to something other than the console.
Parameters:
Name Type Argument Description level
string Log level.
values
* <repeatable>
Values to log.
- Inherited From:
-
makeBelongsToForeignKey()
-
Return the foreignKey from the given record for the provided relationship.
Override with care.
- Inherited From:
Returns:
- Type
- *
-
makeHasManyForeignKey()
-
Return the foreignKey from the given record for the provided relationship.
There may be reasons why you may want to override this method, like when the id of the parent doesn't exactly match up to the key on the child.
Override with care.
- Inherited From:
Returns:
- Type
- *
-
makeHasManyForeignKeys()
-
Return the foreignKeys from the given record for the provided relationship.
Override with care.
- Inherited From:
Returns:
- Type
- *
-
makeHasManyLocalKeys()
-
Return the localKeys from the given record for the provided relationship.
Override with care.
- Inherited From:
Returns:
- Type
- *
-
respond(response, opts)
-
Parameters:
Name Type Description response
Object Response object.
opts
Object Configuration options. return {Object} If
opts.raw == true
then returnresponse
, else returnresponse.data
.- Inherited From:
-
sum(mapper, field, query, opts)
-
Retrieve sum of the specified field of the records that match the selection query. Called by
Mapper#sum
.Parameters:
Name Type Argument Description mapper
Object The mapper.
field
string By to sum.
query
Object <optional>
Selection query.
Properties
Name Type Argument Description where
Object <optional>
Filtering criteria.
orderBy
string | Array <optional>
Sorting criteria.
sort
string | Array <optional>
Same as
query.sort
.limit
number <optional>
Limit results.
skip
number <optional>
Offset results.
offset
number <optional>
Same as
query.skip
.opts
Object <optional>
Configuration options.
Properties
Name Type Argument Default Description raw
boolean <optional>
false Whether to return a more detailed response object.
- Inherited From:
Returns:
- Type
- Promise
-
update(mapper, id, props, opts)
-
Apply the given update to the record with the specified primary key. Called by
Mapper#update
.Parameters:
Name Type Argument Description mapper
Object The mapper.
id
string | number The primary key of the record to be updated.
props
Object The update to apply to the record.
opts
Object <optional>
Configuration options.
Properties
Name Type Argument Default Description raw
boolean <optional>
false Whether to return a more detailed response object.
- Inherited From:
Returns:
- Type
- Promise
-
updateAll(mapper, props, query, opts)
-
Apply the given update to all records that match the selection query. Called by
Mapper#updateAll
.Parameters:
Name Type Argument Description mapper
Object The mapper.
props
Object The update to apply to the selected records.
query
Object <optional>
Selection query.
Properties
Name Type Argument Description where
Object <optional>
Filtering criteria.
orderBy
string | Array <optional>
Sorting criteria.
sort
string | Array <optional>
Same as
query.sort
.limit
number <optional>
Limit results.
skip
number <optional>
Offset results.
offset
number <optional>
Same as
query.skip
.opts
Object <optional>
Configuration options.
Properties
Name Type Argument Default Description raw
boolean <optional>
false Whether to return a more detailed response object.
- Inherited From:
Returns:
- Type
- Promise
-
updateMany(mapper, records, opts)
-
Update the given records in a single batch. Called by
Mapper#updateMany
.Parameters:
Name Type Argument Description mapper
Object The mapper.
records
Array.<Object> The records to update.
opts
Object <optional>
Configuration options.
Properties
Name Type Argument Default Description raw
boolean <optional>
false Whether to return a more detailed response object.
- Inherited From:
Returns:
- Type
- Promise