返回类型为HttpResponseMessage的自动生成的帮助页

本文关键字：帮助 自动生成 返回类型 HttpResponseMessage | 更新日期: 2023-09-27 18:24:27

如果您能澄清一下webapi自动生成的帮助页面，我将不胜感激。

据我所知，如果我返回一个Type，它将自动生成该操作的帮助页面，并提供一个示例。但是，如果我使用HttpResponseMessage，那么可以理解的是，它无法猜测响应将是什么，只能对请求参数进行假设。

我使用HttpResponseMessage的原因是，当它可能不同于200时，建议指示您希望返回的状态代码。

那么，返回所需状态代码，但帮助页面仍能确定返回的类型的最佳做法是什么？？

返回类型为HttpResponseMessage的自动生成的帮助页

对于这些需要返回HttpResponseMessage的场景，解决方法是使用HelpPage提供的一些帮助程序来指示特定操作的实际返回类型。您可以在路径Areas'HelpPage'App_Start'HelpPageConfig.cs 中找到以下代码

//// Uncomment the following to correct the sample response when the action returns an HttpResponseMessage with ObjectContent<string>.
//// The sample will be generated as if the controller named "Values" and action named "Post" were returning a string.
//config.SetActualResponseType(typeof(string), "Values", "Post");

注意：
在即将发布的版本中，我们将引入一个名为System.Web.Http.Description.ResponseTypeAttribute的新属性，您可以为其提供一个System.Type，指示响应的实际类型。通过这种方式，您可以从操作中返回HttpResponseMessage或IHttpActionResult，并且仍然希望HelpPage正常工作。

我认为Attribute是个好主意，所以我实现了一个可以帮助其他人的属性，直到你们发布它。

用属性装饰你的行动：

public class FooController : ApiController
{
    [ResponseType(typeof(Bar))]
    public HttpResponseMessage Get(string id)
    {
        // ...
    }
}

定义属性：

[AttributeUsage(AttributeTargets.Method, AllowMultiple = false)]
public class ResponseTypeAttribute : Attribute
{
   public ResponseTypeAttribute(Type type)
   {
       if (type == null)
       {
           throw new ArgumentNullException("type");
       }
       Type = type;
   }
   public Type Type { get; private set; }
}

定义注册响应类型的方法：

/// <summary>
///     Registers api controller actions which return HttpResponseMessage
///     and include the ResponseType attribute to be populated with web api
///     auto generated help.
/// </summary>
/// <param name="assembly">The assembly to search for</param>
public static void RegisterHelpResponseTypes(Assembly assembly)
{
    var apiControllerTypes = assembly
        .GetTypes().Where(typeof(ApiController).IsAssignableFrom);
    foreach (var apiControllerType in apiControllerTypes)
    {
        var validActions = apiControllerType.GetMethods()
            .Where(method =>
                Attribute.IsDefined(method, typeof(ResponseTypeAttribute))
                &&
                (method.ReturnType == typeof(HttpResponseMessage)));
        foreach (var action in validActions)
        {
            var responseType = (ResponseTypeAttribute)Attribute
                                    .GetCustomAttributes(action)
                                    .Single(x => x is ResponseTypeAttribute);
            var controllerName = apiControllerType.Name.Substring(0, 
                    apiControllerType.Name.LastIndexOf("Controller", 
                                        StringComparison.OrdinalIgnoreCase));
            var actionName = action.Name;
            GlobalConfiguration
                .Configuration
                .SetActualResponseType(responseType.Type, 
                                       controllerName, 
                                       actionName);
        }
    }
}

将其包含在您的应用程序启动中：

RegisterHelpResponseTypes(typeof(FooController).Assembly);

如果你发现任何问题，请告诉我。

MVC 5有一个内置属性来设置响应类型。

更多信息请点击此处：http://thesoftwaredudeblog.wordpress.com/2014/01/05/webapi-2-helppage-using-responsetype-attribute-instead-of-setactualresponsetype/

只需使用：

    ResponseType(typeof([Your_Class]))]
相关文章：