Should SerializeV2WithoutReference resolve in object references as well?

[martinek-stepan]

Hi,

SerializeV2WithoutReference currently only resolves top-level reference & uses internally SerializeV2 for properties of the AsyncApiSchema.

In my use-case I am trying to extract payload schema to validate my de-serialized model in test against schema with JsonSchema package.
In my tests I serialize and de-serialize my model, parse AsyncApi schema with this library and extract payload with SerializeV2WithoutReference.

That results in JSON like this:

{
"type": "object",
"required": [
"testA",
],
"properties": {
"testA": {
"type": "string",
"format": "uuid"
},
"testB": {
"$ref": "#/components/schemas/testB"
}
}
}

testB is still unresolved so I would need to jump through hoops to actually use this JsonSchema to validate my serialized JSON.

Is there any reason to not serialize completely without references, or some way to do that?
Bonus questions, could this library go step further than just parsing AsyncApi schema and allow validation capacity same as JsonSchema does?

[VisualBean]

Ive spent a bit more time on the issue, trying to streamline this a bit for the payload schemas.
Anyway.. I will make a PR that fixes this.

With default settings you will get an output like this

channels:
mychannel:
publish:
message:
payload:
type: objectrequired:
- testBproperties:
testC:
$ref: '#/components/schemas/testC'testB:
$ref: '#/components/schemas/testB'components:
schemas:
testD:
type: stringformat: uuidtestC:
type: objectproperties:
testD:
$ref: '#/components/schemas/testD'testB:
type: booleandescription: test

But if you instead use the inlinereferences setting

like so

varoutputString=newStringWriter(CultureInfo.InvariantCulture);varwriter=newAsyncApiYamlWriter(outputString,newAsyncApiWriterSettings{ReferenceInline=ReferenceInlineSetting.InlineReferences});asyncApiDocument.SerializeV2(writer);

you will get an output like the following

channels:
mychannel:
publish:
message:
payload:
type: objectrequired:
- testBproperties:
testC:
type: objectproperties:
testD:
type: stringformat: uuidtestB:
type: booleandescription: testcomponents: { }

[martinek-stepan]

Actually this is exactly what I was looking for. Thank you!

var outputString = new StringWriter(CultureInfo.InvariantCulture);
var writer = new AsyncApiYamlWriter(outputString, new AsyncApiWriterSettings { ReferenceInline = ReferenceInlineSetting.InlineReferences });
asyncApiDocument.SerializeV2(writer);

Would be great addition to documentation / examples.

[VisualBean]

https://github.com/LEGO/AsyncAPI.NET/wiki/Reference-Resolution