Document Jersey's package scanning limitations

Closes gh-7496
2016-11-28 11:22:13 +00:00 · 2016-11-28 11:22:13 +00:00 · 491bd745de
parent 5e604437d7
commit 491bd745de
1 changed files with 6 additions and 0 deletions
--- a/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc
+++ b/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc
@ -2097,6 +2097,12 @@ all the endpoints:
 	}
 ----

+WARNING: Jersey's support for scanning executable archives is rather limited. For example,
+it cannot scan for endpoints in a package found in `WEB-INF/classes` when running an
+executable war file. To avoid this limitation, the `packages` method should not be used
+and endpoints should be registered individually using the `register` method as shown
+above.
+
 You can also register an arbitrary number of beans implementing `ResourceConfigCustomizer`
 for more advanced customizations.