Model Package: Resource related classes in SDCM

[wznira]

In SDCM REST Extension, we had a class structure as shown in the diagram below -

I believe we should have similar relationships between Resource, Representation, Payload and Data Classes -

• Resources are the basic building block of a RESTful service. For example, a flight plan or a feature in Web Feature Service that presents a real world thing such as an airport. A resource is identified by a URI.
• Representation is a machine readable document about that resource that is carried by web services, for example, an XML document of feature data that has the encoding of en/us.
• A Representation is carried in a Payload. However, for a service like Web Feature Service, a response may carry multiple features. Each feature is a representation of some resource. For example, NCR may return aeronautical information and weather information in a single response.
• A Representation can be considered a special case of data. For example, a representation of flight plan may follow the FIXM standard, such can be used to describe any payload data. In that case, we can make Representation a subclass of Data.

Diagram below may be applicable -

[diogoroman]

I agree partially with @wznira. The only difference is that I think a Representation would be a Payload specialization. Even the Representation being composed by many features, as you sad @wznira, it'd be considered only one representation of a data body that could be composed by many "data entity". Talking about the example you sad, I believe the Payload (Representation) would carry a complex data object with Aeronautical and Weather information.

The diagram with this change: