Repository navigation
Expand file tree
/
Copy pathAsyncApiParameter.cs
More file actions
94 lines (80 loc) · 3.57 KB
/
Copy pathAsyncApiParameter.cs
File metadata and controls
94 lines (80 loc) · 3.57 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
namespace ByteBard.AsyncAPI.Models
{
using System;
using System.Collections.Generic;
using System.Linq;
using ByteBard.AsyncAPI.Models.Interfaces;
using ByteBard.AsyncAPI.Writers;
/// <summary>
/// Describes a parameter included in a channel name.
/// </summary>
public class AsyncApiParameter : IAsyncApiExtensible, IAsyncApiSerializable
{
/// <summary>
/// An enumeration of string values to be used if the substitution options are from a limited set.
/// </summary>
public virtual IList<string> Enum { get; set; } = new List<string>();
/// <summary>
/// The default value to use for substitution, and to send, if an alternate value is not supplied.
/// </summary>
public virtual string Default { get; set; }
/// <summary>
/// An optional description for the parameter. CommonMark syntax MAY be used for rich text representation.
/// </summary>
public virtual string Description { get; set; }
/// <summary>
/// An array of examples of the parameter value.
/// </summary>
public virtual IList<string> Examples { get; set; } = new List<string>();
/// <summary>
/// A runtime expression that specifies the location of the parameter value.
/// </summary>
public virtual string Location { get; set; }
/// <inheritdoc/>
public virtual IDictionary<string, IAsyncApiExtension> Extensions { get; set; } = new Dictionary<string, IAsyncApiExtension>();
public virtual void SerializeV2(IAsyncApiWriter writer)
{
if (writer is null)
{
throw new ArgumentNullException(nameof(writer));
}
writer.WriteStartObject();
writer.WriteOptionalProperty(AsyncApiConstants.Description, this.Description);
if (this.Enum.Any() || this.Default != null || this.Examples.Any())
{
var schema = new AsyncApiJsonSchema();
if (this.Enum.Any())
{
schema.Enum = this.Enum.Select(e => new AsyncApiAny(e)).ToList();
}
if (this.Default != null)
{
schema.Default = new AsyncApiAny(this.Default);
}
if (this.Examples.Any())
{
schema.Examples = this.Examples.Select(e => new AsyncApiAny(e)).ToList();
}
writer.WriteOptionalObject(AsyncApiConstants.Schema, schema, (w, s) => s.SerializeV2(w));
}
writer.WriteOptionalProperty(AsyncApiConstants.Location, this.Location);
writer.WriteExtensions(this.Extensions);
writer.WriteEndObject();
}
public virtual void SerializeV3(IAsyncApiWriter writer)
{
if (writer is null)
{
throw new ArgumentNullException(nameof(writer));
}
writer.WriteStartObject();
writer.WriteOptionalCollection(AsyncApiConstants.Enum, this.Enum, (w, e) => w.WriteValue(e));
writer.WriteOptionalProperty(AsyncApiConstants.Default, this.Default);
writer.WriteOptionalProperty(AsyncApiConstants.Description, this.Description);
writer.WriteOptionalCollection(AsyncApiConstants.Examples, this.Examples, (w, e) => w.WriteValue(e));
writer.WriteOptionalProperty(AsyncApiConstants.Location, this.Location);
writer.WriteExtensions(this.Extensions);
writer.WriteEndObject();
}
}
}