mark @nullable

Signed-off-by: neo <1100909+neowu@users.noreply.github.com>

Author: neowu

core-ng/src/main/java/core/framework/internal/web/HTTPErrorHandler.java

@@ -19,6 +19,7 @@
 import io.undertow.server.HttpServerExchange;
 import io.undertow.util.HeaderMap;
 import io.undertow.util.Headers;
+import org.jspecify.annotations.Nullable;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -30,6 +31,7 @@
 public class HTTPErrorHandler {
     private final Logger logger = LoggerFactory.getLogger(HTTPErrorHandler.class);
     private final ResponseHandler responseHandler;
+    @Nullable
     public ErrorHandler customErrorHandler;
 
     HTTPErrorHandler(ResponseHandler responseHandler) {

core-ng/src/main/java/core/framework/internal/web/HTTPHandler.java

@@ -20,6 +20,7 @@
 import io.undertow.util.HeaderMap;
 import io.undertow.util.Headers;
 import io.undertow.util.HttpString;
+import org.jspecify.annotations.Nullable;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -144,7 +145,7 @@ void linkContext(ActionLog actionLog, HeaderMap headers) {
         actionLog.warningContext.maxProcessTimeInNano(maxProcessTime(headers.getFirst(HEADER_TIMEOUT)));
     }
 
-    long maxProcessTime(String timeout) {
+    long maxProcessTime(@Nullable String timeout) {
         if (timeout != null) {
             try {
                 return Long.parseLong(timeout);

core-ng/src/main/java/core/framework/internal/web/HTTPIOHandler.java

@@ -11,6 +11,7 @@
 import io.undertow.util.HeaderMap;
 import io.undertow.util.HttpString;
 import io.undertow.util.Methods;
+import org.jspecify.annotations.Nullable;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.xnio.channels.StreamSourceChannel;
@@ -25,13 +26,14 @@ public class HTTPIOHandler implements HttpHandler {
     private final Logger logger = LoggerFactory.getLogger(HTTPIOHandler.class);
 
     private final HTTPHandler httpHandler;
+    @Nullable
     private final ServerSentEventHandler sseHandler;
     private final ShutdownHandler shutdownHandler;
 
     private final FormParserFactory formParserFactory;
     private final long maxEntitySize;
 
-    HTTPIOHandler(HTTPHandler httpHandler, ShutdownHandler shutdownHandler, long maxEntitySize, ServerSentEventHandler sseHandler) {
+    HTTPIOHandler(HTTPHandler httpHandler, ShutdownHandler shutdownHandler, long maxEntitySize, @Nullable ServerSentEventHandler sseHandler) {
         this.httpHandler = httpHandler;
         this.shutdownHandler = shutdownHandler;
         formParserFactory = createFormParserFactory();

core-ng/src/main/java/core/framework/internal/web/HTTPServer.java

@@ -12,6 +12,7 @@
 import io.undertow.server.handlers.encoding.ContentEncodingRepository;
 import io.undertow.server.handlers.encoding.EncodingHandler;
 import io.undertow.server.handlers.encoding.GzipEncodingProvider;
+import org.jspecify.annotations.Nullable;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.xnio.Options;
@@ -40,7 +41,9 @@ public class HTTPServer {
     private final Logger logger = LoggerFactory.getLogger(HTTPServer.class);
     private final ExecutorService worker = ThreadPools.virtualThreadExecutor("http-handler-");
 
+    @Nullable
     public ServerSentEventHandler sseHandler;
+    @Nullable
     private Undertow server;
 
     public HTTPServer(LogManager logManager) {

core-ng/src/main/java/core/framework/internal/web/HTTPServerConfig.java

@@ -2,6 +2,7 @@
 
 import core.framework.util.Lists;
 import core.framework.web.Interceptor;
+import org.jspecify.annotations.Nullable;
 
 import java.util.List;
 
@@ -10,11 +11,14 @@
  */
 public class HTTPServerConfig {
     public final List<Interceptor> interceptors = Lists.newArrayList();
+    @Nullable
     public HTTPHost httpHost;
+    @Nullable
     public HTTPHost httpsHost;
     public boolean gzip;
     public long maxEntitySize = 10_000_000;    // limit max post body to 10M, apply to multipart as well
 
+    @Nullable
     public HTTPHost httpsHost() {
         if (httpHost == null && httpsHost == null) return new HTTPHost("0.0.0.0", 8443);    // by default start https only
         return httpsHost;

core-ng/src/main/java/core/framework/internal/web/package-info.java

@@ -0,0 +1,4 @@
+@NullMarked
+package core.framework.internal.web;
+
+import org.jspecify.annotations.NullMarked;

core-ng/src/main/java/core/framework/internal/web/route/Path.java

@@ -1,5 +1,7 @@
 package core.framework.internal.web.route;
 
+import org.jspecify.annotations.Nullable;
+
 /**
  * @author neo
  */
@@ -28,6 +30,7 @@ public static Path parse(String path) {
     }
 
     public final String value;
+    @Nullable
     public Path next;
 
     private Path(String value) {

core-ng/src/main/java/core/framework/internal/web/route/PathNode.java

@@ -2,6 +2,7 @@
 
 import core.framework.internal.web.request.PathParams;
 import core.framework.util.Strings;
+import org.jspecify.annotations.Nullable;
 
 import java.util.HashMap;
 import java.util.Map;
@@ -12,21 +13,26 @@
  * @author neo
  */
 class PathNode {
+    @Nullable
     private final String param;
+    @Nullable
     private URLHandler handler;
+    @Nullable
     private Map<String, PathNode> staticNodes;
+    @Nullable
     private PathNode dynamicNode;
+    @Nullable
     private PathNode wildcardNode;
 
-    PathNode(String param) {
+    PathNode(@Nullable String param) {
         this.param = param;
     }
 
     URLHandler register(String pathPattern) {
         return register(pathPattern, Path.parse(pathPattern).next);
     }
 
-    private URLHandler register(String pathPattern, Path currentPath) {
+    private URLHandler register(String pathPattern, @Nullable Path currentPath) {
         if (currentPath == null) {
             if (handler == null) handler = new URLHandler(pathPattern);
             return handler;
@@ -68,10 +74,12 @@ private URLHandler registerDynamicNode(String pathPattern, Path currentPath, Str
         return dynamicNode.register(pathPattern, currentPath.next);
     }
 
+    @Nullable
     URLHandler find(String path, PathParams pathParams) {
         return find(Path.parse(path), pathParams);
     }
 
+    @Nullable
     private URLHandler find(Path currentPath, PathParams pathParams) {
         Path nextPath = currentPath.next;
         if (nextPath == null) return handler;
@@ -92,6 +100,7 @@ private URLHandler find(Path currentPath, PathParams pathParams) {
         return null;
     }
 
+    @Nullable
     private URLHandler findStatic(Path nextPath, PathParams pathParams) {
         if (staticNodes != null) {
             PathNode nextNode = staticNodes.get(nextPath.value);
@@ -102,6 +111,7 @@ private URLHandler findStatic(Path nextPath, PathParams pathParams) {
         return null;
     }
 
+    @Nullable
     private URLHandler findDynamic(Path nextPath, PathParams pathParams) {
         if (dynamicNode != null) {
             URLHandler handler = dynamicNode.find(nextPath, pathParams);

core-ng/src/main/java/core/framework/internal/web/route/package-info.java

@@ -0,0 +1,4 @@
+@NullMarked
+package core.framework.internal.web.route;
+
+import org.jspecify.annotations.NullMarked;