forked from quarkusio/quarkus
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Introduce @UnwrapException for Quarkus REST
This allows users to configure exceptions whose cause will be checked against exception mappers. This capability already existed in Quarkus REST and was used to map some internal exceptions, but with the new annotation users can opt into the feature for whatever exceptions make sense for their use case. Closes: quarkusio#42089
- Loading branch information
Showing
4 changed files
with
247 additions
and
7 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
155 changes: 155 additions & 0 deletions
155
...t/java/io/quarkus/resteasy/reactive/server/test/customexceptions/UnwrapExceptionTest.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,155 @@ | ||
| package io.quarkus.resteasy.reactive.server.test.customexceptions; | ||
|
|
||
| import static io.quarkus.resteasy.reactive.server.test.ExceptionUtil.removeStackTrace; | ||
| import static io.restassured.RestAssured.when; | ||
|
|
||
| import java.util.function.Supplier; | ||
|
|
||
| import jakarta.ws.rs.Path; | ||
| import jakarta.ws.rs.core.Response; | ||
|
|
||
| import org.jboss.resteasy.reactive.server.ServerExceptionMapper; | ||
| import org.jboss.resteasy.reactive.server.UnwrapException; | ||
| import org.jboss.shrinkwrap.api.ShrinkWrap; | ||
| import org.jboss.shrinkwrap.api.spec.JavaArchive; | ||
| import org.junit.jupiter.api.Test; | ||
| import org.junit.jupiter.api.extension.RegisterExtension; | ||
|
|
||
| import io.quarkus.resteasy.reactive.server.test.ExceptionUtil; | ||
| import io.quarkus.test.QuarkusUnitTest; | ||
|
|
||
| public class UnwrapExceptionTest { | ||
|
|
||
| @RegisterExtension | ||
| static QuarkusUnitTest test = new QuarkusUnitTest() | ||
| .setArchiveProducer(new Supplier<>() { | ||
| @Override | ||
| public JavaArchive get() { | ||
| return ShrinkWrap.create(JavaArchive.class) | ||
| .addClasses(FirstException.class, SecondException.class, ThirdException.class, | ||
| FourthException.class, FifthException.class, SixthException.class, | ||
| Mappers.class, Resource.class, ExceptionUtil.class); | ||
| } | ||
| }); | ||
|
|
||
| @Test | ||
| public void testWrapperWithUnmappedException() { | ||
| when().get("/hello/iaeInSecond") | ||
| .then().statusCode(500); | ||
| } | ||
|
|
||
| @Test | ||
| public void testMappedExceptionWithoutUnwrappedWrapper() { | ||
| when().get("/hello/iseInFirst") | ||
| .then().statusCode(500); | ||
|
|
||
| when().get("/hello/iseInThird") | ||
| .then().statusCode(500); | ||
|
|
||
| when().get("/hello/iseInSixth") | ||
| .then().statusCode(500); | ||
| } | ||
|
|
||
| @Test | ||
| public void testWrapperWithMappedException() { | ||
| when().get("/hello/iseInSecond") | ||
| .then().statusCode(900); | ||
|
|
||
| when().get("/hello/iseInFourth") | ||
| .then().statusCode(900); | ||
|
|
||
| when().get("/hello/iseInFifth") | ||
| .then().statusCode(900); | ||
| } | ||
|
|
||
| @Path("hello") | ||
| public static class Resource { | ||
|
|
||
| @Path("iseInFirst") | ||
| public String throwsISEAsCauseOfFirstException() { | ||
| throw removeStackTrace(new FirstException(removeStackTrace(new IllegalStateException("dummy")))); | ||
| } | ||
|
|
||
| @Path("iseInSecond") | ||
| public String throwsISEAsCauseOfSecondException() { | ||
| throw removeStackTrace(new SecondException(removeStackTrace(new IllegalStateException("dummy")))); | ||
| } | ||
|
|
||
| @Path("iaeInSecond") | ||
| public String throwsIAEAsCauseOfSecondException() { | ||
| throw removeStackTrace(new SecondException(removeStackTrace(new IllegalArgumentException("dummy")))); | ||
| } | ||
|
|
||
| @Path("iseInThird") | ||
| public String throwsISEAsCauseOfThirdException() throws ThirdException { | ||
| throw removeStackTrace(new ThirdException(removeStackTrace(new IllegalStateException("dummy")))); | ||
| } | ||
|
|
||
| @Path("iseInFourth") | ||
| public String throwsISEAsCauseOfFourthException() throws FourthException { | ||
| throw removeStackTrace(new FourthException(removeStackTrace(new IllegalStateException("dummy")))); | ||
| } | ||
|
|
||
| @Path("iseInFifth") | ||
| public String throwsISEAsCauseOfFifthException() { | ||
| throw removeStackTrace(new FifthException(removeStackTrace(new IllegalStateException("dummy")))); | ||
| } | ||
|
|
||
| @Path("iseInSixth") | ||
| public String throwsISEAsCauseOfSixthException() { | ||
| throw removeStackTrace(new SixthException(removeStackTrace(new IllegalStateException("dummy")))); | ||
| } | ||
| } | ||
|
|
||
| @UnwrapException({ FourthException.class, FifthException.class }) | ||
| public static class Mappers { | ||
|
|
||
| @ServerExceptionMapper | ||
| public Response handleIllegalStateException(IllegalStateException e) { | ||
| return Response.status(900).build(); | ||
| } | ||
| } | ||
|
|
||
| public static class FirstException extends RuntimeException { | ||
|
|
||
| public FirstException(Throwable cause) { | ||
| super(cause); | ||
| } | ||
| } | ||
|
|
||
| @UnwrapException | ||
| public static class SecondException extends FirstException { | ||
|
|
||
| public SecondException(Throwable cause) { | ||
| super(cause); | ||
| } | ||
| } | ||
|
|
||
| public static class ThirdException extends Exception { | ||
|
|
||
| public ThirdException(Throwable cause) { | ||
| super(cause); | ||
| } | ||
| } | ||
|
|
||
| public static class FourthException extends SecondException { | ||
|
|
||
| public FourthException(Throwable cause) { | ||
| super(cause); | ||
| } | ||
| } | ||
|
|
||
| public static class FifthException extends RuntimeException { | ||
|
|
||
| public FifthException(Throwable cause) { | ||
| super(cause); | ||
| } | ||
| } | ||
|
|
||
| public static class SixthException extends RuntimeException { | ||
|
|
||
| public SixthException(Throwable cause) { | ||
| super(cause); | ||
| } | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
22 changes: 22 additions & 0 deletions
22
...tive/server/runtime/src/main/java/org/jboss/resteasy/reactive/server/UnwrapException.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,22 @@ | ||
| package org.jboss.resteasy.reactive.server; | ||
|
|
||
| import java.lang.annotation.ElementType; | ||
| import java.lang.annotation.Retention; | ||
| import java.lang.annotation.RetentionPolicy; | ||
| import java.lang.annotation.Target; | ||
|
|
||
| /** | ||
| * Used to configure that an exception (or exceptions) should be unwrapped during exception handling. | ||
| * <p> | ||
| * Unwrapping means that when an {@link Exception} of the configured type is thrown and no {@code jakarta.ws.rs.ext.ExceptionMapper} exists, | ||
| * then RESTEasy Reactive will attempt to locate an {@code ExceptionMapper} for the cause of the Exception. | ||
| */ | ||
| @Retention(RetentionPolicy.RUNTIME) | ||
| @Target(ElementType.TYPE) | ||
| public @interface UnwrapException { | ||
|
|
||
| /** | ||
| * If this is not set, the value is assumed to be the exception class where the annotation is placed | ||
| */ | ||
| Class<? extends Exception>[] value() default {}; | ||
| } |