You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2022/12/27 15:33:43 UTC
[juneau] branch jbUpgradeHttpClientTo4514 created (now b4c715fd8)
This is an automated email from the ASF dual-hosted git repository.
jamesbognar pushed a change to branch jbUpgradeHttpClientTo4514
in repository https://gitbox.apache.org/repos/asf/juneau.git
at b4c715fd8 Fix javadocs
This branch includes the following new commits:
new b4c715fd8 Fix javadocs
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
[juneau] 01/01: Fix javadocs
Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
jamesbognar pushed a commit to branch jbUpgradeHttpClientTo4514
in repository https://gitbox.apache.org/repos/asf/juneau.git
commit b4c715fd847c4f3d5d060ce40aa856d495181e72
Author: JamesBognar <ja...@salesforce.com>
AuthorDate: Tue Dec 27 10:33:07 2022 -0500
Fix javadocs
---
juneau-doc/docs/ReleaseNotes/6.2.0.html | 2 +-
juneau-doc/docs/ReleaseNotes/6.3.0.html | 8 ++++----
juneau-doc/docs/Topics/01.Overview/03.o.RestServer.html | 6 +++---
juneau-doc/docs/Topics/08.juneau-rest-server.html | 4 ++--
juneau-doc/docs/Topics/08.juneau-rest-server/01.jrs.Overview.html | 2 +-
.../02.jrs.AnnotatedClasses/01.jrs.PredefinedClasses.html | 4 ++--
.../Topics/08.juneau-rest-server/06.jrs.HandlingFormPosts.html | 2 +-
.../docs/Topics/08.juneau-rest-server/19.jrs.HttpStatusCodes.html | 2 +-
.../docs/Topics/08.juneau-rest-server/22.jrs.RestContext.html | 2 +-
.../docs/Topics/08.juneau-rest-server/29.jrs.OtherNotes.html | 4 ++--
.../docs/Topics/11.juneau-rest-mock/01.jrm.MockRestClient.html | 2 +-
juneau-env.sh | 2 +-
12 files changed, 20 insertions(+), 20 deletions(-)
diff --git a/juneau-doc/docs/ReleaseNotes/6.2.0.html b/juneau-doc/docs/ReleaseNotes/6.2.0.html
index 33c3d36de..54da0ac65 100644
--- a/juneau-doc/docs/ReleaseNotes/6.2.0.html
+++ b/juneau-doc/docs/ReleaseNotes/6.2.0.html
@@ -123,7 +123,7 @@
<br><br>
The majority of code has been split up into two separate classes:
<ul>
- <li><del>RestConfig</del> - A modifiable configuration of a resource. Subclasses from {@link javax.servlet.ServletConfig}.
+ <li><del>RestConfig</del> - A modifiable configuration of a resource. Subclasses from <del>javax.servlet.ServletConfig</del>.
<li>{@link oajr.RestContext} - A read-only configuration that's the result of a snapshot of the config.
</ul>
<br><br>
diff --git a/juneau-doc/docs/ReleaseNotes/6.3.0.html b/juneau-doc/docs/ReleaseNotes/6.3.0.html
index d8164ad5b..842dd510d 100644
--- a/juneau-doc/docs/ReleaseNotes/6.3.0.html
+++ b/juneau-doc/docs/ReleaseNotes/6.3.0.html
@@ -202,9 +202,9 @@
<br>For reference, the previous supported types were:
<ul>
<li>{@link oajr.RestRequest} - The request object.
- <li>{@link javax.servlet.http.HttpServletRequest} - The superclass of <c>RestRequest</c>.
+ <li><del>javax.servlet.http.HttpServletRequest</del> - The superclass of <c>RestRequest</c>.
<li>{@link oajr.RestResponse} - The response object.
- <li>{@link javax.servlet.http.HttpServletResponse} - The superclass of <c>RestResponse</c>.
+ <li><del>javax.servlet.http.HttpServletResponse</del> - The superclass of <c>RestResponse</c>.
</ul>
The new supported types are:
<ul>
@@ -238,10 +238,10 @@
<li><del>Warning</del>
<li>{@link java.util.TimeZone}
<li>{@link java.io.InputStream}
- <li>{@link javax.servlet.ServletInputStream}
+ <li><del>javax.servlet.ServletInputStream</del>
<li>{@link java.io.Reader}
<li>{@link java.io.OutputStream}
- <li>{@link javax.servlet.ServletOutputStream}
+ <li><del>javax.servlet.ServletOutputStream</del>
<li>{@link java.io.Writer}
<li>{@link java.util.ResourceBundle} - Client-localized resource bundle.
<li><del>MessageBundle</del> - A resource bundle with additional features.
diff --git a/juneau-doc/docs/Topics/01.Overview/03.o.RestServer.html b/juneau-doc/docs/Topics/01.Overview/03.o.RestServer.html
index 3d3f407b2..e7a9f93ba 100644
--- a/juneau-doc/docs/Topics/01.Overview/03.o.RestServer.html
+++ b/juneau-doc/docs/Topics/01.Overview/03.o.RestServer.html
@@ -20,7 +20,7 @@
<p>
A REST resource is simply a Java class annotated with {@link oajr.annotation.Rest}.
The most common case is a class that extends {@link oajr.servlet.BasicRestServlet}, which itself is simply an
- extension of {@link javax.servlet.http.HttpServlet} which allows it to be deployed as a servlet.
+ extension of {@link jakarta.servlet.http.HttpServlet} which allows it to be deployed as a servlet.
</p>
<p class='bjava'>
| <jc>// Sample REST resource that prints out a simple "Hello world!" message.</jc>
@@ -404,7 +404,7 @@
</ul>
<li>A wide range of possible argument types including:
<ul>
- <li>Standard {@link javax.servlet.http.HttpServletRequest} / {@link javax.servlet.http.HttpServletResponse} objects.
+ <li>Standard {@link jakarta.servlet.http.HttpServletRequest} / {@link jakarta.servlet.http.HttpServletResponse} objects.
<li>Extended {@link oajr.RestRequest} / {@link oajr.RestResponse} objects.
<li>Parsed HTTP parts with either the arguments or beans annotated with {@link oaj.http.annotation.Path @Path} / {@link oaj.http.annotation.Header @Header} / {@link oaj.http.annotation.Query @Query} / {@link oaj.http.annotation.FormData @FormData}.
<li>Parsed HTTP body with either the argument or bean annotated with {@link oaj.http.annotation.Content @Content}.
@@ -414,7 +414,7 @@
<li>Response beans annotated with {@link oaj.http.annotation.Response @Response}.
<li>Standard HTTP headers such as {@link oaj.http.header.Accept} and {@link oaj.http.header.ContentType} provided in {@link oaj.http.header} package.
<li>Auto-generated {@link oaj.dto.swagger.Swagger}.
- <li>Various other standard objects such as {@link java.security.Principal}, {@link javax.servlet.http.Cookie}, {@link javax.servlet.http.HttpSession}, and {@link java.util.ResourceBundle}.
+ <li>Various other standard objects such as {@link java.security.Principal}, {@link jakarta.servlet.http.Cookie}, {@link jakarta.servlet.http.HttpSession}, and {@link java.util.ResourceBundle}.
<li>Spring beans or other injectable beans.
<li>Extensible API for defining custom argument types.
</ul>
diff --git a/juneau-doc/docs/Topics/08.juneau-rest-server.html b/juneau-doc/docs/Topics/08.juneau-rest-server.html
index 7d1c0a76b..6f6b4d41b 100644
--- a/juneau-doc/docs/Topics/08.juneau-rest-server.html
+++ b/juneau-doc/docs/Topics/08.juneau-rest-server.html
@@ -52,9 +52,9 @@
<p>
The API builds upon the existing JEE Servlet API.
The root class, {@link oajr.servlet.RestServlet} is nothing but a specialized
- {@link javax.servlet.http.HttpServlet}, and the {@link oajr.RestRequest} and
+ {@link jakarta.servlet.http.HttpServlet}, and the {@link oajr.RestRequest} and
{@link oajr.RestResponse} classes are nothing more than specialized
- {@link javax.servlet.http.HttpServletRequest} and {@link javax.servlet.http.HttpServletResponse} objects.
+ {@link jakarta.servlet.http.HttpServletRequest} and {@link jakarta.servlet.http.HttpServletResponse} objects.
This allows maximum flexibility for the developer since you can let Juneau handle operations such as
serialization, or you can revert to the existing servlet APIs to do low-level processing of requests yourself.
It also means you need nothing more than a Servlet container such as Jetty to use the REST framework.
diff --git a/juneau-doc/docs/Topics/08.juneau-rest-server/01.jrs.Overview.html b/juneau-doc/docs/Topics/08.juneau-rest-server/01.jrs.Overview.html
index efbc5c3d7..6864d2daa 100644
--- a/juneau-doc/docs/Topics/08.juneau-rest-server/01.jrs.Overview.html
+++ b/juneau-doc/docs/Topics/08.juneau-rest-server/01.jrs.Overview.html
@@ -19,7 +19,7 @@
<p>
A REST resource is simply a Java class annotated with {@link oajr.annotation.Rest @Rest}.
The most common case is a class that extends {@link oajr.servlet.BasicRestServlet}, which itself is simply an
- extension of {@link javax.servlet.http.HttpServlet} which allows it to be deployed as a servlet.
+ extension of {@link jakarta.servlet.http.HttpServlet} which allows it to be deployed as a servlet.
</p>
<p>
Juneau has two sample applications for demonstrating how to use the REST API, one using Jetty and one using
diff --git a/juneau-doc/docs/Topics/08.juneau-rest-server/02.jrs.AnnotatedClasses/01.jrs.PredefinedClasses.html b/juneau-doc/docs/Topics/08.juneau-rest-server/02.jrs.AnnotatedClasses/01.jrs.PredefinedClasses.html
index 39d6692df..61c612426 100644
--- a/juneau-doc/docs/Topics/08.juneau-rest-server/02.jrs.AnnotatedClasses/01.jrs.PredefinedClasses.html
+++ b/juneau-doc/docs/Topics/08.juneau-rest-server/02.jrs.AnnotatedClasses/01.jrs.PredefinedClasses.html
@@ -45,7 +45,7 @@
functionality and to handle different use-cases. Users will typically extend from one of these <c>Basic*</c> classes:
</p>
<ul class='javatree'>
- <li class='jac'>{@link javax.servlet.http.HttpServlet}
+ <li class='jac'>{@link jakarta.servlet.http.HttpServlet}
<ul>
<li class='jac'>{@link oajr.servlet.RestServlet}
<ul>
@@ -168,7 +168,7 @@
</p>
<p>
The <c>*Object*</c> classes provide the same functionality as the servlet
- classes but do not extend from {@link javax.servlet.http.HttpServlet}.
+ classes but do not extend from {@link jakarta.servlet.http.HttpServlet}.
This becomes important in Spring Boot environments where you may want to
define child resources as Spring Beans but don't want Spring Boot to auto-detect
them as servlets to be deployed as top-level resources. This is less important
diff --git a/juneau-doc/docs/Topics/08.juneau-rest-server/06.jrs.HandlingFormPosts.html b/juneau-doc/docs/Topics/08.juneau-rest-server/06.jrs.HandlingFormPosts.html
index a6f4c8001..42263bbca 100644
--- a/juneau-doc/docs/Topics/08.juneau-rest-server/06.jrs.HandlingFormPosts.html
+++ b/juneau-doc/docs/Topics/08.juneau-rest-server/06.jrs.HandlingFormPosts.html
@@ -68,7 +68,7 @@
</p>
<div class='warn'>
If you're using form input beans, DO NOT use the <l>@FormData</l> attribute or
- {@link javax.servlet.http.HttpServletRequest#getParameter(String)} method since this will cause the
+ {@link jakarta.servlet.http.HttpServletRequest#getParameter(String)} method since this will cause the
underlying JEE servlet to parse the HTTP body as a form post.
<br>Your input bean will end up being null since there won't be any content left after the servlet
has parsed the body of the request.
diff --git a/juneau-doc/docs/Topics/08.juneau-rest-server/19.jrs.HttpStatusCodes.html b/juneau-doc/docs/Topics/08.juneau-rest-server/19.jrs.HttpStatusCodes.html
index 2bac86dab..560fa215d 100644
--- a/juneau-doc/docs/Topics/08.juneau-rest-server/19.jrs.HttpStatusCodes.html
+++ b/juneau-doc/docs/Topics/08.juneau-rest-server/19.jrs.HttpStatusCodes.html
@@ -22,7 +22,7 @@
</p>
<p>
Other status codes can be generated by throwing a {@link oaj.http.response.BasicHttpException} with a
- specific HTTP status code, or calling {@link javax.servlet.http.HttpServletResponse#setStatus(int)}.
+ specific HTTP status code, or calling {@link jakarta.servlet.http.HttpServletResponse#setStatus(int)}.
</p>
<p>
Non-OK (200) status codes are automatically triggered by the following conditions:
diff --git a/juneau-doc/docs/Topics/08.juneau-rest-server/22.jrs.RestContext.html b/juneau-doc/docs/Topics/08.juneau-rest-server/22.jrs.RestContext.html
index c1a66ddcd..b3fe354e7 100644
--- a/juneau-doc/docs/Topics/08.juneau-rest-server/22.jrs.RestContext.html
+++ b/juneau-doc/docs/Topics/08.juneau-rest-server/22.jrs.RestContext.html
@@ -28,7 +28,7 @@
<p>
The {@link oajr.RestContext.Builder} class extends {@link oaj.BeanContext.Builder}
allowing you to programmatically set any properties defined on that builder class.
- It also implements {@link javax.servlet.ServletConfig}
+ It also implements {@link jakarta.servlet.ServletConfig}
</p>
<p>
To access this object, simply pass it in as a constructor argument or in an INIT hook:
diff --git a/juneau-doc/docs/Topics/08.juneau-rest-server/29.jrs.OtherNotes.html b/juneau-doc/docs/Topics/08.juneau-rest-server/29.jrs.OtherNotes.html
index 90ec1b1c9..7fec40286 100644
--- a/juneau-doc/docs/Topics/08.juneau-rest-server/29.jrs.OtherNotes.html
+++ b/juneau-doc/docs/Topics/08.juneau-rest-server/29.jrs.OtherNotes.html
@@ -18,8 +18,8 @@
<div class='topic'>
<ul class='notes'>
<li class='note'>
- Subclasses can use either {@link javax.servlet.http.HttpServlet#init(ServletConfig)}
- or {@link javax.servlet.http.HttpServlet#init()} for initialization just like any other servlet.
+ Subclasses can use either {@link jakarta.servlet.http.HttpServlet#init(ServletConfig)}
+ or {@link jakarta.servlet.http.HttpServlet#init()} for initialization just like any other servlet.
<li class='note'>
The <l>X-Response-Headers</l> header can be used to pass through header values into the response.
The value should be a URL-encoded map of key-value pairs.
diff --git a/juneau-doc/docs/Topics/11.juneau-rest-mock/01.jrm.MockRestClient.html b/juneau-doc/docs/Topics/11.juneau-rest-mock/01.jrm.MockRestClient.html
index 302c95919..1e39c5db1 100644
--- a/juneau-doc/docs/Topics/11.juneau-rest-mock/01.jrm.MockRestClient.html
+++ b/juneau-doc/docs/Topics/11.juneau-rest-mock/01.jrm.MockRestClient.html
@@ -147,7 +147,7 @@
<hr>
<p>
The {@link oajr.mock.MockRestRequest} object has convenience methods provided to allow you to set properties
- directly on the underlying {@link javax.servlet.http.HttpServletRequest} object. The following example shows how
+ directly on the underlying {@link jakarta.servlet.http.HttpServletRequest} object. The following example shows how
this can be used to directly set roles on the request object to perform security testing.
</p>
<h5 class='figure'>Example:</h5>
diff --git a/juneau-env.sh b/juneau-env.sh
index 9def82841..923e2b85f 100755
--- a/juneau-env.sh
+++ b/juneau-env.sh
@@ -14,7 +14,7 @@
. ~/.profile
set -e
export JUNEAU_VERSION=9.0.0
-export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-14.jdk/Contents/Home
+export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-18.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH
export PATH=/opt/homebrew/bin:$PATH
export GPG_TTY=$(tty)