Simply pushing harder within the old boundaries will not do. | ||
--Karl Weick |
How you go about designing your service interface will go a long way towards the long term success and stability of your overall service. As we saw in the last chapter, a well-built service should only reveal its location, available operations, and the messages it exchanges with clients. The service's internal plumbing should remain safely tucked away from those who intend to consume the interface. We will spend the majority of this chapter looking at how to practically implement a series of key schema and endpoint patterns.
In this chapter you will learn:
Good practices for building schemas that coincide with the service type you've chosen
When and how to build canonical schemas
The benefits and limits of schema reuse
How data types and node characteristics translate into client code
The ways to use generic schemas in your solutions
Strategies for building contract-first endpoints...