Making calls to service-layer APIs

The scenarios in this section describe how to make calls into service-layer APIs from other code. Typically this "other code" is façade-layer logic.

Whilst service-layer APIs can perform a wide variety of functionality, very typically the overwhelming majority of service-layer API calls are related to the reading or writing of database data. Accordingly, the scenarios in this section are described in terms of database tables.

These scenarios build up a typical façade which controls the

read;
insert;
modification;
removal;
cancellation; and
list

of a data stored on a database table.