Javadoc fixes

Author: namedgraph

src/main/java/com/atomgraph/linkeddatahub/client/LinkedDataClient.java

@@ -40,6 +40,9 @@ public class LinkedDataClient extends com.atomgraph.core.client.LinkedDataClient
 
     private static final Logger log = LoggerFactory.getLogger(LinkedDataClient.class);
 
+    /**
+     * <samp>User-Agent</samp> request header value used by this HTTP client.
+     */
     public final static String USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:107.0) Gecko/20100101 Firefox/107.0"; // impersonate Firefox
 
     private URI baseURI;

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

@@ -169,7 +169,16 @@ public Response post(Model model, @QueryParam("default") @DefaultValue("false")
         }
     }
 
-     public Resource createContainerSelect(Model model, String title, Query query, Resource service)
+    /**
+     * Creates <code>SELECT</code> SPARQL query.
+     * 
+     * @param model RDF model
+     * @param title query title
+     * @param query query object
+     * @param service SPARQL service resource
+     * @return query resource
+     */
+    public Resource createContainerSelect(Model model, String title, Query query, Resource service)
     {
         return model.createResource().
             addProperty(RDF.type, SP.Select).
@@ -178,6 +187,16 @@ public Resource createContainerSelect(Model model, String title, Query query, Re
             addProperty(LDH.service, service);
     }
 
+    /**
+     * Creates a container document.
+     * 
+     * @param model RDF model
+     * @param graphURI named graph URI
+     * @param parent parent document resource
+     * @param title document title
+     * @param content document content
+     * @return container resource
+     */
     public Resource createContainer(Model model, URI graphURI, Resource parent, String title, Resource content)
     {
         return model.createResource(graphURI.toString()).
@@ -189,6 +208,13 @@ public Resource createContainer(Model model, URI graphURI, Resource parent, Stri
             addProperty(ResourceFactory.createProperty(RDF.getURI(), "_1"), content);
     }
 
+    /**
+     * Creates content resource.
+     * 
+     * @param model RDF model
+     * @param query query resource
+     * @return content resource
+     */
     public Resource createContent(Model model, Resource query)
     {
         return model.createResource().

src/main/java/com/atomgraph/linkeddatahub/server/exception/RDFSyntaxException.java

@@ -30,7 +30,6 @@
  * Thrown when read RDF data contains a syntax error.
  * 
  * @author Martynas Jusevičius {@literal <martynas@atomgraph.com>}
- * @see com.atomgraph.server.io.SkolemizingModelProvider
  */
 public class RDFSyntaxException extends ModelException
 {

src/main/java/com/atomgraph/linkeddatahub/server/io/CollectingErrorHandler.java

@@ -25,7 +25,6 @@
  * Collects syntax errors reported by the RDF parser.
  * 
  * @author Martynas Jusevičius {@literal <martynas@atomgraph.com>}
- * @see com.atomgraph.server.io.SkolemizingModelProvider
  */
 public class CollectingErrorHandler implements org.apache.jena.riot.system.ErrorHandler
 {

src/main/java/com/atomgraph/linkeddatahub/server/model/impl/GraphStoreImpl.java

@@ -490,8 +490,8 @@ public Response delete(@QueryParam("default") @DefaultValue("false") Boolean def
      * List allowed HTTP methods for the given graph URI.
      * Exceptions apply to the application's Root document, owner's WebID document, and secretary's WebID document.
      * 
-     * @param graphUri
-     * @return 
+     * @param graphUri ma,ed graph URI
+     * @return list of HTTP methods
      */
     public Set<String> getAllowedMethods(URI graphUri)
     {

src/main/java/com/atomgraph/linkeddatahub/vocabulary/DH.java

@@ -46,14 +46,16 @@ public static String getURI()
     /** <p>The namespace of the vocabulary as a resource</p> */
     public static final Resource NAMESPACE = m_model.createResource( NS );
 
+    /** Document class */
     public static final OntClass Document = m_model.createClass( NS + "Document" );
 
+    /** Container class */
     public static final OntClass Container = m_model.createClass( NS + "Container" );
 
+    /** Item class */
     public static final OntClass Item = m_model.createClass( NS + "Item" );
 
+    /** Slug property */
     public static final DatatypeProperty slug = m_model.createDatatypeProperty( NS + "slug" );
 
-    public static final ObjectProperty select = m_model.createObjectProperty( NS + "select");
-    
 }

src/main/java/com/atomgraph/linkeddatahub/vocabulary/SIOC.java

@@ -41,13 +41,17 @@ public class SIOC {
    */
   public static final String NS = "http://rdfs.org/sioc/ns#";
 
+  /**
+   * Default prefix for this namespace.
+   */
   public static final String PREFIX = "sioc";
 
   /**
    * <p>
    * The namespace of the vocabulary as a string
    * </p>
    *
+     * @return the URI of this namespace
    * @see #NS
    */
   public static String getURI() {
@@ -154,6 +158,9 @@ public static String getURI() {
   public static final ObjectProperty FUNCTION_OF = m_model
       .createObjectProperty("http://rdfs.org/sioc/ns#function_of");
 
+  /**
+   * This property has been renamed. Use <samp>sioc:sioc:usergroup_of</samp> instead.
+   */
   public static final ObjectProperty GROUP_OF = m_model
       .createObjectProperty("http://rdfs.org/sioc/ns#group_of");
 
@@ -197,6 +204,9 @@ public static String getURI() {
   public static final ObjectProperty HAS_FUNCTION = m_model
       .createObjectProperty("http://rdfs.org/sioc/ns#has_function");
 
+  /**
+   * This property has been renamed. Use <samp>sioc:has_usergroup</samp> instead.
+   */
   public static final ObjectProperty HAS_GROUP = m_model
       .createObjectProperty("http://rdfs.org/sioc/ns#has_group");
 

src/main/java/com/atomgraph/linkeddatahub/writer/function/Reserialize.java

@@ -46,6 +46,9 @@
 public class Reserialize implements ExtensionFunction
 {
 
+    /**
+     * The RDF syntax language used by this function.
+     */
     public static Lang LANG = Lang.RDFXML;
 
     private final Processor processor;