This is an automated email from the ASF dual-hosted git repository.
jamesbognar pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/juneau.git
The following commit(s) were added to refs/heads/master by this push:
new f6c17c9 Javadocs
f6c17c9 is described below
commit f6c17c995929a54ed4696ed0fab4d434072cb6e3
Author: JamesBognar <[email protected]>
AuthorDate: Mon May 13 20:05:47 2019 -0400
Javadocs
---
.../{16.Transforms.html => 17.Transforms.html} | 0
.../{17.URIs.html => 18.URIs.html} | 0
.../{18.Guards.html => 19.Guards.html} | 0
.../{19.Converters.html => 20.Converters.html} | 0
.../{20.Messages.html => 21.Messages.html} | 0
.../{21.Encoders.html => 22.Encoders.html} | 0
.../{22.SvlVariables.html => 23.SvlVariables.html} | 0
...rationFiles.html => 24.ConfigurationFiles.html} | 0
.../{24.StaticFiles.html => 25.StaticFiles.html} | 0
...entVersioning.html => 26.ClientVersioning.html} | 0
...tInfoProvider.html => 27.RestInfoProvider.html} | 0
.../01.BasicRestInfoProvider.html | 0
.../{27.Swagger.html => 28.Swagger.html} | 0
.../01.BasicRestServlet.html | 0
.../02.BasicSwaggerInfo.html | 0
.../{27.Swagger => 28.Swagger}/03.Tags.html | 0
.../{27.Swagger => 28.Swagger}/04.Operations.html | 0
.../{27.Swagger => 28.Swagger}/05.Parameters.html | 0
.../06.ParameterExamples.html | 0
.../{27.Swagger => 28.Swagger}/07.Responses.html | 0
.../08.ResponseExamples.html | 0
.../{27.Swagger => 28.Swagger}/09.Models.html | 0
.../{27.Swagger => 28.Swagger}/10.Stylesheet.html | 0
.../juneau-rest-server.Swagger.Models.1.png | Bin
.../juneau-rest-server.Swagger.Models.2.png | Bin
.../juneau-rest-server.Swagger.Models.3.png | Bin
.../juneau-rest-server.Swagger.Operations.1.png | Bin
.../juneau-rest-server.Swagger.Operations.2.png | Bin
.../juneau-rest-server.Swagger.Operations.3.png | Bin
.../juneau-rest-server.Swagger.Parameters.1.png | Bin
.../juneau-rest-server.Swagger.Parameters.2.png | Bin
.../juneau-rest-server.Swagger.Parameters.3.png | Bin
.../juneau-rest-server.Swagger.Parameters.4.png | Bin
...neau-rest-server.Swagger.ResponseExamples.1.png | Bin
...neau-rest-server.Swagger.ResponseExamples.2.png | Bin
...neau-rest-server.Swagger.ResponseExamples.3.png | Bin
...neau-rest-server.Swagger.ResponseExamples.4.png | Bin
...ocAnnotation.html => 29.HtmlDocAnnotation.html} | 0
.../01.UIvsDI.html | 0
.../02.Widgets.html | 0
.../03.PredefinedWidgets.html | 0
.../04.UiCustomization.html | 0
.../05.Stylesheets.html | 0
...erver.HtmlDocAnnotation.PredefinedWidgets.1.png | Bin
...erver.HtmlDocAnnotation.PredefinedWidgets.2.png | Bin
...erver.HtmlDocAnnotation.PredefinedWidgets.3.png | Bin
...erver.HtmlDocAnnotation.PredefinedWidgets.4.png | Bin
....DefaultHeaders.html => 30.DefaultHeaders.html} | 0
...ndling.html => 31.LoggingAndErrorHandling.html} | 0
...ttpStatusCodes.html => 32.HttpStatusCodes.html} | 0
...Methods.html => 33.OverloadingHttpMethods.html} | 0
...InParameters.html => 34.BuiltInParameters.html} | 0
...rs.html => 35.CustomSerializersAndParsers.html} | 0
...35.UsingWithOsgi.html => 36.UsingWithOsgi.html} | 0
.../{36.Injection.html => 37.Injection.html} | 0
.../{37.HTTP2.html => 38.HTTP2.html} | 0
.../{38.OtherNotes.html => 39.OtherNotes.html} | 0
juneau-doc/src/main/javadoc/overview.html | 753 +++++++++++++--------
juneau-doc/src/main/javadoc/resources/docs.txt | 17 +-
.../src/main/javadoc/resources/fragments/toc.html | 26 +-
60 files changed, 480 insertions(+), 316 deletions(-)
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/16.Transforms.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/17.Transforms.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/16.Transforms.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/17.Transforms.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/17.URIs.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/18.URIs.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/17.URIs.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/18.URIs.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/18.Guards.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/19.Guards.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/18.Guards.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/19.Guards.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/19.Converters.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/20.Converters.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/19.Converters.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/20.Converters.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/20.Messages.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/21.Messages.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/20.Messages.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/21.Messages.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/21.Encoders.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/22.Encoders.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/21.Encoders.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/22.Encoders.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/22.SvlVariables.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/23.SvlVariables.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/22.SvlVariables.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/23.SvlVariables.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/23.ConfigurationFiles.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/24.ConfigurationFiles.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/23.ConfigurationFiles.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/24.ConfigurationFiles.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/24.StaticFiles.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/25.StaticFiles.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/24.StaticFiles.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/25.StaticFiles.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/25.ClientVersioning.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/26.ClientVersioning.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/25.ClientVersioning.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/26.ClientVersioning.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/26.RestInfoProvider.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/27.RestInfoProvider.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/26.RestInfoProvider.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/27.RestInfoProvider.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/26.RestInfoProvider/01.BasicRestInfoProvider.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/27.RestInfoProvider/01.BasicRestInfoProvider.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/26.RestInfoProvider/01.BasicRestInfoProvider.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/27.RestInfoProvider/01.BasicRestInfoProvider.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/01.BasicRestServlet.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/01.BasicRestServlet.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/01.BasicRestServlet.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/01.BasicRestServlet.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/02.BasicSwaggerInfo.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/02.BasicSwaggerInfo.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/02.BasicSwaggerInfo.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/02.BasicSwaggerInfo.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/03.Tags.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/03.Tags.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/03.Tags.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/03.Tags.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/04.Operations.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/04.Operations.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/04.Operations.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/04.Operations.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/05.Parameters.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/05.Parameters.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/05.Parameters.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/05.Parameters.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/06.ParameterExamples.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/06.ParameterExamples.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/06.ParameterExamples.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/06.ParameterExamples.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/07.Responses.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/07.Responses.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/07.Responses.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/07.Responses.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/08.ResponseExamples.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/08.ResponseExamples.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/08.ResponseExamples.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/08.ResponseExamples.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/09.Models.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/09.Models.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/09.Models.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/09.Models.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/10.Stylesheet.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/10.Stylesheet.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/10.Stylesheet.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/10.Stylesheet.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Models.1.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Models.1.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Models.1.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Models.1.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Models.2.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Models.2.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Models.2.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Models.2.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Models.3.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Models.3.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Models.3.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Models.3.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Operations.1.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Operations.1.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Operations.1.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Operations.1.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Operations.2.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Operations.2.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Operations.2.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Operations.2.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Operations.3.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Operations.3.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Operations.3.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Operations.3.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.1.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.1.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.1.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.1.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.2.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.2.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.2.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.2.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.3.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.3.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.3.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.3.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.4.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.4.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.4.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.Parameters.4.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.1.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.1.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.1.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.1.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.2.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.2.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.2.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.2.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.3.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.3.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.3.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.3.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.4.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.4.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/27.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.4.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/28.Swagger/doc-files/juneau-rest-server.Swagger.ResponseExamples.4.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/01.UIvsDI.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/01.UIvsDI.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/01.UIvsDI.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/01.UIvsDI.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/02.Widgets.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/02.Widgets.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/02.Widgets.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/02.Widgets.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/03.PredefinedWidgets.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/03.PredefinedWidgets.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/03.PredefinedWidgets.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/03.PredefinedWidgets.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/04.UiCustomization.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/04.UiCustomization.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/04.UiCustomization.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/04.UiCustomization.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/05.Stylesheets.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/05.Stylesheets.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/05.Stylesheets.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/05.Stylesheets.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.1.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.1.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.1.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.1.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.2.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.2.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.2.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.2.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.3.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.3.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.3.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.3.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.4.png
b/juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.4.png
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/28.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.4.png
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/29.HtmlDocAnnotation/doc-files/juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets.4.png
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/29.DefaultHeaders.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/30.DefaultHeaders.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/29.DefaultHeaders.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/30.DefaultHeaders.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/30.LoggingAndErrorHandling.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/31.LoggingAndErrorHandling.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/30.LoggingAndErrorHandling.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/31.LoggingAndErrorHandling.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/31.HttpStatusCodes.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/32.HttpStatusCodes.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/31.HttpStatusCodes.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/32.HttpStatusCodes.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/32.OverloadingHttpMethods.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/33.OverloadingHttpMethods.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/32.OverloadingHttpMethods.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/33.OverloadingHttpMethods.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/33.BuiltInParameters.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/34.BuiltInParameters.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/33.BuiltInParameters.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/34.BuiltInParameters.html
diff --git
a/juneau-doc/docs/Topics/07.juneau-rest-server/34.CustomSerializersAndParsers.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/35.CustomSerializersAndParsers.html
similarity index 100%
rename from
juneau-doc/docs/Topics/07.juneau-rest-server/34.CustomSerializersAndParsers.html
rename to
juneau-doc/docs/Topics/07.juneau-rest-server/35.CustomSerializersAndParsers.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/35.UsingWithOsgi.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/36.UsingWithOsgi.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/35.UsingWithOsgi.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/36.UsingWithOsgi.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/36.Injection.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/37.Injection.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/36.Injection.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/37.Injection.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/37.HTTP2.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/38.HTTP2.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/37.HTTP2.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/38.HTTP2.html
diff --git a/juneau-doc/docs/Topics/07.juneau-rest-server/38.OtherNotes.html
b/juneau-doc/docs/Topics/07.juneau-rest-server/39.OtherNotes.html
similarity index 100%
rename from juneau-doc/docs/Topics/07.juneau-rest-server/38.OtherNotes.html
rename to juneau-doc/docs/Topics/07.juneau-rest-server/39.OtherNotes.html
diff --git a/juneau-doc/src/main/javadoc/overview.html
b/juneau-doc/src/main/javadoc/overview.html
index 91bf648..a41b006 100644
--- a/juneau-doc/src/main/javadoc/overview.html
+++ b/juneau-doc/src/main/javadoc/overview.html
@@ -100,9 +100,9 @@
<li><p class=''><a class='doclink'
href='#juneau-marshall.Transforms.TemplatedSwaps'>Templated Swaps</a></p>
<li><p class=''><a class='doclink'
href='#juneau-marshall.Transforms.SwapMethods'>Swap Methods</a></p>
<li><p class=''><a class='doclink'
href='#juneau-marshall.Transforms.SurrogateClasses'>Surrogate Classes</a></p>
- <li><p class=''><a class='doclink'
href='#juneau-marshall.Transforms.BeanAnnotation'>@BeanProperty
Annotation</a></p>
- <li><p class=''><a class='doclink'
href='#juneau-marshall.Transforms.BeanPropertyAnnotation'>@BeanProperty
Annotation</a></p>
- <li><p class=''><a class='doclink'
href='#juneau-marshall.Transforms.BeanConstructorAnnotation'>@BeanConstructor
Annotation</a></p>
+ <li><p class=''><a class='doclink'
href='#juneau-marshall.Transforms.BeanAnnotation'>@Bean Annotation</a></p>
+ <li><p class='updated'><a class='doclink'
href='#juneau-marshall.Transforms.BeanPropertyAnnotation'>@BeanProperty
Annotation</a></p>
+ <li><p class='updated'><a class='doclink'
href='#juneau-marshall.Transforms.BeanConstructorAnnotation'>@BeanConstructor
Annotation</a></p>
<li><p class=''><a class='doclink'
href='#juneau-marshall.Transforms.BeanIgnoreAnnotation'>@BeanIgnore
Annotation</a></p>
<li><p class=''><a class='doclink'
href='#juneau-marshall.Transforms.NamePropertyAnnotation'>@NameProperty
Annotation</a></p>
<li><p class=''><a class='doclink'
href='#juneau-marshall.Transforms.ParentPropertyAnnotation'>@ParentProperty
Annotation</a></p>
@@ -204,8 +204,9 @@
<li><p class='toc2'><a class='doclink'
href='#juneau-svl'>juneau-svl</a></p>
<ol>
<li><p class=''><a class='doclink'
href='#juneau-svl.SimpleVarLanguage'>Simple Variable Language</a></p>
- <li><p class=''><a class='doclink'
href='#juneau-svl.SvlVariables'>SVL Variables</a></p>
+ <li><p class='updated'><a class='doclink'
href='#juneau-svl.SvlVariables'>SVL Variables</a></p>
<li><p class=''><a class='doclink'
href='#juneau-svl.VarResolvers'>VarResolvers and VarResolverSessions</a></p>
+ <li><p class='new'><a class='doclink'
href='#juneau-svl.DefaultVarResolver'>VarResolver.DEFAULT</a></p>
<li><p class=''><a class='doclink'
href='#juneau-svl.OtherNotes'>Other Notes</a></p>
</ol>
<li><p class='toc2'><a class='doclink'
href='#juneau-config'>juneau-config</a></p>
@@ -248,7 +249,7 @@
</ol>
<li><p class=''><a class='doclink'
href='#juneau-config.ReadOnlyConfigs'>Read-only Configs</a></p>
<li><p class=''><a class='doclink'
href='#juneau-config.ClosingConfigs'>Closing Configs</a></p>
- <li><p class=''><a class='doclink'
href='#juneau-config.SystemDefaultConfig'>System Default Config</a></p>
+ <li><p class='updated'><a class='doclink'
href='#juneau-config.SystemDefaultConfig'>System Default Config</a></p>
</ol>
<li><p class='toc2'><a class='doclink'
href='#juneau-rest-server'>juneau-rest-server</a></p>
<ol>
@@ -257,7 +258,7 @@
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Instantiation'>Instantiation</a></p>
<ol>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Instantiation.RestServlet'>RestServlet</a></p>
- <li><p class=''><a class='doclink'
href='#juneau-rest-server.Instantiation.BasicRestServlet'>BasicRestServlet</a></p>
+ <li><p class='updated'><a class='doclink'
href='#juneau-rest-server.Instantiation.BasicRestServlet'>BasicRestServlet</a></p>
<li><p class='new'><a class='doclink'
href='#juneau-rest-server.Instantiation.BasicRest'>BasicRest</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Instantiation.Children'>Children</a></p>
<li><p class='updated'><a class='doclink'
href='#juneau-rest-server.Instantiation.BasicRestServletGroup'>BasicRestServletGroup</a></p>
@@ -311,6 +312,7 @@
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Serializers'>Serializers</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Parsers'>Parsers</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Properties'>Properties</a></p>
+ <li><p class='new'><a class='doclink'
href='#juneau-rest-server.ConfigAnnotations'>Config annotations</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Transforms'>Transforms</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.URIs'>URIs</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Guards'>Guards</a></p>
@@ -327,24 +329,24 @@
</ol>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Swagger'>Swagger</a></p>
<ol>
- <li><p class=''><a class='doclink'
href='#juneau-rest-server.Swagger.BasicRestServlet'>BasicRestServlet</a></p>
+ <li><p class='updated'><a class='doclink'
href='#juneau-rest-server.Swagger.BasicRestServlet'>BasicRestServlet</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Swagger.BasicSwaggerInfo'>Basic Swagger Info</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Swagger.Tags'>Tags</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Swagger.Operations'>Operations</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Swagger.Parameters'>Parameters</a></p>
- <li><p class=''><a class='doclink'
href='#juneau-rest-server.Swagger.ParameterExamples'>Parameter Examples</a></p>
+ <li><p class='updated'><a class='doclink'
href='#juneau-rest-server.Swagger.ParameterExamples'>Parameter Examples</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Swagger.Responses'>Responses</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Swagger.ResponseExamples'>Response Examples</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Swagger.Models'>Models</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.Swagger.Stylesheet'>SwaggerUI.css</a></p>
</ol>
- <li><p class=''><a class='doclink'
href='#juneau-rest-server.HtmlDocAnnotation'>@HtmlDoc</a></p>
+ <li><p class='updated'><a class='doclink'
href='#juneau-rest-server.HtmlDocAnnotation'>@HtmlDocConfig</a></p>
<ol>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.HtmlDocAnnotation.UIvsDI'>User Interfaces (UI) vs.
Developer Interfaces (DI)</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.HtmlDocAnnotation.Widgets'>Widgets</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets'>Predefined
Widgets</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.HtmlDocAnnotation.UiCustomization'>UI
Customization</a></p>
- <li><p class=''><a class='doclink'
href='#juneau-rest-server.HtmlDocAnnotation.Stylesheets'>Stylesheets</a></p>
+ <li><p class='updated'><a class='doclink'
href='#juneau-rest-server.HtmlDocAnnotation.Stylesheets'>Stylesheets</a></p>
</ol>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.DefaultHeaders'>Default Headers</a></p>
<li><p class=''><a class='doclink'
href='#juneau-rest-server.LoggingAndErrorHandling'>Logging and Error
Handling</a></p>
@@ -443,10 +445,10 @@
</ol>
<li><p class='toc2'><a class='doclink'
href='#juneau-examples-rest'>juneau-examples-rest</a></p>
<ol>
- <li><p class=''><a class='doclink'
href='#juneau-examples-rest.RootResources'>RootResources</a></p>
+ <li><p class='updated'><a class='doclink'
href='#juneau-examples-rest.RootResources'>RootResources</a></p>
<li><p class=''><a class='doclink'
href='#juneau-examples-rest.HelloWorldResource'>HelloWorldResource</a></p>
<li><p class=''><a class='doclink'
href='#juneau-examples-rest.PetStoreResource'>PetStore</a></p>
- <li><p class=''><a class='doclink'
href='#juneau-examples-rest.DtoExamples'>DtoExamples</a></p>
+ <li><p class='updated'><a class='doclink'
href='#juneau-examples-rest.DtoExamples'>DtoExamples</a></p>
<li><p class=''><a class='doclink'
href='#juneau-examples-rest.ConfigResource'>ConfigResource</a></p>
<li><p class=''><a class='doclink'
href='#juneau-examples-rest.LogsResource'>LogsResource</a></p>
</ol>
@@ -2470,7 +2472,7 @@
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-marshall.Transforms.BeanAnnotation'
id='juneau-marshall.Transforms.BeanAnnotation'>2.10.8 - @BeanProperty
Annotation</a></h4>
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-marshall.Transforms.BeanAnnotation'
id='juneau-marshall.Transforms.BeanAnnotation'>2.10.8 - @Bean
Annotation</a></h4>
<div class='topic'><!-- START: 2.10.8 -
juneau-marshall.Transforms.BeanAnnotation -->
<p>
The {@link org.apache.juneau.annotation.Bean @Bean} annotation is used
to tailor how beans are
@@ -2608,7 +2610,7 @@
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-marshall.Transforms.BeanPropertyAnnotation'
id='juneau-marshall.Transforms.BeanPropertyAnnotation'>2.10.9 - @BeanProperty
Annotation</a></h4>
+<h4 class='topic updated' onclick='toggle(this)'><a
href='#juneau-marshall.Transforms.BeanPropertyAnnotation'
id='juneau-marshall.Transforms.BeanPropertyAnnotation'>2.10.9 - @BeanProperty
Annotation</a></h4>
<div class='topic'><!-- START: 2.10.9 -
juneau-marshall.Transforms.BeanPropertyAnnotation -->
<p>
The {@link org.apache.juneau.annotation.BeanProperty @BeanProperty}
annotation is used to tailor how
@@ -2625,6 +2627,15 @@
}
</p>
<p>
+ The {@link org.apache.juneau.annoation.Name @Name} annotation is a
shortcut for specifying a bean property name:
+</p>
+<p class='bpcode w800'>
+ <jk>public class</jk> MyBean {
+ <ja>@Name</ja>(<js>"Bar"</js>)
+ <jk>public</jk> String getFoo() {...}
+ }
+</p>
+<p>
If the {@link org.apache.juneau.BeanContext#BEAN_beanFieldVisibility}
setting on the bean context excludes this field
(e.g. the visibility is set to the default of PUBLIC, but the field is
PROTECTED), this annotation
can be used to force the field to be identified as a property.
@@ -2797,7 +2808,7 @@
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-marshall.Transforms.BeanConstructorAnnotation'
id='juneau-marshall.Transforms.BeanConstructorAnnotation'>2.10.10 -
@BeanConstructor Annotation</a></h4>
+<h4 class='topic updated' onclick='toggle(this)'><a
href='#juneau-marshall.Transforms.BeanConstructorAnnotation'
id='juneau-marshall.Transforms.BeanConstructorAnnotation'>2.10.10 -
@BeanConstructor Annotation</a></h4>
<div class='topic'><!-- START: 2.10.10 -
juneau-marshall.Transforms.BeanConstructorAnnotation -->
<p>
The {@link org.apache.juneau.annotation.BeanConstructor
@BeanConstructor} annotation is used to
@@ -2842,6 +2853,20 @@
<p>
Beans can also be defined with a combination of read-only and
read-write properties.
</p>
+<p>
+ The {@link org.apache.juneau.annotation.Name @Name} annotation can also
be used instead of <code><ja>@BeanConstructor</ja>(properties)</code>:
+</p>
+<p class='bpcode w800'>
+ <ja>@BeanConstructor</ja>
+ <jk>public</jk> Person(<ja>@Name</ja>(<js>"name"</js>) String name,
<ja>@Name</ja>(<js>"age"</js>) <jk>int</jk> age) {
+ <jk>this</jk>.<jf>name</jf> = name;
+ <jk>this</jk>.<jf>age</jf> = age;
+ }
+</p>
+<p>
+ If neither <code><ja>@BeanConstructor</ja>(properties)</code> or
<ja>@Name</ja> is used to identify the bean property names,
+ we will try to use the parameter names if they are available in the
bytecode.
+</p>
</div><!-- END: 2.10.10 - juneau-marshall.Transforms.BeanConstructorAnnotation
-->
<!--
====================================================================================================
-->
@@ -10949,7 +10974,7 @@
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-svl.SvlVariables'
id='juneau-svl.SvlVariables'>5.2 - SVL Variables</a></h3>
+<h3 class='topic updated' onclick='toggle(this)'><a
href='#juneau-svl.SvlVariables' id='juneau-svl.SvlVariables'>5.2 - SVL
Variables</a></h3>
<div class='topic'><!-- START: 5.2 - juneau-svl.SvlVariables -->
<p>
Variables are defined through the {@link org.apache.juneau.svl.Var} API.
@@ -11069,6 +11094,10 @@
<td>{@link org.apache.juneau.svl.vars.SubstringVar}</td>
<td class='code'>$ST{arg,start[,end]}</td>
</tr>
+ <tr class='dark'>
+ <td>{@link org.apache.juneau.html.HtmlWidgetVar}</td>
+ <td class='code'>$W{name}</td>
+ </tr>
<tr class='light dd'>
<td rowspan='1'
style='text-align:center;font-weight:bold;padding:20px;'
class='code'>juneau-config</td>
<td>{@link org.apache.juneau.config.vars.ConfigVar}</td>
@@ -11132,7 +11161,7 @@
<td class='code'>$UE{uriPart}</td>
</tr>
<tr class='dark dd'>
- <td>{@link org.apache.juneau.rest.vars.WidgetVar}</td>
+ <td>{@link org.apache.juneau.rest.vars.WidgetVar}
<i>(deprecated)</i></td>
<td class='code'>$W{name}</td>
</tr>
</table>
@@ -11202,8 +11231,34 @@
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-svl.OtherNotes'
id='juneau-svl.OtherNotes'>5.4 - Other Notes</a></h3>
-<div class='topic'><!-- START: 5.4 - juneau-svl.OtherNotes -->
+<h3 class='topic new' onclick='toggle(this)'><a
href='#juneau-svl.DefaultVarResolver' id='juneau-svl.DefaultVarResolver'>5.4 -
VarResolver.DEFAULT</a></h3>
+<div class='topic'><!-- START: 5.4 - juneau-svl.DefaultVarResolver -->
+<p>
+ {@link org.apache.juneau.svl.VarResolver#DEFAULT} is a reusable
variable resolver with default support for the following variables:
+</p>
+<ul>
+ <li><code>$S{key[,default]}</code> - {@link
org.apache.juneau.svl.vars.SystemPropertiesVar}
+ <li><code>$E{key[,default]}</code> - {@link
org.apache.juneau.svl.vars.EnvVariablesVar}
+ <li><code>$A{key[,default]}</code> - {@link
org.apache.juneau.svl.vars.ArgsVar}
+ <li><code>$MF{key[,default]}</code> - {@link
org.apache.juneau.svl.vars.ManifestFileVar}
+
<li><code>$SW{stringArg,pattern:thenValue[,pattern:thenValue...]}</code> -
{@link org.apache.juneau.svl.vars.SwitchVar}
+ <li><code>$IF{arg,then[,else]}</code> - {@link
org.apache.juneau.svl.vars.IfVar}
+ <li><code>$CO{arg[,arg2...]}</code> - {@link
org.apache.juneau.svl.vars.CoalesceVar}
+ <li><code>$PM{arg,pattern}</code> - {@link
org.apache.juneau.svl.vars.PatternMatchVar}
+ <li><code>$PR{stringArg,pattern,replace}</code>- {@link
org.apache.juneau.svl.vars.PatternReplaceVar}
+ <li><code>$PE{arg,pattern,groupIndex}</code> - {@link
org.apache.juneau.svl.vars.PatternExtractVar}
+ <li><code>$UC{arg}</code> - {@link
org.apache.juneau.svl.vars.UpperCaseVar}
+ <li><code>$LC{arg}</code> - {@link
org.apache.juneau.svl.vars.LowerCaseVar}
+ <li><code>$NE{arg}</code> - {@link
org.apache.juneau.svl.vars.NotEmptyVar}
+ <li><code>$LN{arg[,delimiter]}</code> - {@link
org.apache.juneau.svl.vars.LenVar}
+ <li><code>$ST{arg,start[,end]}</code> - {@link
org.apache.juneau.svl.vars.SubstringVar}
+</ul>
+</div><!-- END: 5.4 - juneau-svl.DefaultVarResolver -->
+
+<!--
====================================================================================================
-->
+
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-svl.OtherNotes'
id='juneau-svl.OtherNotes'>5.5 - Other Notes</a></h3>
+<div class='topic'><!-- START: 5.5 - juneau-svl.OtherNotes -->
<ul class='spaced-list'>
<li>
The escape character <js>'\'</js> can be used when necessary to
escape the following characters:
@@ -11219,7 +11274,7 @@
<br>For example, calling the resolve method on a string that
doesn't contain variables (e.g.
<code>resolver.resolve(<js>"foobar"</js>)</code>) will simply
be a no-op and return the same string.
</ul>
-</div><!-- END: 5.4 - juneau-svl.OtherNotes -->
+</div><!-- END: 5.5 - juneau-svl.OtherNotes -->
</div><!-- END: 5 - juneau-svl -->
<!--
====================================================================================================
-->
@@ -12880,7 +12935,7 @@
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-config.SystemDefaultConfig'
id='juneau-config.SystemDefaultConfig'>6.15 - System Default Config</a></h3>
+<h3 class='topic updated' onclick='toggle(this)'><a
href='#juneau-config.SystemDefaultConfig'
id='juneau-config.SystemDefaultConfig'>6.15 - System Default Config</a></h3>
<div class='topic'><!-- START: 6.15 - juneau-config.SystemDefaultConfig -->
<p>
Each JVM has a system default config. This is a configuration file
that serves as the default
@@ -12916,6 +12971,7 @@
<li><code>application.cfg</code>
<li><code>app.cfg</code>
<li><code>settings.cfg</code>
+ <li><code>application.properties</code>
</ol>
</ol>
<p>
@@ -12930,6 +12986,10 @@
<jc>// Use system property if set or the system default if not.</jc>
<ja>@RestResource</ja>(config=<js>"$S{juneau.configFile,SYSTEM_DEFAULT}"</js>)
</p>
+<p>
+ By default, all properties in the system default configuration are
automatically set as system properties.
+ This can be disabled by setting the system property
<js>"juneau.disableAutoSystemProps"</js> to <js>"true"</js>.
+</p>
</div><!-- END: 6.15 - juneau-config.SystemDefaultConfig -->
</div><!-- END: 6 - juneau-config -->
@@ -13287,7 +13347,7 @@
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Instantiation.BasicRestServlet'
id='juneau-rest-server.Instantiation.BasicRestServlet'>7.3.2 -
BasicRestServlet</a></h4>
+<h4 class='topic updated' onclick='toggle(this)'><a
href='#juneau-rest-server.Instantiation.BasicRestServlet'
id='juneau-rest-server.Instantiation.BasicRestServlet'>7.3.2 -
BasicRestServlet</a></h4>
<div class='topic'><!-- START: 7.3.2 -
juneau-rest-server.Instantiation.BasicRestServlet -->
<p>
The {@link org.apache.juneau.rest.BasicRestServlet} class is a subclass
of {@link org.apache.juneau.rest.RestServlet}
@@ -13341,30 +13401,26 @@
},
<jc>// Never show aside contents of page
inherited from class.</jc>
aside=<js>"NONE"</js>
- ),
-
- <jc>// POJO swaps to apply to all
serializers/parsers.</jc>
+ )
+ )
+ <ja>@JsonSchemaConfig</ja>(
+ <jc>// Add descriptions to the following types when not
specified:</jc>
+
addDescriptionsTo=<js>"bean,collection,array,map,enum"</js>,
+ <jc>// Add x-example to the following types:</jc>
+ addExamplesTo=<js>"bean,collection,array,map"</js>,
+ <jc>// Don't generate schema information on the Swagger
bean itself or HTML beans.</jc>
+
ignoreTypes=<js>"Swagger,org.apache.juneau.dto.html5.*"</js>,
+ <jc>// Use $ref references for bean definitions to
reduce duplication in Swagger.</jc>
+ useBeanDefs=<js>"true"</js>
+ )
+ <ja>@BeanConfig</ja>(
+ <jc>// When parsing generated beans, ignore unknown
properties that may only exist as getters and not setters.</jc>
+ ignoreUnknownBeanProperties=<js>"true"</js>,
+ <jc>// POJO swaps to apply to all serializers/parsers
on this method.</jc>
pojoSwaps={
<jc>// Use the SwaggerUI swap when rendering
Swagger beans.</jc>
+ <jc>// This is a per-media-type swap that only
applies to text/html requests.</jc>
SwaggerUI.<jk>class</jk>
- },
-
- <jc>// Properties to apply to all serializers/parsers
and REST-specific API objects.</jc>
- properties={
- <jc>// Add descriptions to the following types
when not specified:</jc>
-
<ja>@Property</ja>(name=<jsf>JSONSCHEMA_addDescriptionsTo</jsf>,
value=<js>"bean,collection,array,map,enum"</js>),
-
- <jc>// Automatically add examples to the
following types:</jc>
-
<ja>@Property</ja>(name=<jsf>JSONSCHEMA_addExamplesTo</jsf>,
value=<js>"bean,collection,array,map"</js>),
-
- <jc>// Don't generate schema information on the
Swagger bean itself or HTML beans.</jc>
-
<ja>@Property</ja>(name=<jsf>JSONSCHEMA_ignoreTypes</jsf>,
value="<js>Swagger,org.apache.juneau.dto.html5.*"</js>)
- },
-
- <jc>// Shortcut for boolean properties.</jc>
- flags={
- <jc>// Use $ref references for bean definitions
to reduce duplication in Swagger.</jc>
- <jsf>JSONSCHEMA_useBeanDefs</jsf>
}
)
<jk>public</jk> Swagger getOptions(RestRequest req) {
@@ -13409,13 +13465,7 @@
MsgPackParser.<jk>class</jk>,
PlainTextParser.<jk>class</jk>
},
-
- <jc>// Properties to apply to all serializers/parsers and
REST-specific API objects.</jc>
- properties={
- <jc>// Enable automatic resolution of URI objects to
root-relative values.</jc>
-
<ja>@Property</ja>(name=<jsf>SERIALIZER_uriResolution</jsf>,
value=<js>"ROOT_RELATIVE"</js>)
- },
-
+
<jc>// HTML-page specific settings</jc>
htmldoc=<ja>@HtmlDoc</ja>(
@@ -13458,6 +13508,10 @@
// By default, we define static files through the external
configuration file.</jc>
staticFiles={<js>"$C{REST/staticFiles}"</js>}
)
+ <ja>@SerializerConfig</ja>(
+ <jc>// Enable automatic resolution of URI objects to
root-relative values.</jc>
+ uriResolution=<js>"ROOT_RELATIVE"</js>
+ )
<jk>public interface</jk> BasicRestConfig {}
</p>
<p>
@@ -13530,30 +13584,26 @@
},
<jc>// Never show aside contents of page
inherited from class.</jc>
aside=<js>"NONE"</js>
- ),
-
- <jc>// POJO swaps to apply to all
serializers/parsers.</jc>
+ )
+ )
+ <ja>@JsonSchemaConfig</ja>(
+ <jc>// Add descriptions to the following types when not
specified:</jc>
+
addDescriptionsTo=<js>"bean,collection,array,map,enum"</js>,
+ <jc>// Add x-example to the following types:</jc>
+ addExamplesTo=<js>"bean,collection,array,map"</js>,
+ <jc>// Don't generate schema information on the Swagger
bean itself or HTML beans.</jc>
+
ignoreTypes=<js>"Swagger,org.apache.juneau.dto.html5.*"</js>,
+ <jc>// Use $ref references for bean definitions to
reduce duplication in Swagger.</jc>
+ useBeanDefs=<js>"true"</js>
+ )
+ <ja>@BeanConfig</ja>(
+ <jc>// When parsing generated beans, ignore unknown
properties that may only exist as getters and not setters.</jc>
+ ignoreUnknownBeanProperties=<js>"true"</js>,
+ <jc>// POJO swaps to apply to all serializers/parsers
on this method.</jc>
pojoSwaps={
<jc>// Use the SwaggerUI swap when rendering
Swagger beans.</jc>
+ <jc>// This is a per-media-type swap that only
applies to text/html requests.</jc>
SwaggerUI.<jk>class</jk>
- },
-
- <jc>// Properties to apply to all serializers/parsers
and REST-specific API objects.</jc>
- properties={
- <jc>// Add descriptions to the following types
when not specified:</jc>
-
<ja>@Property</ja>(name=<jsf>JSONSCHEMA_addDescriptionsTo</jsf>,
value=<js>"bean,collection,array,map,enum"</js>),
-
- <jc>// Automatically add examples to the
following types:</jc>
-
<ja>@Property</ja>(name=<jsf>JSONSCHEMA_addExamplesTo</jsf>,
value=<js>"bean,collection,array,map"</js>),
-
- <jc>// Don't generate schema information on the
Swagger bean itself or HTML beans.</jc>
-
<ja>@Property</ja>(name=<jsf>JSONSCHEMA_ignoreTypes</jsf>,
value="<js>Swagger,org.apache.juneau.dto.html5.*"</js>)
- },
-
- <jc>// Shortcut for boolean properties.</jc>
- flags={
- <jc>// Use $ref references for bean definitions
to reduce duplication in Swagger.</jc>
- <jsf>JSONSCHEMA_useBeanDefs</jsf>
}
)
<jk>public</jk> Swagger getOptions(RestRequest req) {
@@ -17798,8 +17848,71 @@
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Transforms' id='juneau-rest-server.Transforms'>7.16 -
Transforms</a></h3>
-<div class='topic'><!-- START: 7.16 - juneau-rest-server.Transforms -->
+<h3 class='topic new' onclick='toggle(this)'><a
href='#juneau-rest-server.ConfigAnnotations'
id='juneau-rest-server.ConfigAnnotations'>7.16 - Config annotations</a></h3>
+<div class='topic'><!-- START: 7.16 - juneau-rest-server.ConfigAnnotations -->
+<p>
+ Config annotations allow you to define serializer and parser properties
using specialized annotations.
+ All configuration properties have annotation-equivalents.
+</p>
+<p>
+ The following shows the difference between the two approaches:
+</p>
+<h5 class='figure'>Example:</h5>
+<p class='bpcode w800'>
+ <jc>// Servlet with properties applied</jc>
+ <ja>@RestResource</ja>(
+ properties={
+ <ja>@Property</ja>(name=<jsf>BEAN_sortProperties</jsf>,
value=<js>"true"</js>),
+
<ja>@Property</ja>(name=<jsf>SERIALIZER_trimNulls</jsf>, value=<js>"true"</js>),
+ <ja>@Property</ja>(name=<jsf>JSON_escapeSolidus</jsf>,
value=<js>"true"</js>)
+ }
+ )
+ <jk>public</jk> MyRestServlet <jk>extends</jk> BasicRestServlet {...}
+</p>
+<p class='bpcode w800'>
+ <jc>// Servlet with config annotations applied</jc>
+ <ja>@RestResource</ja>(
+ ...
+ )
+ <ja>@BeanConfig</ja>(sortProperties=<js>"true"</js>)
+ <ja>@SerializerConfig</ja>(trimNulls=<js>"true"</js>)
+ <ja>@JsonConfig</ja>(escapeSolidus=<js>"true"</js>)
+ <jk>public</jk> MyRestServlet <jk>extends</jk> BasicRestServlet {...}
+</p>
+<p>
+ Using config annotations is often cleaner and supports the same SVL
variable support as those in the REST annotations.
+</p>
+<p>
+ Config annotations are defined for all serializers and parsers:
+</p>
+<ul>
+ <li class='ja'>{@link org.apache.juneau.annotation.BeanConfig
BeanConfig}
+ <li class='ja'>{@link org.apache.juneau.csv.annotation.CsvConfig
CsvConfig}
+ <li class='ja'>{@link org.apache.juneau.html.annotation.HtmlConfig
HtmlConfig}
+ <li class='ja'>{@link org.apache.juneau.html.annotation.HtmlDocConfig
HtmlDocConfig}
+ <li class='ja'>{@link org.apache.juneau.jso.annotation.JsoConfig
JsoConfig}
+ <li class='ja'>{@link org.apache.juneau.json.annotation.JsonConfig
JsonConfig}
+ <li class='ja'>{@link
org.apache.juneau.jsonschema.annotation.JsonSchemaConfig JsonSchemaConfig}
+ <li class='ja'>{@link
org.apache.juneau.msgpack.annotation.MsgPackConfig MsgPackConfig}
+ <li class='ja'>{@link org.apache.juneau.oapi.annotation.OpenApiConfig
OpenApiConfig}
+ <li class='ja'>{@link org.apache.juneau.parser.annotation.ParserConfig
ParserConfig}
+ <li class='ja'>{@link
org.apache.juneau.plaintext.annotation.PlainTextConfig PlainTextConfig}
+ <li class='ja'>{@link org.apache.juneau.jena.annotation.RdfConfig
RdfConfig}
+ <li class='ja'>{@link
org.apache.juneau.serializer.annotation.SerializerConfig SerializerConfig}
+ <li class='ja'>{@link org.apache.juneau.soap.annotation.SoapXmlConfig
SoapXmlConfig}
+ <li class='ja'>{@link org.apache.juneau.uon.annotation.UonConfig
UonConfig}
+ <li class='ja'>{@link
org.apache.juneau.urlencoding.annotation.UrlEncodingConfig UrlEncodingConfig}
+ <li class='ja'>{@link org.apache.juneau.xml.annotation.XmlConfig
XmlConfig}
+</ul>
+<p>
+ Config annotations can be defined at both the class and method level
just like properties.
+</p>
+</div><!-- END: 7.16 - juneau-rest-server.ConfigAnnotations -->
+
+<!--
====================================================================================================
-->
+
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Transforms' id='juneau-rest-server.Transforms'>7.17 -
Transforms</a></h3>
+<div class='topic'><!-- START: 7.17 - juneau-rest-server.Transforms -->
<p>
The Juneau serializers and parsers can be configured on how to handle
POJOs through the use of Transforms.
(See {@doc juneau-marshall.Transforms Transforms})
@@ -17851,12 +17964,12 @@
}
}
</p>
-</div><!-- END: 7.16 - juneau-rest-server.Transforms -->
+</div><!-- END: 7.17 - juneau-rest-server.Transforms -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.URIs'
id='juneau-rest-server.URIs'>7.17 - URIs</a></h3>
-<div class='topic'><!-- START: 7.17 - juneau-rest-server.URIs -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.URIs'
id='juneau-rest-server.URIs'>7.18 - URIs</a></h3>
+<div class='topic'><!-- START: 7.18 - juneau-rest-server.URIs -->
<p>
As mention earlier {@doc juneau-marshall.URIs here}, Juneau serializers
have sophisticated support for transforming relative URIs to absolute form.
</p>
@@ -17936,12 +18049,12 @@
<p>
URIs are resolved by both regular and part serializers.
</p>
-</div><!-- END: 7.17 - juneau-rest-server.URIs -->
+</div><!-- END: 7.18 - juneau-rest-server.URIs -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.Guards'
id='juneau-rest-server.Guards'>7.18 - Guards</a></h3>
-<div class='topic'><!-- START: 7.18 - juneau-rest-server.Guards -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.Guards'
id='juneau-rest-server.Guards'>7.19 - Guards</a></h3>
+<div class='topic'><!-- START: 7.19 - juneau-rest-server.Guards -->
<p>
Guards are classes that control access to REST classes and methods.
</p>
@@ -18015,12 +18128,12 @@
<ul>
<li class='jf'>{@link org.apache.juneau.rest.RestContext#REST_guards}
</ul>
-</div><!-- END: 7.18 - juneau-rest-server.Guards -->
+</div><!-- END: 7.19 - juneau-rest-server.Guards -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Converters' id='juneau-rest-server.Converters'>7.19 -
Converters</a></h3>
-<div class='topic'><!-- START: 7.19 - juneau-rest-server.Converters -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Converters' id='juneau-rest-server.Converters'>7.20 -
Converters</a></h3>
+<div class='topic'><!-- START: 7.20 - juneau-rest-server.Converters -->
<p>
Converters can be thought of as "post-processors" for POJOs before they
get passed to the serializers.
</p>
@@ -18120,12 +18233,12 @@
<ul>
<li class='jf'>{@link
org.apache.juneau.rest.RestContext#REST_converters}
</ul>
-</div><!-- END: 7.19 - juneau-rest-server.Converters -->
+</div><!-- END: 7.20 - juneau-rest-server.Converters -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Messages' id='juneau-rest-server.Messages'>7.20 -
Messages</a></h3>
-<div class='topic'><!-- START: 7.20 - juneau-rest-server.Messages -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Messages' id='juneau-rest-server.Messages'>7.21 -
Messages</a></h3>
+<div class='topic'><!-- START: 7.21 - juneau-rest-server.Messages -->
<p>
The {@link org.apache.juneau.rest.annotation.RestResource#messages
@RestResource(messages)} annotation is used to associate a resource bundle with
a servlet class.
</p>
@@ -18170,12 +18283,12 @@
<ul>
<li class='jf'>{@link org.apache.juneau.rest.RestContext#REST_messages}
</ul>
-</div><!-- END: 7.20 - juneau-rest-server.Messages -->
+</div><!-- END: 7.21 - juneau-rest-server.Messages -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Encoders' id='juneau-rest-server.Encoders'>7.21 -
Encoders</a></h3>
-<div class='topic'><!-- START: 7.21 - juneau-rest-server.Encoders -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Encoders' id='juneau-rest-server.Encoders'>7.22 -
Encoders</a></h3>
+<div class='topic'><!-- START: 7.22 - juneau-rest-server.Encoders -->
<p>
The {@link org.apache.juneau.rest.annotation.RestResource#encoders
@RestResource(encoders)} annotation can
be used to associate character encoders with a servlet class.
@@ -18208,12 +18321,12 @@
<ul>
<li class='jf'>{@link org.apache.juneau.rest.RestContext#REST_encoders}
</ul>
-</div><!-- END: 7.21 - juneau-rest-server.Encoders -->
+</div><!-- END: 7.22 - juneau-rest-server.Encoders -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.SvlVariables'
id='juneau-rest-server.SvlVariables'>7.22 - SVL Variables</a></h3>
-<div class='topic'><!-- START: 7.22 - juneau-rest-server.SvlVariables -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.SvlVariables'
id='juneau-rest-server.SvlVariables'>7.23 - SVL Variables</a></h3>
+<div class='topic'><!-- START: 7.23 - juneau-rest-server.SvlVariables -->
<p>
In the previous examples, there were several cases where embedded
variables were contained within
annotation values:
@@ -18482,12 +18595,12 @@
<td class='code'>$W{MenuItemWidget}</td>
</tr>
</table>
-</div><!-- END: 7.22 - juneau-rest-server.SvlVariables -->
+</div><!-- END: 7.23 - juneau-rest-server.SvlVariables -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.ConfigurationFiles'
id='juneau-rest-server.ConfigurationFiles'>7.23 - Configuration Files</a></h3>
-<div class='topic'><!-- START: 7.23 - juneau-rest-server.ConfigurationFiles -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.ConfigurationFiles'
id='juneau-rest-server.ConfigurationFiles'>7.24 - Configuration Files</a></h3>
+<div class='topic'><!-- START: 7.24 - juneau-rest-server.ConfigurationFiles -->
<p>
The Server API provides methods for associating configuration files
with REST servlets so that
configuration properties can be defined in external files.
@@ -18652,12 +18765,12 @@
<ul class='doctree'>
<li>{@doc juneau-config}
</ul>
-</div><!-- END: 7.23 - juneau-rest-server.ConfigurationFiles -->
+</div><!-- END: 7.24 - juneau-rest-server.ConfigurationFiles -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.StaticFiles' id='juneau-rest-server.StaticFiles'>7.24
- Static files</a></h3>
-<div class='topic'><!-- START: 7.24 - juneau-rest-server.StaticFiles -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.StaticFiles' id='juneau-rest-server.StaticFiles'>7.25
- Static files</a></h3>
+<div class='topic'><!-- START: 7.25 - juneau-rest-server.StaticFiles -->
<p>
The {@link org.apache.juneau.rest.annotation.RestResource#staticFiles
@RestResource(staticFiles)}
annotation is used to define paths and locations of statically-served
files such as images or HTML
@@ -18704,12 +18817,12 @@
<ul>
<li class='jf'>{@link
org.apache.juneau.rest.RestContext#REST_staticFiles}
</ul>
-</div><!-- END: 7.24 - juneau-rest-server.StaticFiles -->
+</div><!-- END: 7.25 - juneau-rest-server.StaticFiles -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.ClientVersioning'
id='juneau-rest-server.ClientVersioning'>7.25 - Client Versioning</a></h3>
-<div class='topic'><!-- START: 7.25 - juneau-rest-server.ClientVersioning -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.ClientVersioning'
id='juneau-rest-server.ClientVersioning'>7.26 - Client Versioning</a></h3>
+<div class='topic'><!-- START: 7.26 - juneau-rest-server.ClientVersioning -->
<p>
Client version headers are used to support backwards compatibility for
breaking REST interface changes.
Using them, you're able to return different responses based on which
client is making a request.
@@ -18751,12 +18864,12 @@
<ul>
<li class='jf'>{@link
org.apache.juneau.rest.RestContext#REST_clientVersionHeader}
</ul>
-</div><!-- END: 7.25 - juneau-rest-server.ClientVersioning -->
+</div><!-- END: 7.26 - juneau-rest-server.ClientVersioning -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.RestInfoProvider'
id='juneau-rest-server.RestInfoProvider'>7.26 - RestInfoProvider</a></h3>
-<div class='topic'><!-- START: 7.26 - juneau-rest-server.RestInfoProvider -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.RestInfoProvider'
id='juneau-rest-server.RestInfoProvider'>7.27 - RestInfoProvider</a></h3>
+<div class='topic'><!-- START: 7.27 - juneau-rest-server.RestInfoProvider -->
<p>
The {@link org.apache.juneau.rest.RestInfoProvider} class is used to
find the title
and description for your resource and also generate the Swagger
documentation.
@@ -18803,8 +18916,8 @@
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.RestInfoProvider.BasicRestInfoProvider'
id='juneau-rest-server.RestInfoProvider.BasicRestInfoProvider'>7.26.1 -
BasicRestInfoProvider</a></h4>
-<div class='topic'><!-- START: 7.26.1 -
juneau-rest-server.RestInfoProvider.BasicRestInfoProvider -->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.RestInfoProvider.BasicRestInfoProvider'
id='juneau-rest-server.RestInfoProvider.BasicRestInfoProvider'>7.27.1 -
BasicRestInfoProvider</a></h4>
+<div class='topic'><!-- START: 7.27.1 -
juneau-rest-server.RestInfoProvider.BasicRestInfoProvider -->
<p>
The {@link org.apache.juneau.rest.BasicRestInfoProvider} class is the
default implementation of the
{@link org.apache.juneau.rest.RestInfoProvider} interface.
@@ -18822,13 +18935,13 @@
The class itself is designed to be extended if you wish to rely mostly
on the default behavior, but tweak
certain aspects.
</p>
-</div><!-- END: 7.26.1 -
juneau-rest-server.RestInfoProvider.BasicRestInfoProvider -->
-</div><!-- END: 7.26 - juneau-rest-server.RestInfoProvider -->
+</div><!-- END: 7.27.1 -
juneau-rest-server.RestInfoProvider.BasicRestInfoProvider -->
+</div><!-- END: 7.27 - juneau-rest-server.RestInfoProvider -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger' id='juneau-rest-server.Swagger'>7.27 -
Swagger</a></h3>
-<div class='topic'><!-- START: 7.27 - juneau-rest-server.Swagger -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger' id='juneau-rest-server.Swagger'>7.28 -
Swagger</a></h3>
+<div class='topic'><!-- START: 7.28 - juneau-rest-server.Swagger -->
<p>
One of the most useful features of Juneau is the ability to generate
Swagger-based OPTIONS pages for self-documenting designs
(i.e. REST interfaces that document themselves).
@@ -18844,8 +18957,8 @@
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.BasicRestServlet'
id='juneau-rest-server.Swagger.BasicRestServlet'>7.27.1 -
BasicRestServlet</a></h4>
-<div class='topic'><!-- START: 7.27.1 -
juneau-rest-server.Swagger.BasicRestServlet -->
+<h4 class='topic updated' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.BasicRestServlet'
id='juneau-rest-server.Swagger.BasicRestServlet'>7.28.1 -
BasicRestServlet</a></h4>
+<div class='topic'><!-- START: 7.28.1 -
juneau-rest-server.Swagger.BasicRestServlet -->
<p>
Any subclass of {@link org.apache.juneau.rest.BasicRestServlet} gets an
auto-generated Swagger UI when performing an <code>OPTIONS</code>
request with <code>Accept:text/html</code>.
@@ -18888,31 +19001,26 @@
},
<jc>// Never show aside contents of page
inherited from class.</jc>
aside=<js>"NONE"</js>
- ),
-
- <jc>// POJO swaps to apply to all
serializers/parsers.</jc>
+ )
+ )
+ <ja>@JsonSchemaConfig</ja>(
+ <jc>// Add descriptions to the following types when not
specified:</jc>
+
addDescriptionsTo=<js>"bean,collection,array,map,enum"</js>,
+ <jc>// Add x-example to the following types:</jc>
+ addExamplesTo=<js>"bean,collection,array,map"</js>,
+ <jc>// Don't generate schema information on the Swagger
bean itself or HTML beans.</jc>
+
ignoreTypes=<js>"Swagger,org.apache.juneau.dto.html5.*"</js>,
+ <jc>// Use $ref references for bean definitions to
reduce duplication in Swagger.</jc>
+ useBeanDefs=<js>"true"</js>
+ )
+ <ja>@BeanConfig</ja>(
+ <jc>// When parsing generated beans, ignore unknown
properties that may only exist as getters and not setters.</jc>
+ ignoreUnknownBeanProperties=<js>"true"</js>,
+ <jc>// POJO swaps to apply to all serializers/parsers
on this method.</jc>
pojoSwaps={
<jc>// Use the SwaggerUI swap when rendering
Swagger beans.</jc>
<jc>// This is a per-media-type swap that only
applies to text/html requests.</jc>
SwaggerUI.<jk>class</jk>
- },
-
- <jc>// Properties to apply to all serializers/parsers
and REST-specific API objects.</jc>
- properties={
- <jc>// Add descriptions to the following types
when not specified:</jc>
-
<ja>@Property</ja>(name=<jsf>JSONSCHEMA_addDescriptionsTo</jsf>,
value=<js>"bean,collection,array,map,enum"</js>),
-
- <jc>// Add x-example to the following
types:</jc>
-
<ja>@Property</ja>(name=<jsf>JSONSCHEMA_addExamplesTo</jsf>,
value=<js>"bean,collection,array,map"</js>),
-
- <jc>// Don't generate schema information on the
Swagger bean itself or HTML beans.</jc>
-
<ja>@Property</ja>(name=<jsf>JSONSCHEMA_ignoreTypes</jsf>,
value=<js>"Swagger,org.apache.juneau.dto.html5.*"</js>)
- },
-
- <jc>// Shortcut for boolean properties.</jc>
- flags={
- <jc>// Use $ref references for bean definitions
to reduce duplication in Swagger.</jc>
- <jsf>JSONSCHEMA_useBeanDefs</jsf>
}
)
<jk>public</jk> Swagger getOptions(RestRequest req) {
@@ -18925,12 +19033,12 @@
Note that to have your resource create Swagger UI, you must either
extend from {@link org.apache.juneau.rest.BasicRestServlet} or provide
your own <ja>@RestMethod</ja>-annotated method that returns a {@link
org.apache.juneau.dto.swagger.Swagger} object and a {@link
org.apache.juneau.dto.swagger.ui.SwaggerUI} swap.
</p>
-</div><!-- END: 7.27.1 - juneau-rest-server.Swagger.BasicRestServlet -->
+</div><!-- END: 7.28.1 - juneau-rest-server.Swagger.BasicRestServlet -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.BasicSwaggerInfo'
id='juneau-rest-server.Swagger.BasicSwaggerInfo'>7.27.2 - Basic Swagger
Info</a></h4>
-<div class='topic'><!-- START: 7.27.2 -
juneau-rest-server.Swagger.BasicSwaggerInfo -->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.BasicSwaggerInfo'
id='juneau-rest-server.Swagger.BasicSwaggerInfo'>7.28.2 - Basic Swagger
Info</a></h4>
+<div class='topic'><!-- START: 7.28.2 -
juneau-rest-server.Swagger.BasicSwaggerInfo -->
<p>
Let's look at the various parts of the <code>Petstore</code>
application Swagger UI to see how they are defined.
</p>
@@ -19091,12 +19199,12 @@
<li>Resource bundle
<li>Swagger JSON file
</ol>
-</div><!-- END: 7.27.2 - juneau-rest-server.Swagger.BasicSwaggerInfo -->
+</div><!-- END: 7.28.2 - juneau-rest-server.Swagger.BasicSwaggerInfo -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Tags'
id='juneau-rest-server.Swagger.Tags'>7.27.3 - Tags</a></h4>
-<div class='topic'><!-- START: 7.27.3 - juneau-rest-server.Swagger.Tags -->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Tags'
id='juneau-rest-server.Swagger.Tags'>7.28.3 - Tags</a></h4>
+<div class='topic'><!-- START: 7.28.3 - juneau-rest-server.Swagger.Tags -->
<p>
Tags allow you to group operations into general categories.
In the user interface, these can be expanded/collapsed by clicking on
the tag sections.
@@ -19192,12 +19300,12 @@
show up at the top of the page:
</p>
<img class='bordered w900' src='doc-files/juneau-rest-server.Swagger.5.png'>
-</div><!-- END: 7.27.3 - juneau-rest-server.Swagger.Tags -->
+</div><!-- END: 7.28.3 - juneau-rest-server.Swagger.Tags -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Operations'
id='juneau-rest-server.Swagger.Operations'>7.27.4 - Operations</a></h4>
-<div class='topic'><!-- START: 7.27.4 - juneau-rest-server.Swagger.Operations
-->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Operations'
id='juneau-rest-server.Swagger.Operations'>7.28.4 - Operations</a></h4>
+<div class='topic'><!-- START: 7.28.4 - juneau-rest-server.Swagger.Operations
-->
<p>
<ja>@RestMethod</ja>-annotated methods automatically get rendered as
Swagger operations:
</p>
@@ -19237,12 +19345,12 @@
...
}
</p>
-</div><!-- END: 7.27.4 - juneau-rest-server.Swagger.Operations -->
+</div><!-- END: 7.28.4 - juneau-rest-server.Swagger.Operations -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Parameters'
id='juneau-rest-server.Swagger.Parameters'>7.27.5 - Parameters</a></h4>
-<div class='topic'><!-- START: 7.27.5 - juneau-rest-server.Swagger.Parameters
-->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Parameters'
id='juneau-rest-server.Swagger.Parameters'>7.28.5 - Parameters</a></h4>
+<div class='topic'><!-- START: 7.28.5 - juneau-rest-server.Swagger.Parameters
-->
<p>
Expanding operations shows you a list of parameters:
</p>
@@ -19377,12 +19485,12 @@
<p>
Note that the schema information on the body parameter is automatically
detected if not provided.
</p>
-</div><!-- END: 7.27.5 - juneau-rest-server.Swagger.Parameters -->
+</div><!-- END: 7.28.5 - juneau-rest-server.Swagger.Parameters -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.ParameterExamples'
id='juneau-rest-server.Swagger.ParameterExamples'>7.27.6 - Parameter
Examples</a></h4>
-<div class='topic'><!-- START: 7.27.6 -
juneau-rest-server.Swagger.ParameterExamples -->
+<h4 class='topic updated' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.ParameterExamples'
id='juneau-rest-server.Swagger.ParameterExamples'>7.28.6 - Parameter
Examples</a></h4>
+<div class='topic'><!-- START: 7.28.6 -
juneau-rest-server.Swagger.ParameterExamples -->
<p>
The <code>model</code> select box in the parameters can be expanded to
show examples:
</p>
@@ -19537,10 +19645,10 @@
<ja>@RestMethod</ja>(name=<jsf>OPTIONS</jsf>,
path=<js>"/*"</js>,
...
- properties={
- <jc>// Add x-example to the following
types:</jc>
-
<ja>@Property</ja>(name=<jsf>JSONSCHEMA_addExamplesTo</jsf>,
value=<js>"bean,collection,array,map"</js>),
- },
+ )
+ <ja>@JsonSchemaConfig</ja>(
+ <jc>// Add x-example to the following types:</jc>
+ addExamplesTo=<js>"bean,collection,array,map"</js>,
...
)
<jk>public</jk> Swagger getOptions(RestRequest req) {...}
@@ -19581,18 +19689,14 @@
}
</p>
<p>
- Examples can also be specified via generic properties as well using the
{@link org.apache.juneau.BeanContext#BEAN_examples} property at either the
class or method level.
+ Examples can also be specified via generic properties as well using the
{@link org.apache.juneau.BeanContext#BEAN_examples} property or {@link
org.apache.juneau.annotation.BeanConfig#examples() @BeanConfig(examples)}
annotation at either the class or method level.
</p>
<h5 class='figure'>Example:</h5>
<p class='bpcode w800'>
<jc>// Examples defined at class level.</jc>
- <ja>@RestResource</ja>(
- properties={
- <ja>@Property</ja>(
- name=<jsf>BEAN_examples</jsf>,
-
value=<js>"{'org.apache.juneau.examples.rest.petstore.PetCreate':
{name:'Doggie',price:9.99,species:'Dog',tags:['friendly','cute']}}"</js>
- )
- }
+ <ja>@RestResource</ja>(...)
+ <ja>@BeanConfig</ja>(
+ examples=<js>"{PetCreate:
{name:'Doggie',price:9.99,species:'Dog',tags:['friendly','cute']}}"</js>
)
</p>
<h5 class='section'>See Also:</h5>
@@ -19608,12 +19712,12 @@
<li class='jf'>{@link
org.apache.juneau.jsonschema.JsonSchemaGenerator#JSONSCHEMA_allowNestedExamples
JSONSCHEMA_allowNestedExamples}
</ul>
</ul>
-</div><!-- END: 7.27.6 - juneau-rest-server.Swagger.ParameterExamples -->
+</div><!-- END: 7.28.6 - juneau-rest-server.Swagger.ParameterExamples -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Responses'
id='juneau-rest-server.Swagger.Responses'>7.27.7 - Responses</a></h4>
-<div class='topic'><!-- START: 7.27.7 - juneau-rest-server.Swagger.Responses
-->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Responses'
id='juneau-rest-server.Swagger.Responses'>7.28.7 - Responses</a></h4>
+<div class='topic'><!-- START: 7.28.7 - juneau-rest-server.Swagger.Responses
-->
<p>
Under the input parameters are listed the possible responses for the
resource:
</p>
@@ -19653,12 +19757,12 @@
<li class='link'>{@doc
juneau-rest-server.HttpPartAnnotations.ResponseHeader}
<li class='link'>{@doc
juneau-rest-server.HttpPartAnnotations.ResponseStatus}
</ul>
-</div><!-- END: 7.27.7 - juneau-rest-server.Swagger.Responses -->
+</div><!-- END: 7.28.7 - juneau-rest-server.Swagger.Responses -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.ResponseExamples'
id='juneau-rest-server.Swagger.ResponseExamples'>7.27.8 - Response
Examples</a></h4>
-<div class='topic'><!-- START: 7.27.8 -
juneau-rest-server.Swagger.ResponseExamples -->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.ResponseExamples'
id='juneau-rest-server.Swagger.ResponseExamples'>7.28.8 - Response
Examples</a></h4>
+<div class='topic'><!-- START: 7.28.8 -
juneau-rest-server.Swagger.ResponseExamples -->
<p>
The <code>model</code> select box in the responses can be expanded to
show examples:
</p>
@@ -19791,17 +19895,14 @@
}
</p>
<p>
- Examples can also be specified via generic properties as well using the
{@link org.apache.juneau.BeanContext#BEAN_examples} property at either the
class or method level.
+ Examples can also be specified via generic properties as well using the
{@link org.apache.juneau.BeanContext#BEAN_examples} property
+ or {@link org.apache.juneau.annoation.BeanConfig#examples
@BeanConfig(examples)} annotation at either the class or method level.
</p>
<p class='bpcode w800'>
<jc>// Examples defined at class level.</jc>
- <ja>@RestResource</ja>(
- properties={
- <ja>@Property</ja>(
- name=<jsf>BEAN_examples</jsf>,
-
value=<js>"{'org.apache.juneau.examples.rest.petstore.PetCreate':
{name:'Doggie',price:9.99,species:'Dog',tags:['friendly','cute']}}"</js>
- )
- }
+ <ja>@RestResource</ja>(...)
+ <ja>@BeanConfig</ja>(
+ examples=<js>"{PetCreate:
{name:'Doggie',price:9.99,species:'Dog',tags:['friendly','cute']}}"</js>
)
</p>
<p>
@@ -19879,12 +19980,12 @@
}
}
</p>
-</div><!-- END: 7.27.8 - juneau-rest-server.Swagger.ResponseExamples -->
+</div><!-- END: 7.28.8 - juneau-rest-server.Swagger.ResponseExamples -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Models'
id='juneau-rest-server.Swagger.Models'>7.27.9 - Models</a></h4>
-<div class='topic'><!-- START: 7.27.9 - juneau-rest-server.Swagger.Models -->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Models'
id='juneau-rest-server.Swagger.Models'>7.28.9 - Models</a></h4>
+<div class='topic'><!-- START: 7.28.9 - juneau-rest-server.Swagger.Models -->
<p>
The {@link
org.apache.juneau.jsonschema.JsonSchemaGenerator#JSONSCHEMA_useBeanDefs}
setting can be used to reduce the size of your
generated Swagger JSON files by creating model definitions for beans
and referencing those definitions through <code>$ref</code> attributes.
@@ -19977,12 +20078,12 @@
Note that this does not affect how the information is rendered for that
bean in the Swagger UI:
</p>
<img class='bordered w900'
src='doc-files/juneau-rest-server.Swagger.Models.3.png'>
-</div><!-- END: 7.27.9 - juneau-rest-server.Swagger.Models -->
+</div><!-- END: 7.28.9 - juneau-rest-server.Swagger.Models -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Stylesheet'
id='juneau-rest-server.Swagger.Stylesheet'>7.27.10 - SwaggerUI.css</a></h4>
-<div class='topic'><!-- START: 7.27.10 - juneau-rest-server.Swagger.Stylesheet
-->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Swagger.Stylesheet'
id='juneau-rest-server.Swagger.Stylesheet'>7.28.10 - SwaggerUI.css</a></h4>
+<div class='topic'><!-- START: 7.28.10 - juneau-rest-server.Swagger.Stylesheet
-->
<p>
The look-and-feel of the Swagger UI is controlled via a single CSS
file: <code>SwaggerUI.css</code>.
</p>
@@ -19991,21 +20092,21 @@
It's a simple straightforward file consisting of less than 350 lines.
This file can be modified to change the look-and-feel of your Swagger
UI.
</p>
-</div><!-- END: 7.27.10 - juneau-rest-server.Swagger.Stylesheet -->
-</div><!-- END: 7.27 - juneau-rest-server.Swagger -->
+</div><!-- END: 7.28.10 - juneau-rest-server.Swagger.Stylesheet -->
+</div><!-- END: 7.28 - juneau-rest-server.Swagger -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation'
id='juneau-rest-server.HtmlDocAnnotation'>7.28 - @HtmlDoc</a></h3>
-<div class='topic'><!-- START: 7.28 - juneau-rest-server.HtmlDocAnnotation -->
+<h3 class='topic updated' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation'
id='juneau-rest-server.HtmlDocAnnotation'>7.29 - @HtmlDocConfig</a></h3>
+<div class='topic'><!-- START: 7.29 - juneau-rest-server.HtmlDocAnnotation -->
<p>
- The {@link org.apache.juneau.rest.annotation.HtmlDoc @HtmlDoc}
annotation is used to customize the HTML
+ The {@link org.apache.juneau.rest.annotation.HtmlDocConfig
@HtmlDocConfig} annotation is used to customize the HTML
view of your serialized POJOs.
It's used in the following locations:
</p>
<ul>
- <li class='ja'>{@link
org.apache.juneau.rest.annotation.RestResource#htmldoc() RestResource(htmldoc)}
- <li class='ja'>{@link
org.apache.juneau.rest.annotation.RestMethod#htmldoc() RestMethod(htmldoc)}
+ <li>{@link org.apache.juneau.rest.annotation.RestResource
@RestResource}-annotated classes.
+ <li>{@link org.apache.juneau.rest.annotation.RestMethod
@RestMethod}-annotated methods.
</ul>
<p>
The annotation itself is just a convenience for setting configuration
properties set
@@ -20021,10 +20122,9 @@
)
<jc>// Title defined via @HtmlDoc annotation.</jc>
- <ja>@RestResource</ja>(
- htmldoc=<ja>@HtmlDoc</ja>(
- title=<js>"My Resource Page"</js>
- )
+ <ja>@RestResource</ja>()
+ <ja>@HtmlDocConfig</ja>(
+ title=<js>"My Resource Page"</js>
)
</p>
<p>
@@ -20069,19 +20169,19 @@
* Sample REST resource that prints out a simple "Hello world!" message.
*/</jd>
<ja>@RestResource</ja>(
- path=<js>"/helloWorld"</js>,
- htmldoc=<ja>@HtmlDoc</ja>(
- navlinks={
- <js>"up: request:/.."</js>,
- <js>"options: servlet:/?method=OPTIONS"</js>
- },
- aside={
- <js>"<div style='max-width:400px'
class='text'>"</js>,
- <js>" <p>This page shows a resource
that simply response with a 'Hello world!' message</p>"</js>,
- <js>" <p>The POJO serialized is a
simple String.</p>"</js>,
- <js>"</div>"</js>
- }
- )
+ path=<js>"/helloWorld"</js>
+ )
+ <ja>@HtmlDocConfig</ja>(
+ navlinks={
+ <js>"up: request:/.."</js>,
+ <js>"options: servlet:/?method=OPTIONS"</js>
+ },
+ aside={
+ <js>"<div style='max-width:400px'
class='text'>"</js>,
+ <js>" <p>This page shows a resource that simply
response with a 'Hello world!' message</p>"</js>,
+ <js>" <p>The POJO serialized is a simple
String.</p>"</js>,
+ <js>"</div>"</js>
+ }
)
<jk>public class</jk> HelloWorldResource <jk>extends</jk>
BasicRestServlet {...}
</p>
@@ -20092,35 +20192,30 @@
<ja>@RestResource</ja>(
path=<js>"/helloWorld"</js>,
<jc>// Register a config file.</jc>
- config=<js>"MyConfig.cfg"</js>,
- htmldoc=<ja>@HtmlDoc</ja>(
- navlinks={
- <js>"up: request:/.."</js>,
- <js>"options: servlet:/?method=OPTIONS"</js>,
- <jc>// Add a nav link to view the source code
for this class.</jc>
- <js>"source:
$C{Source/gitHub}/org/apache/juneau/examples/rest/$R{servletClassSimple}.java"</js>
- },
- aside={
- <jc>// Localize our messages.</jc>
- <js>"<div style='max-width:400px'
class='text'>"</js>,
- <js>"
<p>$L{localizedMessage1}</p>"</js>,
- <js>"
<p>$L{localizedMessage2}</p>"</js>,
- <js>"</div>"</js>
- }
- )
+ config=<js>"MyConfig.cfg"</js>
+ )
+ <ja>@HtmlDocConfig</ja>(
+ navlinks={
+ <js>"up: request:/.."</js>,
+ <js>"options: servlet:/?method=OPTIONS"</js>,
+ <jc>// Add a nav link to view the source code for this
class.</jc>
+ <js>"source:
$C{Source/gitHub}/org/apache/juneau/examples/rest/$R{servletClassSimple}.java"</js>
+ },
+ aside={
+ <jc>// Localize our messages.</jc>
+ <js>"<div style='max-width:400px'
class='text'>"</js>,
+ <js>" <p>$L{localizedMessage1}</p>"</js>,
+ <js>" <p>$L{localizedMessage2}</p>"</js>,
+ <js>"</div>"</js>
+ }
)
<jk>public class</jk> HelloWorldResource <jk>extends</jk>
BasicRestServlet {...}
</p>
-<h5 class='section'>See Also:</h5>
-<ul>
- <li class='ja'>{@link org.apache.juneau.rest.annotation.HtmlDoc}
- <li class='jc'>{@link org.apache.juneau.rest.HtmlDocBuilder}
-</ul>
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation.UIvsDI'
id='juneau-rest-server.HtmlDocAnnotation.UIvsDI'>7.28.1 - User Interfaces (UI)
vs. Developer Interfaces (DI)</a></h4>
-<div class='topic'><!-- START: 7.28.1 -
juneau-rest-server.HtmlDocAnnotation.UIvsDI -->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation.UIvsDI'
id='juneau-rest-server.HtmlDocAnnotation.UIvsDI'>7.29.1 - User Interfaces (UI)
vs. Developer Interfaces (DI)</a></h4>
+<div class='topic'><!-- START: 7.29.1 -
juneau-rest-server.HtmlDocAnnotation.UIvsDI -->
<p>
An important distinction needs to be made about the HTML
representations produced by the REST
API. These should not be considered User Interfaces, but rather
Developer Interfaces.
@@ -20161,12 +20256,12 @@
The architecture is flexible enough that you could in theory
pull in and use jQuery, React,
Angular, or any number of sophisticated Javascript UI
frameworks. Resist the urge to do so.
</ul>
-</div><!-- END: 7.28.1 - juneau-rest-server.HtmlDocAnnotation.UIvsDI -->
+</div><!-- END: 7.29.1 - juneau-rest-server.HtmlDocAnnotation.UIvsDI -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation.Widgets'
id='juneau-rest-server.HtmlDocAnnotation.Widgets'>7.28.2 - Widgets</a></h4>
-<div class='topic'><!-- START: 7.28.2 -
juneau-rest-server.HtmlDocAnnotation.Widgets -->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation.Widgets'
id='juneau-rest-server.HtmlDocAnnotation.Widgets'>7.29.2 - Widgets</a></h4>
+<div class='topic'><!-- START: 7.29.2 -
juneau-rest-server.HtmlDocAnnotation.Widgets -->
<p>
The {@link org.apache.juneau.rest.widget.Widget} class allows you to
add arbitrary HTML, CSS, and Javascript
to HTML pages.
@@ -20281,12 +20376,12 @@
<ul>
<li class='jf'>{@link org.apache.juneau.rest.RestContext#REST_widgets}
</ul>
-</div><!-- END: 7.28.2 - juneau-rest-server.HtmlDocAnnotation.Widgets -->
+</div><!-- END: 7.29.2 - juneau-rest-server.HtmlDocAnnotation.Widgets -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets'
id='juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets'>7.28.3 - Predefined
Widgets</a></h4>
-<div class='topic'><!-- START: 7.28.3 -
juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets -->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets'
id='juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets'>7.29.3 - Predefined
Widgets</a></h4>
+<div class='topic'><!-- START: 7.29.3 -
juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets -->
<p>
The {@link org.apache.juneau.rest.widget} package contains predefined
reusable widgets.
</p>
@@ -20524,12 +20619,12 @@
}
}
</p>
-</div><!-- END: 7.28.3 -
juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets -->
+</div><!-- END: 7.29.3 -
juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets -->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation.UiCustomization'
id='juneau-rest-server.HtmlDocAnnotation.UiCustomization'>7.28.4 - UI
Customization</a></h4>
-<div class='topic'><!-- START: 7.28.4 -
juneau-rest-server.HtmlDocAnnotation.UiCustomization -->
+<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation.UiCustomization'
id='juneau-rest-server.HtmlDocAnnotation.UiCustomization'>7.29.4 - UI
Customization</a></h4>
+<div class='topic'><!-- START: 7.29.4 -
juneau-rest-server.HtmlDocAnnotation.UiCustomization -->
<p>
The HTML views of POJOs can somewhat be considered a rudimentary User
Interface.
In reality, a better term for them would be a Developer Interface as
they're meant to be used
@@ -20674,12 +20769,12 @@
<ul>
<li class='link'>{@doc juneau-microservice-jetty.UiCustomization}
</ul>
-</div><!-- END: 7.28.4 - juneau-rest-server.HtmlDocAnnotation.UiCustomization
-->
+</div><!-- END: 7.29.4 - juneau-rest-server.HtmlDocAnnotation.UiCustomization
-->
<!--
====================================================================================================
-->
-<h4 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation.Stylesheets'
id='juneau-rest-server.HtmlDocAnnotation.Stylesheets'>7.28.5 -
Stylesheets</a></h4>
-<div class='topic'><!-- START: 7.28.5 -
juneau-rest-server.HtmlDocAnnotation.Stylesheets -->
+<h4 class='topic updated' onclick='toggle(this)'><a
href='#juneau-rest-server.HtmlDocAnnotation.Stylesheets'
id='juneau-rest-server.HtmlDocAnnotation.Stylesheets'>7.29.5 -
Stylesheets</a></h4>
+<div class='topic'><!-- START: 7.29.5 -
juneau-rest-server.HtmlDocAnnotation.Stylesheets -->
<p>
The sample root page renders in the default "devops" look-and-feel:
</p>
@@ -20706,7 +20801,7 @@
</p>
<img class='bordered w800'
src='doc-files/juneau-rest-server.Stylesheets.3.png'>
<p>
- The stylesheet URL is controlled by the {@link
org.apache.juneau.rest.annotation.HtmlDoc#stylesheet() @HtmlDoc(stylesheet)}
annotation.
+ The stylesheet URL is controlled by the {@link
org.apache.juneau.rest.annotation.HtmlDocConfig#stylesheet()
@HtmlDocConfig(stylesheet)} annotation.
The {@link org.apache.juneau.rest.BasicRestServlet} class defines the
stylesheet served up as a static file:
<p class='bpcode w800'>
<ja>@RestResource</ja>(
@@ -20789,13 +20884,13 @@
}
}
</p>
-</div><!-- END: 7.28.5 - juneau-rest-server.HtmlDocAnnotation.Stylesheets -->
-</div><!-- END: 7.28 - juneau-rest-server.HtmlDocAnnotation -->
+</div><!-- END: 7.29.5 - juneau-rest-server.HtmlDocAnnotation.Stylesheets -->
+</div><!-- END: 7.29 - juneau-rest-server.HtmlDocAnnotation -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.DefaultHeaders'
id='juneau-rest-server.DefaultHeaders'>7.29 - Default Headers</a></h3>
-<div class='topic'><!-- START: 7.29 - juneau-rest-server.DefaultHeaders -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.DefaultHeaders'
id='juneau-rest-server.DefaultHeaders'>7.30 - Default Headers</a></h3>
+<div class='topic'><!-- START: 7.30 - juneau-rest-server.DefaultHeaders -->
<p>
The following annotations are provided for specifying default header
values for requests and responses:
</p>
@@ -20837,12 +20932,12 @@
</ul>
</li>
</ul>
-</div><!-- END: 7.29 - juneau-rest-server.DefaultHeaders -->
+</div><!-- END: 7.30 - juneau-rest-server.DefaultHeaders -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.LoggingAndErrorHandling'
id='juneau-rest-server.LoggingAndErrorHandling'>7.30 - Logging and Error
Handling</a></h3>
-<div class='topic'><!-- START: 7.30 -
juneau-rest-server.LoggingAndErrorHandling -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.LoggingAndErrorHandling'
id='juneau-rest-server.LoggingAndErrorHandling'>7.31 - Logging and Error
Handling</a></h3>
+<div class='topic'><!-- START: 7.31 -
juneau-rest-server.LoggingAndErrorHandling -->
<p>
The {@link org.apache.juneau.rest.RestContext#REST_logger} property
allows you to configure
logging for your resource.
@@ -20901,12 +20996,12 @@
<li class='jm'>{@link
org.apache.juneau.rest.RestServlet#log(Level,String,Object...)}
<li class='jm'>{@link
org.apache.juneau.rest.RestServlet#log(Level,Throwable,String,Object...)}
</ul>
-</div><!-- END: 7.30 - juneau-rest-server.LoggingAndErrorHandling -->
+</div><!-- END: 7.31 - juneau-rest-server.LoggingAndErrorHandling -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HttpStatusCodes'
id='juneau-rest-server.HttpStatusCodes'>7.31 - HTTP Status Codes</a></h3>
-<div class='topic'><!-- START: 7.31 - juneau-rest-server.HttpStatusCodes -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.HttpStatusCodes'
id='juneau-rest-server.HttpStatusCodes'>7.32 - HTTP Status Codes</a></h3>
+<div class='topic'><!-- START: 7.32 - juneau-rest-server.HttpStatusCodes -->
<p>
By default, a 200 (OK) status is automatically set as the HTTP status
when a Java method executes
successfully.
@@ -20969,12 +21064,12 @@
<td>The Java method threw an exception other than {@link
org.apache.juneau.rest.RestException}</td>
</tr>
</table>
-</div><!-- END: 7.31 - juneau-rest-server.HttpStatusCodes -->
+</div><!-- END: 7.32 - juneau-rest-server.HttpStatusCodes -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.OverloadingHttpMethods'
id='juneau-rest-server.OverloadingHttpMethods'>7.32 - Overloading HTTP
Methods</a></h3>
-<div class='topic'><!-- START: 7.32 -
juneau-rest-server.OverloadingHttpMethods -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.OverloadingHttpMethods'
id='juneau-rest-server.OverloadingHttpMethods'>7.33 - Overloading HTTP
Methods</a></h3>
+<div class='topic'><!-- START: 7.33 -
juneau-rest-server.OverloadingHttpMethods -->
<p>
Through the use of the built-in <l>"method"</l> GET parameter, you can
implement requests beyond the basic
REST http method types.
@@ -20998,12 +21093,12 @@
allowedMethodParams=<js>"BAR"</js>
)
</p>
-</div><!-- END: 7.32 - juneau-rest-server.OverloadingHttpMethods -->
+</div><!-- END: 7.33 - juneau-rest-server.OverloadingHttpMethods -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.BuiltInParameters'
id='juneau-rest-server.BuiltInParameters'>7.33 - Built-in Parameters</a></h3>
-<div class='topic'><!-- START: 7.33 - juneau-rest-server.BuiltInParameters -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.BuiltInParameters'
id='juneau-rest-server.BuiltInParameters'>7.34 - Built-in Parameters</a></h3>
+<div class='topic'><!-- START: 7.34 - juneau-rest-server.BuiltInParameters -->
<p>
The following URL parameters have special meaning and can be passed in
through the URL of the request:
</p>
@@ -21063,12 +21158,12 @@
</td>
</tr>
</table>
-</div><!-- END: 7.33 - juneau-rest-server.BuiltInParameters -->
+</div><!-- END: 7.34 - juneau-rest-server.BuiltInParameters -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.CustomSerializersAndParsers'
id='juneau-rest-server.CustomSerializersAndParsers'>7.34 - Custom Serializers
and Parsers</a></h3>
-<div class='topic'><!-- START: 7.34 -
juneau-rest-server.CustomSerializersAndParsers -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.CustomSerializersAndParsers'
id='juneau-rest-server.CustomSerializersAndParsers'>7.35 - Custom Serializers
and Parsers</a></h3>
+<div class='topic'><!-- START: 7.35 -
juneau-rest-server.CustomSerializersAndParsers -->
<p>
A very easy-to-use API is provided for defining your own serializers
and parsers at both the servlet and
method levels.
@@ -21189,12 +21284,12 @@
}
}
</p>
-</div><!-- END: 7.34 - juneau-rest-server.CustomSerializersAndParsers -->
+</div><!-- END: 7.35 - juneau-rest-server.CustomSerializersAndParsers -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.UsingWithOsgi'
id='juneau-rest-server.UsingWithOsgi'>7.35 - Using with OSGi</a></h3>
-<div class='topic'><!-- START: 7.35 - juneau-rest-server.UsingWithOsgi -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.UsingWithOsgi'
id='juneau-rest-server.UsingWithOsgi'>7.36 - Using with OSGi</a></h3>
+<div class='topic'><!-- START: 7.36 - juneau-rest-server.UsingWithOsgi -->
<p>
Since REST servlets are basically just <l>HttpServlets</l>,
incorporating them into an OSGi environment
is pretty straightforward.
@@ -21256,12 +21351,12 @@
}
}
</p>
-</div><!-- END: 7.35 - juneau-rest-server.UsingWithOsgi -->
+</div><!-- END: 7.36 - juneau-rest-server.UsingWithOsgi -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Injection' id='juneau-rest-server.Injection'>7.36 -
Using with Spring and Injection frameworks</a></h3>
-<div class='topic'><!-- START: 7.36 - juneau-rest-server.Injection -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.Injection' id='juneau-rest-server.Injection'>7.37 -
Using with Spring and Injection frameworks</a></h3>
+<div class='topic'><!-- START: 7.37 - juneau-rest-server.Injection -->
<p>
The Juneau REST server API is compatible with dependency injection
frameworks such as Spring.
</p>
@@ -21363,24 +21458,24 @@
<jk>this</jk>.<jf>bean3</jf> = bean3;
}
</p>
-</div><!-- END: 7.36 - juneau-rest-server.Injection -->
+</div><!-- END: 7.37 - juneau-rest-server.Injection -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HTTP2'
id='juneau-rest-server.HTTP2'>7.37 - Using HTTP/2 features</a></h3>
-<div class='topic'><!-- START: 7.37 - juneau-rest-server.HTTP2 -->
+<h3 class='topic ' onclick='toggle(this)'><a href='#juneau-rest-server.HTTP2'
id='juneau-rest-server.HTTP2'>7.38 - Using HTTP/2 features</a></h3>
+<div class='topic'><!-- START: 7.38 - juneau-rest-server.HTTP2 -->
<p>
Juneau is built as a veneer on top of the Servlet API, allowing you to
use low-level Servlet APIs
whenever needed.
This allows you to take advantage of the newest HTTP/2 features
implemented in the new Servlet 4.0
specification.
</p>
-</div><!-- END: 7.37 - juneau-rest-server.HTTP2 -->
+</div><!-- END: 7.38 - juneau-rest-server.HTTP2 -->
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.OtherNotes' id='juneau-rest-server.OtherNotes'>7.38 -
Other Notes</a></h3>
-<div class='topic'><!-- START: 7.38 - juneau-rest-server.OtherNotes -->
+<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-rest-server.OtherNotes' id='juneau-rest-server.OtherNotes'>7.39 -
Other Notes</a></h3>
+<div class='topic'><!-- START: 7.39 - juneau-rest-server.OtherNotes -->
<ul class='spaced-list'>
<li>
Subclasses can use either {@link
javax.servlet.http.HttpServlet#init(ServletConfig)}
@@ -21391,7 +21486,7 @@
For example, to add a <l>"Refresh: 1"</l> header to the
response to auto-refresh a page, the following
parameter can be specified:
<l>"/sample?X-Response-Headers={Refresh=1}"</l>
</ul>
-</div><!-- END: 7.38 - juneau-rest-server.OtherNotes -->
+</div><!-- END: 7.39 - juneau-rest-server.OtherNotes -->
</div><!-- END: 7 - juneau-rest-server -->
<!--
====================================================================================================
-->
@@ -26326,7 +26421,7 @@
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-examples-rest.RootResources'
id='juneau-examples-rest.RootResources'>17.1 - RootResources</a></h3>
+<h3 class='topic updated' onclick='toggle(this)'><a
href='#juneau-examples-rest.RootResources'
id='juneau-examples-rest.RootResources'>17.1 - RootResources</a></h3>
<div class='topic'><!-- START: 17.1 - juneau-examples-rest.RootResources -->
<p>
The <l>RootResources</l> class is the main page for the REST
microservice.
@@ -26416,12 +26511,6 @@
<js>"</div>"</js>
}
),
- properties={
- <jc>// For testing purposes, we want to use single
quotes in all the serializers so it's easier to do simple
- // String comparisons.
- // You can apply any of the
Serializer/Parser/BeanContext settings this way.</jc>
-
<ja>@Property</ja>(name=<jsf>WSERIALIZER_quoteChar</jsf>, value=<js>"'"</js>)
- },
children={
HelloWorldResource.<jk>class</jk>,
PetStoreResource.<jk>class</jk>,
@@ -26432,6 +26521,11 @@
ShutdownResource.<jk>class</jk>
}
)
+ <ja>@SerializerConfig</ja>(
+ <jc>// For testing purposes, we want to use single quotes in
all the serializers so it's easier to do simple
+ // String comparisons.</jc>
+ quoteChar=<js>"'"</js>
+ )
<jk>public class</jk> RootResources <jk>extends</jk>
BasicRestServletJenaGroup {
<jc>// No code!</jc>
}
@@ -27908,7 +28002,7 @@
<!--
====================================================================================================
-->
-<h3 class='topic ' onclick='toggle(this)'><a
href='#juneau-examples-rest.DtoExamples'
id='juneau-examples-rest.DtoExamples'>17.4 - DtoExamples</a></h3>
+<h3 class='topic updated' onclick='toggle(this)'><a
href='#juneau-examples-rest.DtoExamples'
id='juneau-examples-rest.DtoExamples'>17.4 - DtoExamples</a></h3>
<div class='topic'><!-- START: 17.4 - juneau-examples-rest.DtoExamples -->
<p>
The <l>DtoExamples</l> resource is a resource group for demonstrating
various DTO examples.
@@ -27964,13 +28058,10 @@
<js>"source:
$C{Source/gitHub}/org/apache/juneau/examples/rest/$R{servletClassSimple}.java"</js>
}
),
- properties={
-
<ja>@Property</ja>(name=<jsf>SERIALIZER_quoteChar</jsf>, value=<js>"'"</js>),
- <ja>@Property</ja>(name=<jsf>RDF_rdfxml_tab</jsf>,
value=<js>"5"</js>),
- <ja>@Property</ja>(name=<jsf>RDF_addRootProperty</jsf>,
value=<js>"true"</js>)
- },
encoders=GzipEncoder.<jk>class</jk>
)
+ <ja>@SerializerConfig</ja>(quoteChar=<js>"'"</js>)
+ <ja>@RdfConfig</ja>(rdfxml_tab=<js>"5"</js>,
addRootProperty=<js>"true"</js>)
<jk>public class</jk> AtomFeedResource <jk>extends</jk>
BasicRestServletJena {
<jk>private</jk> Feed <jf>feed</jf>; <jc>// The root resource
object</jc>
@@ -28393,12 +28484,6 @@
<js>"</div>"</js>
}
),
- properties={
- <jc>// For testing purposes, we want to use single
quotes in all the serializers so it's easier to do simple
- // String comparisons.
- // You can apply any of the
Serializer/Parser/BeanContext settings this way.</jc>
-
<ja>@Property</ja>(name=<jsf>WSERIALIZER_quoteChar</jsf>, value=<js>"'"</js>)
- },
children={
HelloWorldResource.<jk>class</jk>,
PetStoreResource.<jk>class</jk>,
@@ -28408,6 +28493,11 @@
ShutdownResource.<jk>class</jk>
}
)
+ <ja>@SerializerConfig</ja>(
+ <jc>// For testing purposes, we want to use single quotes in
all the serializers so it's easier to do simple
+ // String comparisons.</jc>
+ quoteChar=<js>"'"</js>
+ )
<jk>public class</jk> RootResources <jk>extends</jk>
BasicRestServletJenaGroup {
<jc>// No code</jc>
}
@@ -28785,12 +28875,6 @@
<js>"</div>"</js>
}
),
- properties={
- <jc>// For testing purposes, we want to use single
quotes in all the serializers so it's easier to do simple
- // String comparisons.
- // You can apply any of the
Serializer/Parser/BeanContext settings this way.</jc>
-
<ja>@Property</ja>(name=<jsf>WSERIALIZER_quoteChar</jsf>, value=<js>"'"</js>)
- },
children={
HelloWorldResource.<jk>class</jk>,
PetStoreResource.<jk>class</jk>,
@@ -28800,6 +28884,11 @@
ShutdownResource.<jk>class</jk>
}
)
+ <ja>@SerializerConfig</ja>(
+ <jc>// For testing purposes, we want to use single quotes in
all the serializers so it's easier to do simple
+ // String comparisons.</jc>
+ quoteChar=<js>"'"</js>
+ )
<jk>public class</jk> RootResources <jk>extends</jk>
BasicRestServletJenaGroup {
<jc>// No code</jc>
}
@@ -35451,6 +35540,14 @@
TBD
</p>
+<h5 class='topic w800'>juneau-marshall</h5>
+<ul class='spaced-list'>
+ <li>
+ New utility class for diffing beans: {@link
org.apache.juneau.utils.BeanDiff}
+ <li>
+ New annotation for defining bean property names: {@link
org.apache.juneau.annotation.Name}
+</ul>
+
<h5 class='topic w800'>juneau-config</h5>
<ul class='spaced-list'>
<li>
@@ -35471,12 +35568,74 @@
<li>
Fixed a bug where instances of {@link
org.apache.juneau.config.store.ConfigMemoryStore} ended up resolving to the
same object.
<li>
-
+ Uses <js>"application.properties"</js> file as a system default
if present.
+ <br>Useful when being used in a Spring Boot application.
+ <li>
+ New {@link org.apache.juneau.config.Config#setSystemProperties}
method for quickly moving configuration settings into the
+ system properties.
+ <li>
+ Entries in the system config are automatically set as system
properties.
+ <br>This mean you can set any of the various serializer and
parser settings (e.g. <js>"JsonSerializer.simpleMode.b"</js>)
+ in the default configuration area or
<code>application.properties</code>.
</ul>
<h5 class='topic w800'>juneau-rest-server</h5>
<ul class='spaced-list'>
<li>
+ New annotations that can be applied to REST classes and methods
to configure serializers and parsers.
+ <p class='bcode w800'>
+ <jc>// Old way using generic properties.</jc>
+ <ja>@RestResource</ja>(
+ path=<js>"/atom"</js>,
+ title=<js>"Sample ATOM feed resource"</js>,
+ properties={
+
<ja>@Property</ja>(name=<jsf>WSERIALIZER_quoteChar</jsf>, value=<js>"'"</js>),
+ <ja>@Property</ja>(name=<jsf>RDF_rdfxml_tab</jsf>,
value=<js>"5"</js>),
+ <ja>@Property</ja>(name<jsf>RDF_addRootProperty</jsf>,
value=<js>"true"</js>),
+ <ja>@Property</ja>(name=<jsf>BEAN_examples</jsf>,
value=<js>"{'org.apache.juneau.dto.atom.Feed':
$F{AtomFeedResource_example.json}}"</js>)
+ }
+ ...
+ )
+ <jk>public class</jk> AtomFeedResource <jk>extends</jk>
BasicRestServletJena {
+ ...
+ }
+
+ <jc>New way using specific annotations.</jc>
+ <ja>@RestResource</ja>(
+ path=<js>"/atom"</js>,
+ title=<js>"Sample ATOM feed resource"</js>
+ ...
+ )
+ <ja>@SerializerConfig</ja>(quoteChar=<js>"'"</js>)
+ <ja>@RdfConfig</ja>(rdfxml_tab=<js>"5"</js>,
addRootProperty=<js>"true"</js>)
+ <ja>@BeanConfig</ja>(examples=<js>"Feed:
$F{AtomFeedResource_example.json}"</js>)
+ <jk>public class</jk> AtomFeedResource <jk>extends</jk>
BasicRestServletJena {
+ ...
+ }
+ </p>
+ <p>
+ Config annotations are provided for all serializers and
parsers:
+ </p>
+ <ul>
+ <li class='ja'>{@link
org.apache.juneau.annotation.BeanConfig BeanConfig}
+ <li class='ja'>{@link
org.apache.juneau.csv.annotation.CsvConfig CsvConfig}
+ <li class='ja'>{@link
org.apache.juneau.html.annotation.HtmlConfig HtmlConfig}
+ <li class='ja'>{@link
org.apache.juneau.html.annotation.HtmlDocConfig HtmlDocConfig}
+ <li class='ja'>{@link
org.apache.juneau.jso.annotation.JsoConfig JsoConfig}
+ <li class='ja'>{@link
org.apache.juneau.json.annotation.JsonConfig JsonConfig}
+ <li class='ja'>{@link
org.apache.juneau.jsonschema.annotation.JsonSchemaConfig JsonSchemaConfig}
+ <li class='ja'>{@link
org.apache.juneau.msgpack.annotation.MsgPackConfig MsgPackConfig}
+ <li class='ja'>{@link
org.apache.juneau.oapi.annotation.OpenApiConfig OpenApiConfig}
+ <li class='ja'>{@link
org.apache.juneau.parser.annotation.ParserConfig ParserConfig}
+ <li class='ja'>{@link
org.apache.juneau.plaintext.annotation.PlainTextConfig PlainTextConfig}
+ <li class='ja'>{@link
org.apache.juneau.jena.annotation.RdfConfig RdfConfig}
+ <li class='ja'>{@link
org.apache.juneau.serializer.annotation.SerializerConfig SerializerConfig}
+ <li class='ja'>{@link
org.apache.juneau.soap.annotation.SoapXmlConfig SoapXmlConfig}
+ <li class='ja'>{@link
org.apache.juneau.uon.annotation.UonConfig UonConfig}
+ <li class='ja'>{@link
org.apache.juneau.urlencoding.annotation.UrlEncodingConfig UrlEncodingConfig}
+ <li class='ja'>{@link
org.apache.juneau.xml.annotation.XmlConfig XmlConfig}
+ </ul>
+ <li>
Added the following classes that provide the same support as
the servlet classes but doesn't extend from <code>HttpServlet</code>.
<br>This fixes an issue where instances of {@link
org.apache.juneau.rest.BasicRestServlet} are registered as top-level servlets
even though
you don't want them to be.
diff --git a/juneau-doc/src/main/javadoc/resources/docs.txt
b/juneau-doc/src/main/javadoc/resources/docs.txt
index 3e557af..d5db59d 100644
--- a/juneau-doc/src/main/javadoc/resources/docs.txt
+++ b/juneau-doc/src/main/javadoc/resources/docs.txt
@@ -1,6 +1,7 @@
ARP = https://jena.apache.org/documentation/io/arp.html, arp.html
ConfigurableProperties = #juneau-marshall.ConfigurableProperties, Configurable
Properties
DefaultRestSvlVariables = #DefaultRestSvlVariables, Default REST SVL Variables
+DefaultSvlVariables = #juneau-svl.DefaultVarResolver, Default SVL Variables
GFM = https://help.github.com/articles/github-flavored-markdown, GFM syntax
HTML5 = https://www.w3.org/TR/html5, html5
HTML5.document-metadata = https://www.w3.org/TR/html5/document-metadata.html,
document-metadata.html
@@ -170,7 +171,7 @@ juneau-marshall.ReadingContinuousStreams =
#juneau-marshall.ReadingContinuousStr
juneau-marshall.Recursion = #juneau-marshall.Recursion, Overview >
juneau-marshall > Non-Tree Models and Recursion Detection
juneau-marshall.Serializers = #juneau-marshall.Serializers, Overview >
juneau-marshall > Serializers
juneau-marshall.Transforms = #juneau-marshall.Transforms, Overview >
juneau-marshall > Transforms
-juneau-marshall.Transforms.BeanAnnotation =
#juneau-marshall.Transforms.BeanAnnotation, Overview > juneau-marshall >
Transforms > @BeanProperty Annotation
+juneau-marshall.Transforms.BeanAnnotation =
#juneau-marshall.Transforms.BeanAnnotation, Overview > juneau-marshall >
Transforms > @Bean Annotation
juneau-marshall.Transforms.BeanConstructorAnnotation =
#juneau-marshall.Transforms.BeanConstructorAnnotation, Overview >
juneau-marshall > Transforms > @BeanConstructor Annotation
juneau-marshall.Transforms.BeanFilters =
#juneau-marshall.Transforms.BeanFilters, Overview > juneau-marshall >
Transforms > BeanFilter Class
juneau-marshall.Transforms.BeanIgnoreAnnotation =
#juneau-marshall.Transforms.BeanIgnoreAnnotation, Overview > juneau-marshall >
Transforms > @BeanIgnore Annotation
@@ -263,6 +264,7 @@ juneau-rest-server-springboot.Overview =
#juneau-rest-server-springboot.Overview
juneau-rest-server.BuiltInParameters = #juneau-rest-server.BuiltInParameters,
Overview > juneau-rest-server > Built-in Parameters
juneau-rest-server.ClassHierarchy = #juneau-rest-server.ClassHierarchy,
Overview > juneau-rest-server > Class Hierarchy
juneau-rest-server.ClientVersioning = #juneau-rest-server.ClientVersioning,
Overview > juneau-rest-server > Client Versioning
+juneau-rest-server.ConfigAnnotations = #juneau-rest-server.ConfigAnnotations,
Overview > juneau-rest-server > Config annotations
juneau-rest-server.ConfigurationFiles =
#juneau-rest-server.ConfigurationFiles, Overview > juneau-rest-server >
Configuration Files
juneau-rest-server.Converters = #juneau-rest-server.Converters, Overview >
juneau-rest-server > Converters
juneau-rest-server.CustomSerializersAndParsers =
#juneau-rest-server.CustomSerializersAndParsers, Overview > juneau-rest-server
> Custom Serializers and Parsers
@@ -273,12 +275,12 @@ juneau-rest-server.HTTP2 = #juneau-rest-server.HTTP2,
Overview > juneau-rest-ser
juneau-rest-server.HandlingFormPosts = #juneau-rest-server.HandlingFormPosts,
Overview > juneau-rest-server > Handling Form Posts
juneau-rest-server.HandlingMultiPartFormPosts =
#juneau-rest-server.HandlingMultiPartFormPosts, Overview > juneau-rest-server >
Handling Multi-Part Form Posts
juneau-rest-server.HelloWorldExample = #juneau-rest-server.HelloWorldExample,
Overview > juneau-rest-server > Hello World Example
-juneau-rest-server.HtmlDocAnnotation = #juneau-rest-server.HtmlDocAnnotation,
Overview > juneau-rest-server > @HtmlDoc
-juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets =
#juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets, Overview >
juneau-rest-server > @HtmlDoc > Predefined Widgets
-juneau-rest-server.HtmlDocAnnotation.Stylesheets =
#juneau-rest-server.HtmlDocAnnotation.Stylesheets, Overview >
juneau-rest-server > @HtmlDoc > Stylesheets
-juneau-rest-server.HtmlDocAnnotation.UIvsDI =
#juneau-rest-server.HtmlDocAnnotation.UIvsDI, Overview > juneau-rest-server >
@HtmlDoc > User Interfaces (UI) vs. Developer Interfaces (DI)
-juneau-rest-server.HtmlDocAnnotation.UiCustomization =
#juneau-rest-server.HtmlDocAnnotation.UiCustomization, Overview >
juneau-rest-server > @HtmlDoc > UI Customization
-juneau-rest-server.HtmlDocAnnotation.Widgets =
#juneau-rest-server.HtmlDocAnnotation.Widgets, Overview > juneau-rest-server >
@HtmlDoc > Widgets
+juneau-rest-server.HtmlDocAnnotation = #juneau-rest-server.HtmlDocAnnotation,
Overview > juneau-rest-server > @HtmlDocConfig
+juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets =
#juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets, Overview >
juneau-rest-server > @HtmlDocConfig > Predefined Widgets
+juneau-rest-server.HtmlDocAnnotation.Stylesheets =
#juneau-rest-server.HtmlDocAnnotation.Stylesheets, Overview >
juneau-rest-server > @HtmlDocConfig > Stylesheets
+juneau-rest-server.HtmlDocAnnotation.UIvsDI =
#juneau-rest-server.HtmlDocAnnotation.UIvsDI, Overview > juneau-rest-server >
@HtmlDocConfig > User Interfaces (UI) vs. Developer Interfaces (DI)
+juneau-rest-server.HtmlDocAnnotation.UiCustomization =
#juneau-rest-server.HtmlDocAnnotation.UiCustomization, Overview >
juneau-rest-server > @HtmlDocConfig > UI Customization
+juneau-rest-server.HtmlDocAnnotation.Widgets =
#juneau-rest-server.HtmlDocAnnotation.Widgets, Overview > juneau-rest-server >
@HtmlDocConfig > Widgets
juneau-rest-server.HttpPartAnnotations =
#juneau-rest-server.HttpPartAnnotations, Overview > juneau-rest-server >
HTTP-Part Annotations
juneau-rest-server.HttpPartAnnotations.Body =
#juneau-rest-server.HttpPartAnnotations.Body, Overview > juneau-rest-server >
HTTP-Part Annotations > @Body
juneau-rest-server.HttpPartAnnotations.FormData =
#juneau-rest-server.HttpPartAnnotations.FormData, Overview > juneau-rest-server
> HTTP-Part Annotations > @FormData
@@ -351,6 +353,7 @@ juneau-rest-server.URIs = #juneau-rest-server.URIs,
Overview > juneau-rest-serve
juneau-rest-server.UsingWithOsgi = #juneau-rest-server.UsingWithOsgi, Overview
> juneau-rest-server > Using with OSGi
juneau-rest-server.restRPC = #juneau-rest-server.restRPC, Overview >
juneau-rest-server > restRPC
juneau-svl = #juneau-svl, Overview > juneau-svl
+juneau-svl.DefaultVarResolver = #juneau-svl.DefaultVarResolver, Overview >
juneau-svl > VarResolver.DEFAULT
juneau-svl.OtherNotes = #juneau-svl.OtherNotes, Overview > juneau-svl > Other
Notes
juneau-svl.SimpleVarLanguage = #juneau-svl.SimpleVarLanguage, Overview >
juneau-svl > Simple Variable Language
juneau-svl.SvlVariables = #juneau-svl.SvlVariables, Overview > juneau-svl >
SVL Variables
diff --git a/juneau-doc/src/main/javadoc/resources/fragments/toc.html
b/juneau-doc/src/main/javadoc/resources/fragments/toc.html
index fc443dc..48503cb 100644
--- a/juneau-doc/src/main/javadoc/resources/fragments/toc.html
+++ b/juneau-doc/src/main/javadoc/resources/fragments/toc.html
@@ -43,9 +43,9 @@
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.TemplatedSwaps'>Templated
Swaps</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.SwapMethods'>Swap
Methods</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.SurrogateClasses'>Surrogate
Classes</a></p>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.BeanAnnotation'>@BeanProperty
Annotation</a></p>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.BeanPropertyAnnotation'>@BeanProperty
Annotation</a></p>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.BeanConstructorAnnotation'>@BeanConstructor
Annotation</a></p>
+ <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.BeanAnnotation'>@Bean
Annotation</a></p>
+ <li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.BeanPropertyAnnotation'>@BeanProperty
Annotation</a></p>
+ <li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.BeanConstructorAnnotation'>@BeanConstructor
Annotation</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.BeanIgnoreAnnotation'>@BeanIgnore
Annotation</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.NamePropertyAnnotation'>@NameProperty
Annotation</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-marshall.Transforms.ParentPropertyAnnotation'>@ParentProperty
Annotation</a></p>
@@ -147,8 +147,9 @@
<li><p class='toc2'><a class='doclink'
href='{OVERVIEW_URL}#juneau-svl'>juneau-svl</a></p>
<ol>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-svl.SimpleVarLanguage'>Simple Variable
Language</a></p>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-svl.SvlVariables'>SVL Variables</a></p>
+ <li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-svl.SvlVariables'>SVL Variables</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-svl.VarResolvers'>VarResolvers and
VarResolverSessions</a></p>
+ <li><p class='new'><a class='doclink'
href='{OVERVIEW_URL}#juneau-svl.DefaultVarResolver'>VarResolver.DEFAULT</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-svl.OtherNotes'>Other Notes</a></p>
</ol>
<li><p class='toc2'><a class='doclink'
href='{OVERVIEW_URL}#juneau-config'>juneau-config</a></p>
@@ -191,7 +192,7 @@
</ol>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-config.ReadOnlyConfigs'>Read-only Configs</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-config.ClosingConfigs'>Closing Configs</a></p>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-config.SystemDefaultConfig'>System Default
Config</a></p>
+ <li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-config.SystemDefaultConfig'>System Default
Config</a></p>
</ol>
<li><p class='toc2'><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server'>juneau-rest-server</a></p>
<ol>
@@ -200,7 +201,7 @@
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Instantiation'>Instantiation</a></p>
<ol>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Instantiation.RestServlet'>RestServlet</a></p>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Instantiation.BasicRestServlet'>BasicRestServlet</a></p>
+ <li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Instantiation.BasicRestServlet'>BasicRestServlet</a></p>
<li><p class='new'><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Instantiation.BasicRest'>BasicRest</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Instantiation.Children'>Children</a></p>
<li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Instantiation.BasicRestServletGroup'>BasicRestServletGroup</a></p>
@@ -254,6 +255,7 @@
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Serializers'>Serializers</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Parsers'>Parsers</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Properties'>Properties</a></p>
+ <li><p class='new'><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.ConfigAnnotations'>Config
annotations</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Transforms'>Transforms</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.URIs'>URIs</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Guards'>Guards</a></p>
@@ -270,24 +272,24 @@
</ol>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger'>Swagger</a></p>
<ol>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.BasicRestServlet'>BasicRestServlet</a></p>
+ <li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.BasicRestServlet'>BasicRestServlet</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.BasicSwaggerInfo'>Basic Swagger
Info</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.Tags'>Tags</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.Operations'>Operations</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.Parameters'>Parameters</a></p>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.ParameterExamples'>Parameter
Examples</a></p>
+ <li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.ParameterExamples'>Parameter
Examples</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.Responses'>Responses</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.ResponseExamples'>Response
Examples</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.Models'>Models</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.Swagger.Stylesheet'>SwaggerUI.css</a></p>
</ol>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.HtmlDocAnnotation'>@HtmlDoc</a></p>
+ <li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.HtmlDocAnnotation'>@HtmlDocConfig</a></p>
<ol>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.HtmlDocAnnotation.UIvsDI'>User
Interfaces (UI) vs. Developer Interfaces (DI)</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.HtmlDocAnnotation.Widgets'>Widgets</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.HtmlDocAnnotation.PredefinedWidgets'>Predefined
Widgets</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.HtmlDocAnnotation.UiCustomization'>UI
Customization</a></p>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.HtmlDocAnnotation.Stylesheets'>Stylesheets</a></p>
+ <li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.HtmlDocAnnotation.Stylesheets'>Stylesheets</a></p>
</ol>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.DefaultHeaders'>Default Headers</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-rest-server.LoggingAndErrorHandling'>Logging and
Error Handling</a></p>
@@ -386,10 +388,10 @@
</ol>
<li><p class='toc2'><a class='doclink'
href='{OVERVIEW_URL}#juneau-examples-rest'>juneau-examples-rest</a></p>
<ol>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-examples-rest.RootResources'>RootResources</a></p>
+ <li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-examples-rest.RootResources'>RootResources</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-examples-rest.HelloWorldResource'>HelloWorldResource</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-examples-rest.PetStoreResource'>PetStore</a></p>
- <li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-examples-rest.DtoExamples'>DtoExamples</a></p>
+ <li><p class='updated'><a class='doclink'
href='{OVERVIEW_URL}#juneau-examples-rest.DtoExamples'>DtoExamples</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-examples-rest.ConfigResource'>ConfigResource</a></p>
<li><p class=''><a class='doclink'
href='{OVERVIEW_URL}#juneau-examples-rest.LogsResource'>LogsResource</a></p>
</ol>
