> {
*
* @param the type of ClaimsMutator to return for method chaining.
* @see #single(String)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
interface AudienceCollection
extends NestedCollection {
@@ -238,7 +238,7 @@ interface AudienceCollection extends NestedCollection {
* @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.
*/
diff --git a/api/src/main/java/io/jsonwebtoken/CompressionCodec.java b/api/src/main/java/io/jsonwebtoken/CompressionCodec.java
index ad7e1bd50..b3b92281d 100644
--- a/api/src/main/java/io/jsonwebtoken/CompressionCodec.java
+++ b/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
* zip
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")
diff --git a/api/src/main/java/io/jsonwebtoken/Header.java b/api/src/main/java/io/jsonwebtoken/Header.java
index ea28b7a93..f6dd1f9db 100644
--- a/api/src/main/java/io/jsonwebtoken/Header.java
+++ b/api/src/main/java/io/jsonwebtoken/Header.java
@@ -47,21 +47,21 @@ public interface Header extends Map {
/**
* JWT {@code Type} (typ) value: "JWT"
*
- * @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: "typ"
- * @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: "cty"
- * @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 {
*
* @see JWS Algorithm Header
* @see JWE Algorithm Header
- * @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: "zip"
- * @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 {
*
* @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();
diff --git a/api/src/main/java/io/jsonwebtoken/HeaderMutator.java b/api/src/main/java/io/jsonwebtoken/HeaderMutator.java
index fd07229ed..acaf687dc 100644
--- a/api/src/main/java/io/jsonwebtoken/HeaderMutator.java
+++ b/api/src/main/java/io/jsonwebtoken/HeaderMutator.java
@@ -21,7 +21,7 @@
* Mutation (modifications) to a {@link Header Header} instance.
*
* @param the mutator subtype, for method chaining
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface HeaderMutator> extends MapMutator {
@@ -47,7 +47,7 @@ public interface HeaderMutator> extends MapMutator> extends MapMutator
*
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface Identifiable {
diff --git a/api/src/main/java/io/jsonwebtoken/Jwe.java b/api/src/main/java/io/jsonwebtoken/Jwe.java
index 94589e873..885ddae36 100644
--- a/api/src/main/java/io/jsonwebtoken/Jwe.java
+++ b/api/src/main/java/io/jsonwebtoken/Jwe.java
@@ -20,7 +20,7 @@
* JWE (RFC 7516) Specification.
*
* @param payload type, either {@link Claims} or {@code byte[]} content.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface Jwe extends ProtectedJwt {
@@ -30,7 +30,7 @@ public interface Jwe extends ProtectedJwt {
* {@link UnsupportedJwtException}.
*
* @see SupportedJwtVisitor#onDecryptedContent(Jwe)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
@SuppressWarnings("UnnecessaryModifier")
public static final JwtVisitor> CONTENT = new SupportedJwtVisitor>() {
@@ -46,7 +46,7 @@ public Jwe onDecryptedContent(Jwe jwe) {
* {@link UnsupportedJwtException}.
*
* @see SupportedJwtVisitor#onDecryptedClaims(Jwe)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
@SuppressWarnings("UnnecessaryModifier")
public static final JwtVisitor> CLAIMS = new SupportedJwtVisitor>() {
diff --git a/api/src/main/java/io/jsonwebtoken/JweHeader.java b/api/src/main/java/io/jsonwebtoken/JweHeader.java
index d40f1878b..8ba6b7f7d 100644
--- a/api/src/main/java/io/jsonwebtoken/JweHeader.java
+++ b/api/src/main/java/io/jsonwebtoken/JweHeader.java
@@ -25,7 +25,7 @@
/**
* A JWE header.
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface JweHeader extends ProtectedHeader {
diff --git a/api/src/main/java/io/jsonwebtoken/JweHeaderMutator.java b/api/src/main/java/io/jsonwebtoken/JweHeaderMutator.java
index d118c7374..912136d66 100644
--- a/api/src/main/java/io/jsonwebtoken/JweHeaderMutator.java
+++ b/api/src/main/java/io/jsonwebtoken/JweHeaderMutator.java
@@ -21,7 +21,7 @@
* Mutation (modifications) to a {@link JweHeader} instance.
*
* @param the mutator subtype, for method chaining
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface JweHeaderMutator> extends ProtectedHeaderMutator {
diff --git a/api/src/main/java/io/jsonwebtoken/Jws.java b/api/src/main/java/io/jsonwebtoken/Jws.java
index 89b3f621e..8c6010c1e 100644
--- a/api/src/main/java/io/jsonwebtoken/Jws.java
+++ b/api/src/main/java/io/jsonwebtoken/Jws.java
@@ -29,7 +29,7 @@ public interface Jws extends ProtectedJwt {
* {@link UnsupportedJwtException}.
*
* @see SupportedJwtVisitor#onVerifiedContent(Jws)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
@SuppressWarnings("UnnecessaryModifier")
public static final JwtVisitor> CONTENT = new SupportedJwtVisitor>() {
@@ -45,7 +45,7 @@ public Jws onVerifiedContent(Jws jws) {
* {@link UnsupportedJwtException}.
*
* @see SupportedJwtVisitor#onVerifiedClaims(Jws)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
@SuppressWarnings("UnnecessaryModifier")
public static final JwtVisitor> CLAIMS = new SupportedJwtVisitor>() {
@@ -59,7 +59,7 @@ public Jws onVerifiedClaims(Jws jws) {
* Returns the verified JWS signature as a Base64Url string.
*
* @return the verified JWS signature as a Base64Url string.
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getDigest() getDigest()}.
+ * @deprecated since 0.12.0 in favor of {@link #getDigest() getDigest()}.
*/
@Deprecated
String getSignature(); //TODO for 1.0: return a byte[]
diff --git a/api/src/main/java/io/jsonwebtoken/JwsHeader.java b/api/src/main/java/io/jsonwebtoken/JwsHeader.java
index e10a0bef8..0afab2a32 100644
--- a/api/src/main/java/io/jsonwebtoken/JwsHeader.java
+++ b/api/src/main/java/io/jsonwebtoken/JwsHeader.java
@@ -25,7 +25,7 @@ public interface JwsHeader extends ProtectedHeader {
/**
* JWS Algorithm Header name: the string literal alg
*
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getAlgorithm()}
+ * @deprecated since 0.12.0 in favor of {@link #getAlgorithm()}
*/
@Deprecated
String ALGORITHM = "alg";
@@ -33,7 +33,7 @@ public interface JwsHeader extends ProtectedHeader {
/**
* JWS JWK Set URL Header name: the string literal jku
*
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getJwkSetUrl()}
+ * @deprecated since 0.12.0 in favor of {@link #getJwkSetUrl()}
*/
@Deprecated
String JWK_SET_URL = "jku";
@@ -41,7 +41,7 @@ public interface JwsHeader extends ProtectedHeader {
/**
* JWS JSON Web Key Header name: the string literal jwk
*
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getJwk()}
+ * @deprecated since 0.12.0 in favor of {@link #getJwk()}
*/
@Deprecated
String JSON_WEB_KEY = "jwk";
@@ -49,7 +49,7 @@ public interface JwsHeader extends ProtectedHeader {
/**
* JWS Key ID Header name: the string literal kid
*
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getKeyId()}
+ * @deprecated since 0.12.0 in favor of {@link #getKeyId()}
*/
@Deprecated
String KEY_ID = "kid";
@@ -57,7 +57,7 @@ public interface JwsHeader extends ProtectedHeader {
/**
* JWS X.509 URL Header name: the string literal x5u
*
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getX509Url()}
+ * @deprecated since 0.12.0 in favor of {@link #getX509Url()}
*/
@Deprecated
String X509_URL = "x5u";
@@ -65,7 +65,7 @@ public interface JwsHeader extends ProtectedHeader {
/**
* JWS X.509 Certificate Chain Header name: the string literal x5c
*
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getX509Chain()}
+ * @deprecated since 0.12.0 in favor of {@link #getX509Chain()}
*/
@Deprecated
String X509_CERT_CHAIN = "x5c";
@@ -73,7 +73,7 @@ public interface JwsHeader extends ProtectedHeader {
/**
* JWS X.509 Certificate SHA-1 Thumbprint Header name: the string literal x5t
*
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getX509Sha1Thumbprint()}
+ * @deprecated since 0.12.0 in favor of {@link #getX509Sha1Thumbprint()}
*/
@Deprecated
String X509_CERT_SHA1_THUMBPRINT = "x5t";
@@ -81,7 +81,7 @@ public interface JwsHeader extends ProtectedHeader {
/**
* JWS X.509 Certificate SHA-256 Thumbprint Header name: the string literal x5t#S256
*
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getX509Sha256Thumbprint()}
+ * @deprecated since 0.12.0 in favor of {@link #getX509Sha256Thumbprint()}
*/
@Deprecated
String X509_CERT_SHA256_THUMBPRINT = "x5t#S256";
@@ -89,7 +89,7 @@ public interface JwsHeader extends ProtectedHeader {
/**
* JWS Critical Header name: the string literal crit
*
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #getCritical()}
+ * @deprecated since 0.12.0 in favor of {@link #getCritical()}
*/
@Deprecated
String CRITICAL = "crit";
diff --git a/api/src/main/java/io/jsonwebtoken/Jwt.java b/api/src/main/java/io/jsonwebtoken/Jwt.java
index 7cd251bea..a1bb23a96 100644
--- a/api/src/main/java/io/jsonwebtoken/Jwt.java
+++ b/api/src/main/java/io/jsonwebtoken/Jwt.java
@@ -29,7 +29,7 @@ public interface Jwt {
* signed or encrypted) and rejects all others with an {@link UnsupportedJwtException}.
*
* @see SupportedJwtVisitor#onUnsecuredContent(Jwt)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
@SuppressWarnings("UnnecessaryModifier")
public static final JwtVisitor> UNSECURED_CONTENT = new SupportedJwtVisitor>() {
@@ -44,7 +44,7 @@ public Jwt onUnsecuredContent(Jwt jwt) {
* cryptographically signed or encrypted) and rejects all others with an {@link UnsupportedJwtException}.
*
* @see SupportedJwtVisitor#onUnsecuredClaims(Jwt)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
@SuppressWarnings("UnnecessaryModifier")
public static final JwtVisitor> UNSECURED_CLAIMS = new SupportedJwtVisitor>() {
@@ -66,7 +66,7 @@ public Jwt onUnsecuredClaims(Jwt jwt) {
* {@link #getPayload()} instead, as this method will be removed prior to the 1.0 release.
*
* @return the JWT payload, either a {@code byte[]} or a {@code Claims} instance.
- * @deprecated since JJWT_RELEASE_VERSION because it has been renamed to {@link #getPayload()}. 'Payload' (not
+ * @deprecated since 0.12.0 because it has been renamed to {@link #getPayload()}. 'Payload' (not
* body) is what the JWT specifications call this property, so it has been renamed to reflect the correct JWT
* nomenclature/taxonomy.
*/
@@ -81,7 +81,7 @@ public Jwt onUnsecuredClaims(Jwt jwt) {
* the final content type as desired.
*
* @return the JWT payload, either a {@code byte[]} or a {@code Claims} instance.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
P getPayload();
diff --git a/api/src/main/java/io/jsonwebtoken/JwtBuilder.java b/api/src/main/java/io/jsonwebtoken/JwtBuilder.java
index d2ad6f516..38647a5ee 100644
--- a/api/src/main/java/io/jsonwebtoken/JwtBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/JwtBuilder.java
@@ -57,7 +57,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @param provider the JCA Provider to use during cryptographic signing or encryption operations, or {@code null} if the
* JCA subsystem preferred provider should be used.
* @return the builder for method chaining.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder provider(Provider provider);
@@ -68,7 +68,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @param secureRandom the {@link SecureRandom} to use during cryptographic signing or encryption operations, or
* {@code null} if a default {@link SecureRandom} should be used.
* @return the builder for method chaining.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder random(SecureRandom secureRandom);
@@ -92,7 +92,7 @@ public interface JwtBuilder extends ClaimsMutator {
* .compact();
*
* @return the {@link BuilderHeader} to use for header construction.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
BuilderHeader header();
@@ -108,7 +108,7 @@ public interface JwtBuilder extends ClaimsMutator {
*
* @param map the name/value pairs to set as (and potentially replace) the constructed JWT header.
* @return the builder for method chaining.
- * @deprecated since JJWT_RELEASE_VERSION in favor of
+ * @deprecated since 0.12.0 in favor of
* {@link #header()}.{@link MapMutator#empty() empty()}.{@link MapMutator#add(Map) add(map)}.{@link BuilderHeader#and() and()}
* (to replace all header parameters) or
* {@link #header()}.{@link MapMutator#add(Map) add(map)}.{@link BuilderHeader#and() and()}
@@ -126,7 +126,7 @@ public interface JwtBuilder extends ClaimsMutator {
*
* @param params the header name/value pairs to append to the header.
* @return the builder for method chaining.
- * @deprecated since JJWT_RELEASE_VERSION in favor of
+ * @deprecated since 0.12.0 in favor of
* {@link #header()}.{@link MapMutator#add(Map) add(map)}.{@link BuilderHeader#and() and()}
.
* This method will be removed before the 1.0 release.
*/
@@ -143,7 +143,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @param name the header parameter name
* @param value the header parameter value
* @return the builder for method chaining.
- * @deprecated since JJWT_RELEASE_VERSION in favor of
+ * @deprecated since 0.12.0 in favor of
* {@link #header()}.{@link MapMutator#add(Object, Object) add(name, value)}.{@link BuilderHeader#and() and()}
.
* This method will be removed before the 1.0 release.
*/
@@ -152,7 +152,7 @@ public interface JwtBuilder extends ClaimsMutator {
JwtBuilder setHeaderParam(String name, Object value);
/**
- * Since JJWT JJWT_RELEASE_VERSION, this is an alias for {@link #content(String)}. This method will be removed
+ * Since JJWT 0.12.0, this is an alias for {@link #content(String)}. This method will be removed
* before the 1.0 release.
*
* @param payload the string used to set UTF-8-encoded bytes as the JWT payload.
@@ -191,7 +191,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @see #content(String, String)
* @see #content(byte[], String)
* @see #content(InputStream, String)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder content(String content);
@@ -222,7 +222,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @param content the content byte array to use as the JWT payload
* @return the builder for method chaining.
* @see #content(byte[], String)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder content(byte[] content);
@@ -250,7 +250,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @param in the input stream containing the bytes to use as the JWT payload
* @return the builder for method chaining.
* @see #content(byte[], String)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder content(InputStream in);
@@ -297,7 +297,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @param cty the content type (media type) identifier attributed to the byte array. Cannot be null or empty.
* @return the builder for method chaining.
* @throws IllegalArgumentException if either {@code content} or {@code cty} are null or empty.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder content(String content, String cty) throws IllegalArgumentException;
@@ -343,7 +343,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @param cty the content type (media type) identifier attributed to the byte array. Cannot be null or empty.
* @return the builder for method chaining.
* @throws IllegalArgumentException if either {@code content} or {@code cty} are null or empty.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder content(byte[] content, String cty) throws IllegalArgumentException;
@@ -390,7 +390,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @param cty the content type (media type) identifier attributed to the byte array. Cannot be null or empty.
* @return the builder for method chaining.
* @throws IllegalArgumentException if either {@code content} or {@code cty} are null or empty.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder content(InputStream content, String cty) throws IllegalArgumentException;
@@ -416,7 +416,7 @@ public interface JwtBuilder extends ClaimsMutator {
* .compact();
*
* @return the {@link BuilderClaims} to use for Claims construction.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
BuilderClaims claims();
@@ -434,7 +434,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @see #content(String)
* @see #content(byte[])
* @see #content(InputStream)
- * @deprecated since JJWT_RELEASE_VERSION in favor of using the {@link #claims()} builder.
+ * @deprecated since 0.12.0 in favor of using the {@link #claims()} builder.
*/
@SuppressWarnings("DeprecatedIsStillUsed")
@Deprecated
@@ -451,7 +451,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @param claims the JWT Claims to be added to the JWT payload.
* @return the builder for method chaining.
* @since 0.8
- * @deprecated since JJWT_RELEASE_VERSION in favor of
+ * @deprecated since 0.12.0 in favor of
* {@link #claims()}.{@link BuilderClaims#add(Map) add(Map)}.{@link BuilderClaims#and() and()}
.
* This method will be removed before the 1.0 release.
*/
@@ -483,7 +483,7 @@ public interface JwtBuilder extends ClaimsMutator {
*
* @param claims the JWT Claims to be added to the JWT payload.
* @return the builder instance for method chaining
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder claims(Map claims);
@@ -815,7 +815,7 @@ public interface JwtBuilder extends ClaimsMutator {
/**
* Deprecation Notice
*
- * This has been deprecated since JJWT_RELEASE_VERSION. Use
+ *
This has been deprecated since 0.12.0. Use
* {@link #signWith(Key, SecureDigestAlgorithm)} instead. Standard JWA algorithms
* are represented as instances of this new interface in the {@link Jwts.SIG}
* algorithm registry.
@@ -833,7 +833,7 @@ public interface JwtBuilder extends ClaimsMutator {
* the specified algorithm.
* @see #signWith(Key)
* @since 0.10.0
- * @deprecated since JJWT_RELEASE_VERSION to use the more flexible {@link #signWith(Key, SecureDigestAlgorithm)}.
+ * @deprecated since 0.12.0 to use the more flexible {@link #signWith(Key, SecureDigestAlgorithm)}.
*/
@Deprecated
JwtBuilder signWith(Key key, SignatureAlgorithm alg) throws InvalidKeyException;
@@ -856,7 +856,7 @@ public interface JwtBuilder extends ClaimsMutator {
* the specified algorithm.
* @see #signWith(Key)
* @see Jwts.SIG
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder signWith(K key, SecureDigestAlgorithm super K, ?> alg) throws InvalidKeyException;
@@ -943,7 +943,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @param alg implementation of the {@link CompressionAlgorithm} to be used.
* @return the builder for method chaining.
* @see Jwts.ZIP
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder compressWith(CompressionAlgorithm alg);
@@ -957,7 +957,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @return the builder for method chaining.
* @see #b64Url(Encoder)
* @since 0.10.0
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #b64Url(Encoder)}.
+ * @deprecated since 0.12.0 in favor of {@link #b64Url(Encoder)}.
*/
@SuppressWarnings("DeprecatedIsStillUsed")
@Deprecated
@@ -974,7 +974,7 @@ public interface JwtBuilder extends ClaimsMutator {
*
* @param encoder the encoder to use when Base64Url-encoding
* @return the builder for method chaining.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder b64Url(Encoder encoder);
@@ -1003,7 +1003,7 @@ public interface JwtBuilder extends ClaimsMutator {
* @param serializer the serializer to use when converting Map objects to JSON strings.
* @return the builder for method chaining.
* @since 0.10.0
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #json(Serializer)}
+ * @deprecated since 0.12.0 in favor of {@link #json(Serializer)}
*/
@SuppressWarnings("DeprecatedIsStillUsed")
@Deprecated
@@ -1019,7 +1019,7 @@ public interface JwtBuilder extends ClaimsMutator {
*
* @param serializer the Serializer to use when converting Map objects to JSON strings.
* @return the builder for method chaining.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
JwtBuilder json(Serializer
*
* @param the type of object that may be returned from the {@link #locate(Header)} method
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface Locator {
diff --git a/api/src/main/java/io/jsonwebtoken/LocatorAdapter.java b/api/src/main/java/io/jsonwebtoken/LocatorAdapter.java
index a64035d13..43f12dc96 100644
--- a/api/src/main/java/io/jsonwebtoken/LocatorAdapter.java
+++ b/api/src/main/java/io/jsonwebtoken/LocatorAdapter.java
@@ -24,7 +24,7 @@
* unprotected JWT, or an integrity-protected JWT (either a JWS or JWE).
*
* @param the type of object to locate
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public abstract class LocatorAdapter implements Locator {
diff --git a/api/src/main/java/io/jsonwebtoken/MissingClaimException.java b/api/src/main/java/io/jsonwebtoken/MissingClaimException.java
index 1eef4cb16..246748d46 100644
--- a/api/src/main/java/io/jsonwebtoken/MissingClaimException.java
+++ b/api/src/main/java/io/jsonwebtoken/MissingClaimException.java
@@ -46,7 +46,7 @@ public MissingClaimException(Header header, Claims claims, String claimName, Obj
* @param claimValue the value of the claim that could not be validated
* @param message the message explaining why the exception is thrown.
* @param cause the underlying cause that resulted in this exception being thrown.
- * @deprecated since JJWT_RELEASE_VERSION since it is not used in JJWT's codebase
+ * @deprecated since 0.12.0 since it is not used in JJWT's codebase
*/
@Deprecated
public MissingClaimException(Header header, Claims claims, String claimName, Object claimValue, String message, Throwable cause) {
diff --git a/api/src/main/java/io/jsonwebtoken/PrematureJwtException.java b/api/src/main/java/io/jsonwebtoken/PrematureJwtException.java
index 8bca60054..4bdb2ee39 100644
--- a/api/src/main/java/io/jsonwebtoken/PrematureJwtException.java
+++ b/api/src/main/java/io/jsonwebtoken/PrematureJwtException.java
@@ -41,7 +41,7 @@ public PrematureJwtException(Header header, Claims claims, String message) {
* @param message exception message
* @param cause cause
* @since 0.5
- * @deprecated since JJWT_RELEASE_VERSION since it is not used in JJWT's codebase
+ * @deprecated since 0.12.0 since it is not used in JJWT's codebase
*/
@Deprecated
public PrematureJwtException(Header header, Claims claims, String message, Throwable cause) {
diff --git a/api/src/main/java/io/jsonwebtoken/ProtectedHeader.java b/api/src/main/java/io/jsonwebtoken/ProtectedHeader.java
index 4656bf96c..4c13c28a7 100644
--- a/api/src/main/java/io/jsonwebtoken/ProtectedHeader.java
+++ b/api/src/main/java/io/jsonwebtoken/ProtectedHeader.java
@@ -26,7 +26,7 @@
*
* @see JwsHeader
* @see JweHeader
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface ProtectedHeader extends Header, X509Accessor {
diff --git a/api/src/main/java/io/jsonwebtoken/ProtectedHeaderMutator.java b/api/src/main/java/io/jsonwebtoken/ProtectedHeaderMutator.java
index 371735efd..dd38bcaca 100644
--- a/api/src/main/java/io/jsonwebtoken/ProtectedHeaderMutator.java
+++ b/api/src/main/java/io/jsonwebtoken/ProtectedHeaderMutator.java
@@ -26,7 +26,7 @@
* Mutation (modifications) to a {@link ProtectedHeader Header} instance.
*
* @param the mutator subtype, for method chaining
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface ProtectedHeaderMutator> extends HeaderMutator, X509Mutator {
@@ -90,25 +90,25 @@ public interface ProtectedHeaderMutator> ext
T keyId(String kid);
/**
- * Deprecated since JJWT_RELEASE_VERSION, delegates to {@link #keyId(String)}.
+ * Deprecated since 0.12.0, delegates to {@link #keyId(String)}.
*
* @param kid the case-sensitive JWS {@code kid} header value or {@code null} to remove the property from the JSON map.
* @return the instance for method chaining.
* @see JWS Key ID
* @see JWE Key ID
- * @deprecated since JJWT_RELEASE_VERSION in favor of the more modern builder-style {@link #keyId(String)} method.
+ * @deprecated since 0.12.0 in favor of the more modern builder-style {@link #keyId(String)} method.
*/
@Deprecated
T setKeyId(String kid);
/**
- * 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 alg} header as necessary.
*
* @param alg the JWS or JWE algorithm {@code alg} value or {@code null} to remove the property from the JSON map.
* @return the instance for method chaining.
* @since 0.1
- * @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 setAlgorithm(String alg);
diff --git a/api/src/main/java/io/jsonwebtoken/ProtectedJwt.java b/api/src/main/java/io/jsonwebtoken/ProtectedJwt.java
index 4058246b8..1531a13df 100644
--- a/api/src/main/java/io/jsonwebtoken/ProtectedJwt.java
+++ b/api/src/main/java/io/jsonwebtoken/ProtectedJwt.java
@@ -31,7 +31,7 @@
*
* @param the type of the JWT protected header
* @param the type of the JWT payload, either a content byte array or a {@link Claims} instance.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface ProtectedJwt extends Jwt, DigestSupplier {
}
diff --git a/api/src/main/java/io/jsonwebtoken/SignatureAlgorithm.java b/api/src/main/java/io/jsonwebtoken/SignatureAlgorithm.java
index 4d1348c16..ee25883d7 100644
--- a/api/src/main/java/io/jsonwebtoken/SignatureAlgorithm.java
+++ b/api/src/main/java/io/jsonwebtoken/SignatureAlgorithm.java
@@ -34,7 +34,7 @@
* JSON Web Algorithms specification.
*
* @since 0.1
- * @deprecated since JJWT_RELEASE_VERSION; use {@link Jwts.SIG} instead.
+ * @deprecated since 0.12.0; use {@link Jwts.SIG} instead.
*/
@Deprecated
public enum SignatureAlgorithm {
diff --git a/api/src/main/java/io/jsonwebtoken/SigningKeyResolver.java b/api/src/main/java/io/jsonwebtoken/SigningKeyResolver.java
index e497028fd..82b9edca3 100644
--- a/api/src/main/java/io/jsonwebtoken/SigningKeyResolver.java
+++ b/api/src/main/java/io/jsonwebtoken/SigningKeyResolver.java
@@ -46,7 +46,7 @@
*
* @see io.jsonwebtoken.JwtParserBuilder#keyLocator(Locator)
* @since 0.4
- * @deprecated since JJWT_RELEASE_VERSION. Implement {@link Locator} instead.
+ * @deprecated since 0.12.0. Implement {@link Locator} instead.
*/
@Deprecated
public interface SigningKeyResolver {
diff --git a/api/src/main/java/io/jsonwebtoken/SigningKeyResolverAdapter.java b/api/src/main/java/io/jsonwebtoken/SigningKeyResolverAdapter.java
index 6695f5acd..6e90ca15a 100644
--- a/api/src/main/java/io/jsonwebtoken/SigningKeyResolverAdapter.java
+++ b/api/src/main/java/io/jsonwebtoken/SigningKeyResolverAdapter.java
@@ -23,7 +23,7 @@
/**
* Deprecation Notice
*
- * As of JJWT JJWT_RELEASE_VERSION, various Resolver concepts (including the {@code SigningKeyResolver}) have been
+ *
As of JJWT 0.12.0, various Resolver concepts (including the {@code SigningKeyResolver}) have been
* unified into a single {@link Locator} interface. For key location, (for both signing and encryption keys),
* use the {@link JwtParserBuilder#keyLocator(Locator)} to configure a parser with your desired Key locator instead
* of using a {@code SigningKeyResolver}. Also see {@link LocatorAdapter} for the Adapter pattern parallel of this
@@ -49,7 +49,7 @@
* @see io.jsonwebtoken.JwtParserBuilder#keyLocator(Locator)
* @see LocatorAdapter
* @since 0.4
- * @deprecated since JJWT_RELEASE_VERSION. Use {@link LocatorAdapter LocatorAdapter} with
+ * @deprecated since 0.12.0. Use {@link LocatorAdapter LocatorAdapter} with
* {@link JwtParserBuilder#keyLocator(Locator)}
*/
@SuppressWarnings("DeprecatedIsStillUsed")
diff --git a/api/src/main/java/io/jsonwebtoken/SupportedJwtVisitor.java b/api/src/main/java/io/jsonwebtoken/SupportedJwtVisitor.java
index cd3bd2dcb..61cdd7803 100644
--- a/api/src/main/java/io/jsonwebtoken/SupportedJwtVisitor.java
+++ b/api/src/main/java/io/jsonwebtoken/SupportedJwtVisitor.java
@@ -23,7 +23,7 @@
* only if the type-specific handler method is overridden by a subclass.
*
* @param the type of value returned from the subclass handler method implementation.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public class SupportedJwtVisitor implements JwtVisitor {
diff --git a/api/src/main/java/io/jsonwebtoken/io/AbstractDeserializer.java b/api/src/main/java/io/jsonwebtoken/io/AbstractDeserializer.java
index 10526eaf5..0d29fafa0 100644
--- a/api/src/main/java/io/jsonwebtoken/io/AbstractDeserializer.java
+++ b/api/src/main/java/io/jsonwebtoken/io/AbstractDeserializer.java
@@ -28,7 +28,7 @@
* {@link #doDeserialize(Reader)}.
*
* @param the type of object returned after deserialization
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public abstract class AbstractDeserializer implements Deserializer {
diff --git a/api/src/main/java/io/jsonwebtoken/io/AbstractSerializer.java b/api/src/main/java/io/jsonwebtoken/io/AbstractSerializer.java
index f74d558df..5c74b50a5 100644
--- a/api/src/main/java/io/jsonwebtoken/io/AbstractSerializer.java
+++ b/api/src/main/java/io/jsonwebtoken/io/AbstractSerializer.java
@@ -25,7 +25,7 @@
* * {@link #doSerialize(Object, OutputStream)}.
*
* @param the type of object to serialize
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public abstract class AbstractSerializer implements Serializer {
@@ -69,7 +69,7 @@ public final void serialize(T t, OutputStream out) throws SerializationException
* @param out the stream to write to
* @throws Exception if there is a problem converting the object to a byte stream or writing the
* bytes to the {@code out}put stream.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
protected abstract void doSerialize(T t, OutputStream out) throws Exception;
}
diff --git a/api/src/main/java/io/jsonwebtoken/io/CompressionAlgorithm.java b/api/src/main/java/io/jsonwebtoken/io/CompressionAlgorithm.java
index 72e0533c7..5ad0164fe 100644
--- a/api/src/main/java/io/jsonwebtoken/io/CompressionAlgorithm.java
+++ b/api/src/main/java/io/jsonwebtoken/io/CompressionAlgorithm.java
@@ -43,7 +43,7 @@
* @see Jwts.ZIP#DEF
* @see Jwts.ZIP#GZIP
* @see JSON Web Encryption Compression Algorithms Registry
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface CompressionAlgorithm extends Identifiable {
diff --git a/api/src/main/java/io/jsonwebtoken/io/Deserializer.java b/api/src/main/java/io/jsonwebtoken/io/Deserializer.java
index 4962425e1..a61a28a99 100644
--- a/api/src/main/java/io/jsonwebtoken/io/Deserializer.java
+++ b/api/src/main/java/io/jsonwebtoken/io/Deserializer.java
@@ -31,7 +31,7 @@ public interface Deserializer {
* @param bytes the formatted data byte array to convert
* @return the reconstituted Java object
* @throws DeserializationException if there is a problem converting the byte array to an object.
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #deserialize(Reader)}
+ * @deprecated since 0.12.0 in favor of {@link #deserialize(Reader)}
*/
@Deprecated
T deserialize(byte[] bytes) throws DeserializationException;
@@ -42,7 +42,7 @@ public interface Deserializer {
* @param reader the reader to use to read the character stream
* @return the deserialized Java object
* @throws DeserializationException if there is a problem reading the stream or creating the expected Java object
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
T deserialize(Reader reader) throws DeserializationException;
}
diff --git a/api/src/main/java/io/jsonwebtoken/io/Parser.java b/api/src/main/java/io/jsonwebtoken/io/Parser.java
index 584fd134b..b8cac46ba 100644
--- a/api/src/main/java/io/jsonwebtoken/io/Parser.java
+++ b/api/src/main/java/io/jsonwebtoken/io/Parser.java
@@ -22,7 +22,7 @@
* A Parser converts a character stream into a Java object.
*
* @param the instance type created after parsing
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface Parser {
diff --git a/api/src/main/java/io/jsonwebtoken/io/ParserBuilder.java b/api/src/main/java/io/jsonwebtoken/io/ParserBuilder.java
index 3eda0baa6..9cb006880 100644
--- a/api/src/main/java/io/jsonwebtoken/io/ParserBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/io/ParserBuilder.java
@@ -25,7 +25,7 @@
*
* @param The resulting parser's {@link Parser#parse parse} output type
* @param builder type used for method chaining
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface ParserBuilder> extends Builder> {
diff --git a/api/src/main/java/io/jsonwebtoken/io/Serializer.java b/api/src/main/java/io/jsonwebtoken/io/Serializer.java
index d0d68a51d..6bc59ce4a 100644
--- a/api/src/main/java/io/jsonwebtoken/io/Serializer.java
+++ b/api/src/main/java/io/jsonwebtoken/io/Serializer.java
@@ -32,7 +32,7 @@ public interface Serializer {
* @param t the object to serialize
* @return the serialized byte array representing the specified object.
* @throws SerializationException if there is a problem converting the object to a byte array.
- * @deprecated since JJWT_RELEASE_VERSION in favor of {@link #serialize(Object, OutputStream)}
+ * @deprecated since 0.12.0 in favor of {@link #serialize(Object, OutputStream)}
*/
@Deprecated
byte[] serialize(T t) throws SerializationException;
@@ -45,7 +45,7 @@ public interface Serializer {
* @param out the stream to write to
* @throws SerializationException if there is a problem converting the object to a byte stream or writing the
* bytes to the {@code out}put stream.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
void serialize(T t, OutputStream out) throws SerializationException;
}
diff --git a/api/src/main/java/io/jsonwebtoken/lang/Assert.java b/api/src/main/java/io/jsonwebtoken/lang/Assert.java
index 78c99b4f1..022d58f9a 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/Assert.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/Assert.java
@@ -230,7 +230,7 @@ public static void notEmpty(Object[] array) {
* @param msg the exception message to use if the assertion fails
* @return the byte array if the assertion passes
* @throws IllegalArgumentException if the byte array is null or empty
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static byte[] notEmpty(byte[] array, String msg) {
if (Objects.isEmpty(array)) {
@@ -246,7 +246,7 @@ public static byte[] notEmpty(byte[] array, String msg) {
* @param msg the exception message to use if the assertion fails
* @return the character array if the assertion passes
* @throws IllegalArgumentException if the character array is null or empty
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static char[] notEmpty(char[] chars, String msg) {
if (Objects.isEmpty(chars)) {
@@ -454,7 +454,7 @@ public static void isAssignable(Class superType, Class subType, String message)
* @param requirement the requirement that {@code value} must be greater than
* @param msg the message to use for the {@code IllegalArgumentException} if thrown.
* @return {@code value} if greater than the specified {@code requirement}.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static > T eq(T value, T requirement, String msg) {
if (compareTo(value, requirement) != 0) {
@@ -478,7 +478,7 @@ private static > int compareTo(T value, T requirement) {
* @param requirement the requirement that {@code value} must be greater than
* @param msg the message to use for the {@code IllegalArgumentException} if thrown.
* @return {@code value} if greater than the specified {@code requirement}.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static > T gt(T value, T requirement, String msg) {
if (!(compareTo(value, requirement) > 0)) {
@@ -496,7 +496,7 @@ public static > T gt(T value, T requirement, String msg)
* @param requirement the requirement that {@code value} must be greater than
* @param msg the message to use for the {@code IllegalArgumentException} if thrown.
* @return {@code value} if greater than the specified {@code requirement}.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static > T lte(T value, T requirement, String msg) {
if (compareTo(value, requirement) > 0) {
@@ -546,7 +546,7 @@ public static void state(boolean expression) {
* @param value type
* @return the non-null value
* @throws IllegalStateException with the specified {@code msg} if {@code value} is null.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static T stateNotNull(T value, String msg) throws IllegalStateException {
if (value == null) {
diff --git a/api/src/main/java/io/jsonwebtoken/lang/Builder.java b/api/src/main/java/io/jsonwebtoken/lang/Builder.java
index fb872b2a0..506c802dc 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/Builder.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/Builder.java
@@ -19,7 +19,7 @@
* Type-safe interface that reflects the Builder pattern.
*
* @param The type of object that will be created when {@link #build()} is invoked.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface Builder {
diff --git a/api/src/main/java/io/jsonwebtoken/lang/Classes.java b/api/src/main/java/io/jsonwebtoken/lang/Classes.java
index 65d8715b2..37e07522c 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/Classes.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/Classes.java
@@ -130,7 +130,7 @@ public static InputStream getResourceAsStream(String name) {
* @param name the name of the resource to acquire from the classloader(s).
* @return the URL of the resource found, or null
if the resource cannot be found from any
* of the three mentioned ClassLoaders.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
private static URL getResource(String name) {
URL url = THREAD_CL_ACCESSOR.getResource(name);
@@ -311,7 +311,7 @@ public static T invokeStatic(String fqcn, String methodName, Class>[] argT
* @param args the actual runtime arguments to use when invoking the method
* @param the type of object expected to be returned from the method
* @return the result returned by the invoked method.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
@SuppressWarnings("unchecked")
public static T invokeStatic(Class> clazz, String methodName, Class>[] argTypes, Object... args) {
diff --git a/api/src/main/java/io/jsonwebtoken/lang/CollectionMutator.java b/api/src/main/java/io/jsonwebtoken/lang/CollectionMutator.java
index a7916b3b9..6978ac82c 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/CollectionMutator.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/CollectionMutator.java
@@ -24,7 +24,7 @@
*
* @param the type of elements in the collection
* @param the mutator subtype, for method chaining
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface CollectionMutator> {
diff --git a/api/src/main/java/io/jsonwebtoken/lang/Collections.java b/api/src/main/java/io/jsonwebtoken/lang/Collections.java
index 4126c4e53..01768fc64 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/Collections.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/Collections.java
@@ -89,7 +89,7 @@ public static List of(T... elements) {
* @param c the collection to represent as a set
* @param collection element type
* @return a type-safe immutable {@code Set} containing the specified collection elements.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static Set asSet(Collection c) {
if (c instanceof Set) {
@@ -125,7 +125,7 @@ public static Set setOf(T... elements) {
* @param map key type
* @param map value type
* @return an immutable wrapper for {@code m}.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static Map immutable(Map m) {
return m != null ? java.util.Collections.unmodifiableMap(m) : null;
@@ -163,7 +163,7 @@ public static List immutable(List list) {
* @param type of collection
* @param type of elements in the collection
* @return an immutable wrapper for {@code l}.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
@SuppressWarnings("unchecked")
public static > C immutable(C c) {
@@ -184,7 +184,7 @@ public static > C immutable(C c) {
* @param s the set to check for null
* @param type of elements in the set
* @return a non-null set, either {@code s} if it is not null, or {@link #emptySet()} otherwise.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static Set nullSafe(Set s) {
return s == null ? Collections.emptySet() : s;
@@ -196,7 +196,7 @@ public static Set nullSafe(Set s) {
* @param c the collection to check for null
* @param type of elements in the collection
* @return a non-null collection, either {@code c} if it is not null, or {@link #emptyList()} otherwise.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static Collection nullSafe(Collection c) {
return c == null ? Collections.emptyList() : c;
diff --git a/api/src/main/java/io/jsonwebtoken/lang/Conjunctor.java b/api/src/main/java/io/jsonwebtoken/lang/Conjunctor.java
index 30cad3b19..c604752fd 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/Conjunctor.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/Conjunctor.java
@@ -20,7 +20,7 @@
* to the source/original builder.
*
* @param the type of joined object to return.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface Conjunctor {
diff --git a/api/src/main/java/io/jsonwebtoken/lang/MapMutator.java b/api/src/main/java/io/jsonwebtoken/lang/MapMutator.java
index 98fa66746..5133b3033 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/MapMutator.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/MapMutator.java
@@ -25,7 +25,7 @@
* @param map key type
* @param map value type
* @param the mutator subtype, for method chaining
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface MapMutator> {
diff --git a/api/src/main/java/io/jsonwebtoken/lang/NestedCollection.java b/api/src/main/java/io/jsonwebtoken/lang/NestedCollection.java
index 387dfe883..cf0118d4b 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/NestedCollection.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/NestedCollection.java
@@ -21,7 +21,7 @@
*
* @param the type of elements in the collection
* @param the parent to return
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface NestedCollection extends CollectionMutator>, Conjunctor {
}
diff --git a/api/src/main/java/io/jsonwebtoken/lang/Objects.java b/api/src/main/java/io/jsonwebtoken/lang/Objects.java
index 2b7811000..12a92dfd7 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/Objects.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/Objects.java
@@ -102,7 +102,7 @@ public static boolean isArray(Object obj) {
*
* @param v object to check
* @return {@code true} if the specified argument is empty, {@code false} otherwise.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static boolean isEmpty(Object v) {
return v == null ||
@@ -1015,7 +1015,7 @@ public static void nullSafeClose(Closeable... closeables) {
* {@link Flushable#flush()} on each one, ignoring any potential {@link IOException}s.
*
* @param flushables the flushables to flush.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static void nullSafeFlush(Flushable... flushables) {
if (flushables == null) return;
diff --git a/api/src/main/java/io/jsonwebtoken/lang/Registry.java b/api/src/main/java/io/jsonwebtoken/lang/Registry.java
index 5858e7c68..de5849eb1 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/Registry.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/Registry.java
@@ -33,7 +33,7 @@
*
* @param key type
* @param value type
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface Registry extends Map {
diff --git a/api/src/main/java/io/jsonwebtoken/lang/RuntimeEnvironment.java b/api/src/main/java/io/jsonwebtoken/lang/RuntimeEnvironment.java
index 1bb301628..885cef84a 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/RuntimeEnvironment.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/RuntimeEnvironment.java
@@ -22,7 +22,7 @@
/**
* No longer used by JJWT. Will be removed before the 1.0 final release.
*
- * @deprecated since JJWT_RELEASE_VERSION. will be removed before the 1.0 final release.
+ * @deprecated since 0.12.0. will be removed before the 1.0 final release.
*/
@Deprecated
public final class RuntimeEnvironment {
@@ -37,7 +37,7 @@ private RuntimeEnvironment() {
/**
* {@code true} if BouncyCastle is in the runtime classpath, {@code false} otherwise.
*
- * @deprecated since JJWT_RELEASE_VERSION. will be removed before the 1.0 final release.
+ * @deprecated since 0.12.0. will be removed before the 1.0 final release.
*/
@Deprecated
public static final boolean BOUNCY_CASTLE_AVAILABLE = Classes.isAvailable(BC_PROVIDER_CLASS_NAME);
@@ -46,7 +46,7 @@ private RuntimeEnvironment() {
* Register BouncyCastle as a JCA provider in the system's {@link Security#getProviders() Security Providers} list
* if BouncyCastle is in the runtime classpath.
*
- * @deprecated since JJWT_RELEASE_VERSION. will be removed before the 1.0 final release.
+ * @deprecated since 0.12.0. will be removed before the 1.0 final release.
*/
@Deprecated
public static void enableBouncyCastleIfPossible() {
diff --git a/api/src/main/java/io/jsonwebtoken/lang/Strings.java b/api/src/main/java/io/jsonwebtoken/lang/Strings.java
index 442a533b6..ac66ef1c6 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/Strings.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/Strings.java
@@ -240,7 +240,7 @@ public static CharSequence clean(CharSequence str) {
*
* @param s the string to obtain UTF-8 bytes
* @return the specified string's UTF-8 bytes, or {@code null} if the string is {@code null}.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static byte[] utf8(CharSequence s) {
if (s == null) return null;
@@ -258,7 +258,7 @@ public static byte[] utf8(CharSequence s) {
*
* @param utf8Bytes UTF-8 bytes to use with the {@code String} constructor.
* @return {@code new String(utf8Bytes, StandardCharsets.UTF_8)}.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static String utf8(byte[] utf8Bytes) {
return new String(utf8Bytes, UTF_8);
@@ -269,7 +269,7 @@ public static String utf8(byte[] utf8Bytes) {
*
* @param asciiBytes US_ASCII bytes to use with the {@code String} constructor.
* @return {@code new String(asciiBytes, StandardCharsets.US_ASCII)}.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static String ascii(byte[] asciiBytes) {
return new String(asciiBytes, StandardCharsets.US_ASCII);
@@ -1355,7 +1355,7 @@ public static String arrayToCommaDelimitedString(Object[] arr) {
*
* @param sb the string builder to append a space to if non-empty
* @return the string builder argument for method chaining.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static StringBuilder nespace(StringBuilder sb) {
if (sb == null) {
diff --git a/api/src/main/java/io/jsonwebtoken/lang/Supplier.java b/api/src/main/java/io/jsonwebtoken/lang/Supplier.java
index 839a86043..7a94e591c 100644
--- a/api/src/main/java/io/jsonwebtoken/lang/Supplier.java
+++ b/api/src/main/java/io/jsonwebtoken/lang/Supplier.java
@@ -24,7 +24,7 @@
* JDK 7 environments.
*
* @param the type of object returned by this supplier
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface Supplier {
diff --git a/api/src/main/java/io/jsonwebtoken/security/AeadAlgorithm.java b/api/src/main/java/io/jsonwebtoken/security/AeadAlgorithm.java
index 625e386e1..7e82d85f9 100644
--- a/api/src/main/java/io/jsonwebtoken/security/AeadAlgorithm.java
+++ b/api/src/main/java/io/jsonwebtoken/security/AeadAlgorithm.java
@@ -63,7 +63,7 @@
* @see KeyLengthSupplier
* @see KeyBuilderSupplier
* @see KeyBuilder
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface AeadAlgorithm extends Identifiable, KeyLengthSupplier, KeyBuilderSupplier {
diff --git a/api/src/main/java/io/jsonwebtoken/security/AeadRequest.java b/api/src/main/java/io/jsonwebtoken/security/AeadRequest.java
index 61896bb97..828786982 100644
--- a/api/src/main/java/io/jsonwebtoken/security/AeadRequest.java
+++ b/api/src/main/java/io/jsonwebtoken/security/AeadRequest.java
@@ -24,7 +24,7 @@
*
* @see SecureRequest
* @see AssociatedDataSupplier
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface AeadRequest extends SecureRequest, AssociatedDataSupplier {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/AeadResult.java b/api/src/main/java/io/jsonwebtoken/security/AeadResult.java
index 61b61fa46..c8734b5a3 100644
--- a/api/src/main/java/io/jsonwebtoken/security/AeadResult.java
+++ b/api/src/main/java/io/jsonwebtoken/security/AeadResult.java
@@ -22,7 +22,7 @@
* and resulting {@link #setTag(byte[]) AAD tag} and {@link #setIv(byte[]) initialization vector}.
* The AAD tag and initialization vector must be supplied with the ciphertext to decrypt.
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface AeadResult {
diff --git a/api/src/main/java/io/jsonwebtoken/security/AssociatedDataSupplier.java b/api/src/main/java/io/jsonwebtoken/security/AssociatedDataSupplier.java
index cfd9c77ea..4f5cd3719 100644
--- a/api/src/main/java/io/jsonwebtoken/security/AssociatedDataSupplier.java
+++ b/api/src/main/java/io/jsonwebtoken/security/AssociatedDataSupplier.java
@@ -22,7 +22,7 @@
* AEAD encryption or decryption.
*
* @see #getAssociatedData()
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface AssociatedDataSupplier {
diff --git a/api/src/main/java/io/jsonwebtoken/security/AsymmetricJwk.java b/api/src/main/java/io/jsonwebtoken/security/AsymmetricJwk.java
index b67995233..b69db5484 100644
--- a/api/src/main/java/io/jsonwebtoken/security/AsymmetricJwk.java
+++ b/api/src/main/java/io/jsonwebtoken/security/AsymmetricJwk.java
@@ -21,7 +21,7 @@
* JWK representation of an asymmetric (public or private) cryptographic key.
*
* @param the type of {@link java.security.PublicKey} or {@link java.security.PrivateKey} represented by this JWK.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface AsymmetricJwk extends Jwk, X509Accessor {
diff --git a/api/src/main/java/io/jsonwebtoken/security/AsymmetricJwkBuilder.java b/api/src/main/java/io/jsonwebtoken/security/AsymmetricJwkBuilder.java
index 84583434a..fe3ce7eda 100644
--- a/api/src/main/java/io/jsonwebtoken/security/AsymmetricJwkBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/AsymmetricJwkBuilder.java
@@ -23,7 +23,7 @@
* @param the type of Java key provided by the JWK.
* @param the type of asymmetric JWK created
* @param the type of the builder, for subtype method chaining
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface AsymmetricJwkBuilder, T extends AsymmetricJwkBuilder>
extends JwkBuilder, X509Builder {
diff --git a/api/src/main/java/io/jsonwebtoken/security/Curve.java b/api/src/main/java/io/jsonwebtoken/security/Curve.java
index d78e67ccc..2cc1f425d 100644
--- a/api/src/main/java/io/jsonwebtoken/security/Curve.java
+++ b/api/src/main/java/io/jsonwebtoken/security/Curve.java
@@ -35,7 +35,7 @@
* Constants for all JWA standard Curves are available via the {@link Jwks.CRV} registry.
*
* @see Jwks.CRV
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface Curve extends Identifiable, KeyPairBuilderSupplier {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/DecryptAeadRequest.java b/api/src/main/java/io/jsonwebtoken/security/DecryptAeadRequest.java
index a5673f941..5faf1f6a5 100644
--- a/api/src/main/java/io/jsonwebtoken/security/DecryptAeadRequest.java
+++ b/api/src/main/java/io/jsonwebtoken/security/DecryptAeadRequest.java
@@ -22,7 +22,7 @@
* decryption {@link SecretKey}. Extends both {@link IvSupplier} and {@link DigestSupplier} to
* ensure the respective required IV and AAD tag returned from an {@link AeadResult} are available for decryption.
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface DecryptAeadRequest extends AeadRequest, IvSupplier, DigestSupplier {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/DecryptionKeyRequest.java b/api/src/main/java/io/jsonwebtoken/security/DecryptionKeyRequest.java
index 3a4b84c7b..893cad946 100644
--- a/api/src/main/java/io/jsonwebtoken/security/DecryptionKeyRequest.java
+++ b/api/src/main/java/io/jsonwebtoken/security/DecryptionKeyRequest.java
@@ -36,7 +36,7 @@
* to be available in the JWE protected header, accessible via {@link #getHeader()}.
*
* @param the type of {@link Key} used during the request to obtain the resulting decryption key.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface DecryptionKeyRequest extends SecureRequest, KeyRequest {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/DigestAlgorithm.java b/api/src/main/java/io/jsonwebtoken/security/DigestAlgorithm.java
index bc5622fcb..daeaa6a7a 100644
--- a/api/src/main/java/io/jsonwebtoken/security/DigestAlgorithm.java
+++ b/api/src/main/java/io/jsonwebtoken/security/DigestAlgorithm.java
@@ -74,7 +74,7 @@
* @param the type of {@link VerifyDigestRequest} used when verifying a digest.
* @see Jwks.HASH
* @see io.jsonwebtoken.Jwts.SIG Jwts.SIG
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface DigestAlgorithm, V extends VerifyDigestRequest> extends Identifiable {
diff --git a/api/src/main/java/io/jsonwebtoken/security/DigestSupplier.java b/api/src/main/java/io/jsonwebtoken/security/DigestSupplier.java
index 60f0ec2b3..4c697d9bf 100644
--- a/api/src/main/java/io/jsonwebtoken/security/DigestSupplier.java
+++ b/api/src/main/java/io/jsonwebtoken/security/DigestSupplier.java
@@ -19,7 +19,7 @@
* A {@code DigestSupplier} provides access to the result of a cryptographic digest algorithm, such as a
* Message Digest, MAC, Signature, or Authentication Tag.
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface DigestSupplier {
diff --git a/api/src/main/java/io/jsonwebtoken/security/DynamicJwkBuilder.java b/api/src/main/java/io/jsonwebtoken/security/DynamicJwkBuilder.java
index 5ac13fecf..afc909455 100644
--- a/api/src/main/java/io/jsonwebtoken/security/DynamicJwkBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/DynamicJwkBuilder.java
@@ -33,7 +33,7 @@
*
* @param the type of Java {@link Key} represented by the created {@link Jwk}.
* @param the type of {@link Jwk} created by the builder
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface DynamicJwkBuilder> extends JwkBuilder> {
diff --git a/api/src/main/java/io/jsonwebtoken/security/EcPrivateJwk.java b/api/src/main/java/io/jsonwebtoken/security/EcPrivateJwk.java
index 7d2a27140..b746646f4 100644
--- a/api/src/main/java/io/jsonwebtoken/security/EcPrivateJwk.java
+++ b/api/src/main/java/io/jsonwebtoken/security/EcPrivateJwk.java
@@ -37,7 +37,7 @@
* jwk.get("y");
* // ... etc ...
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface EcPrivateJwk extends PrivateJwk {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/EcPrivateJwkBuilder.java b/api/src/main/java/io/jsonwebtoken/security/EcPrivateJwkBuilder.java
index 07d91f448..f92e6e437 100644
--- a/api/src/main/java/io/jsonwebtoken/security/EcPrivateJwkBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/EcPrivateJwkBuilder.java
@@ -21,7 +21,7 @@
/**
* A {@link PrivateJwkBuilder} that creates {@link EcPrivateJwk}s.
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface EcPrivateJwkBuilder extends PrivateJwkBuilder {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/EcPublicJwk.java b/api/src/main/java/io/jsonwebtoken/security/EcPublicJwk.java
index 925f61f79..898fc6f34 100644
--- a/api/src/main/java/io/jsonwebtoken/security/EcPublicJwk.java
+++ b/api/src/main/java/io/jsonwebtoken/security/EcPublicJwk.java
@@ -36,7 +36,7 @@
* jwk.get("y");
* // ... etc ...
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface EcPublicJwk extends PublicJwk {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/EcPublicJwkBuilder.java b/api/src/main/java/io/jsonwebtoken/security/EcPublicJwkBuilder.java
index 4a0ce8872..b3ed2ce33 100644
--- a/api/src/main/java/io/jsonwebtoken/security/EcPublicJwkBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/EcPublicJwkBuilder.java
@@ -21,7 +21,7 @@
/**
* A {@link PublicJwkBuilder} that creates {@link EcPublicJwk}s.
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface EcPublicJwkBuilder extends PublicJwkBuilder {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/HashAlgorithm.java b/api/src/main/java/io/jsonwebtoken/security/HashAlgorithm.java
index 2168b6065..3bc4ec449 100644
--- a/api/src/main/java/io/jsonwebtoken/security/HashAlgorithm.java
+++ b/api/src/main/java/io/jsonwebtoken/security/HashAlgorithm.java
@@ -39,7 +39,7 @@
* Algorithms are available via {@link Jwks.HASH}.
*
* @see Jwks.HASH
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface HashAlgorithm extends DigestAlgorithm, VerifyDigestRequest> {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/InvalidKeyException.java b/api/src/main/java/io/jsonwebtoken/security/InvalidKeyException.java
index ad9d4a7da..659c89d26 100644
--- a/api/src/main/java/io/jsonwebtoken/security/InvalidKeyException.java
+++ b/api/src/main/java/io/jsonwebtoken/security/InvalidKeyException.java
@@ -37,7 +37,7 @@ public InvalidKeyException(String message) {
*
* @param message the message explaining why the exception is thrown.
* @param cause the underlying cause that resulted in this exception being thrown.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public InvalidKeyException(String message, Throwable cause) {
super(message, cause);
diff --git a/api/src/main/java/io/jsonwebtoken/security/IvSupplier.java b/api/src/main/java/io/jsonwebtoken/security/IvSupplier.java
index b3ee9a910..f1cc3d506 100644
--- a/api/src/main/java/io/jsonwebtoken/security/IvSupplier.java
+++ b/api/src/main/java/io/jsonwebtoken/security/IvSupplier.java
@@ -21,7 +21,7 @@
* algorithms, a new secure-random Initialization Vector MUST be generated for every individual
* encryption attempt.
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface IvSupplier {
diff --git a/api/src/main/java/io/jsonwebtoken/security/Jwk.java b/api/src/main/java/io/jsonwebtoken/security/Jwk.java
index 6b015bb10..fef6420aa 100644
--- a/api/src/main/java/io/jsonwebtoken/security/Jwk.java
+++ b/api/src/main/java/io/jsonwebtoken/security/Jwk.java
@@ -81,7 +81,7 @@
* JWK internal serialization parameters.
*
* @param The type of Java {@link Key} represented by this JWK
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface Jwk extends Identifiable, Map {
diff --git a/api/src/main/java/io/jsonwebtoken/security/JwkBuilder.java b/api/src/main/java/io/jsonwebtoken/security/JwkBuilder.java
index af41efb04..2133925c9 100644
--- a/api/src/main/java/io/jsonwebtoken/security/JwkBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/JwkBuilder.java
@@ -39,7 +39,7 @@
* @see EcPrivateJwkBuilder
* @see OctetPublicJwkBuilder
* @see OctetPrivateJwkBuilder
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface JwkBuilder, T extends JwkBuilder>
extends MapMutator, SecurityBuilder, KeyOperationPolicied {
diff --git a/api/src/main/java/io/jsonwebtoken/security/JwkParserBuilder.java b/api/src/main/java/io/jsonwebtoken/security/JwkParserBuilder.java
index 470bc91f5..9c66db773 100644
--- a/api/src/main/java/io/jsonwebtoken/security/JwkParserBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/JwkParserBuilder.java
@@ -29,7 +29,7 @@
* .build()
* .parse(jwkString);
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface JwkParserBuilder extends ParserBuilder, JwkParserBuilder>, KeyOperationPolicied {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/JwkSet.java b/api/src/main/java/io/jsonwebtoken/security/JwkSet.java
index 142490bfa..c8b3ea5a9 100644
--- a/api/src/main/java/io/jsonwebtoken/security/JwkSet.java
+++ b/api/src/main/java/io/jsonwebtoken/security/JwkSet.java
@@ -33,7 +33,7 @@
* {@link Map#remove(Object) remove}, {@link Map#clear() clear}, etc) will throw an
* {@link UnsupportedOperationException}.
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface JwkSet extends Map, Iterable> {
diff --git a/api/src/main/java/io/jsonwebtoken/security/JwkSetBuilder.java b/api/src/main/java/io/jsonwebtoken/security/JwkSetBuilder.java
index b87bc5c63..987f436d3 100644
--- a/api/src/main/java/io/jsonwebtoken/security/JwkSetBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/JwkSetBuilder.java
@@ -27,7 +27,7 @@
*
* @see #operationPolicy(KeyOperationPolicy)
* @see #provider(Provider)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface JwkSetBuilder extends MapMutator,
SecurityBuilder, KeyOperationPolicied {
diff --git a/api/src/main/java/io/jsonwebtoken/security/JwkSetParserBuilder.java b/api/src/main/java/io/jsonwebtoken/security/JwkSetParserBuilder.java
index 05530de4e..d3fcb757a 100644
--- a/api/src/main/java/io/jsonwebtoken/security/JwkSetParserBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/JwkSetParserBuilder.java
@@ -30,7 +30,7 @@
* .build()
* .parse(jwkSetString);
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface JwkSetParserBuilder extends ParserBuilder, KeyOperationPolicied {
diff --git a/api/src/main/java/io/jsonwebtoken/security/JwkThumbprint.java b/api/src/main/java/io/jsonwebtoken/security/JwkThumbprint.java
index c88fca3f5..1c2034386 100644
--- a/api/src/main/java/io/jsonwebtoken/security/JwkThumbprint.java
+++ b/api/src/main/java/io/jsonwebtoken/security/JwkThumbprint.java
@@ -21,7 +21,7 @@
* A canonical cryptographic digest of a JWK as defined by the
* JSON Web Key (JWK) Thumbprint specification.
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface JwkThumbprint {
diff --git a/api/src/main/java/io/jsonwebtoken/security/Jwks.java b/api/src/main/java/io/jsonwebtoken/security/Jwks.java
index 1c422b0ea..ee8a164d4 100644
--- a/api/src/main/java/io/jsonwebtoken/security/Jwks.java
+++ b/api/src/main/java/io/jsonwebtoken/security/Jwks.java
@@ -34,7 +34,7 @@
* Jwks.{@link Jwks.HASH HASH}.// press hotkeys to suggest individual hash algorithms or utility methods
*
* @see #builder()
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public final class Jwks {
@@ -143,7 +143,7 @@ public static String UNSAFE_JSON(Jwk> jwk) {
* They are also available together as a {@link Registry} instance via the {@link #get()} method.
*
* @see #get()
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static final class CRV {
@@ -268,7 +268,7 @@ private CRV() {
* They are also available together as a {@link Registry} instance via the {@link #get()} method.
*
* @see #get()
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static final class HASH {
@@ -363,7 +363,7 @@ private HASH() {
* They are also available together as a {@link Registry} instance via the {@link #get()} method.
*
* @see #get()
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static final class OP {
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyAlgorithm.java b/api/src/main/java/io/jsonwebtoken/security/KeyAlgorithm.java
index 134d5058d..e3cd13c65 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyAlgorithm.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyAlgorithm.java
@@ -42,7 +42,7 @@
* @param The type of key to use to obtain the AEAD decryption key
* @see Jwts.KEY
* @see RFC 7561, Section 2: JWE Key (Management) Algorithms
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
@SuppressWarnings("JavadocLinkAsPlainText")
public interface KeyAlgorithm extends Identifiable {
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyBuilder.java b/api/src/main/java/io/jsonwebtoken/security/KeyBuilder.java
index dd50239a9..9de8f00f9 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyBuilder.java
@@ -28,7 +28,7 @@
* @param the type of key to build
* @param the type of the builder, for subtype method chaining
* @see KeyBuilderSupplier
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyBuilder> extends SecurityBuilder {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyBuilderSupplier.java b/api/src/main/java/io/jsonwebtoken/security/KeyBuilderSupplier.java
index 97b3eb02a..d55611209 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyBuilderSupplier.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyBuilderSupplier.java
@@ -25,7 +25,7 @@
* @param type of builder to create each time {@link #key()} is called.
* @see #key()
* @see KeyBuilder
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyBuilderSupplier> {
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyLengthSupplier.java b/api/src/main/java/io/jsonwebtoken/security/KeyLengthSupplier.java
index 407230288..f550dcfd9 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyLengthSupplier.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyLengthSupplier.java
@@ -18,7 +18,7 @@
/**
* Provides access to the required length in bits (not bytes) of keys usable with the associated algorithm.
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyLengthSupplier {
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyOperation.java b/api/src/main/java/io/jsonwebtoken/security/KeyOperation.java
index 38c4222cd..925a3a086 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyOperation.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyOperation.java
@@ -29,7 +29,7 @@
*
* @see JWK key_ops (Key Operations) Parameter
* @see JSON Web Key Operations Registry
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyOperation extends Identifiable {
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyOperationBuilder.java b/api/src/main/java/io/jsonwebtoken/security/KeyOperationBuilder.java
index cb24e45bf..9d41477d3 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyOperationBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyOperationBuilder.java
@@ -26,7 +26,7 @@
* @see Jwks.OP#builder()
* @see Jwks.OP#policy()
* @see JwkBuilder#operationPolicy(KeyOperationPolicy)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyOperationBuilder extends Builder {
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyOperationPolicy.java b/api/src/main/java/io/jsonwebtoken/security/KeyOperationPolicy.java
index b36aaa315..60389a24b 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyOperationPolicy.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyOperationPolicy.java
@@ -21,7 +21,7 @@
* A key operation policy determines which {@link KeyOperation}s may be assigned to a JWK.
*
* @see JwkBuilder#operationPolicy(KeyOperationPolicy)
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyOperationPolicy {
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyOperationPolicyBuilder.java b/api/src/main/java/io/jsonwebtoken/security/KeyOperationPolicyBuilder.java
index 3873cc2fd..548a1a966 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyOperationPolicyBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyOperationPolicyBuilder.java
@@ -31,7 +31,7 @@
* @see Jwks.OP#policy()
* @see JwkBuilder#operationPolicy(KeyOperationPolicy)
* @see Jwks.OP#builder()
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyOperationPolicyBuilder extends CollectionMutator,
Builder {
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyPair.java b/api/src/main/java/io/jsonwebtoken/security/KeyPair.java
index f680534b7..edd2bd1c8 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyPair.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyPair.java
@@ -24,7 +24,7 @@
*
* @param The type of {@link PublicKey} in the key pair.
* @param The type of {@link PrivateKey} in the key pair.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyPair {
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyPairBuilder.java b/api/src/main/java/io/jsonwebtoken/security/KeyPairBuilder.java
index 2b240609d..f6db1b241 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyPairBuilder.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyPairBuilder.java
@@ -25,7 +25,7 @@
* ensuring the resulting {@link KeyPair}s are compatible with their associated cryptographic algorithm.
*
* @see KeyPairBuilderSupplier
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyPairBuilder extends SecurityBuilder {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyPairBuilderSupplier.java b/api/src/main/java/io/jsonwebtoken/security/KeyPairBuilderSupplier.java
index a6b79bda3..98d42eae6 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyPairBuilderSupplier.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyPairBuilderSupplier.java
@@ -23,7 +23,7 @@
*
* @see #keyPair()
* @see KeyPairBuilder
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyPairBuilderSupplier {
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyRequest.java b/api/src/main/java/io/jsonwebtoken/security/KeyRequest.java
index f9fe51f0f..ffe22061e 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyRequest.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyRequest.java
@@ -40,7 +40,7 @@
*
* @param the type of object relevant during key algorithm cryptographic operations.
* @see DecryptionKeyRequest
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyRequest extends Request {
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeyResult.java b/api/src/main/java/io/jsonwebtoken/security/KeyResult.java
index 5c029fb81..753909dec 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeyResult.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeyResult.java
@@ -28,7 +28,7 @@
* The result {@link #getKey() key} is the {@code JWE Content Encryption Key (CEK)} which will be used to encrypt
* the JWE.
*
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeyResult extends Message, KeySupplier {
}
diff --git a/api/src/main/java/io/jsonwebtoken/security/KeySupplier.java b/api/src/main/java/io/jsonwebtoken/security/KeySupplier.java
index df582971a..2026b2553 100644
--- a/api/src/main/java/io/jsonwebtoken/security/KeySupplier.java
+++ b/api/src/main/java/io/jsonwebtoken/security/KeySupplier.java
@@ -21,7 +21,7 @@
* Provides access to a cryptographic {@link Key} necessary for signing, wrapping, encryption or decryption algorithms.
*
* @param the type of key provided by this supplier.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public interface KeySupplier {
diff --git a/api/src/main/java/io/jsonwebtoken/security/Keys.java b/api/src/main/java/io/jsonwebtoken/security/Keys.java
index f86e4aaa9..9ae54e73e 100644
--- a/api/src/main/java/io/jsonwebtoken/security/Keys.java
+++ b/api/src/main/java/io/jsonwebtoken/security/Keys.java
@@ -86,7 +86,7 @@ public static SecretKey hmacShaKeyFor(byte[] bytes) throws WeakKeyException {
/**
* Deprecation Notice
*
- * As of JJWT JJWT_RELEASE_VERSION, symmetric (secret) key algorithm instances can generate a key of suitable
+ *
As of JJWT 0.12.0, symmetric (secret) key algorithm instances can generate a key of suitable
* length for that specific algorithm by calling their {@code key()} builder method directly. For example:
*
*
@@ -132,7 +132,7 @@ public static SecretKey hmacShaKeyFor(byte[] bytes) throws WeakKeyException {
* @return a new {@link SecretKey} instance suitable for use with the specified {@link SignatureAlgorithm}.
* @throws IllegalArgumentException for any input value other than {@link io.jsonwebtoken.SignatureAlgorithm#HS256},
* {@link io.jsonwebtoken.SignatureAlgorithm#HS384}, or {@link io.jsonwebtoken.SignatureAlgorithm#HS512}
- * @deprecated since JJWT_RELEASE_VERSION. Use your preferred {@link MacAlgorithm} instance's
+ * @deprecated since 0.12.0. Use your preferred {@link MacAlgorithm} instance's
* {@link MacAlgorithm#key() key()} builder method directly.
*/
@SuppressWarnings("DeprecatedIsStillUsed")
@@ -150,7 +150,7 @@ public static SecretKey secretKeyFor(io.jsonwebtoken.SignatureAlgorithm alg) thr
/**
* Deprecation Notice
*
- * As of JJWT JJWT_RELEASE_VERSION, asymmetric key algorithm instances can generate KeyPairs of suitable strength
+ *
As of JJWT 0.12.0, asymmetric key algorithm instances can generate KeyPairs of suitable strength
* for that specific algorithm by calling their {@code keyPair()} builder method directly. For example:
*
*
@@ -236,7 +236,7 @@ public static SecretKey secretKeyFor(io.jsonwebtoken.SignatureAlgorithm alg) thr
* @param alg the {@code SignatureAlgorithm} to inspect to determine which asymmetric algorithm to use.
* @return a new {@link KeyPair} suitable for use with the specified asymmetric algorithm.
* @throws IllegalArgumentException if {@code alg} is not an asymmetric algorithm
- * @deprecated since JJWT_RELEASE_VERSION in favor of your preferred
+ * @deprecated since 0.12.0 in favor of your preferred
* {@link io.jsonwebtoken.security.SignatureAlgorithm} instance's
* {@link SignatureAlgorithm#keyPair() keyPair()} builder method directly.
*/
@@ -271,7 +271,7 @@ public static KeyPair keyPairFor(io.jsonwebtoken.SignatureAlgorithm alg) throws
* @param password the raw password character array to clone for use with password-based key derivation algorithms.
* @return a new {@link Password} instance that wraps a new clone of the specified {@code password} character array.
* @see Password#toCharArray()
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static Password password(char[] password) {
return invokeStatic("password", FOR_PASSWORD_ARG_TYPES, new Object[]{password});
@@ -296,7 +296,7 @@ public static Password password(char[] password) {
* {@link Provider}
* @return a new {@code SecretKeyBuilder} that produces the specified key, potentially associated with any
* specified provider.
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static SecretKeyBuilder builder(SecretKey key) {
Assert.notNull(key, "SecretKey cannot be null.");
@@ -323,7 +323,7 @@ public static SecretKeyBuilder builder(SecretKey key) {
* {@link Provider} or {@link PublicKey}.
* @return a new {@code PrivateKeyBuilder} that produces the specified private key, potentially associated with any
* specified provider or {@code PublicKey}
- * @since JJWT_RELEASE_VERSION
+ * @since 0.12.0
*/
public static PrivateKeyBuilder builder(PrivateKey key) {
Assert.notNull(key, "PrivateKey cannot be null.");
diff --git a/api/src/main/java/io/jsonwebtoken/security/MacAlgorithm.java b/api/src/main/java/io/jsonwebtoken/security/MacAlgorithm.java
index 3d04e9747..e34d927b3 100644
--- a/api/src/main/java/io/jsonwebtoken/security/MacAlgorithm.java
+++ b/api/src/main/java/io/jsonwebtoken/security/MacAlgorithm.java
@@ -58,7 +58,7 @@
* available via {@link io.jsonwebtoken.Jwts.SIG Jwts.SIG}.