From 89d1cac5c0f46572e7baec0d899d236200cafb11 Mon Sep 17 00:00:00 2001
From: Georgios Andrianakis <geoand@gmail.com>
Date: Wed, 13 Nov 2019 13:56:04 +0200
Subject: [PATCH] Add conversion table from Spring Web annotations to JAX-RS

---
 docs/src/main/asciidoc/spring-web.adoc | 48 ++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/docs/src/main/asciidoc/spring-web.adoc b/docs/src/main/asciidoc/spring-web.adoc
index 15078f950b7ba..c487581691b6f 100644
--- a/docs/src/main/asciidoc/spring-web.adoc
+++ b/docs/src/main/asciidoc/spring-web.adoc
@@ -247,6 +247,54 @@ Spring classes and annotations are only used for reading metadata and / or are u
 What that means for end users, is that adding arbitrary Spring libraries will not have any effect. Moreover Spring infrastructure
 classes (like `org.springframework.beans.factory.config.BeanPostProcessor` for example) will not be executed.
 
+== Conversion Table
+
+The following table shows how Spring Web annotations can be converted to JAX-RS annotations.
+
+|===
+|Spring |JAX-RS |Comments
+
+|@RequestController
+|
+|There is no equivalent in JAX-RS. Annotating a class with @Path suffices
+
+|@RequestMapping(path="/api")
+|@Path("/api")
+|
+
+|@RequestMapping(consumes="application/json")
+|@Consumes("application/json")
+|
+
+|@RequestMapping(produces="application/json")
+|@Produces("application/json")
+|
+
+|@RequestParam
+|@QueryParam
+|
+
+|@PathVariable
+|@PathParam
+|
+
+|@RequestBody
+|
+|No equivalent in JAX-RS. Method parameters corresponding to the body of the request are handled in JAX-RS without requiring any annotation
+
+|@RestControllerAdvice
+|
+|No equivalent in JAX-RS
+
+|@ResponseStatus
+|
+|No equivalent in JAX-RS
+
+|@ExceptionHandler
+|
+|No equivalent annotation in JAX-RS. Exceptions are handled by implementing `javax.ws.rs.ext.ExceptionMapper`
+|===
+
 == More Spring guides
 
 Quarkus support has more Spring compatibility features. See the following guides for more details: