RestCollectionView RestAPI

This sample shows how you can extend the RestCollectionView class to create a custom RestCollectionViewExt class that talks to Mescius Demo Service's Grouping and Pagination RestAPI.

The RestCollectionViewExt class supports server-based pagination/virtualization along with server based sorting, filtering.

You can check a sample implementation with server and client code Wijmo-Rest-CollectionView-Sample

Learn about FlexGrid | Loading Data Documentation | CollectionView API Reference

import 'bootstrap.css'; import '@mescius/wijmo.styles/wijmo.css'; import './styles.css'; // import { RestCollectionViewExt } from "./rest-collection-view-ext"; import { CollectionViewNavigator } from '@mescius/wijmo.input'; import { createElement } from '@mescius/wijmo'; import { FlexGrid } from '@mescius/wijmo.grid'; import { FlexGridFilter } from '@mescius/wijmo.grid.filter'; // field info for PurchaseOrders table const fields = 'OrderId,StockItem,Color,State,City,Quantity,UnitPrice,Date,IsChillerStock'.split(','); document.readyState === 'complete' ? init() : window.onload = init; // function init() { // initialize PageSize const pageSize = 100; // create the grid to show the data let theGrid = new FlexGrid('#theGrid', { isReadOnly: true, // create RestCollectionViewExt itemsSource: new RestCollectionViewExt('purchaseorders', { fields: fields, pageSize: pageSize, loading: () => { toggleSpinner(theGrid, true); }, loaded: () => { toggleSpinner(theGrid, false); } }) }); // add the filter new FlexGridFilter(theGrid); // add the navigator let nav = new CollectionViewNavigator('#theNavigator', { cv: theGrid.collectionView, byPage: true }); // toggle b/w pagination and virtualization document.body.addEventListener('click', e => { let radio = e.target, view = theGrid.collectionView; if (radio.name == "viewtype" && radio.id === 'paging') { view.virtualization = false; view.pageSize = pageSize; nav.hostElement.style.display = 'inline-flex'; } if (radio.name == "viewtype" && radio.id !== 'paging') { let view = theGrid.collectionView; view.virtualization = true; view.pageSize = 0; nav.hostElement.style.display = 'none'; } }); } //show gif loader while data loading function toggleSpinner(grid, show) { let _rect = grid.controlRect; let elem = grid.hostElement.querySelector('.spinner'); if (!elem) elem = createElement(`<div class='spinner' style="left:${_rect.left}px;top:${_rect.top}px;width:${_rect.width}px;height:${_rect.height}px;"><img src="resources/Rounded%20blocks.gif"></div>`, grid.hostElement); elem.style.display = show ? 'block' : 'none'; }
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <title>MESCIUS Wijmo RestCollectionView RestAPI</title> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <!-- SystemJS --> <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.21.5/system.src.js" integrity="sha512-skZbMyvYdNoZfLmiGn5ii6KmklM82rYX2uWctBhzaXPxJgiv4XBwJnFGr5k8s+6tE1pcR1nuTKghozJHyzMcoA==" crossorigin="anonymous"></script> <script src="systemjs.config.js"></script> <script> System.import('./src/app'); </script> </head> <body> <div class="container-fluid"> <label> <input id="paging" name="viewtype" type="radio" value="paging" checked />Paging </label> <label> <input id="virtualization" type="radio" name="viewtype" value="Virtualization" />Virtualization </label> <br /> <div id="theNavigator"></div> <div id="theGrid"></div> <p id="msg"></p> </div> </body> </html>
body { margin-bottom: 36pt; margin-top: 10px; } label { padding-right: 10px; } .wj-flexgrid { height: 400px; } .spinner { position: absolute; z-index: 10; opacity: .5; } .spinner img { margin: auto; position: relative; top: 40%; left: 45%; }
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) { function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); } return new (P || (P = Promise))(function (resolve, reject) { function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } } function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } } function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); } step((generator = generator.apply(thisArg, _arguments || [])).next()); }); }; import { RestCollectionView } from '@mescius/wijmo.rest'; import { DataType, isDate, DateTime, asNumber, isBoolean, httpRequest, copy, changeType, isString } from '@mescius/wijmo'; const _apiUrl = "https://demodata.mescius.io/wwi/api/v1/"; /** * Class that extends {@link RestCollectionView} to support RestAPI data sources. */ export class RestCollectionViewExt extends RestCollectionView { /** * Initializes a new instance of the {@link RestCollectionViewExt} class. * * @param tableName Name of the table (entity) to retrieve from the service. * @param options JavaScript object containing initialization data (property * values and event handlers) for the {@link RestCollectionView}. */ constructor(tableName, options) { super(); this._url = _apiUrl; this._tbl = tableName; copy(this, options); } // parse json data _jsonReviver(key, value) { const _rxDate = /^\d{4}\-\d{2}\-\d{2}T\d{2}\:\d{2}\:\d{2}|\/Date\([\d\-]*?\)/; if (typeof value === 'string' && _rxDate.test(value)) { value = value.indexOf('/Date(') == 0 // verbosejson ? new Date(parseInt(value.substr(6))) : new Date(value); } return value; } // get parameter for sorting, filtering, paging and virtualization _getReadParams() { let settings = {}; // apply filter if (this.filterOnServer && this._filterProvider) { let filter = this._asODataFilter(this._filterProvider); if (filter.length > 0) { settings.filterBy = filter; } } //apply sortBy if (this.sortOnServer && this.sortDescriptions.length > 0) { let _sortBy = []; for (let i = 0; i < this.sortDescriptions.length; i++) { let sort = `${this.sortDescriptions[i].property} ${this.sortDescriptions[i].ascending ? 'ASC' : 'DESC'}`; _sortBy.push(sort); // add sort } settings.sortBy = _sortBy.join(','); } // current view window if (this.virtualization) { settings.skip = this._start; settings.top = this._fetchSize(); } // get page params if (this.pageOnServer && this.pageSize > 0) { settings.skip = this.pageIndex * this.pageSize; settings.top = this.pageSize; } if (this.fields && this.fields.length > 0) { settings.select = this.fields; } return settings; } // ** overrides getItems() { // cancel any pending requests if (this._pendingReq) { this._pendingReq.abort(); } return new Promise(resolve => { let _settings = this._getReadParams(); // get the items virtually this._pendingReq = httpRequest(this._url + this._tbl, { requestHeaders: this.requestHeaders, data: _settings, success: (xhr) => __awaiter(this, void 0, void 0, function* () { // parse response let resp = JSON.parse(xhr.responseText, this._jsonReviver); let _count = asNumber(resp.totalItemCount); if (_count != this._totalItemCount) this._totalItemCount = _count; resolve(resp.items); }), error: xhr => this._raiseError(xhr.responseText, false), complete: xhr => { this._pendingReq = null; } // no pending requests }); }); ; } //#region Filter Implementation // gets the OData filter definition from a wijmo.grid.filter.FlexGridFilter object. // https://www.odata.org/documentation/odata-version-2-0/uri-conventions/ _asODataFilter(filter) { let def = ''; for (let c = 0; c < filter.grid.columns.length; c++) { let col = filter.grid.columns[c], cf = filter.getColumnFilter(col, false); if (cf && cf.isActive) { if (def) { def += ' and '; } if (cf.conditionFilter && cf.conditionFilter.isActive) { def += this._asODataConditionFilter(cf.conditionFilter); } else if (cf.valueFilter && cf.valueFilter.isActive) { def += this._asODataValueFilter(cf.valueFilter); } } } return def; } _asODataValueFilter(vf) { let col = vf.column, fld = col.binding, map = col.dataMap, def = ''; // build condition with 'eq/or' for (let key in vf.showValues) { let value = changeType(key, col.dataType, col.format); if (map && isString(value)) { // TFS 239356 value = map.getKeyValue(value); } if (def) def += ' or '; def += this._asEquals(fld, value, col.dataType); } // enclose in parenthesis if not empty if (def.length) { def = '(' + def + ')'; } // all done return def; } _asEquals(fld, value, type) { let def = '', DT = DataType; if (value === '' || value == null) { // null or empty def += fld + ' eq null'; if (type == DT.String) { // empty OK for strings only def += ' or ' + fld + ' eq \'\''; } } else if (type == DT.Date) { // non-null/empty dates (TFS 458080) def += fld + ' ge ' + this._asODataValue(value, type) + ' and ' + fld + ' lt ' + this._asODataValue(DateTime.addDays(value, 1), type); } else { // other types def += fld + ' eq ' + this._asODataValue(value, type); } return '(' + def + ')'; } _asODataConditionFilter(cf) { let c1 = this._asODataCondition(cf, cf.condition1), c2 = this._asODataCondition(cf, cf.condition2); if (c1 && c2) return '(' + c1 + (cf.and ? ' and ' : ' or ') + c2 + ')'; if (c1) return '(' + c1 + ')'; if (c2) return '(' + c2 + ')'; return null; } _asODataCondition(cf, cnd) { let col = cf.column, fld = col.binding, map = col.dataMap, value = cnd.value; if (map && isString(value)) { // TFS 440901 value = map.getKeyValue(value); } value = this._asODataValue(value, cf.column.dataType); switch (cnd.operator) { case 0: // EQ = 0, return fld + ' eq ' + value; case 1: // NE = 1, return fld + ' ne ' + value; case 2: // GT = 2, return fld + ' gt ' + value; case 3: // GE = 3, return fld + ' ge ' + value; case 4: // LT = 4, return fld + ' lt ' + value; case 5: // LE = 5, return fld + ' le ' + value; case 6: // BW = 6, return `${fld} starts-with ${value}`; case 7: // EW = 7, return `${fld} ends-with ${value}`; case 8: // CT = 8, return `${fld} contains ${value}`; case 9: // NC = 9 return `${fld} not-contains ${value}`; case 10: // NBW = 10 return `${fld} not-starts-with ${value}`; case 11: // NEW = 11 return `${fld} not-ends-with ${value}`; } } _asODataValue(value, dataType) { if (isDate(value)) { value = `'${value.toJSON()}'`; return value; } else if (isString(value)) { return "'" + value.replace(/'/g, "''") + "'"; } else if (isBoolean(value)) { return "'" + value + "'"; } else if (value != null) { return value.toString(); } return dataType == DataType.String ? "''" : null; } }
(function (global) { System.config({ transpiler: 'plugin-babel', babelOptions: { es2015: true }, meta: { '*.css': { loader: 'css' } }, paths: { // paths serve as alias 'npm:': 'node_modules/' }, // map tells the System loader where to look for things map: { 'jszip': 'npm:jszip/dist/jszip.js', '@mescius/wijmo': 'npm:@mescius/wijmo/index.js', '@mescius/wijmo.input': 'npm:@mescius/wijmo.input/index.js', '@mescius/wijmo.styles': 'npm:@mescius/wijmo.styles', '@mescius/wijmo.cultures': 'npm:@mescius/wijmo.cultures', '@mescius/wijmo.chart': 'npm:@mescius/wijmo.chart/index.js', '@mescius/wijmo.chart.analytics': 'npm:@mescius/wijmo.chart.analytics/index.js', '@mescius/wijmo.chart.animation': 'npm:@mescius/wijmo.chart.animation/index.js', '@mescius/wijmo.chart.annotation': 'npm:@mescius/wijmo.chart.annotation/index.js', '@mescius/wijmo.chart.finance': 'npm:@mescius/wijmo.chart.finance/index.js', '@mescius/wijmo.chart.finance.analytics': 'npm:@mescius/wijmo.chart.finance.analytics/index.js', '@mescius/wijmo.chart.hierarchical': 'npm:@mescius/wijmo.chart.hierarchical/index.js', '@mescius/wijmo.chart.interaction': 'npm:@mescius/wijmo.chart.interaction/index.js', '@mescius/wijmo.chart.radar': 'npm:@mescius/wijmo.chart.radar/index.js', '@mescius/wijmo.chart.render': 'npm:@mescius/wijmo.chart.render/index.js', '@mescius/wijmo.chart.webgl': 'npm:@mescius/wijmo.chart.webgl/index.js', '@mescius/wijmo.chart.map': 'npm:@mescius/wijmo.chart.map/index.js', '@mescius/wijmo.gauge': 'npm:@mescius/wijmo.gauge/index.js', '@mescius/wijmo.grid': 'npm:@mescius/wijmo.grid/index.js', '@mescius/wijmo.grid.detail': 'npm:@mescius/wijmo.grid.detail/index.js', '@mescius/wijmo.grid.filter': 'npm:@mescius/wijmo.grid.filter/index.js', '@mescius/wijmo.grid.search': 'npm:@mescius/wijmo.grid.search/index.js', '@mescius/wijmo.grid.style': 'npm:@mescius/wijmo.grid.style/index.js', '@mescius/wijmo.grid.grouppanel': 'npm:@mescius/wijmo.grid.grouppanel/index.js', '@mescius/wijmo.grid.multirow': 'npm:@mescius/wijmo.grid.multirow/index.js', '@mescius/wijmo.grid.transposed': 'npm:@mescius/wijmo.grid.transposed/index.js', '@mescius/wijmo.grid.transposedmultirow': 'npm:@mescius/wijmo.grid.transposedmultirow/index.js', '@mescius/wijmo.grid.pdf': 'npm:@mescius/wijmo.grid.pdf/index.js', '@mescius/wijmo.grid.sheet': 'npm:@mescius/wijmo.grid.sheet/index.js', '@mescius/wijmo.grid.xlsx': 'npm:@mescius/wijmo.grid.xlsx/index.js', '@mescius/wijmo.grid.selector': 'npm:@mescius/wijmo.grid.selector/index.js', '@mescius/wijmo.grid.cellmaker': 'npm:@mescius/wijmo.grid.cellmaker/index.js', '@mescius/wijmo.nav': 'npm:@mescius/wijmo.nav/index.js', '@mescius/wijmo.odata': 'npm:@mescius/wijmo.odata/index.js', '@mescius/wijmo.olap': 'npm:@mescius/wijmo.olap/index.js', '@mescius/wijmo.rest': 'npm:@mescius/wijmo.rest/index.js', '@mescius/wijmo.pdf': 'npm:@mescius/wijmo.pdf/index.js', '@mescius/wijmo.pdf.security': 'npm:@mescius/wijmo.pdf.security/index.js', '@mescius/wijmo.viewer': 'npm:@mescius/wijmo.viewer/index.js', '@mescius/wijmo.xlsx': 'npm:@mescius/wijmo.xlsx/index.js', '@mescius/wijmo.undo': 'npm:@mescius/wijmo.undo/index.js', '@mescius/wijmo.interop.grid': 'npm:@mescius/wijmo.interop.grid/index.js', '@mescius/wijmo.touch': 'npm:@mescius/wijmo.touch/index.js', '@mescius/wijmo.cloud': 'npm:@mescius/wijmo.cloud/index.js', '@mescius/wijmo.barcode': 'npm:@mescius/wijmo.barcode/index.js', '@mescius/wijmo.barcode.common': 'npm:@mescius/wijmo.barcode.common/index.js', '@mescius/wijmo.barcode.composite': 'npm:@mescius/wijmo.barcode.composite/index.js', '@mescius/wijmo.barcode.specialized': 'npm:@mescius/wijmo.barcode.specialized/index.js', 'jszip': 'npm:jszip/dist/jszip.js', 'bootstrap.css': 'npm:bootstrap/dist/css/bootstrap.min.css', 'css': 'npm:systemjs-plugin-css/css.js', 'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js', 'systemjs-babel-build':'npm:systemjs-plugin-babel/systemjs-babel-browser.js' }, // packages tells the System loader how to load when no filename and/or no extension packages: { src: { defaultExtension: 'js' }, "node_modules": { defaultExtension: 'js' }, } }); })(this);