Saule est une bibliothèque API JSON (version 1.0) pour l'API Web ASP.Net 2. Installez Saule à l'aide de NuGet :
Install-Package saule
Pour utiliser Saule, vous devez définir des ressources qui contiennent les informations sur votre domaine :
public class PersonResource : ApiResource{ public PersonResource() { Attribute("FirstName"); Attribut("Nom"); Attribut("Âge"); BelongsTo<CompanyResource>("Job"); HasMany<PersonResource>("Amis"); }}classe publique CompanyResource : ApiResource{ public CompanyResource() { Attribute("Name"); Attribut("Nombre d'employés"); }}
Vous pouvez ensuite les utiliser pour sérialiser n'importe quelle classe dans Json Api (à condition que votre classe ait des propriétés portant les mêmes noms que dans votre modèle) :
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", " nom de famille": "Smith", "âge": 34 }, "relationships": { "job": { "links": { "self": "http://example.com/people/123/relationships/job/", "rated": "http://example .com/people/123/job/" }, "data": { "type": "société", "id": "456" } }, "friends": { "links": { "self": "http://example.com/people/123/relationships/friends/", "rated": "http://example.com/people/ 123/amis/" }, "données": [ { "type": "personne", "id": "789" } ] } } }, "inclus": [ { "type": "company", "id": "456", "attributs": { "name": "Awesome, Inc.", "number-of-employees": 24 } }, { "type": "personne", "id": "789", "attributs": { "first-name": "Sara", "last-name": "Jones", "age": 38 } } ], "links": { "self": "http://example.com/people/123" } }
La désérialisation fonctionne comme dans une API Web normale ; vous n'avez rien de spécial à faire pour que cela fonctionne.
Suivez les étapes ci-dessous pour créer une nouvelle version :
Créez une branche appelée release-v<version>
(par exemple release-v1.5
)
Augmentez le numéro de version dans appveyor.yml
dans master
Poussez les deux modifications et attendez la construction
Copiez les notes de version dans la description de la version sur Github
Publier la nouvelle version