version 1.1.3

Author: hoangtien2k3

pom.xml

@@ -11,7 +11,7 @@
 
     <groupId>io.github.hoangtien2k3</groupId>
     <artifactId>fw-commons</artifactId>
-    <version>1.1.2</version>
+    <version>1.1.3</version>
     <packaging>jar</packaging>
     <name>fw-commons</name>
     <description>a commons java tool lib with spring boot framework</description>
@@ -151,10 +151,10 @@
         </dependency>
 
         <!-- redis -->
-        <!--        <dependency>-->
-        <!--            <groupId>org.springframework.boot</groupId>-->
-        <!--            <artifactId>spring-boot-starter-data-redis</artifactId>-->
-        <!--        </dependency>-->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-redis</artifactId>
+        </dependency>
 
         <dependency>
             <groupId>org.springframework.data</groupId>
@@ -276,23 +276,26 @@
         </dependency>
 
         <!-- r2dbc depenedcies-->
-<!--        <dependency>-->
-<!--            <groupId>org.postgresql</groupId>-->
-<!--            <artifactId>r2dbc-postgresql</artifactId>-->
-<!--            <version>1.0.5.RELEASE</version>-->
-<!--            <scope>runtime</scope>-->
-<!--        </dependency>-->
-<!--        <dependency>-->
-<!--            <groupId>org.postgresql</groupId>-->
-<!--            <artifactId>postgresql</artifactId>-->
-<!--            <version>42.7.3</version>-->
-<!--            <scope>runtime</scope>-->
-<!--        </dependency>-->
-
-<!--        <dependency>-->
-<!--            <groupId>io.r2dbc</groupId>-->
-<!--            <artifactId>r2dbc-pool</artifactId>-->
-<!--        </dependency>-->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-r2dbc</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.r2dbc</groupId>
+            <artifactId>r2dbc-pool</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.postgresql</groupId>
+            <artifactId>r2dbc-postgresql</artifactId>
+            <version>1.0.5.RELEASE</version>
+            <scope>runtime</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.postgresql</groupId>
+            <artifactId>postgresql</artifactId>
+            <version>42.7.3</version>
+            <scope>runtime</scope>
+        </dependency>
 
         <!--Bouncy Castle-->
         <dependency>
@@ -376,11 +379,6 @@
             <version>${mapstruct.processor.version}</version>
             <scope>provided</scope>
         </dependency>
-        <!-- r2dbc depenedcies-->
-<!--        <dependency>-->
-<!--            <groupId>org.springframework.boot</groupId>-->
-<!--            <artifactId>spring-boot-starter-data-r2dbc</artifactId>-->
-<!--        </dependency>-->
 
         <dependency>
             <groupId>org.springframework.boot</groupId>
@@ -507,9 +505,9 @@
                         </indent>
                         <removeUnusedImports/>
                         <palantirJavaFormat/>
-<!--                        <licenseHeader>-->
-<!--                            <file>${basedir}/license.txt</file>-->
-<!--                        </licenseHeader>-->
+                        <!--                        <licenseHeader>-->
+                        <!--                            <file>${basedir}/license.txt</file>-->
+                        <!--                        </licenseHeader>-->
                     </java>
                 </configuration>
                 <executions>

src/main/java/io/hoangtien2k3/commons/annotations/LocalCache.java

@@ -19,55 +19,14 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
-/**
- * Annotation for specifying caching behavior on methods.
- *
- * <p>
- * This annotation allows methods to utilize caching by specifying cache
- * parameters. The caching behavior is controlled by the
- * {@code durationInMinute}, {@code maxRecord}, and {@code autoCache}
- * attributes.
- * </p>
- *
- * <ul>
- * <li><b>durationInMinute:</b> Specifies the duration (in minutes) for which
- * the cache entries should be retained. The default value is 120 minutes.</li>
- * <li><b>maxRecord:</b> Defines the maximum number of cache records to store.
- * The default value is 1000 records.</li>
- * <li><b>autoCache:</b> Indicates whether caching should be automatically
- * applied. If {@code true}, caching is enabled without additional
- * configuration. The default value is {@code false}.</li>
- * </ul>
- *
- * <p>
- * This annotation should be applied to methods where caching is desired. The
- * cache implementation will use the specified parameters to manage caching
- * behavior, including cache expiration and size limits.
- * </p>
- */
+/** @deprecated */
+@Deprecated
 @Target(ElementType.METHOD)
 @Retention(RetentionPolicy.RUNTIME)
 public @interface LocalCache {
-
-    /**
-     * The duration (in minutes) for which cache entries should be retained.
-     *
-     * @return the cache duration in minutes
-     */
     int durationInMinute() default 120;
 
-    /**
-     * The maximum number of cache records to store.
-     *
-     * @return the maximum number of cache records
-     */
     int maxRecord() default 1000;
 
-    /**
-     * Whether caching should be automatically applied.
-     *
-     * @return {@code true} if caching should be automatically applied;
-     *         {@code false} otherwise
-     */
     boolean autoCache() default false;
 }

src/main/java/io/hoangtien2k3/commons/annotations/LogPerformance.java

@@ -59,68 +59,13 @@
 @Target({ElementType.METHOD, ElementType.TYPE})
 @Retention(RetentionPolicy.RUNTIME)
 public @interface LogPerformance {
-
-    /**
-     * Specifies the type of log entry, such as "API_CALL", "DB_QUERY", etc.
-     * <p>
-     * This value helps categorize logs based on the type of operation being logged.
-     * For instance, you might use different log types for API calls versus database
-     * queries to differentiate them in your log analysis.
-     * </p>
-     *
-     * @return the type of log entry
-     */
     String logType() default "";
 
-    /**
-     * Specifies the type of action being performed, such as "CREATE", "UPDATE",
-     * "DELETE", etc.
-     * <p>
-     * This value can be used to identify what kind of action is being logged,
-     * providing more context for the log entry. For example, you might have actions
-     * like "FETCH_DATA", "SAVE_ENTITY", etc.
-     * </p>
-     *
-     * @return the type of action being logged
-     */
     String actionType() default "";
 
-    /**
-     * Indicates whether the output (result) of the method should be logged.
-     * <p>
-     * When set to {@code true}, the output of the method will be logged, provided
-     * it can be serialized. This is useful for tracing the results of method
-     * executions, especially when debugging or monitoring system behavior.
-     * </p>
-     *
-     * @return {@code true} if the output should be logged, {@code false} otherwise
-     */
     boolean logOutput() default true;
 
-    /**
-     * Indicates whether the input arguments of the method should be logged.
-     * <p>
-     * When set to {@code true}, the input arguments to the method will be logged.
-     * This is useful for capturing the state of the inputs when the method was
-     * called, which can be important for understanding the context of the log
-     * entry.
-     * </p>
-     *
-     * @return {@code true} if the input arguments should be logged, {@code false}
-     *         otherwise
-     */
     boolean logInput() default true;
 
-    /**
-     * Specifies a custom title for the log entry.
-     * <p>
-     * This title can be used to provide a brief description of the logged
-     * operation, making it easier to identify and search for specific log entries
-     * in your logging system. For example, the title might be something like "User
-     * Login Attempt" or "Order Processing".
-     * </p>
-     *
-     * @return the custom title for the log entry
-     */
     String title() default "";
 }

src/main/java/io/hoangtien2k3/commons/annotations/cache/CacheAspect.java

@@ -51,6 +51,8 @@
  * @see CacheMono
  * @see Signal
  */
+/** @deprecated */
+@Deprecated
 @Aspect
 @Configuration
 @Slf4j

src/main/java/io/hoangtien2k3/commons/annotations/cache/CacheStore.java

@@ -60,6 +60,8 @@
  * @see Caffeine
  * @see Reflections
  */
+/** @deprecated */
+@Deprecated
 @Slf4j
 @Component
 public class CacheStore {

src/main/java/io/hoangtien2k3/commons/annotations/cache/CacheUtils.java

@@ -28,6 +28,8 @@
  * methods dynamically and handling exceptions.
  * </p>
  */
+/** @deprecated */
+@Deprecated
 @Slf4j
 @Component
 @RequiredArgsConstructor

src/main/java/io/hoangtien2k3/commons/annotations/cache/CustomizeRemovalListener.java

@@ -53,6 +53,8 @@
  *
  * @author Your Name
  */
+/** @deprecated */
+@Deprecated
 @Slf4j
 @AllArgsConstructor
 public class CustomizeRemovalListener implements RemovalListener {

src/main/java/io/hoangtien2k3/commons/aop/LogPerf.java

@@ -0,0 +1,10 @@
+package io.hoangtien2k3.commons.aop;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Retention(RetentionPolicy.RUNTIME)
+@Target(value = {ElementType.METHOD})
+public @interface LogPerf {}

src/main/java/io/hoangtien2k3/commons/aop/cache/Cache2L.java

@@ -0,0 +1,18 @@
+package io.hoangtien2k3.commons.aop.cache;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface Cache2L {
+    int durationInMinute() default 120;
+
+    int maxRecord() default 1000;
+
+    boolean autoCache() default false;
+
+    boolean useGlobalCache() default false;
+}