You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jclouds.apache.org by na...@apache.org on 2019/10/21 08:22:22 UTC

[jclouds-site] branch master updated: Release notes for 2.2.0 and 2.1.3 (#11)

This is an automated email from the ASF dual-hosted git repository.

nacx pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/jclouds-site.git


The following commit(s) were added to refs/heads/master by this push:
     new b904af0  Release notes for 2.2.0 and 2.1.3 (#11)
b904af0 is described below

commit b904af03a5e885eadaf0d5570664e04ac98fb079
Author: Ignasi Barrera <na...@apache.org>
AuthorDate: Mon Oct 21 10:22:07 2019 +0200

    Release notes for 2.2.0 and 2.1.3 (#11)
    
    * Release notes for 2.2.0 and 2.1.3
    
    * Addressed comments
---
 _config.yml           |   6 +-
 _includes/navbar.html |   6 +-
 doap_jclouds.rdf      |  14 ++++
 releasenotes/2.1.3.md |  91 +++++++++++++++++++++++
 releasenotes/2.2.0.md | 197 ++++++++++++++++++++++++++++++++++++++++++++++++++
 releasenotes/index.md |   2 +
 6 files changed, 309 insertions(+), 7 deletions(-)

diff --git a/_config.yml b/_config.yml
index 25a5436..7bea3f4 100644
--- a/_config.yml
+++ b/_config.yml
@@ -6,6 +6,6 @@ paginate: 5
 paginate_path: "blog/page:num"
 permalink: /blog/:categories/:year/:month/:day/:title
 relative_permalinks: false
-latest_version: 2.1.2
-latest_version_date: 2019-02-07
-latest_snapshot: 2.2.0-SNAPSHOT
+latest_version: 2.2.0
+latest_version_date: 2019-10-21
+latest_snapshot: 2.3.0-SNAPSHOT
diff --git a/_includes/navbar.html b/_includes/navbar.html
index c2d32cd..f782f79 100755
--- a/_includes/navbar.html
+++ b/_includes/navbar.html
@@ -72,6 +72,8 @@
                     <a href="#" class="dropdown-toggle" data-toggle="dropdown">Release Notes<strong class="caret"></strong></a>
                     <ul class="dropdown-menu">
                         <!-- only keep the release notes for supported versions in this list -->
+                        <li><a href="/releasenotes/2.2.0">2.2.0</a></li>
+                        <li><a href="/releasenotes/2.1.3">2.1.3</a></li>
                         <li><a href="/releasenotes/2.1.2">2.1.2</a></li>
                         <li><a href="/releasenotes/2.1.1">2.1.1</a></li>
                         <li><a href="/releasenotes/2.1.0">2.1.0</a></li>
@@ -79,10 +81,6 @@
                         <li><a href="/releasenotes/2.0.2">2.0.2</a></li>
                         <li><a href="/releasenotes/2.0.1">2.0.1</a></li>
                         <li><a href="/releasenotes/2.0.0">2.0.0</a></li>
-                        <li><a href="/releasenotes/1.9.3">1.9.3</a></li>
-                        <li><a href="/releasenotes/1.9.2">1.9.2</a></li>
-                        <li><a href="/releasenotes/1.9.1">1.9.1</a></li>
-                        <li><a href="/releasenotes/1.9.0">1.9.0</a></li>
                         <li class="divider"></li>
                         <li class="dropdown-header">Previous releases</li>
                         <li><a href="/releasenotes">Release archive</a></li>
diff --git a/doap_jclouds.rdf b/doap_jclouds.rdf
index b80172b..9748953 100644
--- a/doap_jclouds.rdf
+++ b/doap_jclouds.rdf
@@ -37,6 +37,20 @@
     <category rdf:resource="http://projects.apache.org/category/library" />
     <release>
       <Version>
+        <name>Apache jclouds 2.2.0</name>
+        <created>2019-10-21</created>
+        <revision>2.2.0</revision>
+      </Version>
+    </release>
+    <release>
+      <Version>
+        <name>Apache jclouds 2.1.3</name>
+        <created>2019-10-21</created>
+        <revision>2.1.3</revision>
+      </Version>
+    </release>
+    <release>
+      <Version>
         <name>Apache jclouds 2.1.2</name>
         <created>2018-02-07</created>
         <revision>2.1.2</revision>
diff --git a/releasenotes/2.1.3.md b/releasenotes/2.1.3.md
new file mode 100644
index 0000000..119bc30
--- /dev/null
+++ b/releasenotes/2.1.3.md
@@ -0,0 +1,91 @@
+---
+layout: releasenotes
+title: Release Notes for Version 2.1.3
+date: 2019-10-21 20:00:00
+release_notes: true
+permalink: /releasenotes/2.1.3/
+---
+
+1. [Introduction](#intro)
+1. [Release Highlights](#highlights)
+1. [Known Issues](#knownissues)
+1. [Credits](#credits)
+1. [Test Results](#test)
+
+## <a id="intro"></a>Introduction
+
+Apache jclouds 2.1.3 is the third bugfix release after jclouds 2.1.0 and comes with several bugfixes and performance improvements. 
+You can [read the official announcement here](https://s.apache.org/jclouds213). To get started with jclouds, please see the [jclouds installation guide](/start/install/).
+
+## <a id="highlights"></a>Release Highlights
+
+New features in Apache jclouds 2.1.3 include:
+
+* The jclouds Karaf integration and the jclouds CLI are no longer part of the jclouds releases. The projects are now
+  maintained by the Apache Karaf team and they will be released by them.
+
+### Bugs and patches
+            
+<ul>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1492'>JCLOUDS-1492</a> -         Dimension Data Feature API Predicates are not usable
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1503'>JCLOUDS-1503</a> -         Azurecompute-arm deploy doesn&#39;t work
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1505'>JCLOUDS-1505</a> -         BlobStore.blobMetadata(container, object) returns a StorageMetadata object with empty size when using org.jclouds.http.apachehc.config.ApacheHCHttpCommandExecutorServiceModule
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1509'>JCLOUDS-1509</a> -         ParseAWSErrorFromXmlContent uses the default charset
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1510'>JCLOUDS-1510</a> -         ParseSax convertStreamToStringAndParse creates a String from bytes without specifying a charset
+</li>
+</ul>
+            
+### New Feature
+
+<ul>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1494'>JCLOUDS-1494</a> -         Add S3 Glacier Deep Archive tier
+</li>
+</ul>
+    
+### Improvement
+
+<ul>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1428'>JCLOUDS-1428</a> -         Support for SAS token based Authentication for Azure Blob Storage
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1489'>JCLOUDS-1489</a> -         allow glacier storage tier during create object
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1506'>JCLOUDS-1506</a> -         Azurecompute-arm add tags on disk create/update
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1512'>JCLOUDS-1512</a> -         Use SecureRandom in Sha512Crypt
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1514'>JCLOUDS-1514</a> -         Azurecompute-arm add disk storage types on disk create/update
+</li>
+</ul>
+            
+### Task
+
+<ul>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1495'>JCLOUDS-1495</a> -         maven plugins are not correctly referred to
+</li>
+</ul>
+
+The complete list of fixed issues and improvements can be found [here](https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12314430&version=12344941).
+
+## <a id="knownissues"></a> Known Issues
+
+* [JCLOUDS-1520](https://issues.apache.org/jira/browse/JCLOUDS-1520) - JClouds is not using the JDK's KeepAliveCache when UntrustedSSLContextSupplier is used.
+
+## <a id="credits"></a>Credits
+
+jclouds would like to thank everyone who contributed time and effort in order to make this release happen:
+
+* Especial thanks to the Apache Karaf team for taking over the `jclouds-karaf` and `jclouds-cli` projects to
+  make sure they will have continuity.
+
+* Apache jclouds [PMC](http://people.apache.org/committers-by-project.html#jclouds-pmc) and community for verifying the release.
+* Check out who has been busy on [Open Hub](https://www.openhub.net/p/jclouds/contributors?query=&sort=latest_commit).
+
+## <a id="test"></a>Test Results
+
+Please see the discussion and the vote threads for live test results for 2.1.3:
+
+* RC1 [vote](https://s.apache.org/jclouds213rc1vote) and [discussion](https://s.apache.org/jclouds213rc1discuss) threads.
diff --git a/releasenotes/2.2.0.md b/releasenotes/2.2.0.md
new file mode 100644
index 0000000..a36d278
--- /dev/null
+++ b/releasenotes/2.2.0.md
@@ -0,0 +1,197 @@
+---
+layout: releasenotes
+title: Release Notes for Version 2.2.0
+date: 2019-10-21 20:00:00
+release_notes: true
+permalink: /releasenotes/2.2.0/
+---
+
+1. [Introduction](#intro)
+1. [Release Highlights](#highlights)
+1. [Known Issues](#knownissues)
+1. [Credits](#credits)
+1. [Test Results](#test)
+
+## <a id="intro"></a>Introduction
+
+Apache jclouds 2.2.0 is a first major release after a long period of time. In this release we have focused on modernizing the
+codebase and some dependencies to upgrade to Java 8 and prepare to upgrade to newer Java versions in future.
+You can [read the official announcement here](https://s.apache.org/jclouds220). To get started with jclouds, please see the [jclouds installation guide](/start/install/).
+
+## <a id="highlights"></a>Release Highlights
+
+New features in Apache jclouds 2.2.0 include:
+
+* Java 8 friendly builds
+* The jclouds Karaf integration and the jclouds CLI are no longer part of the jclouds releases. The projects are now
+  maintained by the Apache Karaf team and they will be released by them.
+
+### Bugs and patches
+
+<ul>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1200'>JCLOUDS-1200</a> -         org.jclouds.http.HttpResponseException fails to serialize
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1263'>JCLOUDS-1263</a> -         Listing objects in Openstack Swift blob store containers fails if a key has an invalid URL encode sequence
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1294'>JCLOUDS-1294</a> -         Azure ARM improve HTTP retry logic
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1366'>JCLOUDS-1366</a> -         OutOfMemory when InputStream referencing to big file is used as payload
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1367'>JCLOUDS-1367</a> -         Blob.getPayload.openStream() is inconsistent across implementations
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1389'>JCLOUDS-1389</a> -         Multipart upload to Google cloud storage failing with 400 bad request
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1391'>JCLOUDS-1391</a> -         Headers must be sorted by lowercase when calculating signature
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1392'>JCLOUDS-1392</a> -         When fetching blob metadata with details all folders are removed from response
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1400'>JCLOUDS-1400</a> -         GCS&#39;s presigned url requires blank Content-Type
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1401'>JCLOUDS-1401</a> -         S3 SignatureDoesNotMatch when listing keys using prefix with ampersand
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1405'>JCLOUDS-1405</a> -         Dimension Data Live Tests Broken - Domain classes for Server and Image with List nics incorrect
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1410'>JCLOUDS-1410</a> -         SoftLayer cannot provision with private image
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1419'>JCLOUDS-1419</a> -         Missing StorageClass REGIONAL for GCS buckets
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1422'>JCLOUDS-1422</a> -         LocalBlobStore.list ignores recursive flag when prefix set
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1427'>JCLOUDS-1427</a> -         NPE when deserializing Elastic IPs that have tags
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1433'>JCLOUDS-1433</a> -         IllegalArgumentException from Strings2.replaceTokens
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1441'>JCLOUDS-1441</a> -         [ARM] China regions can not be used
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1443'>JCLOUDS-1443</a> -         unable to resolve URI with complex host
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1447'>JCLOUDS-1447</a> -         S3 CopyObject requires x-amz-copy-source to be URL encoded
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1462'>JCLOUDS-1462</a> -         Upgrade Apache Http driver in response to CVE-2015-5262
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1463'>JCLOUDS-1463</a> -         MachineTypeToHardware throws exception when region has no available zone
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1467'>JCLOUDS-1467</a> -         Newly added c5 instanceType do not supports c5d series of AWS
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1472'>JCLOUDS-1472</a> -         Multipart upload for AzureBlob fails when using InputStream for files greater than 32MB
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1479'>JCLOUDS-1479</a> -         Swift API throws Exception when getting blob from containers
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1488'>JCLOUDS-1488</a> -         Filesystem list call with prefix is slow in large containers
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1492'>JCLOUDS-1492</a> -         Dimension Data Feature API Predicates are not usable
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1503'>JCLOUDS-1503</a> -         Azurecompute-arm deploy doesn&#39;t work
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1505'>JCLOUDS-1505</a> -         BlobStore.blobMetadata(container, object) returns a StorageMetadata object with empty size when using org.jclouds.http.apachehc.config.ApacheHCHttpCommandExecutorServiceModule
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1509'>JCLOUDS-1509</a> -         ParseAWSErrorFromXmlContent uses the default charset
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1510'>JCLOUDS-1510</a> -         ParseSax convertStreamToStringAndParse creates a String from bytes without specifying a charset
+</li>
+</ul>
+            
+### New Feature
+
+<ul>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1399'>JCLOUDS-1399</a> -         S3 One Zone-IA Storage Class
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1418'>JCLOUDS-1418</a> -         The Azure ARM provider is missing several statuses for the PowerState enum
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1421'>JCLOUDS-1421</a> -         Images created by the ImageExtension may lack the mandatory default credentials
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1468'>JCLOUDS-1468</a> -         Add missing fields on CloudStack usage API
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1494'>JCLOUDS-1494</a> -         Add S3 Glacier Deep Archive tier
+</li>
+</ul>
+    
+### Improvement
+
+<ul>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-847'>JCLOUDS-847</a> -         S3 poor upload performance
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1271'>JCLOUDS-1271</a> -         Remove signRemoveBlob
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1339'>JCLOUDS-1339</a> -         Support launching an x1 EC2 instance
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1387'>JCLOUDS-1387</a> -         Add support for c5 instance types in AWS ec2
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1390'>JCLOUDS-1390</a> -         google-cloud-storage: Avoid per blob calls to get user metadata when listing with details 
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1394'>JCLOUDS-1394</a> -         Increase limit for azure blob from 64MB to 256MB
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1404'>JCLOUDS-1404</a> -         Available Google Storage regions
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1414'>JCLOUDS-1414</a> -         OpenStack Keystone V3: Support different &quot;domain&quot; for &quot;identity/user&quot; and &quot;project&quot;
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1428'>JCLOUDS-1428</a> -         Support for SAS token based Authentication for Azure Blob Storage
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1436'>JCLOUDS-1436</a> -         Add support for m5 instance types in AWS ec2
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1450'>JCLOUDS-1450</a> -         Multi-part upload against the filesystem provider should return ETag similar to S3
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1452'>JCLOUDS-1452</a> -         Switch to B2 v2 API
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1460'>JCLOUDS-1460</a> -         Add support for t3 instance types in AWS ec2
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1464'>JCLOUDS-1464</a> -         Google Cloud Storage regions need updating
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1477'>JCLOUDS-1477</a> -         B2 cannot upload small payloads when multipart specified
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1489'>JCLOUDS-1489</a> -         allow glacier storage tier during create object
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1506'>JCLOUDS-1506</a> -         Azurecompute-arm add tags on disk create/update
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1512'>JCLOUDS-1512</a> -         Use SecureRandom in Sha512Crypt
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1514'>JCLOUDS-1514</a> -         Azurecompute-arm add disk storage types on disk create/update
+</li>
+</ul>
+            
+### Task
+
+<ul>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1406'>JCLOUDS-1406</a> -         Add default location configuration to dimension data provider
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1431'>JCLOUDS-1431</a> -         Support AU geo for Live Tests
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1432'>JCLOUDS-1432</a> -         API Client expects 404 code when asset UUID not found for Get APIs
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1454'>JCLOUDS-1454</a> -         Implement ServerToServerWithExternalIp function for dimensiondata
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1455'>JCLOUDS-1455</a> -         Update ParseResponse to log error details. Add ParseTests for Domain Objects in NetworkApi and ServerApi
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1457'>JCLOUDS-1457</a> -         Add Clean Server operation to ServerApi
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1495'>JCLOUDS-1495</a> -         maven plugins are not correctly referred to
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1496'>JCLOUDS-1496</a> -         Update maven-compiler-plugin for increased JDK compatibility 
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1497'>JCLOUDS-1497</a> -         Fix jclouds-labs after JCLOUDS-1496
+</li>
+<li><a href='https://issues.apache.org/jira/browse/JCLOUDS-1499'>JCLOUDS-1499</a> -         Disable sonatype snapshot repository for plugins
+</li>
+</ul>
+
+The complete list of fixed issues and improvements can be found [here](https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12314430&version=12342811).
+
+## <a id="knownissues"></a> Known Issues
+
+* [JCLOUDS-1520](https://issues.apache.org/jira/browse/JCLOUDS-1520) - JClouds is not using the JDK's KeepAliveCache when UntrustedSSLContextSupplier is used.
+
+## <a id="credits"></a>Credits
+
+jclouds would like to thank everyone who contributed time and effort in order to make this release happen:
+
+* Especial thanks to the Apache Karaf team for taking over the `jclouds-karaf` and `jclouds-cli` projects to
+  make sure they will have continuity.
+
+* Apache jclouds [PMC](http://people.apache.org/committers-by-project.html#jclouds-pmc) and community for verifying the release.
+* Check out who has been busy on [Open Hub](https://www.openhub.net/p/jclouds/contributors?query=&sort=latest_commit).
+
+## <a id="test"></a>Test Results
+
+Please see the discussion and the vote threads for live test results for 2.2.0:
+
+* RC1 [vote](https://s.apache.org/jclouds220rc1vote) and [discussion](https://s.apache.org/jclouds220rc1discuss) threads.
diff --git a/releasenotes/index.md b/releasenotes/index.md
index f7d556c..bc14989 100644
--- a/releasenotes/index.md
+++ b/releasenotes/index.md
@@ -6,6 +6,8 @@ permalink: /releasenotes/
 
 The Release Notes and Javadocs for every major release of Apache jclouds are listed chronologically below.
 
+* [2.2.0](/releasenotes/2.2.0) | [Javadoc](/reference/javadoc/2.2.x/)
+* [2.1.3](/releasenotes/2.1.3) | [Javadoc](/reference/javadoc/2.1.x/)
 * [2.1.2](/releasenotes/2.1.2) | [Javadoc](/reference/javadoc/2.1.x/)
 * [2.1.1](/releasenotes/2.1.1) | [Javadoc](/reference/javadoc/2.1.x/)
 * [2.1.0](/releasenotes/2.1.0) | [Javadoc](/reference/javadoc/2.1.x/)