Skip to content

Class BackendForFrontendRestDocumentRuntimeDescriptor

Namespace: Cephalon.Abstractions.Transports
Assembly: Cephalon.Abstractions.dll

Describes one backend-for-frontend REST documentation surface materialized for one scope and one published OpenAPI document.

public sealed class BackendForFrontendRestDocumentRuntimeDescriptor

objectBackendForFrontendRestDocumentRuntimeDescriptor

object.Equals(object?), object.Equals(object?, object?), object.GetHashCode(), object.GetType(), object.ReferenceEquals(object?, object?), object.ToString()

These runtime descriptors keep client-aware REST documentation surfaces introspectable without turning OpenAPI JSON or Scalar page routes into a second source of truth outside the shared backend-for-frontend and REST runtime catalogs.

BackendForFrontendRestDocumentRuntimeDescriptor(string, string, string, string, string, string, string, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?)

Section titled “ BackendForFrontendRestDocumentRuntimeDescriptor(string, string, string, string, string, string, string, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?, IReadOnlyList<string>?)”

Creates a backend-for-frontend REST documentation runtime descriptor.

public BackendForFrontendRestDocumentRuntimeDescriptor(string id, string kind, string scopeId, string clientId, string documentName, string openApiPath, string scalarPath, IReadOnlyList<string>? bindingIds = null, IReadOnlyList<string>? sourceModuleIds = null, IReadOnlyList<string>? runtimeEndpointIds = null, IReadOnlyList<string>? restEndpointIds = null)

id string

The stable documentation-surface identifier.

kind string

The stable scope kind. Supported values are and .

scopeId string

The stable scope identifier. For binding-scoped surfaces this is the binding identifier, while client-scoped surfaces use the client identifier.

clientId string

The stable client identifier served by the materialized document.

documentName string

The resolved OpenAPI document name.

openApiPath string

The rooted OpenAPI JSON path for the filtered document.

scalarPath string

The rooted Scalar page path for the filtered document.

bindingIds IReadOnlyList<string>?

The backend-for-frontend binding identifiers that contribute to the materialized document. Binding-scoped surfaces contain one value, while client-scoped surfaces can aggregate more than one binding.

sourceModuleIds IReadOnlyList<string>?

The published-endpoint source-module identifiers represented in the materialized document.

runtimeEndpointIds IReadOnlyList<string>?

The client-aware runtime endpoint identifiers included in the materialized document.

restEndpointIds IReadOnlyList<string>?

The published REST endpoint identifiers included in the materialized document.

The stable kind identifier used when the documentation surface is scoped to one binding.

public const string BindingKind = "binding"

string

The stable kind identifier used when the documentation surface is scoped to one client.

public const string ClientKind = "client"

string

Gets the binding identifier when the surface is scoped to one binding.

public string? BindingId { get; }

string?

Gets the contributing backend-for-frontend binding identifiers.

public IReadOnlyList<string> BindingIds { get; }

IReadOnlyList<string>

Gets the stable client identifier represented by the materialized document.

public string ClientId { get; }

string

Gets the resolved OpenAPI document name.

public string DocumentName { get; }

string

Gets the stable documentation-surface identifier.

public string Id { get; }

string

Gets the stable scope kind.

public string Kind { get; }

string

Gets the rooted OpenAPI JSON path for the filtered document.

public string OpenApiPath { get; }

string

Gets the included published REST endpoint identifiers.

public IReadOnlyList<string> RestEndpointIds { get; }

IReadOnlyList<string>

Gets the included client-aware runtime endpoint identifiers.

public IReadOnlyList<string> RuntimeEndpointIds { get; }

IReadOnlyList<string>

Gets the rooted Scalar page path for the filtered document.

public string ScalarPath { get; }

string

Gets the stable scope identifier.

public string ScopeId { get; }

string

Gets the published-endpoint source-module identifiers represented in the materialized document.

public IReadOnlyList<string> SourceModuleIds { get; }

IReadOnlyList<string>