saule
v1.8.0
Saule 是 ASP.Net Web API 2 的 JSON API(版本 1.0)函式庫。
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 上的發行說明中
發布新版本