Feature Suggestion: Using JSON-LD for Gizmo results

[iddan]

Description
Currently, Gizmo returns JSONs of strings which may or may not be valid n3 values. This is a non-standard behaviour that is hard to integrate with other systems.

Examples
Results of IRIs:

{ "@id": "bob" }

Results of literals:

"Bob"

Results of literals with language:

{ "@language": "en", "@value": "Bob" }

Results of literals with type:

{
    "@value": "2010-05-29T14:17:39+02:00",
    "@type": "http://www.w3.org/2001/XMLSchema#dateTime"
}

All together

{
   "id": { "@id": "bob" },
   "name": "Bob",
   "englishName": { "@value": "Bob", "@language": "en" },
   "timeCreated": {
      "@value": "2010-05-29T14:17:39+02:00",
      "@type": "http://www.w3.org/2001/XMLSchema#dateTime"
   }
}

Future Proposals

• It might be better to change id default property

[dennwc]

Totally agree on this! Also, don't forget TypedString, it's probably { "@value": "xxx", "@type": "yyy" }.

[iddan]

Updated the description

[dennwc]

Also, in "future proposals", do you mean changing id to @id? Sounds like a good idea.

The change mentioned above will break things already, so it will be HTTP API v2, and we can easily change the default id tag as well.

[iddan]

Yeah, it will look like that:

{
  "@id": "bob",
  "name": "Bob",
  "englishName": { "@value": "Bob", "@language": "en" },
  "timeCreated": {
    "@value": "2010-05-29T14:17:39+02:00",
    "@type": "http://www.w3.org/2001/XMLSchema#dateTime"
  }
}

[iddan]

Later, we can streamline the format in GraphQL as well as done in: https://github.com/rubensworks/GraphQL-LD.js

[iddan]

Took a deeper look into Gremlin. It seems like you need to be explicit about the return type you get there.
To get nodes:

g.V()

To get values:

g.V(1).values('name')

To get tags

g.V().as('a').out().as('b').out().as('c').select('a','b','c')

Which I find more explicit and simple.

With JSON-LD the results will be:

{ "@id": "bob" }

"Bob"

{ "a": { "@id": "bob" }, "b": { "@id": "alice" }, "c": { "@id": "steve" } }

[iddan]

Here is a basic implementation: #821

[iddan]

@dennwc what do you think about the previous comment?

[dennwc]

@iddan It's definitely a nicer way for selecting results. May also help the optimizer to some extent.

[iddan]

Merged #821