saule
v1.8.0
Saule 是 ASP.Net Web API 2 的 JSON API(版本 1.0)库。使用 NuGet 安装 Saule:
Install-Package saule
要使用 Saule,您必须定义包含有关您的域的信息的资源:
公共类 PersonResource : ApiResource{ 公共 PersonResource() { 属性(“名字”); 属性(“姓氏”); 属性(“年龄”); 属于<公司资源>(“工作”); HasMany<PersonResource>("朋友"); }}公共类 CompanyResource : ApiResource{ public CompanyResource() { Attribute("名称"); 属性(“员工人数”); }}
然后,您可以使用它们将任何类序列化为 Json Api(只要您的类具有与模型中名称相同的属性):
public class PersonController : ApiController{ [HttpGet] [ReturnsResource(typeof(PersonResource))] [Route("people/{id}")] public JohnSmith GetPerson(string id) { return new JohnSmith(); } }}
GET http://example.com/people/123{ "data": { "type": "person", "id": "123", "attributes": { "first-name": "John", "姓氏”:“史密斯”,“年龄”:34 }, "关系": { "工作": { "链接": { "自我": "http://example.com/people/123/relationships/job/", "相关": "http://example .com/people/123/job/" }, "数据": { "类型": "公司", "id": "456" } }, "朋友": { "链接": { "自我": "http://example.com/people/123/relationships/friends/", "相关": "http://example.com/people/ 123/朋友/” }, “数据”: [ {“类型”:“人”,“id”:“789” } ] } } }, “包括”: [ {“类型”:“公司”,“id”:“456”,“属性”:{“名称”:“Awesome,Inc.”,“员工人数”:24 } }, {“类型”:“人”,“id”:“789”,“属性”:{“名字”:“萨拉”,“姓氏”:“琼斯”,“年龄”:38 } } ], “链接”: { “自我”: “http://example.com/people/123” } }
反序列化的工作方式与普通 Web API 一样;你不需要做任何特别的事情来完成这项工作。
请按照以下步骤创建新版本:
创建一个名为release-v<version>
的分支(例如release-v1.5
)
增加master
中appveyor.yml
的版本号
推送两个更改并等待构建
将发行说明复制到 Github 上的发行说明中
发布新版本