0.12.0 staging complete (#847)

* replaced JJWT_RELEASE_VERSION placeholders with 0.12.0

* [maven-release-plugin] prepare release 0.12.0

* [maven-release-plugin] prepare for next development iteration

CHANGELOG.md

@@ -1,6 +1,6 @@
 ## Release Notes
 
-### JJWT_RELEASE_VERSION
+### 0.12.0
 
 This is a big release! JJWT now fully supports Encrypted JSON Web Tokens (JWE), JSON Web Keys (JWK) and more!  See the 
 sections below enumerating all new features as well as important notes on breaking changes or backwards-incompatible 

README.md

@@ -540,18 +540,18 @@ If you're building a (non-Android) JDK project, you will want to define the foll
 <dependency>
     <groupId>io.jsonwebtoken</groupId>
     <artifactId>jjwt-api</artifactId>
-    <version>JJWT_RELEASE_VERSION</version>
+    <version>0.12.0</version>
 </dependency>
 <dependency>
     <groupId>io.jsonwebtoken</groupId>
     <artifactId>jjwt-impl</artifactId>
-    <version>JJWT_RELEASE_VERSION</version>
+    <version>0.12.0</version>
     <scope>runtime</scope>
 </dependency>
 <dependency>
     <groupId>io.jsonwebtoken</groupId>
     <artifactId>jjwt-jackson</artifactId> <!-- or jjwt-gson if Gson is preferred -->
-    <version>JJWT_RELEASE_VERSION</version>
+    <version>0.12.0</version>
     <scope>runtime</scope>
 </dependency>
 <!-- Uncomment this next dependency if you are using:
@@ -574,9 +574,9 @@ If you're building a (non-Android) JDK project, you will want to define the foll
 
 ```groovy
 dependencies {
-    implementation 'io.jsonwebtoken:jjwt-api:JJWT_RELEASE_VERSION'
-    runtimeOnly 'io.jsonwebtoken:jjwt-impl:JJWT_RELEASE_VERSION'
-    runtimeOnly 'io.jsonwebtoken:jjwt-jackson:JJWT_RELEASE_VERSION' // or 'io.jsonwebtoken:jjwt-gson:JJWT_RELEASE_VERSION' for gson
+    implementation 'io.jsonwebtoken:jjwt-api:0.12.0'
+    runtimeOnly 'io.jsonwebtoken:jjwt-impl:0.12.0'
+    runtimeOnly 'io.jsonwebtoken:jjwt-jackson:0.12.0' // or 'io.jsonwebtoken:jjwt-gson:0.12.0' for gson
     /* 
       Uncomment this next dependency if you are using:
        - JDK 10 or earlier, and you want to use RSASSA-PSS (PS256, PS384, PS512) signature algorithms.
@@ -601,9 +601,9 @@ Add the dependencies to your project:
 
 ```groovy
 dependencies {
-    api('io.jsonwebtoken:jjwt-api:JJWT_RELEASE_VERSION')
-    runtimeOnly('io.jsonwebtoken:jjwt-impl:JJWT_RELEASE_VERSION') 
-    runtimeOnly('io.jsonwebtoken:jjwt-orgjson:JJWT_RELEASE_VERSION') {
+    api('io.jsonwebtoken:jjwt-api:0.12.0')
+    runtimeOnly('io.jsonwebtoken:jjwt-impl:0.12.0') 
+    runtimeOnly('io.jsonwebtoken:jjwt-orgjson:0.12.0') {
         exclude(group: 'org.json', module: 'json') //provided by Android natively
     }
     /* 
@@ -2952,7 +2952,7 @@ scope which is the typical JJWT default).  That is:
 <dependency>
     <groupId>io.jsonwebtoken</groupId>
     <artifactId>jjwt-jackson</artifactId>
-    <version>JJWT_RELEASE_VERSION</version>
+    <version>0.12.0</version>
     <scope>compile</scope> <!-- Not runtime -->
 </dependency>
 ```
@@ -2961,7 +2961,7 @@ scope which is the typical JJWT default).  That is:
 
 ```groovy
 dependencies {
-    implementation 'io.jsonwebtoken:jjwt-jackson:JJWT_RELEASE_VERSION'
+    implementation 'io.jsonwebtoken:jjwt-jackson:0.12.0'
 }
 ```
 
@@ -3069,7 +3069,7 @@ scope which is the typical JJWT default).  That is:
 <dependency>
     <groupId>io.jsonwebtoken</groupId>
     <artifactId>jjwt-gson</artifactId>
-    <version>JJWT_RELEASE_VERSION</version>
+    <version>0.12.0</version>
     <scope>compile</scope> <!-- Not runtime -->
 </dependency>
 ```
@@ -3078,7 +3078,7 @@ scope which is the typical JJWT default).  That is:
 
 ```groovy
 dependencies {
-    implementation 'io.jsonwebtoken:jjwt-gson:JJWT_RELEASE_VERSION'
+    implementation 'io.jsonwebtoken:jjwt-gson:0.12.0'
 }
 ```
 

api/pom.xml

@@ -21,7 +21,7 @@
     <parent>
         <groupId>io.jsonwebtoken</groupId>
         <artifactId>jjwt-root</artifactId>
-        <version>0.11.6-SNAPSHOT</version>
+        <version>0.13.0-SNAPSHOT</version>
         <relativePath>../pom.xml</relativePath>
     </parent>
 

api/src/main/java/io/jsonwebtoken/ClaimsBuilder.java

@@ -23,7 +23,7 @@
  *
  * @see JwtBuilder
  * @see Claims
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
  */
 public interface ClaimsBuilder extends MapMutator<String, Object, ClaimsBuilder>, ClaimsMutator<ClaimsBuilder>, Builder<Claims> {
 }

api/src/main/java/io/jsonwebtoken/ClaimsMutator.java

@@ -36,7 +36,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param iss the JWT {@code iss} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @deprecated since JJWT_RELEASE_VERSION in favor of the shorter and more modern builder-style named
+     * @deprecated since 0.12.0 in favor of the shorter and more modern builder-style named
      * {@link #issuer(String)}. This method will be removed before the JJWT 1.0 release.
      */
     @Deprecated
@@ -48,7 +48,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param iss the JWT {@code iss} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @since JJWT_RELEASE_VERSION
+     * @since 0.12.0
      */
     T issuer(String iss);
 
@@ -58,7 +58,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param sub the JWT {@code sub} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @deprecated since JJWT_RELEASE_VERSION in favor of the shorter and more modern builder-style named
+     * @deprecated since 0.12.0 in favor of the shorter and more modern builder-style named
      * {@link #subject(String)}. This method will be removed before the JJWT 1.0 release.
      */
     @Deprecated
@@ -70,7 +70,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param sub the JWT {@code sub} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @since JJWT_RELEASE_VERSION
+     * @since 0.12.0
      */
     T subject(String sub);
 
@@ -85,7 +85,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param aud the JWT {@code aud} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #audience()}. This method will be removed before
+     * @deprecated since 0.12.0 in favor of {@link #audience()}. This method will be removed before
      * the JJWT 1.0 release.
      */
     @Deprecated
@@ -99,7 +99,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      * @return the {@link AudienceCollection AudienceCollection} to use for {@code aud} configuration.
      * @see AudienceCollection AudienceCollection
      * @see AudienceCollection#single(String) AudienceCollection.single(String)
-     * @since JJWT_RELEASE_VERSION
+     * @since 0.12.0
      */
     AudienceCollection<T> audience();
 
@@ -112,7 +112,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param exp the JWT {@code exp} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @deprecated since JJWT_RELEASE_VERSION in favor of the shorter and more modern builder-style named
+     * @deprecated since 0.12.0 in favor of the shorter and more modern builder-style named
      * {@link #expiration(Date)}. This method will be removed before the JJWT 1.0 release.
      */
     @Deprecated
@@ -127,7 +127,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param exp the JWT {@code exp} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @since JJWT_RELEASE_VERSION
+     * @since 0.12.0
      */
     T expiration(Date exp);
 
@@ -140,7 +140,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param nbf the JWT {@code nbf} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @deprecated since JJWT_RELEASE_VERSION in favor of the shorter and more modern builder-style named
+     * @deprecated since 0.12.0 in favor of the shorter and more modern builder-style named
      * {@link #notBefore(Date)}. This method will be removed before the JJWT 1.0 release.
      */
     @Deprecated
@@ -155,7 +155,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param nbf the JWT {@code nbf} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @since JJWT_RELEASE_VERSION
+     * @since 0.12.0
      */
     T notBefore(Date nbf);
 
@@ -168,7 +168,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param iat the JWT {@code iat} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @deprecated since JJWT_RELEASE_VERSION in favor of the shorter and more modern builder-style named
+     * @deprecated since 0.12.0 in favor of the shorter and more modern builder-style named
      * {@link #issuedAt(Date)}. This method will be removed before the JJWT 1.0 release.
      */
     @Deprecated
@@ -183,7 +183,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param iat the JWT {@code iat} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @since JJWT_RELEASE_VERSION
+     * @since 0.12.0
      */
     T issuedAt(Date iat);
 
@@ -197,7 +197,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param jti the JWT {@code jti} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @deprecated since JJWT_RELEASE_VERSION in favor of the shorter and more modern builder-style named
+     * @deprecated since 0.12.0 in favor of the shorter and more modern builder-style named
      * {@link #id(String)}. This method will be removed before the JJWT 1.0 release.
      */
     @Deprecated
@@ -213,7 +213,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param jti the JWT {@code jti} value or {@code null} to remove the property from the JSON map.
      * @return the {@code Claims} instance for method chaining.
-     * @since JJWT_RELEASE_VERSION
+     * @since 0.12.0
      */
     T id(String jti);
 
@@ -223,7 +223,7 @@ public interface ClaimsMutator<T extends ClaimsMutator<T>> {
      *
      * @param <P> the type of ClaimsMutator to return for method chaining.
      * @see #single(String)
-     * @since JJWT_RELEASE_VERSION
+     * @since 0.12.0
      */
     interface AudienceCollection<P> extends NestedCollection<String, P> {
 
@@ -238,7 +238,7 @@ interface AudienceCollection<P> extends NestedCollection<String, P> {
          * @param aud the value to use as the {@code aud} Claim single-String value (and not an array of Strings), or
          *            {@code null}, empty or whitespace to remove the property from the JSON map.
          * @return the instance for method chaining
-         * @since JJWT_RELEASE_VERSION
+         * @since 0.12.0
          * @deprecated This is technically not deprecated because the JWT RFC mandates support for single string values,
          * but it is marked as deprecated to discourage its use when possible.
          */

api/src/main/java/io/jsonwebtoken/CompressionCodec.java

@@ -29,7 +29,7 @@
  * @see Jwts.ZIP#DEF
  * @see Jwts.ZIP#GZIP
  * @since 0.6.0
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link io.jsonwebtoken.io.CompressionAlgorithm} to equal the RFC name for this concept.
+ * @deprecated since 0.12.0 in favor of {@link io.jsonwebtoken.io.CompressionAlgorithm} to equal the RFC name for this concept.
  */
 @Deprecated
 public interface CompressionCodec extends CompressionAlgorithm {
@@ -40,7 +40,7 @@ public interface CompressionCodec extends CompressionAlgorithm {
      *
      * @return the algorithm name to use as the JWT
      * <a href="https://tools.ietf.org/html/rfc7516#section-4.1.3"><code>zip</code></a> header value.
-     * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getId()} to ensure congruence with
+     * @deprecated since 0.12.0 in favor of {@link #getId()} to ensure congruence with
      * all other identifiable algorithms.
      */
     @SuppressWarnings("DeprecatedIsStillUsed")

api/src/main/java/io/jsonwebtoken/Header.java

@@ -47,21 +47,21 @@ public interface Header extends Map<String, Object> {
     /**
      * JWT {@code Type} (typ) value: <code>"JWT"</code>
      *
-     * @deprecated since JJWT_RELEASE_VERSION - this constant is never used within the JJWT codebase.
+     * @deprecated since 0.12.0 - this constant is never used within the JJWT codebase.
      */
     @Deprecated
     String JWT_TYPE = "JWT";
 
     /**
      * JWT {@code Type} header parameter name: <code>"typ"</code>
-     * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getType()}.
+     * @deprecated since 0.12.0 in favor of {@link #getType()}.
      */
     @Deprecated
     String TYPE = "typ";
 
     /**
      * JWT {@code Content Type} header parameter name: <code>"cty"</code>
-     * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getContentType()}.
+     * @deprecated since 0.12.0 in favor of {@link #getContentType()}.
      */
     @Deprecated
     String CONTENT_TYPE = "cty";
@@ -71,14 +71,14 @@ public interface Header extends Map<String, Object> {
      *
      * @see <a href="https://tools.ietf.org/html/rfc7515#section-4.1.1">JWS Algorithm Header</a>
      * @see <a href="https://tools.ietf.org/html/rfc7516#section-4.1.1">JWE Algorithm Header</a>
-     * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getAlgorithm()}.
+     * @deprecated since 0.12.0 in favor of {@link #getAlgorithm()}.
      */
     @Deprecated
     String ALGORITHM = "alg";
 
     /**
      * JWT {@code Compression Algorithm} header parameter name: <code>"zip"</code>
-     * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getCompressionAlgorithm()}
+     * @deprecated since 0.12.0 in favor of {@link #getCompressionAlgorithm()}
      */
     @Deprecated
     String COMPRESSION_ALGORITHM = "zip";
@@ -143,7 +143,7 @@ public interface Header extends Map<String, Object> {
      *
      * @return the {@code alg} header value or {@code null} if not present.  This will always be
      * {@code non-null} on validly constructed JWT instances, but could be {@code null} during construction.
-     * @since JJWT_RELEASE_VERSION
+     * @since 0.12.0
      */
     String getAlgorithm();
 

api/src/main/java/io/jsonwebtoken/HeaderMutator.java

@@ -21,7 +21,7 @@
  * Mutation (modifications) to a {@link Header Header} instance.
  *
  * @param <T> the mutator subtype, for method chaining
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
  */
 public interface HeaderMutator<T extends HeaderMutator<T>> extends MapMutator<String, Object, T> {
 
@@ -47,7 +47,7 @@ public interface HeaderMutator<T extends HeaderMutator<T>> extends MapMutator<St
      *
      * @param alg the {@code alg} header value
      * @return this header for method chaining
-     * @since JJWT_RELEASE_VERSION
+     * @since 0.12.0
      *
     T algorithm(String alg);
     */
@@ -95,36 +95,36 @@ public interface HeaderMutator<T extends HeaderMutator<T>> extends MapMutator<St
     T contentType(String cty);
 
     /**
-     * Deprecated since of JJWT_RELEASE_VERSION, delegates to {@link #type(String)}.
+     * Deprecated since of 0.12.0, delegates to {@link #type(String)}.
      *
      * @param typ the JWT JOSE {@code typ} header value or {@code null} to remove the property from the JSON map.
      * @return the instance for method chaining.
      * @see #type(String)
-     * @deprecated since JJWT_RELEASE_VERSION in favor of the more modern builder-style {@link #type(String)} method.
+     * @deprecated since 0.12.0 in favor of the more modern builder-style {@link #type(String)} method.
      * This method will be removed before the 1.0 release.
      */
     @Deprecated
     T setType(String typ);
 
     /**
-     * Deprecated as of JJWT_RELEASE_VERSION, delegates to {@link #contentType(String)}.
+     * Deprecated as of 0.12.0, delegates to {@link #contentType(String)}.
      *
      * @param cty the JWT JOSE {@code cty} header value or {@code null} to remove the property from the JSON map.
      * @return the instance for method chaining.
      * @see #contentType(String)
-     * @deprecated since JJWT_RELEASE_VERSION in favor of the more modern builder-style {@link #contentType(String)}.
+     * @deprecated since 0.12.0 in favor of the more modern builder-style {@link #contentType(String)}.
      */
     @Deprecated
     T setContentType(String cty);
 
     /**
-     * Deprecated as of JJWT_RELEASE_VERSION, there is no need to set this any longer as the {@code JwtBuilder} will
+     * Deprecated as of 0.12.0, there is no need to set this any longer as the {@code JwtBuilder} will
      * always set the {@code zip} header as necessary.
      *
      * @param zip the JWT compression algorithm {@code zip} value or {@code null} to remove the property from the JSON map.
      * @return the instance for method chaining.
      * @since 0.6.0
-     * @deprecated since JJWT_RELEASE_VERSION and will be removed before the 1.0 release.
+     * @deprecated since 0.12.0 and will be removed before the 1.0 release.
      */
     @Deprecated
     T setCompressionAlgorithm(String zip);

api/src/main/java/io/jsonwebtoken/Identifiable.java

@@ -79,7 +79,7 @@
  * </tbody>
  * </table>
  *
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
  */
 public interface Identifiable {