asp.net webAPI

Get:

1、Get参数传递的本质是url字符串拼接；
2、url字符串长度受限制；
3、Get参数传递在Http请求头部传递，而不支持Request-Body传递；
4、Get类型的方法支持参数为基本类型，不支持实体类型；
5、Get类型的方法命名，应尽量采用“Get+方法名”的命名方式，且习惯性地在方法前加上[HttpGet特性]；
6、实参与形参的匹配，遵循路由规则；
7、Get对应DB的Select操作，从这一点来理解，就知道为什么Http不支持实体对象传递的合理性了，因为一般情况，我们都是通过简单的字段查询信息(对应基本类型)

        //api/Person
        public IEnumerable<string> Get()
        {
            return new string[] { "value1", "value2" };
        }

        //http://localhost:27653/api/person/25
        //[Route("GetID")]
        [Route("api/Person/{id}")]//如果在这里设置了路由，那么就不会再执行webAPIConfig.cs中的路由了。
        public string Get(int id)
        {
            return "vichin" + id;
        }
        //api/Person?phoneNum=186

        //http://localhost:27653/api/person?phoneNum=25
        //多个重载的时候，可以通过URL传参的形式来指定所要调用的方法。
        public string GetPhoneNum(int phoneNum)
        {
            return phoneNum.ToString();
        }

        //api/Person?name=vichin
        public int Get(string name)
        {
            return name.Length;
        }

 

Post:

1、Post参数传递本身是在Request-Body内传递，而Get参数传递本质是url拼接；
2、Post参数传递不是key/value形式，而Get参数是key/value形式；
3、Post传递参数时，无论是单个参数还是对象，均借助[FromBody] 特性(当然，某些情况去掉[FromBody] 特性也可把值传递进去，但为了规范化，尽量加上该特性)；
4、Post没长度限制，而Get有长度限制(一般为1024b);
5、Post相对Get，较安全；
6、Post操作相当于DB的Insert操作；

        [HttpPost]
        public string Post([FromBody]string value, string value1)//[FromBody] string value
        {
            return "Post 请求，value= " + value;
        }

        [HttpPost]
        public string PostDynamic([FromBody]Product product)//[FromBody] string value
        {
            return "PostDynamic 请求，value= " + product.ProductName;
        }

        public string Put(int id, [FromBody] string value)//只有有一个参数用FromBody来修饰
        {
            return "Put 请求，value=" + value + ",id=" + id;
        }
        public string Delete(int id)
        {
            return "Delte请求, id:";
        }

如果使用Post请求，那么就需要每个方法都声明一个参数对应的类(即使只有一个参数），参数前标注[FromBody]，参数少的话麻烦，如果使用Get请求，那么都可以，但是需要注意防范缓存(HttpClient，ajax等需要禁用掉缓存)。

            $("#btn").click(function () {
                $.ajax({
                    type: "Post",
                    url: "http://localhost:27653/api/person",
                    data: { "": "value" },//post请求，不需要key
                    success: function (res) {
                        alert(res);
                    },
                    error: function (msg) {
                        alert(msg.responseText);
                    }
                });
            });

            //GET请求可以在url传参也可以将data中，已KEY:VALUE的形式进行传参。（其实在Chrome中能够发现，最终也是变成了URL传参）
            //    $.ajax({
            //        type: "Get",
            //        url: "/api/Default/ProductDetails",
            //        data: { "productDetail": JSON.stringify({ "ProductName": "YaGao", "ProductCode": "JX80869", "ProductPrice": 40.5 }) }
            //    })
            //})

            //dynamic单个参数传递
            $("#btn1").click(function () {
                $.ajax({
                    type: "Post",
                    url: "http://localhost:27653/api/person",
                    data: { "ProductCode": "JX00036", "ProductName": "YaGao", "ProductPrice": 20.5 },
                    success: function (res) {
                        alert(res);
                    },
                    error: function (msg) {
                        alert(msg.responseText);
                    }
                });
            });

            var list_ProductDetail = [
                { "ProductCode": "JX00031", "ProductName": "ToothPaste", "ProductPrice": "20.5" },
                { "ProductCode": "JX00032", "ProductName": "ToothBrush ", "ProductPrice": "18.9" },
                { "ProductCode": "JX00033", "ProductName": "Pen", "ProductPrice": "199.9" },
                { "ProductCode": "JX00034", "ProductName": "computer", "ProductPrice": "15000.5" }
            ]

            $.ajax({
                type: "Post",
                contentType: 'application/json',
                url: "/api/Default/PostParamToProducts",
                data: JSON.stringify(list_ProductDetail)
            });

            var arr = ["a", "b", "c", "d"];
            data: JSON.stringify(arr)

 

其他的操作如put delete大体上与post请求差不多。

 

路由：

    public static class WebApiConfig
    {
        public static void Register(HttpConfiguration config)
        {
            // Web API configuration and services

            // Web API routes
            config.MapHttpAttributeRoutes();//特性路由

            config.Routes.MapHttpRoute(
                name: "DefaultApi",
                routeTemplate: "api/{controller}/{id}",
                defaults: new { id = RouteParameter.Optional }
            );
        }
    }

如果在路由中配置了action(routeTemplate: "api/{controller}/{action}/{id}")， MVC风格的路由。那么请求的网址将会是api/person/GetName/id。