Javadoc fixes

Author: namedgraph

CHANGELOG.md

@@ -1,5 +1,8 @@
 
 ## [5.0.15] - 2025-06-15
+## Added
+- Javadoc comments
+
 ### Changed
 - Inlined nginx and Varnish config templates into `docker-compose.yml`
 - SaxonJS 3 bump to 3.0.0-beta-2

src/main/java/com/atomgraph/linkeddatahub/client/util/RejectTooLargeResponseInputStream.java

@@ -22,6 +22,7 @@
 import java.io.InputStream;
 
 /**
+ * Input stream that rejects HTTP responses that exceed the maximum size limit.
  *
  * @author Martynas Jusevičius {@literal <martynas@atomgraph.com>}
  */

src/main/java/com/atomgraph/linkeddatahub/client/util/RetryAfterHelper.java

@@ -39,7 +39,6 @@
  *     RetryAfterHelper helper = new RetryAfterHelper(5000L, 3);
  *     Response response = helper.invokeWithRetry(() -> client.target(url).request().get());
  * </pre>
- * </p>
  * 
  * @author Martynas Jusevičius {@literal <martynas@atomgraph.com>}
  */
@@ -50,6 +49,12 @@ public class RetryAfterHelper
     private final long defaultDelayMillis;
     private final int maxRetryCount;
 
+    /**
+     * Constructs retry helper.
+     * 
+     * @param defaultDelayMillis default delay in milliseconds
+     * @param maxRetryCount maximum retry count
+     */
     public RetryAfterHelper(long defaultDelayMillis, int maxRetryCount)
     {
         this.defaultDelayMillis = defaultDelayMillis;

src/main/java/com/atomgraph/linkeddatahub/imports/stream/csv/CSVGraphStoreRowProcessor.java

@@ -41,6 +41,7 @@
 import org.slf4j.LoggerFactory;
 
 /**
+ * CSV row processor that transforms CSV data to RDF and stores it in a graph store.
  *
  * @author {@literal Martynas Jusevičius <martynas@atomgraph.com>}
  */

src/main/java/com/atomgraph/linkeddatahub/model/auth/Authorization.java

@@ -21,6 +21,7 @@
 import org.apache.jena.rdf.model.Resource;
 
 /**
+ * Authorization interface for access control.
  *
  * @author {@literal Martynas Jusevičius <martynas@atomgraph.com>}
  */

src/main/java/com/atomgraph/linkeddatahub/model/auth/impl/AuthorizationImpl.java

@@ -34,6 +34,7 @@
 import org.slf4j.LoggerFactory;
 
 /**
+ * Implementation of authorization model.
  *
  * @author {@literal Martynas Jusevičius <martynas@atomgraph.com>}
  */

src/main/java/com/atomgraph/linkeddatahub/resource/Graph.java

@@ -369,7 +369,7 @@ public Response patch(UpdateRequest updateRequest, @QueryParam("graph") URI grap
      * 
      * @param beforeUpdateModel model before the update
      * @param afterUpdateModel model after the update
-     * @return 
+     * @return set of changed resources
      */
     public Set<Resource> getChangedResources(Model beforeUpdateModel, Model afterUpdateModel)
     {
@@ -708,6 +708,11 @@ public File writeFile(Resource resource, FormDataBodyPart bodyPart)
         }
     }
 
+    /**
+     * Submits imports for the given model.
+     * 
+     * @param model the RDF model
+     */
     public void submitImports(Model model)
     {
         if (model == null) throw new IllegalArgumentException("Model cannot be null");

src/main/java/com/atomgraph/linkeddatahub/resource/acl/Access.java

@@ -57,6 +57,7 @@
 import org.slf4j.LoggerFactory;
 
 /**
+ * ACL access control endpoint for querying authorization data.
  *
  * @author Martynas Jusevičius {@literal <martynas@atomgraph.com>}
  */

src/main/java/com/atomgraph/linkeddatahub/resource/acl/AccessRequest.java

@@ -63,6 +63,7 @@
 import org.slf4j.LoggerFactory;
 
 /**
+ * Resource for handling ACL access requests.
  *
  * @author Martynas Jusevičius {@literal <martynas@atomgraph.com>}
  */
@@ -181,6 +182,12 @@ public Response post(Model model, @QueryParam("default") @DefaultValue("false")
         }
     }
 
+    /**
+     * Returns a human-readable name for the agent.
+     * 
+     * @param agent the agent
+     * @return human-readable name or null if not available
+     */
     public String getAgentsHumanReadableName(Agent agent)
     {
         if (agent.hasProperty(FOAF.givenName) && agent.hasProperty(FOAF.familyName))

src/main/java/com/atomgraph/linkeddatahub/server/factory/AuthorizationContextFactory.java

@@ -24,6 +24,7 @@
 import org.glassfish.hk2.api.ServiceLocator;
 
 /**
+ * Factory for creating authorization context instances.
  *
  * @author {@literal Martynas Jusevičius <martynas@atomgraph.com>}
  */