Skip to content

Commit 2f3eb9b

Browse files
Doc and release notes updates for 2.0.0
1 parent c4ae926 commit 2f3eb9b

File tree

2 files changed

+25
-15
lines changed

2 files changed

+25
-15
lines changed

src/site/markdown/release-notes/2.0.0.md

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,23 +2,34 @@ Apache Axis2 2.0.0 Release Notes
22
--------------------------------
33

44
This release marks the transition to jakarta that has been tested with Tomcat 11
5-
and Wildfly 32, and is expected to support EE 10 and Spring 6 / Spring Boot 3.
5+
and Wildfly 32 and above, and is expected to support EE 10 and Spring 6 / Spring Boot 3.
66

77
The Axis2 project transition to jakarta depends partly on Axiom, which has also been updated to 2.0.0.
88

9+
The JSON support has been updated with many bugs fixed, while the examples have
10+
been updated to use Spring Boot 3. Axis2 isn't just for SOAP anymore, as some committers currently only use JSON in their own projects and not SOAP at all.
11+
912
The main purpose of the release is to upgrade everything possible to the latest,
10-
and have our Jira issues cleaned up.
13+
and have our Jira issues cleaned up. Many issues have been fixed.
14+
15+
New features that may happen in the future are HTTP/2 support and OpenAPI. Let us
16+
know on the dev list if interested.
1117

12-
The most likely way to get a Jira issue fixed is with a GitHub PR, due to
18+
The most likely way to get a Jira issue fixed is with a GitHub PR or patch, due to
1319
the large amount of Axis2 features that are unused by the committers and therefore
1420
difficult to test a fix.
1521

22+
If your Jira issue is unfixed, please reach out and work with the committers on
23+
some type of code contibution and testing as some issues are just too deep in areas that the comitters don't use ourselves.
24+
1625
The 2.0.0 release lacks a few features in previous releases because of a lack of
1726
adequate GitHub PR's.
1827

1928
These missing features include preemptive basic authentication, though there is a work around explained in the Jira issue https://issues.apache.org/jira/browse/AXIS2-6055 .
2029

21-
OSGI support is also missing. The state of its dependency Felix and jakarta is unclear. This feature has code that is difficult to support and lacks GitHub PR's after several attempts
22-
to gain volunteers. We hope to support oSGI again in 2.0.1.
30+
OSGI support is also missing. The state of its dependency Felix and jakarta is unclear. This feature has code that is difficult to support and lacks GitHub PR's after several attempts to gain volunteers. We hope to support OSGI again in 2.0.1.
31+
32+
For those interested in Rampart - an optional implementation of WS-Sec* standards that depends on Axis2 - they can expect a Rampart 2.0.0 soon that isn't expected to add much to the recently released Rampart 1.8.0 which is based on the previous Axis2 version, 1.8.2. Mostly that Rampart 2.0.0 release will upgrade OpenSAML to 5.x that supports jakarta, while the remaining deps that need updates are few.
2333

24-
For those interested in Rampart - an optional implementation of WS-Sec* standards that depends on Axis2 - they can expect a Rampart 2.0.0 soon that isn't expected to add much to the recently released Rampart 1.8.0 which is based on the previous Axis2 version, 1.8.2.
34+
Axis2 added two committers recently and after this big jakarta update, the community
35+
can once again expect releases several times a year to fix bugs and resolve deps with CVE's.

src/site/xdoc/docs/http-transport.xml

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -118,7 +118,7 @@ set the cached httpclient object when your application starts up
118118
(before any actual axis request). You can set the relevant property
119119
as shown below by using HTTPConstants.CACHED_HTTP_CLIENT. </p>
120120

121-
<p>The following code was testing Axis2 on Wildfly 20, the cert was obtained by
121+
<p>The following code was tested with Axis2 on Wildfly 32, the cert was obtained by
122122
'openssl s_client -connect myserver:8443 -showcerts' </p>
123123

124124
<pre>
@@ -136,20 +136,15 @@ as shown below by using HTTPConstants.CACHED_HTTP_CLIENT. </p>
136136
throw new Exception("Unexpected default trust managers:" + Arrays.toString(trustManagers));
137137
}
138138

139-
SSLContext sslContext = SSLContext.getInstance("TLSv1.2");
139+
SSLContext sslContext = SSLContext.getInstance("TLSv1.3");
140140
sslContext.init(null, trustManagers, new SecureRandom());
141141

142142
// NoopHostnameVerifier to trust self-singed cert
143143
SSLConnectionSocketFactory sslsf = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
144144

145-
Registry&lt;ConnectionSocketFactory&gt; socketFactoryRegistry = RegistryBuilder.&lt;ConnectionSocketFactory&gt;create().register("https", sslsf).build();
145+
HttpClientConnectionManager connManager = PoolingHttpClientConnectionManagerBuilder.create().setSSLSocketFactory(sslsf).setMaxConnTotal(100).setMaxConnPerRoute(100).build();
146146

147-
// This code is taken from HTTPSenderImpl, from 200 connections to 20
148-
HttpClientConnectionManager connManager = new PoolingHttpClientConnectionManager(socketFactoryRegistry);
149-
((PoolingHttpClientConnectionManager)connManager).setMaxTotal(20);
150-
((PoolingHttpClientConnectionManager)connManager).setDefaultMaxPerRoute(20);
151-
152-
HttpClient httpClient = HttpClientBuilder.create().setConnectionManager(connManager).setConnectionManagerShared(true).build();
147+
HttpClient httpclient = HttpClients.custom().setConnectionManager(connManager.setConnectionManagerShared(true).build();
153148
Options options = new Options();
154149
options.setTo("myurl");
155150
options.setTransportInProtocol(Constants.TRANSPORT_HTTP);
@@ -291,6 +286,10 @@ options.setProperty(HttpConstants.PROXY, proxyProperties);
291286

292287
<h2>Basic, Digest and NTLM Authentication</h2>
293288

289+
<p>Note: Basic preemptive authentication requires a work around described in
290+
https://issues.apache.org/jira/browse/AXIS2-6055 until a proper fix is contributed by
291+
the community as we lack committers who use it. </p>
292+
294293
<p>HttpClient supports three different types of HTTP authentication schemes:
295294
Basic, Digest and NTLM. Based on the challenge provided by the server,
296295
HttpClient automatically selects the authentication scheme with which the

0 commit comments

Comments
 (0)