-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #80 from neuroglia-io/feat-resource-oriented
Added the Resource Oriented infrastructure implementations
- Loading branch information
Showing
178 changed files
with
10,791 additions
and
146 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,98 @@ | ||
| // Copyright © 2021-Present Neuroglia SRL. All rights reserved. | ||
| // | ||
| // Licensed under the Apache License, Version 2.0 (the "License"), | ||
| // you may not use this file except in compliance with the License. | ||
| // You may obtain a copy of the License at | ||
| // http://www.apache.org/licenses/LICENSE-2.0 | ||
| // | ||
| // Unless required by applicable law or agreed to in writing, software | ||
| // distributed under the License is distributed on an "AS IS" BASIS, | ||
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
| // See the License for the specific language governing permissions and | ||
| // limitations under the License. | ||
|
|
||
| using System.Runtime.Serialization; | ||
| using System.Text.Json.Serialization; | ||
|
|
||
| namespace Neuroglia; | ||
|
|
||
| /// <summary> | ||
| /// Represents an object used to describe a problem, as defined by <see href="https://www.rfc-editor.org/rfc/rfc7807">RFC 7807</see> | ||
| /// </summary> | ||
| [DataContract] | ||
| public record ProblemDetails | ||
| : IExtensible | ||
| { | ||
|
|
||
| /// <summary> | ||
| /// Initialize a new <see cref="ProblemDetails"/> | ||
| /// </summary> | ||
| public ProblemDetails() { } | ||
|
|
||
| /// <summary> | ||
| /// Initialize a new <see cref="ProblemDetails"/> | ||
| /// </summary> | ||
| /// <param name="type">An uri that reference the type of the described problem</param> | ||
| /// <param name="title">A short, human-readable summary of the problem type.It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization</param> | ||
| /// <param name="status">The status code produced by the described problem</param> | ||
| /// <param name="detail">A human-readable explanation specific to this occurrence of the problem</param> | ||
| /// <param name="instance">A <see cref="Uri"/> reference that identifies the specific occurrence of the problem.It may or may not yield further information if dereferenced</param> | ||
| /// <param name="errors">An optional collection containing error messages mapped per error code</param> | ||
| /// <param name="extensionData">A mapping containing problem details extension data, if any</param> | ||
| public ProblemDetails(Uri type, string title, int status, string? detail = null, Uri? instance = null, IEnumerable<KeyValuePair<string, string[]>>? errors = null, IDictionary<string, object>? extensionData = null) | ||
| { | ||
| this.Type = type ?? throw new ArgumentNullException(nameof(type)); | ||
| this.Title = title ?? throw new ArgumentNullException(nameof(title)); | ||
| this.Status = status; | ||
| this.Detail = detail; | ||
| this.Instance = instance; | ||
| this.Errors = errors?.WithValueSemantics(); | ||
| this.ExtensionData = extensionData; | ||
| } | ||
|
|
||
| /// <summary> | ||
| /// Gets/sets an uri that reference the type of the described problem. | ||
| /// </summary> | ||
| [DataMember(Order = 1, Name = "type"), JsonPropertyName("type")] | ||
| public virtual Uri? Type { get; set; } = null!; | ||
|
|
||
| /// <summary> | ||
| /// Gets/sets a short, human-readable summary of the problem type.It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. | ||
| /// </summary> | ||
| [DataMember(Order = 2, Name = "title"), JsonPropertyName("title")] | ||
| public virtual string? Title { get; set; } = null!; | ||
|
|
||
| /// <summary> | ||
| /// Gets/sets the status code produced by the described problem | ||
| /// </summary> | ||
| [DataMember(Order = 3, Name = "status"), JsonPropertyName("status"),] | ||
| public virtual int Status { get; set; } | ||
|
|
||
| /// <summary> | ||
| /// Gets/sets a human-readable explanation specific to this occurrence of the problem. | ||
| /// </summary> | ||
| [DataMember(Order = 4, Name = "detail"), JsonPropertyName("detail")] | ||
| public virtual string? Detail { get; set; } | ||
|
|
||
| /// <summary> | ||
| /// Gets/sets a <see cref="Uri"/> reference that identifies the specific occurrence of the problem.It may or may not yield further information if dereferenced. | ||
| /// </summary> | ||
| [DataMember(Order = 5, Name = "instance"), JsonPropertyName("instance")] | ||
| public virtual Uri? Instance { get; set; } | ||
|
|
||
| /// <summary> | ||
| /// Gets/sets an optional collection containing error messages mapped per error code | ||
| /// </summary> | ||
| [DataMember(Order = 6, Name = "errors"), JsonPropertyName("errors")] | ||
| public virtual EquatableList<KeyValuePair<string, string[]>>? Errors { get; set; } | ||
|
|
||
| /// <summary> | ||
| /// Gets/sets a mapping containing problem details extension data, if any | ||
| /// </summary> | ||
| [DataMember(Order = 7, Name = "extensionData"), JsonExtensionData] | ||
| public virtual IDictionary<string, object>? ExtensionData { get; set; } | ||
|
|
||
| /// <inheritdoc/> | ||
| public override string ToString() => this.Detail ?? Environment.NewLine + string.Join(Environment.NewLine, this.Errors?.Select(e => string.Join(Environment.NewLine, e.Value.Select(v => $"{e.Key}: {v}")))!); | ||
|
|
||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,32 @@ | ||
| // Copyright © 2021-Present Neuroglia SRL. All rights reserved. | ||
| // | ||
| // Licensed under the Apache License, Version 2.0 (the "License"), | ||
| // you may not use this file except in compliance with the License. | ||
| // You may obtain a copy of the License at | ||
| // http://www.apache.org/licenses/LICENSE-2.0 | ||
| // | ||
| // Unless required by applicable law or agreed to in writing, software | ||
| // distributed under the License is distributed on an "AS IS" BASIS, | ||
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
| // See the License for the specific language governing permissions and | ||
| // limitations under the License. | ||
|
|
||
| namespace Neuroglia; | ||
|
|
||
| /// <summary> | ||
| /// Represents an <see cref="Exception"/> described by <see cref="ProblemDetails"/> | ||
| /// </summary> | ||
| /// <remarks> | ||
| /// Initializes a new <see cref="ProblemDetailsException"/> | ||
| /// </remarks> | ||
| /// <param name="problem">An object that describes the problem that has occurred</param> | ||
| public class ProblemDetailsException(ProblemDetails problem) | ||
| : Exception($"[{problem.Status} - {problem.Title}] {problem.Detail}{(problem.Errors?.Count > 0 ? Environment.NewLine + string.Join(Environment.NewLine, problem.Errors.Select(e => $"{e.Key}: {string.Join(", ", e.Value)}")) : "")}") | ||
| { | ||
|
|
||
| /// <summary> | ||
| /// An object that describes the problem that has occurred | ||
| /// </summary> | ||
| public ProblemDetails Problem { get; } = problem; | ||
|
|
||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.