Asp.Net WebApi接口返回值IHttpActionResult

WebApi是微软在VS2012 MVC4版本中绑定发行的,webapi2.0同mvc5发行的

webapi一共有以下接口返回值
1、void无返回值
2、IHttpActionResult

Json(T content)
Ok()、 Ok(T content)
NotFound()
其他
自定义IHttpActionResult接口的实现
3、HttpResponseMessage
4、自定义类型

void无返回值

没有返回值,http状态码204。我感觉用处不大,一个好的api应该有返回值。

public class CeshiController : ApiController
{
    public void PostSave()
    {
        //doing
    }
}

IHttpActionResult

IHttpActionResult是Web API 2中引入的一个接口,IHttpActionResult是HttpResponseMessage的一个工厂类。IHttpActionResult是WebAPI中推荐的标准返回值,ApiController类中也提供了不少标准的工厂函数方便我们快速构建它们,如,Json,Ok,NotFound,BadRequest等。

1、Json(T content)

比较常用的方法

namespace cms.Web.API
{
    public class CeshiController : ApiController
    {
        public studentBLL bll = new studentBLL();
        public IHttpActionResult GetList()
        {
            var list = bll.FindList();
            return Json(list);
        }
        public IHttpActionResult GetList2()
        {
            dynamic data = new { name = "李白", age = 20 };
            return Json(data);
        }
    }
}

2、Ok()、 Ok(T content)

比较常用的方法

namespace cms.Web.API
{
    public class CeshiController : ApiController
    {
        public studentBLL bll = new studentBLL();
        public IHttpActionResult GetList()
        {
            var list = bll.FindList();
            return Ok(list);
        }
        public IHttpActionResult GetList2()
        {
            dynamic data = new { name = "李白", age = 20 };
            return Ok(data);
        }
        public IHttpActionResult PostAdd()
        {
            //表示不向客户端返回任何信息,只告诉客户端请求成功
            return Ok();
        }
        public IHttpActionResult GetModel(int id)
        {
            var model = bll.Find(id);
            return Ok(model);
        }
    }
}

3、NotFound()

比较常用的方法

找不到记录时,有时需要用到NotFound()方法

   public IHttpActionResult GetModel(int id)
    {
        var model = bll.Find(id);
        if (model == null)
        {
            return NotFound();
        }
        return Ok(model);
    }  

4、其他返回值

不常用

Content(HttpStatusCode statusCode, T value)

  public IHttpActionResult GetCeshi()
    {
        return Content(HttpStatusCode.OK, "hello webapi");
        //return Ok("hello webapi")//一样的效果
    }

BadRequest()

public IHttpActionResult GetCeshi(string name)
{
    if (string.IsNullOrEmpty(name))
    {
        return BadRequest();
    }
    return Ok();
}

Redirect(string location)

 public IHttpActionResult GetCeshi(string name)
    {
        return Redirect("https://www.cnblogs.com/webapi/");
    }

HttpResponseMessage

这个对象也有它独特的使用场景,需要向客户端返回HttpResponse时就要用到这个对象。以下载为例,由于需要将下载的文件输出到客户端浏览器,Webapi的服务端需要向Web的客户端输出文件流,这个时候一般的IHttpActionResult对象不方便解决这个问题,于是HttpReponseMessage派上了用场。


```csharp
using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Web.Http;

namespace cms.Web.API
{
    public class CeshiController : ApiController
    {public HttpResponseMessage GetFile()
        {
            try
            {
                var FilePath = System.Web.Hosting.HostingEnvironment.MapPath(@"~/upload/ceshi.zip");
                var stream = new FileStream(FilePath, FileMode.Open);
                HttpResponseMessage response = new HttpResponseMessage(HttpStatusCode.OK);
                response.Content = new StreamContent(stream);
                response.Content.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");
                response.Content.Headers.ContentDisposition = new ContentDispositionHeaderValue("attachment")
                {
                    FileName = "Wep Api Demo ceshi.zip"
                };
                return response;
            }
            catch
            {
                return new HttpResponseMessage(HttpStatusCode.NoContent);
            }
        }
    }
}

自定义类型

你可以将webapi的接口和普通方法一样,返回任意的类型,WebApi会自动序列化你自定义任何返回类型,然后将序列化的值写到响应正文里,状态码统一返回200。

using System;
using System.Collections.Generic;
using System.Net;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Web.Http;
using cms.BLL;
using cms.Model;

namespace cms.Web.API
{
    public class CeshiController : ApiController
    {
        public studentBLL bll = new studentBLL();

        public IEnumerable<student> GetList()
        {
            var list = bll.FindList();
            return list;
        }

        public student GetModel(int id)
        {
            var model = bll.Find(id);
            if (model == null)
            {
                throw new HttpResponseException(HttpStatusCode.NotFound);
            }
            return model;
        }

        public string GetMsg()
        {
            return "webapi";
        }

    }
}

// IHttpActionResult是WebAPI中微软官方推荐的标准返回值,建议大家使用这个,跟着微软走错不了。

上一篇:13. Web 前端开发快速入门-WebAPI编程(1)


下一篇:mysql递归查询cte