diff --git a/jsonschema-hyperschema.xml b/jsonschema-hyperschema.xml index 62c3c152..2d6edfac 100644 --- a/jsonschema-hyperschema.xml +++ b/jsonschema-hyperschema.xml @@ -360,7 +360,7 @@ sub-instance that validated against the schema containing the LDO. - "hrefPointers" allows adjusting + "templatePointers" allows adjusting the location from which instance data is resolved on a per-variable basis. @@ -550,18 +550,18 @@ express a requirement for those variables that can be supplied via input, some variables must be resolved from instance data. When that instance data is not required by the context schema, the - "hrefRequired keyword may be used to - indicate that when the instance data is not available, the link does - not apply. + "templateRequired keyword may + be used to indicate that when the instance data is not available, the + link does not apply. -
+
- The value of the "hrefPointers" link description property MUST be + The value of the "templatePointers" link description property MUST be an object. Each property value in the object MUST be a valid JSON Pointer, or a valid Relative JSON Pointer @@ -596,18 +596,18 @@ { "rel": "self", "href": "/trees/{rootId}/nodes/{id}", - "hrefPointers": { + "templatePointers": { "rootId": "/id" } }, { "rel": "up", "href": "/trees/{rootId}/nodes/{parentId}", - "hrefPointers": { + "templatePointers": { "rootId": "/id", "parentId": "2/id" }, - "hrefRequired": ["parentId"] + "templateRequired": ["parentId"] } ] }]]> @@ -615,7 +615,7 @@ In "self" link, the context node's id resolves with the standard process and - therefore does not appear in "hrefPointers". In both "self" and "up" links, + therefore does not appear in "templatePointers". In both "self" and "up" links, the root id is located using an absolute JSON Pointer. Finally, in "up" link, the parent node uses a Relative JSON Pointer, going up two levels (one level up is the array of children, two levels up is the whole parent node), and then @@ -659,7 +659,7 @@ For the root node, the relative pointer for the parent doesn't point - to anything, so "hrefRequired" + to anything, so "templateRequired" prevents the link from being used with that node.
@@ -755,7 +755,7 @@
-
+
The value of this keyword MUST be an array, and the elements MUST be unique. Each element SHOULD match a variable in the link's URI Template, without @@ -766,21 +766,21 @@
Here is a simplified version of the "up" link from the - "hrefPointers tree example, + "templatePointers tree example, modified to only use the parent identifier for its "href" template. While each individual node is required to have an "id" field, the "up" link uses the parent node's field, and the root node, by definition, - does not have a parent node. Putting "parentId" in "hrefRequired" ensures - that the "up" link is correctly unusable with the root node. + does not have a parent node. Putting "parentId" in "templateRequired" + ensures that the "up" link is correctly unusable with the root node.
diff --git a/links.json b/links.json index f1f32d93..26dbfefb 100644 --- a/links.json +++ b/links.json @@ -9,7 +9,7 @@ "type": "string", "format": "uri-template" }, - "hrefPointers": { + "templatePointers": { "type": "object", "additionalProperties": { "type": "string", @@ -24,7 +24,7 @@ { "$ref": "http://json-schema.org/draft-06/hyper-schema#" } ] }, - "hrefRequired": { + "templateRequired": { "type": "array", "items": { "type": "string"