使用HAL词汇与JSON-LD

时间:2014-06-26 01:48:10

标签: rest rdf hateoas json-ld hal-json

我想知道,有没有办法在JSON-LD中使用HAL概念?

我有当前的jsonld文档:

{
    "@context": {
        "hal": "http://stateless.co/hal#",
        "schema": "http://schema.org",
        "_links": {
            "@id": "hal:link",
            "@container": "@index"
        }
    },
    "@type": ["schema:Person", "hal:Resource"],
    "name": "Jon Snow",
    "_links": {
        "self": {
            "href": "/users/123"
        }
    }
}

但我不确定如何定义href @type @id,等等......

有没有办法根据RDF(S)定义HAL词汇并以某种方式将其导入我的jsonld文档的@context中,或者我应该做些什么呢?
(我试图描述具有各种属性的超链接,如链接关系,HTTP方法,接受的媒体类型,语言,IRI模板,输入字段等等......所以@id类型对我来说还不够描述链接。)

2 个答案:

答案 0 :(得分:8)

正如Tomasz已经建议的那样,你应该考虑使用Hydra,因为它或多或少都是你想要的。您在问题中包含的示例使用Hydra和JSON-LD看起来有点像这样:

{
    "@context": {
        "schema": "http://schema.org",
        "ex": "http://example.com/myvocab#"
    },
    "@id": "/users/123",
    "@type": [ "schema:Person", "hydra:Resource" ],
    "name": "Jon Snow",
    "ex:link": { "@id": "/another-resource" }        
}

由于不需要“自我”链接(@id已明确指定),我添加了另一个链接ex:link。因此,它的链接关系为http://example.com/myvocab#link,其“href”为/another-resource。如果您需要更详细地描述该链接/属性,您可以通过创建一个文档来完成此操作,该文档的描述方式与描述其他内容的方式完全相同(如Tomasz也已解释过):

{
    "@context": {
        "ex": "http://example.com/myvocab#",
        "hydra": "http://www.w3.org/ns/hydra#"
    },
    "@id": "ex:link",
    "@type": "hydra:Link",
    "hydra:title": "My new link relation",
    "hydra:supportedOperation": [
       {
         "@type": "hydra:Operation",
         "hydra:method": "POST",
         "hydra:expects": ....
       }
    ]       
}

关于你的评论

  

顺便说一下。我或多或少熟悉Hydra词汇,但我不喜欢   将资源映射到服务器上的实际类和对象的想法   边语并自动转换操作参数   进入那些对象。也许有可能使用Hydra词汇   另一种方式,但我没有时间去尝试。

Hydra真的只是一个词汇。由您决定如何使用它。我想你在谈论上面的HydraBundle。这只是使用它的一种方式。这只是一个概念证明,表明它很容易实现。所以请不要对此感到困惑。

我想邀请你join the Hydra W3C Community Group。然后我们可以在邮件列表中更详细地讨论这个问题。

免责声明:我是Hydra的创始人,也是Hydra W3C社区团体的主席。

答案 1 :(得分:2)

我想你可能对Hydra感兴趣。你试过了吗?

它是描述超媒体链接和操作的词汇表。以下是它如何适用于简单的父链接

{
  "@context": {
    "schema": "http://schema.org",
    "parent": { 
       "@id": "/vocab#parent"
       "@type": "@id"
    }
  },
  "@id": "/users/123",
  "@type": "schema:Person",
  "name": "Jon Snow",
  "parent": "/users/Ned_Stark" 
}

请注意,您不需要在表示中包含域外的任何数据。相反,您描述了父谓词的含义

{
  "@context": "http://www.w3.org/ns/hydra/context.jsonld",
  "@id": "/vocab#parent",
  "@type": "hydra:Link"
}

您还可以描述类的操作(HTTP方法,范围,域等)和属性。此外,操作可以直接包含在表示中,也可以附加到类和proeprties上。