Web APi之HttpClient注意事项以及建议(四)

简介:

前言

之前对于用SelfHost来手动实现Web API的宿主模式,似乎不是太深入,所以本篇文章我们一起来讨论关于利用HttpClient来访问Web API上的资源来进行探讨以及注意相关事项,希望此文对你也有收获。

来自XML或Json Content的简单参数

当Web API方法中接受如String、Datetime、Int等参数类型时,但是默认情况下这些方法不会接收来自XML或者JSON Body的参数,那么结果就是导致请求失败。接下来我们来进行演示。

我们取名为Default的Web API控制器,方法以及路由注册如下:

复制代码
        [HttpPost]
        public string GetString(string message)
        {
            return message;
        }

         config.Routes.MapHttpRoute(
               name: "DefaultApi",
               routeTemplate: "api/{controller}/{action}/{message}",
               defaults: new { message = RouteParameter.Optional }
         );
复制代码

接下来我们用客户端发出POST请求以及数据来请求Web API来并返回该数据,如下:

            var client = new HttpClient();
            var postUrl = "http://localhost:23133/api/default/GetString";
            var task = client.PostAsJsonAsync<string>(postUrl,"Hello World").Result; //将参数进行序列化为JSON并发送到Request中的Body中

通过上述路由以及请求方式的配置理论上来说是能通过URI能访问到资源,但是结果却令你大跌眼镜

由上可得知,参数Message的值Hello World已经传递过来,但是此时请求响应的资源上方法的参数并未接收到且返回404未找到该方法。

上面可能效果不是太明显,我们利用Ajax传递时间来进行请求并返回该数据,方法如下:

        public HttpResponseMessage GetDateTime(DateTime time)
        {

            return Request.CreateResponse<DateTime>(HttpStatusCode.OK, time);
        }

前台请求如下(路由配置就此略过):

复制代码
       $("#btn").click(function () {
            $.ajax({
                type: "get",
                url: "http://localhost:23133/api/Default/GetDateTime",
                dataType: "json",
                contentType: "application/json; charset=utf-8",
                data: { "time": new Date("2015","09","22") },
                cache: false,
                success: function (r) {
                    console.log(r);
                }
            });
        });
复制代码

此时响应信息如下:

{"Message":"请求无效。","MessageDetail":"对于“WebApplication2.Controllers.DefaultController”中方法“System.Net.Http.HttpResponseMessage GetDateTime(System.DateTime)”的不可以为 null 的类型“System.DateTime”的参数“time”,参数字典包含一个 null 项。可选参数必须为引用类型、可以为 null 的类型或声明为可选参数。"}

出错原因是对于简单的参数(如String、Int以及DateTime等)当进行请求时不会进行解析其属性而会将其设置为null,所以传递过来的时间为null,而方法的时间参数又不能为空,所以会出现错误。对于这种情况我们使用特性[FromBody]来解决【注意】当在前台传递值为字符串或者数字时则是可以解析的,能够成功传递到方法的参数时,而利用HttpClient进行传递时则会出现404。

鉴于上述,我们将其方法参数进行如下修饰即可成功

  public HttpResponseMessage GetDateTime([FromBody] DateTime time)

建议

对于前台进行简单参数进行传递以及和利用HttpClient来进行简单参数的传递出现的情况不同,建议在其参数上加上特性 FromBody  ,这样两者皆可避免。

补充

当然有FromBody也就对应的有FromURI,添加此特性就可获得URL上该特性参数对应的值,URI如下:

    var postUrl = "http://localhost:23133/api/default/GetString?message='xpy0928'";

被请求的资源如下:

        [HttpPost]
        public string GetString([FromUri] string message)
        {
            return message;
        }

此时请求时该message对应的值就为xpy0928。

UrlEncoded表单字符串解析

我们在操作表单时肯定会有将表单数据作为字典进行传递的情况,下面我们就来演示这种情况。

如下为Web API需要被请求的方法

复制代码
        [HttpPost]
        public string GetString(string cnblogs)
        {

            return cnblogs;

        }
复制代码

接下来我们利用客户端来访问上述该方法:

复制代码
            var formVars = new Dictionary<string, string>();
            formVars.Add("cnblogs", "xpy0928");
            var content = new FormUrlEncodedContent(formVars);  

            var client = new HttpClient();
            var postUrl = "http://localhost:23133/api/default/GetString";
            var task = client.PostAsync(postUrl, content).Result;  //参数未进行序列化
复制代码

从上述可以看出理论上是可行的,我们通过URI将表单数据以字典形式进行传递去请求Web API,并获取键cnblogs的值。结果会虐死你,如下:

因为这种对于cnblogs参数值映射到方法上的cnblogs参数上在Web API是行不通的,Web API不会进行映射 。

既然简单的参数来接收不行下面我们尝试利用对象来获得该参数的值就像MVC中提交参数到实体上一样。

首先给出一个类,并且该类中含有cnblogs属性,如下:

        public class CnblogsModel
        {
            public string Cnblogs { get; set; }
        }

将其方法及参数修改如下:

复制代码
       [HttpPost]
        public string GetString(CnblogsModel model)
        {

            return model.Cnblogs;

        }
复制代码

接下来就是见证奇迹的时刻到了,给力啊AngelaBaby,皇天不负有心人,如下:

 【注意】由上可知成功的关键是对象中的字段必须要和POST表单中的键必须相匹配,如果有多个键,那么对象中的字段也要与之对应。

上述的解决方案完全是可行的,但是让人忍俊不禁的是这么做似乎有点太操蛋,接受表单中的参数还得建立对象并与之对应,所以得想更好的出路,既然是针对表单的,难道表单中对于接受这样的字典就没有对应的类来进行处理吗,于是乎,开始找啊找,结果找到了一个 FormDataCollection (表面意思是表单数据集合)。貌似可行,来我们继续将其代码进行改写,如下:

复制代码
       [HttpPost]
        public string GetString(FormDataCollection collection)
        {

            return collection.Get("cnblogs");

        }
复制代码

验证通过,如下:

 

这样就比第一个解决方案可行多了,只是对于这样的集合类有点让人想不明白,为什么不直接通过索引来获取数据而非得用对于单个用Get或者对于多个字段用GetValues()方法

你是不是就以为这样简洁就是可行的呢?那你可就错了,当我们在ASP.NET上运行Web API我们完全可以通过如下来进行获取表单数据:

            var request = HttpContext.Current.Request;
            var formKeys = request.Form.AllKeys;

建议

当获取表单数据时建议用 HttpContext.Current.Request  ,虽然它仅仅只能在ASP.NET上进行应用而无法在SelfHost上使用,但是对于一些复杂的场景下,比如说你需要获得一些Web API上的Request没有暴露的数据,此时用此种方法将是不可替代的,同时HttpContext无论是在ASP.NET还是MVC或者Web API中都是存在的。所以尽量避免使用FormDataCollection,即使看起来在路由上使用它更简单。

补充(1)

感谢园友敷衍不起的疑问,刚开始以为挺简单的,结果就是被打脸了,后经过研究对于复杂类型的数据的传递以及接收,若是具体类,利用FormDataCollection是行不通的,我能想到的解决方案是进行如下操作【期待你更好的解决方案】:

复制代码
            var p = new Person() { Name = "person", Student = new Student() { StuName = "xpy0928" } };

            var client = new HttpClient();

            var postUrl = new Uri("http://localhost:23133/api/default/GetString");


            var task = client.PostAsJsonAsync(postUrl, p).Result;  //利用PostAsJsonAsync方法来进行序列化类
复制代码

在Web API上进行接收,如下:

     [HttpPost]
        public string GetString(Person p)
        {
            return p.Name;
        }

至于用FormDataCollection接收不行的原因是 FormUrlEncodedContent 的参数键和值必须都是string类型,若类不是具体类直接添加键和值都是字符串则是可行的,但是这种情况似乎不太现实,所以对于具体类还是利用 PostAsJsonAsync 来进行解决。

补充(2)

感谢园友【YoMekennywangjin】的提醒,上述必须显式通过路由来进行参数传递才会成功,如果通过Request中body来传递就会出现不解析的情况。

访问QueryString 

在命名空间System.Net.Http下有一扩展方法如下:

            var requestUri = Request.RequestUri.ParseQueryString();
            var paramValue = requestUri["param"];

在大多数场景下使用此方法是比较高效的,但是如果在URI中有许多参数,此时你不得不去显式去解析这些参数。

总结

如上述,Web API对于相关参数的映射是比较简单的,但是在一些不同的情况下,你不得不手动做一些工作来进行处理,同时我们也许意识到了Web API并没有提供任何全局上下文对象,例如Request以及过滤中的Formatters等,都是基于Web API来提供特定的方法来进行操作即方法都是为Web API而量身定制,所以在看到Web API强大的同时也要看到其软肋,这样我们才能更好的对于不同场景下作出不同的处理。







本文转自Jeffcky博客园博客,原文链接:http://www.cnblogs.com/CreateMyself/p/4827171.html,如需转载请自行联系原作者
目录
相关文章
|
4天前
|
开发框架 监控 .NET
Visual Basic的Web服务和REST API开发指南
【4月更文挑战第27天】本文探讨了使用Visual Basic(VB.NET)构建Web服务和RESTful API的方法。首先介绍了Web服务的基础和REST API的概念,然后阐述了.NET Framework与.NET Core/.NET 5+对VB.NET的支持,以及ASP.NET Core在Web开发中的作用。接着,详细讲解了创建RESTful API的步骤,包括控制器与路由设置、模型绑定与验证,以及返回响应。此外,还讨论了安全措施、测试方法、部署选项和监控策略。最后强调,VB.NET开发者可以通过ASP.NET Core涉足现代Web服务开发,拓宽技术领域。
|
2月前
|
JSON API 数据库
解释如何在 Python 中实现 Web 服务(RESTful API)。
解释如何在 Python 中实现 Web 服务(RESTful API)。
26 0
|
1天前
|
弹性计算 JSON Shell
基于Web API的自动化信息收集和整理
【4月更文挑战第30天】
6 0
|
5天前
|
缓存 前端开发 API
toapi,一个强大的 Python Web API库!
toapi,一个强大的 Python Web API库!
20 5
|
13天前
|
JSON API 数据库
解释如何在 Python 中实现 Web 服务(RESTful API)。
在Python中实现Web服务(RESTful API)涉及选择框架(如Flask、Django、FastAPI),定义路由及处理函数(对应HTTP请求方法),处理请求,构建响应和启动服务器。以下是一个使用Flask的简单示例:定义用户列表,通过`@app.route`装饰器设置GET和POST请求处理函数,返回JSON响应,并用`app.run()`启动服务器。实际API会包含更复杂的逻辑和错误处理。
14 1
|
20天前
|
安全 API
OpenAI邮箱API发送邮件注意事项
使用OpenAI邮箱API需注意API密钥安全,避免泄露;确保邮件内容合法合规,不发送垃圾邮件;设置正确发件人信息,防止被视为垃圾邮件;确认收件人信息准确;控制发送频率;保持内容格式规范;记录发送日志;并先进行发送测试。遵循这些提示可确保邮件发送顺利。
|
2月前
|
XML JSON API
通过Flask框架创建灵活的、可扩展的Web Restful API服务
通过Flask框架创建灵活的、可扩展的Web Restful API服务
|
2月前
|
缓存 监控 API
Python Web框架FastAPI——一个比Flask和Tornada更高性能的API框架
Python Web框架FastAPI——一个比Flask和Tornada更高性能的API框架
58 0
|
2月前
|
JSON API 数据格式
构建高效Python Web应用:Flask框架与RESTful API设计实践
【2月更文挑战第17天】在现代Web开发中,轻量级框架与RESTful API设计成为了提升应用性能和可维护性的关键。本文将深入探讨如何使用Python的Flask框架来构建高效的Web服务,并通过具体实例分析RESTful API的设计原则及其实现过程。我们将从基本的应用架构出发,逐步介绍如何利用Flask的灵活性进行模块化开发,并结合请求处理、数据验证以及安全性考虑,打造出一个既符合标准又易于扩展的Web应用。
665 4
|
2月前
|
API 开发工具 数据安全/隐私保护
API接口的对接流程和注意事项(淘宝商品详情店铺)
随着互联网技术的发展和应用的普及,API接口已经成为不同系统、不同应用之间进行交互和数据交换的重要方式。API接口使得不同的系统能够互相调用对方的功能,提高了系统的灵活性和扩展性。但是,在进行API接口对接的过程中,需要注意一些流程和事项,以确保对接的顺利进行和系统的稳定运行。