doc(simple-jwt): Optimised Javadocs.
This commit is contained in:
+2
-7
@@ -45,11 +45,6 @@ import java.util.*;
|
||||
* resolver provides functionality to create, extract, verify, and renew JWT
|
||||
* tokens using various algorithms and custom payload data.
|
||||
* <p>
|
||||
* <b>Dependencies:</b>
|
||||
* This implementation relies on the {@code com.auth0:java-jwt} library. Please
|
||||
* ensure you have added this library as a dependency to your project before
|
||||
* using this resolver.
|
||||
* <p>
|
||||
* <b>Usage:</b>
|
||||
* To use the {@code AuthzeroTokenResolver}, first, create an instance of this
|
||||
* class:
|
||||
@@ -87,7 +82,7 @@ import java.util.*;
|
||||
* correctly configured in your project's dependencies.
|
||||
*
|
||||
* @author Zihlu Wang
|
||||
* @version 1.1.0
|
||||
* @version 1.1.1
|
||||
* @see GuidCreator
|
||||
* @see Algorithm
|
||||
* @see JWTVerifier
|
||||
@@ -279,7 +274,7 @@ public class AuthzeroTokenResolver implements TokenResolver<DecodedJWT> {
|
||||
builder.withClaim(name, v);
|
||||
} else {
|
||||
log.warn("""
|
||||
Unable to determine the type of field {}, converting it to a string now.""", name);
|
||||
Unable to determine the type of field {}, we will handle it as a String.""", name);
|
||||
builder.withClaim(name, value.toString());
|
||||
}
|
||||
} else {
|
||||
|
||||
+10
-9
@@ -35,19 +35,20 @@ import java.util.function.Function;
|
||||
* the {@link AuthzeroTokenResolver}.
|
||||
* <p>
|
||||
* This configuration is used to establish the mapping between the standard
|
||||
* {@link TokenAlgorithm} defined within the {@link AuthzeroTokenResolver}
|
||||
* facade and the specific algorithms used by the {@code com.auth0:java-jwt}
|
||||
* library, which is the underlying library used by {@link
|
||||
* AuthzeroTokenResolver} to handle JSON Web Tokens (JWTs).
|
||||
* {@link TokenAlgorithm} defined in the
|
||||
* {@code cn.org.codecrafters:simple-jwt-facade} and the specific algorithms
|
||||
* used by the {@code com.auth0:java-jwt} library, which is the underlying
|
||||
* library used by {@link AuthzeroTokenResolver} to handle JSON Web Tokens
|
||||
* (JWTs).
|
||||
* <p>
|
||||
* <b>Algorithm Mapping:</b>
|
||||
* The {@code AuthzeroTokenResolverConfig} allows specifying the relationship
|
||||
* The {@code AuthzeroTokenResolverConfig} allows specifying the relationships
|
||||
* between the standard {@link TokenAlgorithm} instances supported by
|
||||
* {@link AuthzeroTokenResolver} and the corresponding algorithms used by the
|
||||
* {@code com.auth0:java-jwt} library. The mapping is achieved using a Map,
|
||||
* where the keys are the standard TokenAlgorithm instances, and the values
|
||||
* represent the algorithm functions used by Auth0 Java JWT library for each
|
||||
* corresponding key.
|
||||
* where the keys are the standard {@link TokenAlgorithm} instances, and the
|
||||
* values represent the algorithm functions used by {@code com.auth0:java-jwt}
|
||||
* library for each corresponding key.
|
||||
* <p>
|
||||
* <b>Note:</b>
|
||||
* The provided algorithm mapping should be consistent with the actual
|
||||
@@ -56,7 +57,7 @@ import java.util.function.Function;
|
||||
* validation and processing within the {@link AuthzeroTokenResolver}.
|
||||
*
|
||||
* @author Zihlu Wang
|
||||
* @version 1.1.0
|
||||
* @version 1.1.1
|
||||
* @since 1.0.0
|
||||
*/
|
||||
public final class AuthzeroTokenResolverConfig implements TokenResolverConfig<Function<String, Algorithm>> {
|
||||
|
||||
+2
-2
@@ -21,8 +21,8 @@ import cn.org.codecrafters.simplejwt.TokenResolver;
|
||||
import cn.org.codecrafters.simplejwt.constants.TokenAlgorithm;
|
||||
|
||||
/**
|
||||
* The {@code TokenResolverConfig} provides a mechanism to configure a
|
||||
* {@link TokenResolver} with algorithm functions.
|
||||
* The {@code TokenResolverConfig} provides a mechanism to configure an
|
||||
* implementation of {@link TokenResolver} with algorithm functions.
|
||||
* <p>
|
||||
* This generic interface is used to define the configuration details for a
|
||||
* {@link TokenResolver} that utilizes algorithm functions. The interface
|
||||
|
||||
-5
@@ -49,11 +49,6 @@ import java.util.UUID;
|
||||
* This resolver provides functionality to create, extract, verify, and renew
|
||||
* JWT tokens using various algorithms and custom payload data.
|
||||
* <p>
|
||||
* <b>Dependencies:</b>
|
||||
* This implementation relies on the {@code io.jsonwebtoken:jjwt} library. Please
|
||||
* ensure you have added this library as a dependency to your project before
|
||||
* using this resolver.
|
||||
* <p>
|
||||
* <b>Usage:</b>
|
||||
* To use the {@code JjwtTokenResolver}, first, create an instance of this
|
||||
* class:
|
||||
|
||||
+12
-11
@@ -28,19 +28,20 @@ import java.util.HashMap;
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* The {@code JjwtTokenResolverConfig} class provides the configuration for the
|
||||
* {@link JjwtTokenResolver}.
|
||||
* The {@code JjwtTokenResolverConfig} class provides the configuration for
|
||||
* the {@link JjwtTokenResolver}.
|
||||
* <p>
|
||||
* This configuration class is used to establish the mapping between the
|
||||
* standard {@link TokenAlgorithm} defined within the
|
||||
* {@code JjwtTokenResolverConfig} and the specific algorithms used by the
|
||||
* {@code io.jsonwebtoken:jjwt} library, which is the underlying library used
|
||||
* by {@code JjwtTokenResolver} to handle JSON Web Tokens (JWTs).
|
||||
* This configuration is used to establish the mapping between the standard
|
||||
* {@link TokenAlgorithm} defined in the
|
||||
* {@code cn.org.codecrafters:simple-jwt-facade} and the specific algorithms
|
||||
* used by the {@code io.jsonwebtoken:jjwt} library, which is the underlying
|
||||
* library used by {@link JjwtTokenResolver} to handle JSON Web Tokens
|
||||
* (JWTs).
|
||||
* <p>
|
||||
* <b>Algorithm Mapping:</b>
|
||||
* The {@code JjwtTokenResolverConfig} allows specifying the relationship
|
||||
* between the standard {@link TokenAlgorithm} instances supported by {@link
|
||||
* JjwtTokenResolver} and the corresponding algorithms used by the
|
||||
* The {@code JjwtTokenResolverConfig} allows specifying the relationships
|
||||
* between the standard {@link TokenAlgorithm} instances supported by
|
||||
* {@link JjwtTokenResolver} and the corresponding algorithms used by the
|
||||
* {@code io.jsonwebtoken:jjwt} library. The mapping is achieved using a Map,
|
||||
* where the keys are the standard {@link TokenAlgorithm} instances, and the
|
||||
* values represent the algorithm functions used by
|
||||
@@ -53,7 +54,7 @@ import java.util.Map;
|
||||
* validation and processing within the {@link JjwtTokenResolver}.
|
||||
*
|
||||
* @author Zihlu Wang
|
||||
* @version 1.1.0
|
||||
* @version 1.1.1
|
||||
* @since 1.0.0
|
||||
*/
|
||||
public final class JjwtTokenResolverConfig implements TokenResolverConfig<SignatureAlgorithm> {
|
||||
|
||||
Reference in New Issue
Block a user