chore: address Checkstyle markers

Author: joaodinissf

com.avaloq.tools.ddk.check.core/src/com/avaloq/tools/ddk/check/validation/UniquenessJavaValidationHelper.java

@@ -48,6 +48,8 @@ public UniquenessJavaValidationHelper(final Function<T, QualifiedName> nameFunct
    *          provides the feature of the duplicate object on which to anchor the marker
    * @param issueCode
    *          the issue code
+   * @throws IllegalArgumentException
+   *           if acceptor is null
    */
   public void warnOnDuplicates(final Iterable<T> possiblyDuplicateObjects, final Function<T, EStructuralFeature> featureProvider, final String issueCode) {
     if (acceptor == null) {
@@ -75,6 +77,8 @@ public void warnOnDuplicates(final Iterable<T> possiblyDuplicateObjects, final F
    *          provides the feature of the duplicate object on which to anchor the marker
    * @param issueCode
    *          the issue code
+   * @throws IllegalArgumentException
+   *           if acceptor is null
    */
   public void errorOnDuplicates(final Iterable<T> possiblyDuplicateObjects, final Function<T, EStructuralFeature> featureProvider, final String issueCode) {
     if (acceptor == null) {

com.avaloq.tools.ddk.check.core/src/com/avaloq/tools/ddk/check/validation/UniquenessValidationHelper.java

@@ -36,9 +36,11 @@ public class UniquenessValidationHelper<T extends EObject> {
 
   /**
    * Creates a Uniqueness validation helper.
-   * 
+   *
    * @param nameFunction
    *          a function that returns a representation of a T object that can be compared by means of equals
+   * @throws IllegalArgumentException
+   *           if nameFunction is null
    */
   public UniquenessValidationHelper(final Function<T, QualifiedName> nameFunction) {
     if (nameFunction == null) {

com.avaloq.tools.ddk.check.runtime.core/src/com/avaloq/tools/ddk/check/runtime/issue/ValidationMessageAcceptorMixin.java

@@ -145,6 +145,8 @@ default Diagnostic createDiagnostic(final Severity severity, final String messag
    * @param severity
    *          the issue severity
    * @return the numeric value representing a severity
+   * @throws IllegalArgumentException
+   *           if the severity is unknown
    */
   static int toDiagnosticSeverity(final Severity severity) {
     return switch (severity) {

com.avaloq.tools.ddk.check.runtime.core/src/com/avaloq/tools/ddk/check/runtime/quickfix/BadLocationException.java

@@ -43,8 +43,8 @@ public BadLocationException(final String message) {
 
   /**
    * Creates a new bad location exception.
-   * 
-   * @param exception
+   *
+   * @param wrappedException
    *          the cause for the exception
    */
   public BadLocationException(final Exception wrappedException) {

com.avaloq.tools.ddk.check.runtime.core/src/com/avaloq/tools/ddk/check/runtime/validation/AbstractCheckValidator.java

@@ -69,13 +69,16 @@ public Iterable<? extends ICheckValidatorImpl> getValidators(final Map<Object, O
 
   /**
    * Internal collect validators.
-   * 
+   *
    * @param language
    *          the language
    * @param object
    *          the object to be validated
    * @return the iterable
+   * @throws IllegalArgumentException
+   *           if language is null
    */
+  @SuppressWarnings("PMD.UnusedFormalParameter")
   protected Iterable<? extends ICheckValidatorImpl> internalCollectValidators(final String language, final EObject object) {
     if (language == null) {
       throw new IllegalArgumentException("Input language cannot be null"); //$NON-NLS-1$

com.avaloq.tools.ddk.check.ui/src/com/avaloq/tools/ddk/check/ui/builder/CheckExtensionGenerator.java

@@ -485,12 +485,15 @@ public boolean saveOpenEditor() {
 
   /**
    * Merges the {@code MANIFEST.MF} file with new plug-in dependencies. Adds dependencies as returned by
+   * {@link com.avaloq.tools.ddk.check.util.GrammarHelper#getRequiredBundleSymbolicNames()} of current
+   * check catalog to the MANIFEST.MF file.
    *
    * @param catalog
    *          check catalog
    * @param monitor
-   *          progress monitor {@link com.avaloq.tools.ddk.check.util.GrammarHelper#getRequiredBundleSymbolicNames()} of current
-   *          check catalog to the MANIFEST.MF file.
+   *          progress monitor
+   * @throws WrappedException
+   *           if an IOException or CoreException occurs during manifest modification
    */
   private void mergeManifest(final CheckCatalog catalog, final IProgressMonitor monitor) {
     final IProject project = RuntimeProjectUtil.getProject(catalog.eResource().getURI(), mapper);

com.avaloq.tools.ddk.check.ui/src/com/avaloq/tools/ddk/check/ui/builder/util/CheckProjectHelper.java

@@ -187,6 +187,8 @@ public CheckCatalog getCatalog(final IBuildContext context, final URI uri) {
    * @param className
    *          the class name, must not be {@code null}
    * @return whether the corresponding java file exists in the project
+   * @throws IllegalArgumentException
+   *           if the class name is simple or not a valid class name
    */
   public boolean isJavaFilePresent(final IProject project, final String className) {
     int packageSplitIndex = className.lastIndexOf('.');

com.avaloq.tools.ddk.check.ui/src/com/avaloq/tools/ddk/check/ui/labeling/CheckLabelProvider.java

@@ -91,6 +91,7 @@ public String text(final Category category) {
    *          any catalog
    * @return a graphical representation of the catalog
    */
+  @SuppressWarnings("PMD.UnusedFormalParameter")
   public Image image(final CheckCatalog catalog) {
     return images.forCheckCatalog();
   }
@@ -102,6 +103,7 @@ public Image image(final CheckCatalog catalog) {
    *          any category
    * @return a graphical representation of the category
    */
+  @SuppressWarnings("PMD.UnusedFormalParameter")
   public Image image(final Category category) {
     return images.forCategory();
   }
@@ -124,39 +126,43 @@ public Image image(final Check check) {
    *          any context
    * @return a graphical representation of the context
    */
+  @SuppressWarnings("PMD.UnusedFormalParameter")
   public Image image(final Context context) {
     return images.forContext();
   }
 
   /**
    * An image for member labels.
-   * 
+   *
    * @param context
    *          any context
    * @return a graphical representation of the context
    */
+  @SuppressWarnings("PMD.UnusedFormalParameter")
   public Image image(final Member context) {
     return images.getJdtImage(xbaseImages.forField(JvmVisibility.PRIVATE, 0));
   }
 
   /**
    * An image for member labels.
-   * 
+   *
    * @param context
    *          any context
    * @return a graphical representation of the context
    */
+  @SuppressWarnings("PMD.UnusedFormalParameter")
   public Image image(final ContextVariable context) {
     return images.getJdtImage(xbaseImages.forLocalVariable(0));
   }
 
   /**
    * An image for member labels.
-   * 
+   *
    * @param context
    *          any context
    * @return a graphical representation of the context
    */
+  @SuppressWarnings("PMD.UnusedFormalParameter")
   public Image image(final FormalParameter context) {
     return images.getJdtImage(xbaseImages.forLocalVariable(0));
   }

com.avaloq.tools.ddk.check.ui/src/com/avaloq/tools/ddk/check/ui/popup/actions/DeployJob.java

@@ -418,7 +418,12 @@ private static class DeployException extends Exception {
     DeployException() {
     }
 
-    /** Constructor with cause exception. */
+    /**
+     * Constructor with cause exception.
+     *
+     * @param e
+     *          the cause exception
+     */
     DeployException(final Exception e) {
       super(e);
     }

com.avaloq.tools.ddk.check.ui/src/com/avaloq/tools/ddk/check/ui/util/FieldInitializerUtil.java

@@ -45,6 +45,8 @@ public class FieldInitializerUtil {
    * @param selection
    *          the selection
    * @return the selected resource
+   * @throws RuntimeException
+   *           if a Java model exception occurs
    */
   public IJavaElement getSelectedResource(final IStructuredSelection selection) {
     IJavaElement elem = null;