Tutorial 10: Complex Data-Types

Next, we will introduce complex data-types available since SpecIF v1.2.

A complex data-type consists of a sequence of simple or complex data-types. A sequence is a list where the position of elements matters. Thus, complex data-types can be nested, but any cyclic dependency is prohibited: In other words, the resulting data-type may have multiple layers and must be a tree. In addition, a value assigned to a property with complex data-type must have a list of values corresponding to the sequence of its data-type.

Have a look at the following example:

  • The sequence contains three elements with a title and a pointer to a dataType.
{
  "dataTypes": [{
    "id": "DT-Coordinate",
    "title": "A coordinate as a real number.",
    "type": "xs:double",
    "revision": "1.2",
    "changedAt": "2024-11-21T10:08:31.960Z"
  },{
    "id": "DT-GeoPoint",
    "title": "geo:Point",
    "type": "xs:complexType",
    "description": [{
      "text": "A point in space, specified by three coordinates.",
      "language": "en"
    },{
      "text": "Ein Punkt im Raum, spezifiziert durch drei Koordinaten.",
      "language": "de"
    }],
    "sequence": [{
      "title": "X",
      "dataType": { "id": "DT-Coordinate" }
    },{
      "title": "Y",
      "dataType": { "id": "DT-Coordinate" }
    },{
      "title": "Z",
      "dataType": { "id": "DT-Coordinate" }
    }],
    "revision": "1.2",
    "changedAt": "2024-11-21T10:08:31.960Z"
  }]
}

The referencing propertyClass and resourceClass is similar to others discussed in the previous tutorials:

{
  "propertyClasses": [{
    "id": "PC-GeoPoint",
    "title": "geo:Point",
    "description": [{
        "text": "A point in space, specified by three coordinates.",
        "language": "en"
    },{
        "text": "Ein Punkt im Raum, spezifiziert durch drei Koordinaten.",
        "language": "de"
    }],
    "dataType": { "id": "DT-GeoPoint" },
    "multiple": false,
    "revision": "1.2",
    "changedAt": "2024-11-21T10:08:31.960Z"
  }],
  "resourceClasses": [{
    "id": "RC-94e50d5023b1a80157",
    "title": "geo:Point",
    "propertyClasses": [
      {
        "id": "PC-Name"
      },{
        "id": "PC-GeoPoint"
      }
    ],
    "changedAt": "2024-11-21T10:08:31.960Z"
  }],
}

A resource’s or statement’s property value is given as follows:

  • An element in the values list is a list with values corresponding to the dataType’s sequence; thus a property can have multiple values (provided that ‘multiple’ is set to ‘true’ in the propertyClass), where each value is a list with values according to its complexType.
  • The position within the list determines by which element in the dataType’s sequence it is defined.
  • Here, the elements of the value list are simple data-types, more concretely real numbers. In general, values of any SpecIF dataType are allowed, e.g. multi-language texts, pointers to enumerated values of the dataType or the values of a nested complex data-type.
{
  "resources": [{
    "id": "R-d5b902394e50",
    "class": "RC-94e50d5023b1a80157",
    "properties": [{
      "class": { "id": "PC-Name" },
      "values": [
        [{ "text": "A point in space" }]
      ]
    },{
      "class": "PC-GeoPoint",
      "values": [
        [ "1.2",  "2.3", "4.0" ]
      ]
    }]
    "changedAt": "2024-11-21T10:08:31.960Z"
  }]
}

Recap: As always, properties is a list of one or more values, if the corresponding propertyClass allows it. The complex value is a list with SpecIF values corresponding to their respective dataType. The example shows simple real numbers, but it could be pointers to enumerated values or multi-language texts. Complex dataTypes may be nested, but without cyclic dependencies: A complex dataType must be a tree.

You may