From 6e22d4130acbfe2610c975649327edba22f82056 Mon Sep 17 00:00:00 2001 From: David Mueller Date: Fri, 17 Jan 2025 14:43:49 -0500 Subject: [PATCH] edits per review #7661 --- modules/ROOT/pages/rest-alternatives.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/rest-alternatives.adoc b/modules/ROOT/pages/rest-alternatives.adoc index dea3677bd..abf4d093d 100644 --- a/modules/ROOT/pages/rest-alternatives.adoc +++ b/modules/ROOT/pages/rest-alternatives.adoc @@ -15,9 +15,9 @@ Although REST is a widely adopted pattern for communications among microservices, Open Liberty supports alternative options that might be better suited for some application scenarios. These alternatives include GraphQL, gRPC, and WebSocket. -REST comes with tradeoffs in capability and performance that can make it a less than ideal solution for some use cases. Issues such as over-fetching and under-fetching of data, lack of real-time communication, and tight coupling between client and server can lead to performance and maintenance concerns for certain types of applications. To address these issues, you can use alternative protocols and frameworks that specifically address the shortcomings of REST. +REST is by far the most common architectural style for microservices, thanks to its simplicity, flexibility, and scalability. However, it comes with tradeoffs that can make it a less than ideal solution for some use cases. Issues such as over-fetching and under-fetching of data, lack of real-time communication, and tight coupling between client and server can lead to performance and maintenance concerns for certain types of applications. To address these issues, you can use alternative protocols and frameworks that specifically address the shortcomings of REST. -* xref:microprofile-graphql.adoc[GraphQL]: This open source data query and manipulation language for APIs directly addresses problems with over-fetching and under-fetching of data that might occur with REST APIs. +* xref:microprofile-graphql.adoc[GraphQL]: This open source query language and runtime can simplify retrieving data from multiple sources, such as APIs, databases, and other services. It directly addresses problems with over-fetching and under-fetching of data that might occur with REST APIs. * xref:web-socket.adoc[WebSocket]: This protocol enables real-time bidirectional communication between a server and one or more clients, which is not feasible in REST architecture. * xref:grpc-services.adoc[gRPC]: This framework provides efficient data serialization and multiplexing capabilities for high-performance applications that require high throughput and low latency. It also enables efficient communication between services and applications in various languages and platforms.