OData V4 Service modules - MongoDB Connector

Service OData v4 requests from a MongoDB data store.

Synopsis

The OData V4 MongoDB Connector provides functionality to convert the various types of OData segments into MongoDB query objects, that you can execute over a MongoDB database.

Potential usage scenarios

• Create high speed, standard compliant data sharing APIs

Usage as server - TypeScript

1import { createFilter } from '@steedos/odata-v4-mongodb'
2
3//example request:  GET /api/products?$filter=category/id eq 5 or color eq 'Red'
4app.get("/api/products", (req: Request, res: Response) => {
5    const filter = createFilter(req.query.$filter);
6    // collection instance from MongoDB Node.JS Driver
7    collection.find(filter, function(err, data){
8        res.json({
9        	'@odata.context': req.protocol + '://' + req.get('host') + '/api/$metadata#products',
10        	value: data
11        });
12    });
13});

Usage ES5

1var createFilter = require('@steedos/odata-v4-mongodb').createFilter;
2
3app.get("/api/products", function(req, res) {
4    var filter = createFilter(req.query.$filter);
5    // collection instance from MongoDB Node.JS Driver
6    collection.find(filter, function(err, data){
7        res.json({
8        	'@odata.context': req.protocol + '://' + req.get('host') + '/api/$metadata#products',
9        	value: data
10        });
11    });
12})

Supported OData segments

For now $filter, $select, $skip and $top

Support for $expand is next.

Supported $filter expressions

The OData v4 Parser layer supports 100% of the specification. The Connector is supporting basic MongoDB queries.

We are into creating a comprehensive feature availability chart for V1 release

√ expression 5.1.1.6.1: NullValue eq null
√ expression 5.1.1.6.1: TrueValue eq true
√ expression 5.1.1.6.1: FalseValue eq false
√ expression 5.1.1.6.1: IntegerValue lt -128
√ expression 5.1.1.6.1: DecimalValue eq 34.95
√ expression 5.1.1.6.1: StringValue eq 'Say Hello,then go'
√ expression 5.1.1.6.1: DurationValue eq duration'P12DT23H59M59.999999999999S'
√ expression 5.1.1.6.1: DateValue eq 2012-12-03
√ expression 5.1.1.6.1: DateTimeOffsetValue eq 2012-12-03T07:16:23Z
√ expression 5.1.1.6.1: GuidValue eq 01234567-89ab-cdef-0123-456789abcdef
√ expression 5.1.1.6.1: Int64Value eq 0
√ expression 5.1.1.6.1: A eq INF
√ expression 5.1.1.6.1: A eq 0.31415926535897931e1
√ expression 5.1.1.1.2: A ne 1
√ expression 5.1.1.1.3: A gt 2
√ expression 5.1.1.1.4: A ge 3
√ expression 5.1.1.1.5: A lt 2
√ expression 5.1.1.1.6: A le 2
√ expression: A/b eq 1
√ expression 5.1.1.3: (A/b eq 2) or (B/c lt 4) and ((E gt 5) or (E lt -1))