Fix javadoc errors and warnings for Kitodo-API

Signed-off-by: Stefan Weil <[email protected]>

Kitodo-API/src/main/java/org/kitodo/api/dataeditor/DataEditorInterface.java

@@ -26,6 +26,7 @@ public interface DataEditorInterface {
      *            The URI to the xml file to read.
      * @param xsltFileUri
      *            The URI to the xsl file for transformation of old format goobi metadata files.
+     * @throws IOException if reading fails.
      */
     void readData(URI xmlFileUri, URI xsltFileUri) throws IOException;
 

Kitodo-API/src/main/java/org/kitodo/api/dataeditor/rulesetmanagement/MetadataViewWithValuesInterface.java

@@ -24,7 +24,7 @@
  * for this key. If the key is a multiple choice, the values are grouped, hence
  * the list, otherwise the length of the list is always only one. Effectively,
  * the return type of
- * {@link ComplexMetadataViewInterface#getSortedVisibleMetadatas(Collection, Collection)}
+ * {@link ComplexMetadataViewInterface#getSortedVisibleMetadata(Collection, Collection)}
  * is {@code List<Pair<MetadataViewInterface, Collection<T>>>}. Since the key
  * must be repeatable if there is more than one value but the key is not a
  * multiple choice, a map would be an inappropriate choice at this point.

Kitodo-API/src/main/java/org/kitodo/api/dataformat/MediaPartial.java

@@ -29,7 +29,7 @@ public class MediaPartial {
      *
      * @param begin
      *         The begin as formatted time in form of
-     *         {@link org.kitodo.production.helper.metadata.MediaPartialHelper#FORMATTED_TIME_PATTERN}
+     *         ([0-1]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}
      */
     public MediaPartial(String begin) {
         this.begin = begin;
@@ -40,10 +40,10 @@ public MediaPartial(String begin) {
      *
      * @param begin
      *         The begin as formatted time in form of
-     *         {@link org.kitodo.production.helper.metadata.MediaPartialHelper#FORMATTED_TIME_PATTERN}
+     *         ([0-1]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}
      * @param extent
      *         The extent as formatted time in form of
-     *         {@link org.kitodo.production.helper.metadata.MediaPartialHelper#FORMATTED_TIME_PATTERN}
+     *         ([0-1]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}
      */
     public MediaPartial(String begin, String extent) {
         this(begin);

Kitodo-API/src/main/java/org/kitodo/api/filemanagement/FileManagementInterface.java

@@ -34,6 +34,7 @@ public interface FileManagementInterface {
      *            the name of the new resource
      * @param file
      *            if true it creates the file, if false it created directory
+     * @throws IOException if file/folder could not be created
      * @return the URI of the new resource
      */
     URI create(URI parentFolderUri, String name, boolean file) throws IOException;
@@ -43,6 +44,7 @@ public interface FileManagementInterface {
      *
      * @param uri
      *            the uri to write to
+     * @throws IOException if uri could not be written
      * @return an writable OutputStream
      */
     OutputStream write(URI uri) throws IOException;
@@ -52,6 +54,7 @@ public interface FileManagementInterface {
      *
      * @param uri
      *            the uri to write from
+     * @throws IOException if uri could not be read
      * @return a readable InputStream
      */
     InputStream read(URI uri) throws IOException;
@@ -63,6 +66,7 @@ public interface FileManagementInterface {
      *            source file as uri
      * @param targetResource
      *            destination file as uri
+     * @throws IOException if source could not be read or destination could not be written
      */
     void copy(URI sourceResource, URI targetResource) throws IOException;
 
@@ -71,6 +75,7 @@ public interface FileManagementInterface {
      *
      * @param uri
      *            the URI to delete
+     * @throws IOException if uri could not be deleted
      * @return true if successful, false otherwise
      */
     boolean delete(URI uri) throws IOException;
@@ -94,6 +99,7 @@ public interface FileManagementInterface {
      *            the URI to the resource to rename
      * @param newName
      *            the new name of the resource
+     * @throws IOException if uri could not be renamed
      * @return URI of renamed resource
      */
     URI rename(URI uri, String newName) throws IOException;
@@ -113,6 +119,7 @@ public interface FileManagementInterface {
      *
      * @param directory
      *            URI to get size
+     * @throws IOException if getting the size of URI failed
      * @return size of directory as Long
      */
     Long getSizeOfDirectory(URI directory) throws IOException;
@@ -178,6 +185,7 @@ public interface FileManagementInterface {
      *
      * @param processId
      *            the id of the process
+     * @throws IOException if the folder structure could not be created
      * @return the URI to the process Location
      */
     URI createProcessLocation(String processId) throws IOException;

Kitodo-API/src/main/java/org/kitodo/config/OPACConfig.java

@@ -70,6 +70,7 @@ private OPACConfig() {
      *
      * @param catalogName String identifying the catalog by title
      * @param parameter String identifying the parameter by name
+     * @throws ParameterNotFoundException if parameter was not found
      * @return value of parameter
      */
     public static String getConfigValue(String catalogName, String parameter) throws ParameterNotFoundException {
@@ -150,6 +151,7 @@ private static String getUrlConfigPart(String catalogName, String parameter)
     /**
      * Get host parameter of catalog configuration with name 'catalogName'.
      * @param catalogName name of catalog configuration
+     * @throws MandatoryParameterMissingException if required parameter is missing
      * @return host value as String
      */
     public static String getHost(String catalogName) throws MandatoryParameterMissingException {
@@ -159,6 +161,7 @@ public static String getHost(String catalogName) throws MandatoryParameterMissin
     /**
      * Get scheme parameter of catalog configuration with name 'catalogName'.
      * @param catalogName name of catalog configuration
+     * @throws MandatoryParameterMissingException if required parameter is missing
      * @return scheme value as String
      */
     public static String getScheme(String catalogName) throws MandatoryParameterMissingException {
@@ -168,6 +171,7 @@ public static String getScheme(String catalogName) throws MandatoryParameterMiss
     /**
      * Get path parameter of catalog configuration with name 'catalogName'.
      * @param catalogName name of catalog configuration
+     * @throws MandatoryParameterMissingException if required parameter is missing
      * @return path value as String
      */
     public static String getPath(String catalogName) throws MandatoryParameterMissingException {
@@ -177,6 +181,7 @@ public static String getPath(String catalogName) throws MandatoryParameterMissin
     /**
      * Get port parameter of catalog configuration with name 'catalogName'.
      * @param catalogName name of catalog configuration
+     * @throws MandatoryParameterMissingException if required parameter is missing
      * @return port value as String
      */
     public static String getPort(String catalogName) throws MandatoryParameterMissingException {

Kitodo-API/src/main/java/org/kitodo/config/enums/KitodoConfigFile.java

@@ -84,6 +84,7 @@ public String getAbsolutePath() {
      *
      * @param name
      *            of configuration file
+     * @throws FileNotFoundException if the configuration file is not found
      * @return File
      */
     public static KitodoConfigFile getByName(String name) throws FileNotFoundException {

Kitodo-API/src/main/java/org/kitodo/exceptions/UnknownTreeNodeDataException.java

@@ -15,6 +15,7 @@ public class UnknownTreeNodeDataException extends RuntimeException {
 
     /**
      * Constructor with given parameter name for exception message.
+     * @param type String which describes the unexpected type
      */
     public UnknownTreeNodeDataException(String type) {
         super("TreeNode contains data of unexpected type '" + type + "!");