From 58746bb3a26927b80a9142127f916817c541d17c Mon Sep 17 00:00:00 2001 From: Zihlu Wang Date: Fri, 4 Aug 2023 19:49:43 +0800 Subject: [PATCH] docs(simple-jwt-jjwt): Created package-info file for package cn.org.codecrafters.simplejwt.jjwt --- .../simplejwt/jjwt/package-info.java | 60 +++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 simple-jwt-jjwt/src/main/java/cn/org/codecrafters/simplejwt/jjwt/package-info.java diff --git a/simple-jwt-jjwt/src/main/java/cn/org/codecrafters/simplejwt/jjwt/package-info.java b/simple-jwt-jjwt/src/main/java/cn/org/codecrafters/simplejwt/jjwt/package-info.java new file mode 100644 index 0000000..cf355ed --- /dev/null +++ b/simple-jwt-jjwt/src/main/java/cn/org/codecrafters/simplejwt/jjwt/package-info.java @@ -0,0 +1,60 @@ +/* + * Copyright (C) 2023 CodeCraftersCN. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * This package contains classes related to the integration of the {@code + * io.jsonwebtoken:jjwt-api} library in the Simple JWT project. {@code + * io.jsonwebtoken:jjwt-api} is a powerful and widely-used Identity as a Service + * (IDaaS) platform that provides secure authentication and authorization + * solutions for web and mobile applications. The classes in this package + * provide the necessary functionality to handle JSON Web Tokens (JWTs) using + * the {@code io.jsonwebtoken:jjwt-api} library. + * + *

+ * The main class in this package is the {@link + * cn.org.codecrafters.simplejwt.jjwt.JjwtTokenResolver}, which + * implements the {@link cn.org.codecrafters.simplejwt.TokenResolver} interface + * and uses the {@code io.jsonwebtoken:jjwt-api} library to handle JWT + * operations. It provides the functionality to create, validate, and extract + * JWTs using the {@code io.jsonwebtoken:jjwt-api} library. Developers can use + * this class as the main token resolver in the Simple JWT project when + * integrating {@code io.jsonwebtoken:jjwt-api} as the JWT management library. + * + *

+ * The {@code AuthzeroTokenResolver} relies on the {@code + * io.jsonwebtoken:jjwt-api} library to handle the underlying JWT operations, + * including token creation, validation, and extraction. It utilizes the {@code + * io.jsonwebtoken:jjwt-api} {@code Algorithm} class to define and use + * different algorithms for JWT signing and verification. + * + *

+ * To use the {@code AuthzeroTokenResolver}, developers must provide the + * necessary configurations and dependencies, such as the {@code GuidCreator} + * for generating unique JWT IDs (JTI), the supported algorithm function, the + * issuer name, and the secret key used for token signing and validation. The + * {@code AuthzeroTokenResolverConfig} class provides a convenient way to + * configure these dependencies. + * + *

+ * Developers using the {@code io.jsonwebtoken:jjwt-api} integration should be + * familiar with the concepts and usage of the {@code io.jsonwebtoken:jjwt-api} + * library and follow the official {@code io.jsonwebtoken:jjwt-api} + * documentation for best practices and security considerations. + * + * @since 1.0.0 + */ +package cn.org.codecrafters.simplejwt.jjwt; \ No newline at end of file