Refactor and enhance URI handling and WSDL/XML components

- Added `normalize` method in `URIUtil` for standardizing paths and URIs.
- Synchronized `resolveToNumber` method in `WSDLPublisherInterceptor` for thread safety.
- Replaced hardcoded schema namespace with constants in `WSDLSchemaExtractor`.
- Removed redundant imports and refactored commentary in multiple classes for clarity.
- Added `XMLNS_NS` constant to `Constants`.

Author: predic8

annot/src/main/java/com/predic8/membrane/annot/Constants.java

@@ -14,8 +14,7 @@
 
 package com.predic8.membrane.annot;
 
-import com.sun.net.httpserver.*;
-
+import javax.xml.*;
 import javax.xml.namespace.*;
 import java.io.*;
 import java.util.*;
@@ -63,6 +62,8 @@ public class Constants {
 
 	public static final String HTTP_VERSION_11 = "1.1";
 
+	public static final String XMLNS_NS = "http://www.w3.org/2000/xmlns/";
+
 	public static final String WSDL11_NS = "http://schemas.xmlsoap.org/wsdl/";
 
 	public static final String WSDL_SOAP11_NS = "http://schemas.xmlsoap.org/wsdl/soap/";
@@ -89,7 +90,7 @@ public enum SoapVersion { SOAP11, SOAP12, SOAP20, UNKNOWN }
 
 
 	/**
-	 * Used for {@link Request}-to-XML and XML-to-{@link Response} conversions.
+	 * Used for Request-to-XML and XML-to-Response conversions.
 	 * See {@link REST2SOAPInterceptor}.
 	 */
 	public static final String HTTP_NS = "http://membrane-soa.org/schemas/http/v1/";

core/src/main/java/com/predic8/membrane/core/interceptor/oauth2/authorizationservice/AuthorizationService.java

@@ -27,7 +27,6 @@
 import com.predic8.membrane.core.transport.http.*;
 import com.predic8.membrane.core.transport.http.client.*;
 import com.predic8.membrane.core.transport.ssl.*;
-import com.predic8.membrane.core.util.*;
 import jakarta.mail.internet.*;
 import org.jose4j.jwt.*;
 import org.jose4j.lang.*;

core/src/main/java/com/predic8/membrane/core/interceptor/schemavalidation/WSDLSchemaExtractor.java

@@ -14,6 +14,7 @@
 
 package com.predic8.membrane.core.interceptor.schemavalidation;
 
+import com.predic8.membrane.annot.*;
 import org.w3c.dom.*;
 import org.xml.sax.*;
 
@@ -24,20 +25,19 @@
 import java.io.*;
 import java.util.*;
 
+import static com.predic8.membrane.annot.Constants.XMLNS_NS;
+import static com.predic8.membrane.annot.Constants.XSD_NS;
 import static javax.xml.XMLConstants.*;
 
 public final class WSDLSchemaExtractor {
 
-    private static final String XML_SCHEMA_NS = "http://www.w3.org/2001/XMLSchema"; // TODO
-    private static final String XMLNS_NS = XMLConstants.XMLNS_ATTRIBUTE_NS_URI;
-
     private WSDLSchemaExtractor() {
     }
 
     public static List<Document> getSchemas(Element wsdl) {
         try {
             var result = new ArrayList<Document>();
-            var schemas = wsdl.getElementsByTagNameNS(XML_SCHEMA_NS, "schema");
+            var schemas = wsdl.getElementsByTagNameNS(XSD_NS, "schema");
             for (int i = 0; i < schemas.getLength(); i++) {
                 result.add(extractSchema((Element) schemas.item(i),
                         getNamespaceDeclarations(wsdl)));
@@ -62,7 +62,6 @@ private static List<Attr> getNamespaceDeclarations(Element element) {
 
     private static Document extractSchema(Element originalSchema, List<Attr> definitionNamespaces) throws Exception {
         var fac = DocumentBuilderFactory.newInstance();
-   //     fac.setFeature(FEATURE_SECURE_PROCESSING, true);
         fac.setNamespaceAware(true);
         var builder = fac.newDocumentBuilder();
 

core/src/main/java/com/predic8/membrane/core/interceptor/server/WSDLPublisherInterceptor.java

@@ -100,15 +100,16 @@ public String rewrite(String path) {
         }
 
         private @NotNull String resolveToNumber(String path) {
-            if (pathsReverse.containsKey(path)) {
-                return pathsReverse.get(path).toString();
+            synchronized (paths) {
+                if (pathsReverse.containsKey(path)) {
+                    return pathsReverse.get(path).toString();
+                }
+                int n = paths.size() + 1;
+                paths.put(n, path);
+                pathsReverse.put(path, n);
+                documentsToProcess.add(path);
+                return Integer.toString(n);
             }
-            int n = paths.size() + 1;
-            paths.put(n, path);
-            pathsReverse.put(path, n);
-            documentsToProcess.add(path);
-            return Integer.toString(n);
-
         }
     }
 

core/src/main/java/com/predic8/membrane/core/interceptor/soap/WebServiceExplorerInterceptor.java

@@ -133,10 +133,7 @@ protected void createContent() {
 
 					for (com.predic8.membrane.core.util.wsdl.parser.PortType pt : ports.stream().map(Port::getBinding).map(Binding::getPortType).toList()) {
 						h2().text("Port Type: " + pt.getName()).end();
-//						Documentation d = pt.getDocumentation(); @TODO
-//						if (d != null) {
-//							p().text("Documentation: " + d).end();
-//						}
+						// @TODO show pt.getDocumentation() wsdl:documentation here when it is implemented
 					}
 
 					var binding = port.getBinding();

core/src/main/java/com/predic8/membrane/core/util/URIUtil.java

@@ -139,6 +139,16 @@ public static String normalizeSingleDot(String uri) {
         return sb.toString();
     }
 
+    /**
+     * Normalizes the given path or URI. This method handles various formats of paths,
+     * including filesystem paths, URIs, and paths with potential Windows drive letters.
+     * The normalization involves resolving relative components, such as "." or "..",
+     * and ensuring the path conforms to a standardized format.
+     *
+     * @param location the path or URI string to normalize. It must not be null or empty.
+     * @return the normalized path or URI as a string.
+     * @throws IllegalArgumentException if the input location is null or empty.
+     */
     public static String normalize(String location) {
         if (location == null || location.isEmpty())
             throw new IllegalArgumentException("location must not be null or empty");