Feature2.4.8 (#278)

* init 2.4.8

* added ServiceContext.report() and ServiceContext.report(StringBuilder)

BootCache.debounced() supports TimeUnit

* fix typo

* release2.4.8

Author: SummerBootFramework

pom.xml

@@ -4,7 +4,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.summerboot</groupId>
     <artifactId>jexpress</artifactId>
-    <version>2.4.7</version>
+    <version>2.4.8</version>
     <packaging>jar</packaging>
     <name>Summer Boot jExpress</name>
     <description>Summer Boot jExpress focuses on solving non-functional and operational maintainability requirements,
@@ -196,12 +196,12 @@
         <jwt.version>0.11.5</jwt.version>
 
         <!-- NIO Netty -->
-        <netty.version>4.1.110.Final</netty.version>
+        <netty.version>4.1.111.Final</netty.version>
         <netty-tcnative.version>2.0.65.Final</netty-tcnative.version>
         <!-- gRPC and protobuf -->
         <grpc.version>1.64.0</grpc.version>
-        <guava.version>33.2.0-jre</guava.version>
-        <protobuf.version>4.27.0</protobuf.version>
+        <guava.version>33.2.1-jre</guava.version>
+        <protobuf.version>4.27.1</protobuf.version>
         <!-- Web JAX-RS -->
         <swagger.core.version>2.2.22</swagger.core.version>
         <!--<elastic-apm.version>1.36.0</elastic-apm.version>-->
@@ -234,7 +234,7 @@
         <mqtt.version>1.2.5</mqtt.version>
 
         <!-- Template Engine -->
-        <freemarker.version>2.3.32</freemarker.version>
+        <freemarker.version>2.3.33</freemarker.version>
         <!-- Barcode -->
         <zxing.version>3.5.3</zxing.version>
         <!-- PDF - PDFBox 

src/main/java/org/summerboot/jexpress/boot/BootConstant.java

@@ -25,7 +25,7 @@ public interface BootConstant {
     String APP_ID = String.format("%06d", new Random().nextInt(999999));
 
     //version
-    String VERSION = "SummerBoot.jExpress 2.4.7";
+    String VERSION = "SummerBoot.jExpress 2.4.8";
     String JEXPRESS_PACKAGE_NAME = "org.summerboot.jexpress";
 
     String DEFAULT_ADMIN_MM = "changeit";

src/main/java/org/summerboot/jexpress/boot/event/HttpLifecycleHandler.java

@@ -42,7 +42,7 @@ public void afterSendPingResponse(ChannelHandlerContext ctx, String uri, long hi
     }
 
     @Override
-    public boolean beofreProcess(RequestProcessor processor, HttpHeaders httpRequestHeaders, String httpRequestPath, ServiceContext context) throws Exception {
+    public boolean beforeProcess(RequestProcessor processor, HttpHeaders httpRequestHeaders, String httpRequestPath, ServiceContext context) throws Exception {
         return true;
     }
 

src/main/java/org/summerboot/jexpress/boot/event/HttpLifecycleListener.java

@@ -44,7 +44,7 @@ public interface HttpLifecycleListener {
      * @return true if good to process request, otherwise false
      * @throws Exception
      */
-    boolean beofreProcess(RequestProcessor processor, HttpHeaders httpRequestHeaders, String httpRequestPath, ServiceContext context) throws Exception;
+    boolean beforeProcess(RequestProcessor processor, HttpHeaders httpRequestHeaders, String httpRequestPath, ServiceContext context) throws Exception;
 
     /**
      * step1 - after process is done, before sending response to client

src/main/java/org/summerboot/jexpress/integration/cache/BootCache.java

@@ -19,6 +19,7 @@
 import org.summerboot.jexpress.integration.cache.domain.FlashSale;
 
 import java.util.UUID;
+import java.util.concurrent.TimeUnit;
 
 /**
  * @author Changski Tie Zheng Zhang 张铁铮, 魏泽北, 杜旺财, 杜富贵
@@ -57,12 +58,23 @@ default String generateUnlockPassword() {
      * @param key
      * @param unlockPassword
      * @param ttlMinute
-     * @return true when debounced
+     * @return true is debounced (failed to acquire lock), false is not debounced (acquired lock successfully
      */
-    default boolean debounced(String key, String unlockPassword, int ttlMinute) {
+    default boolean debounced(String key, String unlockPassword, long ttlMinute) {
         return !tryLock(key, unlockPassword, ttlMinute * 60000);
     }
 
+    /**
+     * @param key
+     * @param unlockPassword
+     * @param ttl
+     * @param timeUnit
+     * @return true is debounced (failed to acquire lock), false is not debounced (acquired lock successfully
+     */
+    default boolean debounced(String key, String unlockPassword, long ttl, TimeUnit timeUnit) {
+        return !tryLock(key, unlockPassword, timeUnit.toMillis(ttl));
+    }
+
     /**
      * flash sale - enable
      *

src/main/java/org/summerboot/jexpress/integration/httpclient/RPCError.java

@@ -33,12 +33,12 @@ public boolean isSingleError() {
     }
 
     @Override
-    public Err toSerivceError(HttpResponseStatus status) {
+    public Err toServiceError(HttpResponseStatus status) {
         return new Err(BootErrorCode.ACCESS_ERROR_RPC, null, null, null, "Default RPC error");
     }
 
     @Override
-    public List<Err> toSerivceErrors(HttpResponseStatus status) {
+    public List<Err> toServiceErrors(HttpResponseStatus status) {
         return null;
     }
 

src/main/java/org/summerboot/jexpress/integration/httpclient/RPCResult.java

@@ -145,10 +145,10 @@ public RPCResult<T, E> update(ObjectMapper jacksonMapper, JavaType successRespon
             errorResponse = fromJson(jacksonMapper, null, errorResponseClass, context);
             if (errorResponse != null & context != null) {
                 if (errorResponse.isSingleError()) {
-                    Err e = errorResponse.toSerivceError(httpStatus);
+                    Err e = errorResponse.toServiceError(httpStatus);
                     context.error(e);
                 } else {
-                    List<Err> errors = errorResponse.toSerivceErrors(httpStatus);
+                    List<Err> errors = errorResponse.toServiceErrors(httpStatus);
                     context.errors(errors);
                 }
             }

src/main/java/org/summerboot/jexpress/nio/server/BootHttpRequestHandler.java

@@ -105,7 +105,7 @@ protected ProcessorSettings service(final ChannelHandlerContext ctx, final HttpH
             if (authenticator != null && !authenticator.customizedAuthorizationCheck(processor, httpRequestHeaders, httpRequestPath, context)) {
                 return processorSettings;
             }
-            if (!httpLifecycleListener.beofreProcess(processor, httpRequestHeaders, httpRequestPath, context)) {
+            if (!httpLifecycleListener.beforeProcess(processor, httpRequestHeaders, httpRequestPath, context)) {
                 return processorSettings;
             }
             processor.process(ctx, httpRequestHeaders, httpRequestPath, queryParams, httpPostRequestBody, context);

src/main/java/org/summerboot/jexpress/nio/server/domain/ServiceContext.java

@@ -886,6 +886,21 @@ public Memo(String id, String desc) {
 
     }
 
+    public StringBuilder report() {
+        StringBuilder sb = new StringBuilder();
+        reportPOI(sb);
+        reportMemo(sb);
+        reportError(sb);
+        return sb;
+    }
+
+    public ServiceContext report(StringBuilder sb) {
+        reportPOI(sb);
+        reportMemo(sb);
+        reportError(sb);
+        return this;
+    }
+
     public ServiceContext reportError(StringBuilder sb) {
         if (serviceError == null /*|| file == null*/) {// log error only for file request
             return this;

src/main/java/org/summerboot/jexpress/nio/server/domain/ServiceErrorConvertible.java

@@ -26,7 +26,7 @@ public interface ServiceErrorConvertible {
 
     boolean isSingleError();
 
-    Err toSerivceError(HttpResponseStatus status);
+    Err toServiceError(HttpResponseStatus status);
 
-    List<Err> toSerivceErrors(HttpResponseStatus status);
+    List<Err> toServiceErrors(HttpResponseStatus status);
 }