This project will no longer be maintained, use the Erudio.HATEOAS package as a replacement!
This is a smart library to implements HATEOAS pattern in your RESTFul API's, implemented based in this project.
Install-Package Tapioca.HATEOAS -Version 1.0.15
namespace RESTFulSampleServer.Data.VO
{
public class BookVO : ISupportsHyperMedia
{
public long? Id { get; set; }
public string Title { get; set; }
public string Author { get; set; }
public decimal Price { get; set; }
public DateTime LaunchDate { get; set; }
public List<HyperMediaLink> Links { get; set; } = new List<HyperMediaLink>();
}
}
namespace RESTFulSampleServer.HyperMedia.Enricher
{
public class BookEnricher : ContentResponseEnricher<BookVO>
{
protected override Task EnrichModel(BookVO content, IUrlHelper urlHelper)
{
var path = "api/book";
string link = GetLink(content.Id, urlHelper, path);
content.Links.Add(new HyperMediaLink()
{
Action = HttpActionVerb.GET,
Href = link,
Rel = RelationType.self,
Type = ResponseTypeFormat.DefaultGet
});
content.Links.Add(new HyperMediaLink()
{
Action = HttpActionVerb.POST,
Href = link,
Rel = RelationType.self,
Type = ResponseTypeFormat.DefaultPost
});
content.Links.Add(new HyperMediaLink()
{
Action = HttpActionVerb.PUT,
Href = link,
Rel = RelationType.self,
Type = ResponseTypeFormat.DefaultPut
});
content.Links.Add(new HyperMediaLink()
{
Action = HttpActionVerb.DELETE,
Href = link,
Rel = RelationType.self,
Type = "int"
});
return Task.CompletedTask;
}
private string GetLink(long id, IUrlHelper urlHelper, string path)
{
lock (this)
{
var url = new { controller = path, id };
return new StringBuilder(urlHelper.Link("DefaultApi", url)).Replace("%2F", "/").ToString();
};
}
}
}
namespace RESTFulSampleServer.Controllers
{
[ApiVersion("1")]
[ApiController]
[Authorize("Bearer")]
[Route("api/[controller]/v{version:apiVersion}")]
public class BookController : ControllerBase
{
private readonly ILogger<BookController> _logger;
private IBookBusiness _bookBusiness;
public BookController(ILogger<BookController> logger, IBookBusiness bookBusiness)
{
_logger = logger;
_bookBusiness = bookBusiness;
}
[HttpGet]
[ProducesResponseType((200), Type = typeof(List<BookVO>))]
[ProducesResponseType(204)]
[ProducesResponseType(400)]
[ProducesResponseType(401)]
// Adds HyperMedia filter
[TypeFilter(typeof(HyperMediaFilter))]
public IActionResult Get()
{
return Ok(_bookBusiness.FindAll());
}
[HttpGet("{id}")]
[ProducesResponseType((200), Type = typeof(BookVO))]
[ProducesResponseType(204)]
[ProducesResponseType(400)]
[ProducesResponseType(401)]
// Adds HyperMedia filter
[TypeFilter(typeof(HyperMediaFilter))]
public IActionResult Get(long id)
{
var book = _bookBusiness.FindByID(id);
if (book == null) return NotFound();
return Ok(book);
}
[HttpPost]
[ProducesResponseType((200), Type = typeof(BookVO))]
[ProducesResponseType(400)]
[ProducesResponseType(401)]
// Adds HyperMedia filter
[TypeFilter(typeof(HyperMediaFilter))]
public IActionResult Post([FromBody] BookVO book)
{
if (book == null) return BadRequest();
return Ok(_bookBusiness.Create(book));
}
[HttpPut]
[ProducesResponseType((200), Type = typeof(BookVO))]
[ProducesResponseType(400)]
[ProducesResponseType(401)]
// Adds HyperMedia filter
[TypeFilter(typeof(HyperMediaFilter))]
public IActionResult Put([FromBody] BookVO book)
{
if (book == null) return BadRequest();
return Ok(_bookBusiness.Update(book));
}
[HttpDelete("{id}")]
[ProducesResponseType(204)]
[ProducesResponseType(400)]
[ProducesResponseType(401)]
public IActionResult Delete(long id)
{
_bookBusiness.Delete(id);
return NoContent();
}
}
}
var filterOptions = new HyperMediaFilterOptions();
filterOptions.ContentResponseEnricherList.Add(new PersonEnricher());
filterOptions.ContentResponseEnricherList.Add(new BookEnricher());
app.MapControllers();
* app.MapControllerRoute("DefaultApi", "{controller=values}/v{version=apiVersion}/{id?}"); *
app.Run();
[
{
"id": 1,
"title": "Working effectively with legacy code",
"author": "Michael C. Feathers",
"price": 49.00,
"launchDate": "2017-11-29T13:50:05.878",
"links": [
{
"rel": "self",
"href": "https://localhost:44300/api/book/v1/1",
"type": "application/json",
"action": "GET"
},
{
"rel": "self",
"href": "https://localhost:44300/api/book/v1/1",
"type": "application/json",
"action": "POST"
},
{
"rel": "self",
"href": "https://localhost:44300/api/book/v1/1",
"type": "application/json",
"action": "PUT"
},
{
"rel": "self",
"href": "https://localhost:44300/api/book/v1/1",
"type": "int",
"action": "DELETE"
}
]
},
{
"id": 2,
"title": "Design Patterns",
"author": "Ralph Johnson, Erich Gamma, John Vlissides e Richard Helm",
"price": 45.00,
"launchDate": "2017-11-29T15:15:13.636",
"links": [
{
"rel": "self",
"href": "https://localhost:44300/api/book/v1/2",
"type": "application/json",
"action": "GET"
},
{
"rel": "self",
"href": "https://localhost:44300/api/book/v1/2",
"type": "application/json",
"action": "POST"
},
{
"rel": "self",
"href": "https://localhost:44300/api/book/v1/2",
"type": "application/json",
"action": "PUT"
},
{
"rel": "self",
"href": "https://localhost:44300/api/book/v1/2",
"type": "int",
"action": "DELETE"
}
]
}
]
<ArrayOfBookVO xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<BookVO>
<Id>1</Id>
<Title>Working effectively with legacy code</Title>
<Author>Michael C. Feathers</Author>
<Price>49.00</Price>
<LaunchDate>2017-11-29T13:50:05.878</LaunchDate>
<Links>
<HyperMediaLink>
<Rel>self</Rel>
<Href>https://localhost:44300/api/book/v1/1</Href>
<Type>application/json</Type>
<Action>GET</Action>
</HyperMediaLink>
<HyperMediaLink>
<Rel>self</Rel>
<Href>https://localhost:44300/api/book/v1/1</Href>
<Type>application/json</Type>
<Action>POST</Action>
</HyperMediaLink>
<HyperMediaLink>
<Rel>self</Rel>
<Href>https://localhost:44300/api/book/v1/1</Href>
<Type>application/json</Type>
<Action>PUT</Action>
</HyperMediaLink>
<HyperMediaLink>
<Rel>self</Rel>
<Href>https://localhost:44300/api/book/v1/1</Href>
<Type>int</Type>
<Action>DELETE</Action>
</HyperMediaLink>
</Links>
</BookVO>
<BookVO>
<Id>2</Id>
<Title>Design Patterns</Title>
<Author>Ralph Johnson, Erich Gamma, John Vlissides e Richard Helm</Author>
<Price>45.00</Price>
<LaunchDate>2017-11-29T15:15:13.636</LaunchDate>
<Links>
<HyperMediaLink>
<Rel>self</Rel>
<Href>https://localhost:44300/api/book/v1/2</Href>
<Type>application/json</Type>
<Action>GET</Action>
</HyperMediaLink>
<HyperMediaLink>
<Rel>self</Rel>
<Href>https://localhost:44300/api/book/v1/2</Href>
<Type>application/json</Type>
<Action>POST</Action>
</HyperMediaLink>
<HyperMediaLink>
<Rel>self</Rel>
<Href>https://localhost:44300/api/book/v1/2</Href>
<Type>application/json</Type>
<Action>PUT</Action>
</HyperMediaLink>
<HyperMediaLink>
<Rel>self</Rel>
<Href>https://localhost:44300/api/book/v1/2</Href>
<Type>int</Type>
<Action>DELETE</Action>
</HyperMediaLink>
</Links>
</BookVO>
</ArrayOfBookVO>