rename and document content abstractions

Author: Fresa

src/OpenAPI.WebApiGenerator/CodeGeneration/ResponseBodyContentGenerator.cs

@@ -66,8 +66,7 @@ internal sealed class {{ClassName}} : {{responseClassName}}
         {{contentTypeFieldName}} = {{(_isContentTypeRange ? "contentType" : $"\"{_contentType.MediaType}\"")}};
     }
     
-    /// <inheritdoc/>
-    public static ContentMediaType<{{responseClassName}}> ContentMediaType { get; } = new(MediaTypeHeaderValue.Parse("{{_contentType}}"));
+    internal static ContentMediaType<{{responseClassName}}> ContentMediaType { get; } = new(MediaTypeHeaderValue.Parse("{{_contentType}}"));
     protected override IJsonValue Content { get; }
     protected override string ContentSchemaLocation { get; } = "{{SchemaLocation}}";
 }

src/OpenAPI.WebApiGenerator/CodeGeneration/ResponseContentGenerator.cs

@@ -62,7 +62,7 @@ public string GenerateResponseContentClass()
         return 
 $$$"""
 {{{_response.Description.AsComment("summary", "para")}}}
-internal {{{(_contentGenerators.Any() ? "abstract" : "sealed")}}} class {{{_responseClassName}}} : Response{{{(_contentGenerators.Any() ? $", IResponse<{_responseClassName}>" : "")}}}
+internal {{{(_contentGenerators.Any() ? "abstract" : "sealed")}}} class {{{_responseClassName}}} : Response{{{(_contentGenerators.Any() ? $", IContent<{_responseClassName}>" : "")}}}
 {
     private string? {{{contentTypeFieldName}}} = null;{{{
     _contentGenerators.AggregateToString(generator =>

src/OpenAPI.WebApiGenerator/CodeGeneration/ResponseGenerator.cs

@@ -69,22 +69,28 @@ protected void EnsureExpectedContentType(MediaTypeHeaderValue contentType, Media
     }}
 }
 
-internal interface IResponse<T> where T : class
+/// <summary>
+/// Represents a response with content
+/// </summary>
+/// <typeparam name="T">Response</typeparam>
+internal interface IContent<T> where T : Response
 {
     /// <summary>
-    /// Contents for this response
+    /// Contents for the response
     /// </summary>
     internal static abstract ContentMediaType<T>[] ContentMediaTypes { get; }
 }
 
-internal interface IContent<T> where T : class, IResponse<T>
-{
-    internal static abstract ContentMediaType<T> ContentMediaType { get; }
-}
-
+/// <summary>
+/// Typed content media type
+/// </summary>
+/// <typeparam name="T">Response</typeparam>
 internal readonly record struct ContentMediaType<T>(MediaTypeHeaderValue Value) 
-    where T : class
+    where T : Response
 {
+    /// <summary>
+    /// Implicitly convert back to MediaTypeHeaderValue
+    /// </summary>
     public static implicit operator MediaTypeHeaderValue(ContentMediaType<T> mediaType) => mediaType.Value;
 }
 
@@ -97,7 +103,7 @@ internal partial class Request
     /// <typeparam name="T">The response to match against</typeparam>
     /// <returns>True if a matched media type was found</returns>
     internal bool TryMatchAcceptMediaType<T>(
-        [NotNullWhen(true)] out ContentMediaType<T>? matchedContentMediaType) where T : class, IResponse<T>
+        [NotNullWhen(true)] out ContentMediaType<T>? matchedContentMediaType) where T : Response, IContent<T>
     {
         var mediaTypes = T.ContentMediaTypes;
         var acceptHeaders = HttpContext.Request.GetTypedHeaders().Accept;