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 上的發行說明中
發布新版本