Fluent API
Faster development thanks to the Fluent API of Umbraco Commerce.
An added side effect of having ReadOnly and Writable entities is that all of an entity's write operations are now performed via methods. This is instead of property setters, enabling to us convert Umbraco Commerce's write API in a fluent API.
You could perform a write operation as follows:
_uowProvider.Execute(uow =>
{
// Fetch the currency
var currency = _currencyService.GetCurrency(currencyId);
// Convert the currency into it's Writable form
var writableCurrency = currency.AsWritable(uow);
// Perform the write operation
writableCurrency.SetName("New Name");
// Persist the changes to the database
_currencyService.SaveCurrency(currency);
// Close the transaction
uow.Complete();
});
This could be simplified further by defining these actions fluently, chaining all of the entity methods into a succinct command sequence as follows:
_uowProvider.Execute(uow =>
{
var currency = _currencyService.GetCurrency(currencyId)
.AsWritable(uow)
.SetName("New Name");
_currencyService.SaveCurrency(currency);
uow.Complete();
});
We know not everyone likes to write their code fluently and so the Umbraco Commerce Fluent API is an optional feature. Both code examples above are valid coding styles that will both work as well as each other. The Fluent API is an opt-in layer of syntax sugar that developers can use depending on their preferred style of coding.
Last modified 3mo ago