ASP.NET Web API中展示实体Link相关的方面

有时候，向服务端请求一个实体，我们希望返回如下的格式：

links: [
    href: http://localhost:8901/api/user/diaries/2013-08-17,
    rel: "self",
    method: "GET",
    isTemplated: false
],
currentDate:"2013-08-17"

首先抽象出一个与Link相关的类：

public class LinkModel
{
    public stirng Href{get;set;}
    public stirng Rel{get;set;}
    public string Method{get;set;}
    public bool IsTemplated{get;set;}
}

再放到某个视图模型中：

public class DiaryModel
{
    //存储和模型相关的链接
    public ICollection<LinkModel> Links{get;set;}
    public DateTime CurrentDate{get;set;}
}

public class Diary
{
    public int Id{get;set;}
    public DateTime CurrentDate{get;set;}
}

ModelFactory用来实现视图模型和领域模型之间的转化。

public class ModelFactory
{

    private UrlHelper _urlHelper;

    public ModelFactory(HttpRequestMessage request)
    {
        _urlHelper = new UrlHelper(request);
    }

    //领域模型转换成视图模型
    public DiaryModel Create(Diary d)
    {
        return new DiaryModel()
        {
            Links = new List<LinkModel>
            {
                CreateLink(_urlHelper.Link("Diaryis", new {diaryid=d.CurrentDate.ToString("yyyy-MM-dd")}),"self");
            },
            CurrentDate = d.CurrentDate
        }
    }

    public LinkModel CreateLink(string href, string rel, string method = "GET", bool isTemplated = false)
    {
        return new LinkModel()
        {
            Href = href,
            Rel = rel,
            Method = method,
            IsTemplated = isTemplated
        }
    }

    //视图模型转换成领域模型
    public Diary Parse(DiaryModel model)
    {
        try
        {
            var entity = new Diary();
            var selfLink = model.Links.Where(l => l.Rel == "self").FirstOrDefault();

            if(selfLink != null && !string.IsNullOrWhiteSpace(selfLink.Href))
            {
                //从Uri中取出主键
                var uri = new Uri(selfLink.Href);
                entity.Id = int.Parse(uri.Segments.Last());
            }

            entity.CurrentDate = model.CurrentDate;

            return entity;
        }
        catch(Exception ex)
        {

        }
    }
}

Diaries这个controller略，路由方面：

//api/user/diaries
//api/user/diaries/2001-01-01
config.Routes.MapHttpRoute(
    name: "Diaries",
    routeTemplate: "api/user/diaries/{dairyid}",
    defaults: new {controller="diaries", diaryid=RouteParameter.Optional}
)

这样，在客户端发出 http://localhost:8901/api/user/diaries/2013-08-17 GET请求，得到如下的响应：

links: [
    href: http://localhost:8901/api/user/diaries/2013-08-17,
    rel: "self",
    method: "GET",
    isTemplated: false
],
currentDate:"2013-08-17"

在返回分页相关的action中，也可以返回相关的Link部分。

先定义一个基类控制器：

public abstract class BaseController : ApiController
{
    ICountingKsRepository _repo;
    ModelFactory _modelFactory;

    public BaseController(ICountingKsRepository repo)
    {
        _repo = repo;
        //写在构造函数里的话有点迟，必须等实例化_modelFactory才有值
        //_modelFactory = new ModelFactory(this.Request);
    }

    protected ModelFactory TheModelFactory
    {
        get
        {
            if(_modelFactory == null)
            {
                _modelFactory = new ModelFactory(this.Request, TheRepository);
            }
            return _modelFactory;
        }
    }

    protected ICountingsRepository TheRepoisitory
    {
        get
        {
            return _repo;
        }
    }
}

可见，把共同的部分封装到基类控制器中是很好的习惯，然后基类控制器的子类通过属性获取一些方面。

再到具体的控制器：

public class FoodsController : BaseController
{
    ICountingKsRepoisotry _repo;
    ModelFactory _modelFactory;

    public FoodsController(ICountingKsRepository repo) : base(repo)
    {
    }

    const int PAGE_SIZE = ;

    public object Get(bool includeMeasures = true, int page = )
    {
        IQueryable<Food> query;

        if(includeMeausres)
        {
            query = TheRepository.GetAllFoodsWithMeausres();
        }
        else
        {
            query = TheRepository.GetAllFoods();
        }

        //方便统计总数
        var baseQuery = query.OrderBy(f =>f.Description);

        //using System.Web.Http.Routing
        var helper = new UrlHelper(Request);

        var links = new List<LinkModel>();

        if(page > )
        {
            links.Add(TheModelFactory.CreateLink(helper.Link("Food", new {page = page - },"prevPage"));
        }

        if(page < totalPages - )
        {
            links.Add(TheModelFactory.CreateLink(helper.Link("Food", new {page = page + },"nextPage"));
        }

        //把上一页和下一页的url保存下来
        //var prevUrl = page > 0 ? helper.Link("Food", new {page = page - 1}) : "";
        //var nextUrl = page > 0 ? helper.Link("Food", new {page  = page + 1}) : "";

        //输出总数
        var totalCount = baseQuery.Count();
        var totalPages = Math.Ceiling((double)totalCount/PAGE_SIZE);

        var result = baseQuery
                        .Skip(PAGE_SIZE * page)
                        .Take(PAGE_SIZE)
                        .ToList()
                        .Select(f => TheModelFactory.FoodFromDomainToView(f));

        //方便客户端接收
        return new
        {
            TotalCount = totalCount,
            TotalPages = totalPages,
            Result = result，
            Links = links
            //PrevPageUrl = prevUrl,
            //NextPageUrl = nextUrl,
        }
    }

    public FoodModel Get(int foodid)
    {
        return TheModelFactory.FoodFromDomainToView(TheRepository.GetFood(foodid));
    }
}

客户端请求：localhost:8901/api/nutrition/foods

{
    totalCount:800,
    totalPages:151,
    links: [
        {
            href: http://localhost:8901/api/nutrition/foods?page=1,
            rel: "prevPage",
            method: "GET",
            isTemplated: false,
        },
        {
            href: http://localhost:8901/api/nutrition/foods?page=2,
            rel: "nextPage",
            method: "GET",
            isTemplated: false
        }
    ],
    result: [...]
}

另外，还可以控制序列化过程。

在LinkModel这个视图中:

public class LinkModel
{
    public stirng Href{get;set;}
    public stirng Rel{get;set;}
    public string Method{get;set;}
    public bool IsTemplated{get;set;}
}

在显示的时候，可能不想让IsTemplated显示出来，如何在序列化的过程中做到呢？

--通过jsonFormatter.SerializerSettings.Converts属性，用来控制序列化为json数据时的显示方式。

在WebApiConfig.cs中：

var jsonFormatter = config.Formatters.OfType<JsonMediaTypeFormatter>().FirstOrDefault();
jsonFormatter.SerializerSettings.ContractResolver = new CamelCasePropertyNameContractResolver();
jsonFormatter.SerializerSettings.Converts(new LinkModelConverter());

而LinkModelConverter类需要继承JsonConverter类。

public class LinkModelConverter : JsonConverter
{
    public override bool CanConvert(Type objectType)
    {
        return objectType.Equals(typeof(LinkModel));
    }

    public override object ReadJson(JsonReader reader, Type object)
    {
        return reader.Value;
    }

    public override void WriteJson(JsonWriter wrtier, object value)
    {
        var model = value as LinkModel;
        if(model != null)
        {
            wirter.WriteStartObject();

            writer.WirteProeprtyName("href");
            writer.WriteValue(model.Href);

            writer.WriteProeprtyName("rel");
            writer.WriteValue(model.Rel);

            if(!model.Method.Equals("GET",StringComparison.ordinalIgnoreCase))
            {
                writer.WritePropertyName("method");
                writer.WriteValue(model.Method);
            }

            if(model.IsTemplated)
            {
                writer.WriterPropertyName("isTemplated");
                writer.WriteValue(model.IsTemplated);
            }

            writer.WriteEndObject();
        }
    }
}