Removed HttpHandler to new library and added structured logging implementation (#121)

The HttpHandler are now at https://github.com/cuioss/cui-http

Author: cuioss-oliver

doc/LogMessages.adoc

@@ -0,0 +1,54 @@
+= Log Messages for cui-java-tools
+:toc: left
+:toclevels: 2
+
+== Overview
+
+All messages follow the format: [Module-Prefix]-[identifier]: [message]
+
+Module Prefix: `CUI_TOOLS`
+
+This document catalogs all structured log messages used in the cui-java-tools module. Each message has a unique identifier within its severity level range and is documented with its component, template, and usage description.
+
+== INFO Level (001-099)
+
+[cols="1,1,2,2", options="header"]
+|===
+|ID |Component |Message |Description
+|CUI_TOOLS-1 |IO |Unable to resolve '%s' from classpath |Logged when a resource cannot be resolved from the classpath. Parameter: resource path
+|===
+
+== WARN Level (100-199)
+
+[cols="1,1,2,2", options="header"]
+|===
+|ID |Component |Message |Description
+|CUI_TOOLS-100 |IO |Unable to resolve real path for '%s', due to '%s'. Returning absolutePath. |Logged when real path resolution fails and the system falls back to absolute path. Parameters: path, error message
+|CUI_TOOLS-101 |IO |File or Directory %s is not accessible, reason: %s |Logged when a file or directory accessibility check fails. Parameters: path, reason (e.g., "Not Writable", "Not Existing", "Not a directory")
+|CUI_TOOLS-102 |REFLECT |Reading from field '%s' with accessible='%s' and parameter='%s' could not complete |Logged when reflection-based field reading fails. Parameters: field, accessible flag, source object
+|CUI_TOOLS-103 |REFLECT |Unable to determine wrapper type for '%s' |Logged when wrapper type determination fails for a primitive type. Parameter: type name
+|CUI_TOOLS-104 |REFLECT |Unable to determine generic-type for '%s' |Logged when generic type extraction fails for a given type. Parameter: type
+|===
+
+== ERROR Level (200-299)
+
+[cols="1,1,2,2", options="header"]
+|===
+|ID |Component |Message |Description
+|CUI_TOOLS-200 |IO |Unable to compare path_a='%s' and path_b='%s' |Logged when path comparison via Files.isSameFile() fails due to IOException. Parameters: first path, second path
+|CUI_TOOLS-201 |IO |Retrieving the current dir failed |Logged when retrieving the current directory fails during external file path resolution
+|CUI_TOOLS-202 |PROPERTY |Failed to read property '%s' from bean of type '%s' |Logged when property reading via reflection fails. Parameters: property name, bean type
+|CUI_TOOLS-203 |PROPERTY |Failed to write property '%s' to bean of type '%s' |Logged when property writing via reflection fails. Parameters: property name, bean type
+|===
+
+== Component Mapping
+
+* *IO*: `de.cuioss.tools.io.*` - File I/O, path operations, and classpath loading
+* *REFLECT*: `de.cuioss.tools.reflect.*` - Reflection utilities and field/type operations
+* *PROPERTY*: `de.cuioss.tools.property.*` - Bean property access and manipulation
+
+== Notes
+
+* DEBUG and TRACE level messages are not documented here as they use direct logging without LogRecords
+* All messages use '%s' for parameter placeholders
+* Exception parameters always come first in the logging method call, followed by the formatted message

doc/ai-rules.md

@@ -32,15 +32,6 @@ When conflicting information exists, AI systems must follow this priority order:
 
 These rules govern ALL development activities:
 
-### 🚨 PRE-1.0 PROJECT RULE (HIGHEST PRIORITY)
-**This project is PRE-1.0 and therefore:**
-- **NEVER deprecate code** - Remove it directly if not needed
-- **NEVER add transitional comments** like "TODO: Remove in v2.0"
-- **NEVER enforce backward compatibility** - Make breaking changes freely
-- **NEVER add @Deprecated annotations** - Delete unnecessary code immediately
-- **Clean APIs aggressively** - Remove unused methods, classes, and patterns
-- **Focus on final API design** - Design for post-1.0 stability, not pre-1.0 transitions
-
 ### General Process Rules
 1. **If in doubt, ask the user** - Never make assumptions
 2. **Always research topics** - Use available tools (WebSearch, WebFetch, etc.) to find the most recent best practices
@@ -78,26 +69,18 @@ Before any code implementation:
 ### Pre-Commit Checklist
 Execute in sequence before ANY commit:
 
-1. **Quality Verification**: `./mvnw -Ppre-commit clean verify -DskipTests`
+1. **Quality Verification**: `./mvnw -Ppre-commit clean verify`
     - Fix ALL errors and warnings (mandatory)
+    - Some recipes may add markers: Either fix them, or suppress them with proper justification. Never commit the markers.
     - Address code quality, formatting, and linting issues
 
-2. **Final Verification**: `./mvnw clean install`
-    - Must complete without errors or warnings
-    - All tests must pass
-    - Tasks are complete ONLY after this succeeds
-
-3. **Run Integration Tests**: `./mvnw clean verify -Pintegration-tests -pl cui-jwt-quarkus-parent/cui-jwt-quarkus-integration-tests`
-    - Ensure all integration tests pass
-    - Verify against the latest standards
-
-4. **Documentation**: Ensure all changes are documented
+2. **Documentation**: Ensure all changes are documented
     - Update Javadoc for public APIs
     - Update AsciiDoc documentation if necessary
 
-5. **Documentation**: Update if changes affect APIs, features, or configuration
+3. **Documentation**: Update if changes affect APIs, features, or configuration
 
-6. **Commit Message**: Follow Git Commit Standards
+4. **Commit Message**: Follow Git Commit Standards
 
 ### Quality Requirements
 - New code requires appropriate test coverage
@@ -108,10 +91,9 @@ Execute in sequence before ANY commit:
 ## Build Commands Template
 Common Maven commands for CUI projects:
 - Build project: `./mvnw clean install`
-- Build Single Module: `./mvnw clean install -pl <module-name>`
 - Run tests: `./mvnw test`
 - Run single test: `./mvnw test -Dtest=ClassName#methodName`
-- Clean-Up Code: `./mvnw -Ppre-commit clean install -DskipTests` -> Check the console after running the command and fix all errors and warnings, verify until they are all corrected
+- Clean-Up Code: `./mvnw -Ppre-commit clean install` -> Check the console after running the command and fix all errors and warnings, verify until they are all corrected
 
 ## Standards Overview
 **Base Reference**: `{STANDARDS_BASE_URL}/standards`
@@ -154,11 +136,19 @@ Common Maven commands for CUI projects:
 - Avoid premature optimization
 - See Lombok Usage section for annotation patterns
 
+### JSpecify Null-Handling
+**Reference**: `{STANDARDS_BASE_URL}/standards/java/java-code-standards.adoc#null-safety-and-api-design`
+- Use `@Nullable` for fields, parameters, and returns that may be null
+- Use `@NonNull` for explicit non-null guarantees
+- Default assumption is non-null unless marked `@Nullable`
+- Apply `@NullMarked` at package level for consistent null-safety
+- Validate null constraints at API boundaries
+- Prefer Optional over nullable return types where appropriate
+
 ### Lombok Usage
 **Reference**: `{STANDARDS_BASE_URL}/standards/java/java-code-standards.adoc`
 - Use `@Builder` for complex object creation
 - Use `@Value` for immutable objects
-- Use `@NonNull` for required parameters
 - Use `@ToString` and `@EqualsAndHashCode` for value objects
 - Use `@UtilityClass` for utility classes
 - Make proper use of `lombok.config` settings
@@ -236,44 +226,6 @@ Common Maven commands for CUI projects:
 - Use `{@link}` for references to classes, methods, and fields
 - Document Builder classes with complete usage examples
 
-## CDI and Quarkus Standards
-**References**: 
-- CDI Development Patterns: `{STANDARDS_BASE_URL}/standards/cdi-quarkus`
-- Quarkus Testing Standards: `{STANDARDS_BASE_URL}/standards/cdi-quarkus/testing-standards.adoc`
-- Container Standards: `{STANDARDS_BASE_URL}/standards/cdi-quarkus/container-standards.adoc`
-- Use constructor injection (mandatory over field injection)
-- Single constructor rule: No `@Inject` needed for single constructors
-- Use `final` fields for injected dependencies
-- Use `@ApplicationScoped` for stateless services
-- Use `@QuarkusTest` for CDI context testing
-- Use `@QuarkusIntegrationTest` for packaged app testing
-- Container: Use Quarkus distroless base image (91.9MB)
-- HTTPS required for all integration tests
-- OWASP Docker Top 10 compliance mandatory
-
-## CSS Standards
-**Reference**: `{STANDARDS_BASE_URL}/standards/css`
-- Use CSS custom properties (variables) for theming
-- Follow BEM methodology for class naming
-- Use Stylelint for code quality enforcement
-- Use Prettier for consistent formatting
-- Mobile-first responsive design approach
-- Semantic HTML with accessible CSS patterns
-- Performance optimization: minimize CSS bundle size
-- Support for modern browsers (last 2 versions)
-
-## JavaScript Standards
-**Reference**: `{STANDARDS_BASE_URL}/standards/javascript`
-- Use ES6+ modern JavaScript features
-- Use ESLint with strict configuration
-- Use Prettier for code formatting
-- Use Jest for unit testing framework
-- Follow functional programming patterns when appropriate
-- Use JSDoc for comprehensive documentation
-- Use Lit components for web components (Quarkus DevUI context)
-- Maven integration via frontend-maven-plugin
-- Cypress for E2E testing
-
 ### General Documentation Standards
 - Use AsciiDoc format with `.adoc` extension
 - Include proper document header with TOC and section numbering

pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>de.cuioss</groupId>
         <artifactId>cui-java-parent</artifactId>
-        <version>1.1.4</version>
+        <version>1.2.1</version>
         <relativePath />
     </parent>
 
@@ -86,5 +86,22 @@
             <artifactId>jakarta.annotation-api</artifactId>
             <scope>provided</scope>
         </dependency>
+        <dependency>
+            <groupId>org.jspecify</groupId>
+            <artifactId>jspecify</artifactId>
+        </dependency>
     </dependencies>
+
+    <build>
+        <plugins>
+            <!-- Configure Surefire to run tests on classpath to bypass JPMS module restrictions -->
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <configuration>
+                    <useModulePath>false</useModulePath>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
 </project>

src/main/java/de/cuioss/tools/ToolsLogMessages.java

@@ -0,0 +1,183 @@
+/*
+ * Copyright © 2025 CUI-OpenSource-Software (info@cuioss.de)
+ *
+ * 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.
+ */
+package de.cuioss.tools;
+
+import de.cuioss.tools.logging.LogRecord;
+import de.cuioss.tools.logging.LogRecordModel;
+import lombok.experimental.UtilityClass;
+
+/**
+ * Centralized log messages for the cui-java-tools module.
+ * Follows the DSL-Style Constants Pattern for organizing log messages by severity level.
+ *
+ * <h2>Message Identifier Ranges</h2>
+ * <ul>
+ *   <li>001-099: INFO level</li>
+ *   <li>100-199: WARN level</li>
+ *   <li>200-299: ERROR level</li>
+ *   <li>300-399: FATAL level</li>
+ * </ul>
+ *
+ * <h2>Usage Examples</h2>
+ * <pre>
+ * import static de.cuioss.tools.ToolsLogMessages.INFO;
+ * import static de.cuioss.tools.ToolsLogMessages.WARN;
+ * import static de.cuioss.tools.ToolsLogMessages.ERROR;
+ *
+ * // INFO level
+ * LOGGER.info(INFO.CLASSPATH_RESOLUTION_FAILED.format(path));
+ *
+ * // WARN level with exception
+ * LOGGER.warn(e, WARN.REAL_PATH_RESOLUTION_FAILED.format(path, e.getMessage()));
+ *
+ * // ERROR level
+ * LOGGER.error(e, ERROR.PATH_COMPARISON_FAILED.format(path1, path2));
+ * </pre>
+ *
+ * @author Oliver Wolff
+ * @see de.cuioss.tools.logging.LogRecord
+ * @see de.cuioss.tools.logging.LogRecordModel
+ */
+@UtilityClass
+public final class ToolsLogMessages {
+
+    /** Module prefix for all log messages */
+    public static final String PREFIX = "CUI_TOOLS";
+
+    /**
+     * INFO level log messages (001-099).
+     * Used for informational messages that highlight the progress of the application.
+     */
+    @UtilityClass
+    public static final class INFO {
+
+        /**
+         * Logged when a resource cannot be resolved from the classpath.
+         * Parameters: path
+         */
+        public static final LogRecord CLASSPATH_RESOLUTION_FAILED = LogRecordModel.builder()
+                .template("Unable to resolve '%s' from classpath")
+                .prefix(PREFIX)
+                .identifier(1)
+                .build();
+    }
+
+    /**
+     * WARN level log messages (100-199).
+     * Used for potentially harmful situations that warrant attention.
+     */
+    @UtilityClass
+    public static final class WARN {
+
+        /**
+         * Logged when real path resolution fails and falls back to absolute path.
+         * Parameters: path, error message
+         */
+        public static final LogRecord REAL_PATH_RESOLUTION_FAILED = LogRecordModel.builder()
+                .template("Unable to resolve real path for '%s', due to '%s'. Returning absolutePath.")
+                .prefix(PREFIX)
+                .identifier(100)
+                .build();
+
+        /**
+         * Logged when a file or directory is not accessible.
+         * Parameters: path, reason
+         */
+        public static final LogRecord PATH_NOT_ACCESSIBLE = LogRecordModel.builder()
+                .template("File or Directory %s is not accessible, reason: %s")
+                .prefix(PREFIX)
+                .identifier(101)
+                .build();
+
+        /**
+         * Logged when field reading via reflection fails.
+         * Parameters: field, accessible flag, source object
+         */
+        public static final LogRecord FIELD_READ_FAILED = LogRecordModel.builder()
+                .template("Reading from field '%s' with accessible='%s' and parameter='%s' could not complete")
+                .prefix(PREFIX)
+                .identifier(102)
+                .build();
+
+        /**
+         * Logged when wrapper type determination fails.
+         * Parameters: type name
+         */
+        public static final LogRecord WRAPPER_TYPE_DETERMINATION_FAILED = LogRecordModel.builder()
+                .template("Unable to determine wrapper type for '%s'")
+                .prefix(PREFIX)
+                .identifier(103)
+                .build();
+
+        /**
+         * Logged when generic type extraction fails.
+         * Parameters: type
+         */
+        public static final LogRecord GENERIC_TYPE_DETERMINATION_FAILED = LogRecordModel.builder()
+                .template("Unable to determine generic-type for '%s'")
+                .prefix(PREFIX)
+                .identifier(104)
+                .build();
+    }
+
+    /**
+     * ERROR level log messages (200-299).
+     * Used for error events that might still allow the application to continue running.
+     */
+    @UtilityClass
+    public static final class ERROR {
+
+        /**
+         * Logged when path comparison fails.
+         * Parameters: path1, path2
+         */
+        public static final LogRecord PATH_COMPARISON_FAILED = LogRecordModel.builder()
+                .template("Unable to compare path_a='%s' and path_b='%s'")
+                .prefix(PREFIX)
+                .identifier(200)
+                .build();
+
+        /**
+         * Logged when retrieving the current directory fails.
+         * Parameters: none
+         */
+        public static final LogRecord CURRENT_DIR_RETRIEVAL_FAILED = LogRecordModel.builder()
+                .template("Retrieving the current dir failed")
+                .prefix(PREFIX)
+                .identifier(201)
+                .build();
+
+        /**
+         * Logged when property reading fails.
+         * Parameters: property name, bean type
+         */
+        public static final LogRecord PROPERTY_READ_FAILED = LogRecordModel.builder()
+                .template("Failed to read property '%s' from bean of type '%s'")
+                .prefix(PREFIX)
+                .identifier(202)
+                .build();
+
+        /**
+         * Logged when property writing fails.
+         * Parameters: property name, bean type
+         */
+        public static final LogRecord PROPERTY_WRITE_FAILED = LogRecordModel.builder()
+                .template("Failed to write property '%s' to bean of type '%s'")
+                .prefix(PREFIX)
+                .identifier(203)
+                .build();
+    }
+}