Adaptors in EJ2 JavaScript Data control
2 Dec 202324 minutes to read
Each data source or remote service uses different way in accepting request and sending back the response. DataManager cannot anticipate every way a data source works. To tackle this problem the DataManager uses the adaptor concept to communicate with particular data source.
For local data sources, the role of the data adaptor is to query the JavaScript object array based on the Query object and manipulate them.
When comes with remote datasource, the data adaptor is used to send the request that the server can understand and process the server response.
The adaptor can be assigned using the adaptor
property of the DataManager.
Json adaptor
JsonAdaptor
is used to query and manipulate JavaScript object array.
var template = '<tr><td>${OrderID}</td><td>${CustomerID}</td><td>${EmployeeID}</td></tr>';
var compiledFunction = ej.base.compile(template);
var result = new ej.data.DataManager(data).executeLocal(new ej.data.Query().take(8));
var table = (document.getElementById('datatable'));
result.forEach((data) => {
table.appendChild(compiledFunction(data)[0]);
});
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Grid</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript Grid Control">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-grids/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-navigations/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-dropdowns/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-lists/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-inputs/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-calendars/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/27.1.48/dist/ej2.min.js" type="text/javascript"></script>
<script src="es5-datasource.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="Grid"></div>
<table id="datatable" class="e-table">
<thead>
<tr><th>Order ID</th><th>Customer ID</th><th>Employee ID</th></tr>
</thead>
<tbody>
</tbody>
</table>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Url adaptor
UrlAdaptor
act as the base adaptor for interacting with remote data services. Most of the built-in adaptors are derived from the UrlAdaptor
.
import { DataManager, Query, UrlAdaptor } from '@syncfusion/ej2-data';
const SERVICE_URI: string = 'https://services.syncfusion.com/js/production/api/UrlDataSource';
new DataManager({
url: SERVICE_URI,
adaptor: new UrlAdaptor
}).executeQuery(new Query().take(8)).then((e) => {
//e.result will contain the records
});
UrlAdaptor
expects response as a JSON object with properties result
and count
which
contains the collection of entities and the total number of records respectively.
The sample response object should be as follows,
{
"result": [{..}, {..}, {..}, ...],
"count": 67
}
OData adaptor
OData is standardized protocol for creating and consuming data. You can retrieve data from OData service using DataManager. The ODataAdaptor
helps you to interact with OData service. You can refer to the following code example of remote Data binding using OData service.
var template = '<tr><td>${OrderID}</td><td>${CustomerID}</td><td>${EmployeeID}</td></tr>'
var compiledFunction = ej.base.compile(template);
const SERVICE_URI = 'https://services.odata.org/V3/Northwind/Northwind.svc/Orders/';
var table = (document.getElementById('datatable'));
new ej.data.DataManager({ url: SERVICE_URI, adaptor: new ej.data.ODataAdaptor })
.executeQuery(new ej.data.Query().take(8))
.then((e) => {
(e.result.items).forEach((data) => {
table.appendChild(compiledFunction(data)[0]);
});
});
<!DOCTYPE html>
<html lang="en">
<head>
<title>EJ2 Grid</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript Grid Control">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-grids/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-navigations/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-dropdowns/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-lists/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-inputs/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-calendars/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/27.1.48/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="Grid"></div>
<table id="datatable" class="e-table">
<thead>
<tr>
<th>Order ID</th>
<th>Customer ID</th>
<th>Employee ID</th>
</tr>
</thead>
<tbody>
</tbody>
</table>
</div>
<script>
var ele = document.getElementById('container');
if (ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body>
</html>
By default,
ODataAdaptor
is used by DataManager.
ODataV4 adaptor
The ODataV4 is an improved version of OData protocols and the DataManager can also retrieve and consume OData v4 services. For more details on OData v4 Services, refer the odata documentation. You can use the ODataV4Adaptor
to interact with ODataV4 service.
var template = '<tr><td>${OrderID}</td><td>${CustomerID}</td><td>${EmployeeID}</td></tr>'
var compiledFunction = ej.base.compile(template);
const SERVICE_URI = 'https://services.odata.org/V4/Northwind/Northwind.svc/Orders/';
var table = (document.getElementById('datatable'));
new ej.data.DataManager({ url: SERVICE_URI, adaptor: new ej.data.ODataV4Adaptor })
.executeQuery(new ej.data.Query().take(8))
.then((e) => {
(e.result).forEach((data) => {
table.appendChild(compiledFunction(data)[0]);
});
});
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Grid</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript Grid Control">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-grids/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-navigations/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-dropdowns/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-lists/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-inputs/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-calendars/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/27.1.48/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="Grid"></div>
<table id="datatable" class="e-table">
<thead>
<tr><th>Order ID</th><th>Customer ID</th><th>Employee ID</th></tr>
</thead>
<tbody>
</tbody>
</table>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Web API adaptor
You can use the WepApiAdaptor
to interact with Web API created with OData endpoint. The WebApiAdaptor
is extended from the ODataAdaptor
. Hence to use WebApiAdaptor
, the endpoint should understand the OData formatted queries send along with request.
To enable OData query option for Web API, please refer to the documentation
import { DataManager, Query, WebApiAdaptor } from '@syncfusion/ej2-data';
const SERVICE_URI: string = 'https://services.syncfusion.com/js/production/api/Orders';
new DataManager({
url: SERVICE_URI,
adaptor: new WebApiAdaptor
}).executeQuery(new Query().take(8)).then((e) => {
//e.result will contain the records
});
WebApiAdaptor
expects JSON response from the server and the response object should contain properties Items
and Count
whose values are collection of entities and total count of the entities respectively.
The sample response object should look like below.
{
Items: [{..}, {..}, {..}, ...],
Count: 830
}
WebMethod Adaptor
The WebMethodAdaptor
is used to bind data source from remote services and code behind methods. It can be enabled in Grid using Adaptor property of DataManager as WebMethodAdaptor
.
For every operations, an Fetch post will be send to the specified data service.
import { DataManager, Query, WebMethodAdaptor } from '@syncfusion/ej2-data';
let SERVICE_URI = 'Default.aspx/DataSource';
new DataManager({
url: SERVICE_URI,
adaptor: new WebMethodAdaptor
}).executeQuery(new Query().take(8)).then((e) => {
//e.result will contain the records
});
WebMethodAdaptor
expects JSON response from the server and the response object should contain properties result
and count
whose values are collection of entities and total count of the entities respectively.
The sample response object should look like below.
{
result: [{..}, {..}, {..}, ...],
count: 830
}
The controller method’s data parameter name must be
value
.
Custom Data Adaptor
The CustomDataAdaptor
provides an option to send your own request to handle the data operations.
You can get the current action details inside the getData
method of CustomDataAdaptor
to build the request. Once the data is fetched from the service successfully, then the onSuccess
method can be invoked to handle the further data processing. In failure case, invoke the onFailure
method.
import { DataManager, Query, CustomDataAdaptor, FetchOption } from '@syncfusion/ej2-data';
const SERVICE_URI: string = 'http://controller.com/actions';
new DataManager({
adaptor: new CustomDataAdaptor({
getData: function (option: FetchOption) {
let request: object;
fetch(SERVICE_URI, {
method: 'POST',
headers: {
'Content-Type': 'application/json; charset=utf-8',
},
}).then((response) => {
request = extend({}, option, { httpRequest: response });
if (response.status >= 200 && response.status <= 299) {
return response.json();
}
}).then((data) => {
option.onSuccess(data, request);
}).catch((error) => {
option.onFailure(request);
});
},
}),
}).executeQuery(new Query().take(8)).then((e) => {
//e.result will contain the records
});
Since the CustomDataAdaptor
is extended from the UrlAdaptor
, it expects response as a JSON object with properties result
and count
which
contains the collection of entities and the total number of records respectively.
The sample response object should be as follows,
{
"result": [{..}, {..}, {..}, ...],
"count": 67
}
Performing CRUD action with CustomDataAdaptor
You can perform the CRUD actions using the addRecord
, updateRecord
, deleteRecord
and batchUpdate
methods.
import { DataManager, Query, CustomDataAdaptor, FetchOption } from '@syncfusion/ej2-data';
let createRequest: Function = (url: string, option: FetchOption) => {
let request: object;
fetch(SERVICE_URI, {
method: 'POST',
headers: {
'Content-Type': 'application/json; charset=utf-8',
},
}).then((response) => {
request = extend({}, option, { httpRequest: response });
if (response.status >= 200 && response.status <= 299) {
return response.json();
}
}).then((data) => {
option.onSuccess(data, request);
}).catch((error) => {
option.onFailure(request);
});
}
let baseUrl: string = "http://localhost:65327/Home/";
new DataManager({
adaptor: new CustomDataAdaptor({
getData: function (option: FetchOption) {
createRequest(baseUrl + 'UrlDatasource', option);
},
addRecord: function (option: FetchOption) {
createRequest(baseUrl + 'Insert', option);
},
updateRecord: function (option: FetchOption) {
createRequest(baseUrl + 'Update', option);
},
deleteRecord: function (option: FetchOption) {
createRequest(baseUrl + 'Delete', option);
}
// to handle Batch operation
//batchUpdate: function (option: FetchOption) {
// createRequest(baseUrl + 'Delete', option);
//}
})
}).executeQuery(new Query().take(8)).then((e) => {
//e.result will contain the records
});
GraphQL Adaptor
The GraphQLAdaptor
provides an option to retrieve data from the GraphQL server. It performs CRUD and data operations such as paging, sorting, filtering etc by sending the required arguments to the server.
You can provide the GraphQL query string by using the query
property of the GraphQLAdaptor
. Since, the GraphQLAdaptor
is extended from the UrlAdaptor
, it expects response as a JSON object with properties result
and count
which contains the collection of entities and the total number of records respectively. The GraphQL response should be returned in JSON format like { “data”: { … }} with query name as field, you need to set the result
and count
properties to map the response.
import { DataManager, Query, GraphQLAdaptor } from '@syncfusion/ej2-data';
const SERVICE_URI: string = 'http://controller.com/actions';
new DataManager({
url: SERVICE_URI, adaptor: new GraphQLAdaptor({
response: {
result: 'getOrders.OrderData',
count: 'getOrders.OrderCount'
},
query: `query getOrders($datamanager: String) {
getOrders(datamanager: $datamanager) {
OrderCount,
OrderData{OrderID, CustomerID, EmployeeID, ShipCity, ShipCountry}
}
}`
})
}).executeQuery(new Query().take(8)).then((e) => {
//e.result will contain the records
});
The Schema for the GraphQL server is
input OrderInput {
OrderID: Int!
CustomerID: String!
EmployeeID: Int!
ShipCity: String!
ShipCountry: String!
}
type Order {
OrderID: Int!
CustomerID: String!
EmployeeID: Int!
ShipCity: String!
ShipCountry: String!
}
type ReturnType {
getOrders: [Order]
count: Int
}
type Query {
getOrders(datamanager: String): ReturnType
}
type Mutation {
createOrder(value: OrderInput): Order!
updateOrder(key: Int!, keyColumn: String, value: OrderInput): Order
deleteOrder(key: Int!, keyColumn: String, value: OrderInput): Order!
}
The resolver for the corresponding action is
import { data } from "./db";
const resolvers = {
Query: {
getOrders: (parent, { datamanager }, context, info) => {
if (datamanager.search) {
// Perform searching
}
if (datamanager.sorted) {
// Perform sorting
}
if (datamanager.where) {
// Perform filtering
}
if (datamanager.search) {
// Perform search
}
if (datamanager.skip && datamanager.take) {
// Perform Paging
}
return { OrderData: data, OrderCount: data.length };
}
},
Mutation: {
createOrder: (parent, { value }, context, info) => {
// Perform Insert
return value;
},
updateOrder: (parent, { key, keyColumn, value }, context, info) => {
// Perform Update
return value;
},
deleteOrder: (parent, { key, keyColumn, value }, context, info) => {
// Perform Delete
return value;
},
}
};
export default resolvers;
The query parameters will be send in a string format which contains the below details.
Parameters | Description |
---|---|
RequiresCounts |
If it is true then the total count of records will be included in response. |
Skip |
Holds the number of records to skip. |
Take |
Holds the number of records to take. |
Sorted |
Contains details about current sorted column and its direction. |
Where |
Contains details about current filter column name and its constraints. |
Group |
Contains details about current Grouped column names. |
Performing CRUD action with GraphQLAdaptor
You can perform the CRUD actions by returning the mutation queries inside the getMutation
method based on the action.
import { DataManager, Query, GraphQLAdaptor } from '@syncfusion/ej2-data';
const SERVICE_URI: string = 'http://controller.com/actions';
new DataManager({
url: SERVICE_URI, adaptor: new GraphQLAdaptor({
response: {
result: 'getOrders.getOrders',
count: 'getOrders.count'
},
query: `query getOrders($datamanager: String) {
getOrders(datamanager: $datamanager) {
count,
getOrders{OrderID, CustomerID, EmployeeID, ShipCity, ShipCountry}
}
}`,
getMutation: function (action): string {
if (action === 'insert') {
return `mutation CreateOrderMutation($value: OrderInput!){
createOrder(value: $value){
OrderID, CustomerID, EmployeeID, ShipCity, ShipCountry
}}`;
}
if (action === 'update') {
return `mutation Update($key: ID!, $keyColumn: String,$value: OrderInput){
updateOrder(key: $key, keyColumn: $keyColumn, value: $value) {
OrderID, CustomerID, EmployeeID, ShipCity, ShipCountry
}
}`;
} else {
return `mutation Remove($key: ID!, $keyColumn: String, $value: OrderInput){
deleteOrder(key: $key, keyColumn: $keyColumn, value: $value) {
OrderID, CustomerID, EmployeeID, ShipCity, ShipCountry
}
}`;
}
}
})
}).executeQuery(new Query().take(8)).then((e) => {
//e.result will contain the records
});
Writing custom adaptor
Sometimes the built-in adaptors does not meet your requirement. In such cases you can create your own adaptor.
To create and use custom adaptor, please refer to the below steps.
- Select an built-in adaptor which will act as base class for your custom adaptor.
- Override the desired method to achieve your requirement.
- Assign the custom adaptor to the
adaptor
property of DataManager.
For the sake of demonstrating custom adaptor approach, we are going to see how to add serial number for the records by overriding the built-in response processing using processResponse
method of the ODataV4Adaptor
.
var template = '<tr><td>${Sno}</td><td>${CustomerID}</td><td>${EmployeeID}</td></tr>';
var compiledFunction = ej.base.compile(template);
class SerialNoAdaptor extends ej.data.ODataV4Adaptor {
processResponse() {
let i = 0;
// calling the base class processResponse function
let original = super.processResponse.apply(this, arguments);
// Adding serial number
original.forEach((item) => item['Sno'] = ++i);
return original;
}
}
const SERVICE_URI = 'https://services.odata.org/V4/Northwind/Northwind.svc/Orders/';
var table = document.getElementById('datatable');
new ej.data.DataManager({ url: SERVICE_URI, adaptor: new SerialNoAdaptor() })
.executeQuery(new ej.data.Query().take(8))
.then((e) => {
(e.result).forEach((data) => {
table.appendChild(compiledFunction(data)[0]);
});
});
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Grid</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript Grid Control">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-grids/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-navigations/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-dropdowns/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-lists/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-inputs/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-calendars/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/27.1.48/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/27.1.48/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="Grid"></div>
<table id="datatable" class="e-table">
<thead>
<tr><th>Order ID</th><th>Customer ID</th><th>Employee ID</th></tr>
</thead>
<tbody>
</tbody>
</table>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>