https://github.com/tomayac/ldf-client
Polymer Linked Data Fragments client
https://github.com/tomayac/ldf-client
Last synced: 3 months ago
JSON representation
Polymer Linked Data Fragments client
- Host: GitHub
- URL: https://github.com/tomayac/ldf-client
- Owner: tomayac
- License: apache-2.0
- Created: 2014-11-20T20:30:00.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2016-07-31T15:13:23.000Z (over 9 years ago)
- Last Synced: 2025-03-27T22:17:30.306Z (8 months ago)
- Language: HTML
- Homepage:
- Size: 2.65 MB
- Stars: 18
- Watchers: 9
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-semantic-web - tomayac/ldf-client - Polymer Linked Data Fragments client. (Linked Data Fragments / SPARQL Applications)
- awesome-semantic-web - tomayac/ldf-client - Polymer Linked Data Fragments client. (Linked Data Fragments / SPARQL Applications)
README
<ldf-client>
==========================
A declarative [Linked Data Fragments](http://linkeddatafragments.org) client in the form of a [Web Component](http://webcomponents.org/).
Simply insert the `````` in your page, fill in the required attribute values,
and you are ready to go.
Live Demo
=========
You can see a [live demo](http://tomayac.github.io/ldf-client/)
of the Web Component in action hosted on GitHub pages.
Installation
============
This assumes that you have [bower](http://bower.io/) and
[polyserve](https://github.com/PolymerLabs/polyserve) installed.
```sh
$ mkdir web-components
$ cd web-components
$ git clone git@github.com:tomayac/ldf-client.git
$ cd ldf-client
$ bower install
$ polyserve
```
Finally visit [http://localhost:8080/components/ldf-client/](http://localhost:8080/components/ldf-client/)
and click the [demo](http://localhost:8080/components/ldf-client/demo/) link in the upper right corner.
Basic Usage
===========
The example below shows basic usage instructions for the element.
```html
Poll
document.addEventListener('polymer-ready', function() {
/* Streaming example */
var ldfClientStreaming = document.querySelector('#ldf-client-streaming');
// Process data as it appears
ldfClientStreaming.addEventListener('ldf-query-streaming-response-partial',
function(e) {
var pre = document.createElement('pre');
pre.textContent = JSON.stringify(e.detail.response);
document.body.appendChild(pre);
});
// Get notified once all data is received
ldfClientStreaming.addEventListener('ldf-query-streaming-response-end', function() {
alert('Received all data');
});
/* Polling example */
var ldfClientPolling = document.querySelector('#ldf-client-polling');
// Poll for data
ldfClientPolling.addEventListener('ldf-query-polling-response', function(e) {
var pre = document.createElement('pre');
pre.textContent = JSON.stringify(e.detail.response);
document.body.appendChild(pre);
});
// Manually trigger polling
var button = document.querySelector('#button');
button.addEventListener('click', function() {
ldfClientPolling.showNext();
});
});
```
About Linked Data Fragments
===========================
The Web is full of high-quality Linked Data,
but we can't reliably query it.
Public SPARQL endpoints are often unavailable,
because they need to answer many unique queries.
One could set up a local endpoint using data dumps,
but that's not Web querying and
the data is never up-to-date.
[Linked Data Fragments](http://linkeddatafragments.org/) offer interfaces to
solve queries at the client side with server data.
Servers can offer data at low processing cost
in a way that enables client-side querying.
You can read more about [the concept of Linked Data Fragments](http://linkeddatafragments.org/concept/)
and learn about available [Linked Data Fragments software](http://linkeddatafragments.org/software/).
Acknowledgements
================
Building this Web Component was pretty straight-forward thanks to
[Ruben Verborgh](http://ruben.verborgh.org/)'s
Linked Data Fragments browser client
[Browser.js](https://github.com/LinkedDataFragments/Browser.js).
License
=======
Copyright 2015 Thomas Steiner (tomac@google.com)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.