Cloud-Native Applications in Java

Naming and associations

The resource names are typically referring to the nouns extracted from the business domain. Once the nouns are identified, API contracts can be modeled as HTTP verbs against these nouns:

• The selection of the resource needs to account for the fine-grained versus coarse-grained model. Too fine-grained means too much chattiness, and coarse-grained means to narrow the focus resulting in support for variations. One can reason that by using the system versus the process API model to an extent. But the issue becomes, if the resources are too fine-grained, the number of system APIs rises leading to unmaintainable complexity.
• APIs are designed by looking at the needs of the consumer. Derive your API needs based on the customer ...