Enhancement of 'ref' mechanism

[ahitacat]

Following the previous work done in #214 and #210 we lack the sub-resource reference.

Current problem

If one has define a class with a reference to another service

// In /aro_hcp/v1_alpha1/cluster_type.model
@ref(path = "/clusters_mgmt/v1/cluster")
class Cluster {
}

Which points to this definition

// In /cluster_mgmt/v1/cluster_type.model
@ref(path = "/clusters_mgmt/v1/cluster")
class Cluster {
    link NodePools []NodePool
}

And then want to override the type NodePool so it is also part of aro_hcp.

// In /aro_hcp/v1_alpha1/cluster_type.model
@ref(path = "/clusters_mgmt/v1/node_pool")
class NodePool {
}

With the current approach this reference class (node_pools) will be pointing to the cluster_mgmt/ instead of aro_hcp/. We wanted to preserve this links except if it was explicit defined. As this example shown that was not the case.

Proposed solution

The types will had a new field, ExplicitDeclared. When a type is referenced as the NodePool shown in the example, this will be set to true. And it will go through the read tree to remove the references from the service where the resource is define and change them to the service that is reading the definition.

Additionally, when generating the rest of the reference tree it will look for ExplicitDeclared types and will change its ownership so it is the same as the version the reader is building.

[nimrodshn]

LGTM 💯