A connector proxying sparql over HTTP to the gRPC federated graph of an IOTICS network.

Build with

mvn clean package

java -jar iotics-sparql-http-<version>.jar

The following variables are either read from the environment or via program arguments. Environment values will always be preferred if not null.

Example:

java -jar iotics-sparql-http-<version>.jar HOST_DNS=myhost.iotics.space PORT=80

To run the integration tests(manually, from within the IDE), you need to create an .env file with the following content

PORT=<the port where the HTTP endpoint is listening>
HOST_DNS=<the host DNS where to forward the gRPC requests>
RESOLVER_URL=<the resolver used to manage identities (find it at https://{HOST_DNS}/index.json)>
SEED=<a valid identity seed>

The proxy should implement most of https://www.w3.org/TR/sparql11-protocol/ for SELECT.

The following endpoints are supported for GET and POST

Authorization: Bearer <token>
Accept: application/sparql-results+json

for an unencoded body

Content-Type: application/sparql-query

for a form encoded query in the body

Content-Type: application/x-www-form-urlencoded

X-IOTICS-HOST: <host DNS>

Assuming the proxy is deployed on localhost:8080

GET /sparql/local?query=<urlencoded query> HTTP/1.1
Host: localhost
Accept: application/sparql-results+json
Authorization: Bearer eyJhbG...sjc4Q_Q

POST /sparql/local HTTP/1.1
Host: localhost
Accept: application/sparql-results+json
Authorization: Bearer eyJhbG...sjc4Q_Q
Content-Type: application/sparql-query

<query>

• No support for default-graph-uriand named-graph-uri
• No support for CORS and OPTION (pre-flight requests)