Merge branch '6.x' into update-mockito

Apply replacement:
* "Mockito.<Object>any()" => "Mockito.any(Object[].class)"

Author: jmini

src/main/java/org/gitlab4j/api/IssuesApi.java

@@ -16,6 +16,7 @@
 import org.gitlab4j.api.models.IssueLink;
 import org.gitlab4j.api.models.IssuesStatistics;
 import org.gitlab4j.api.models.IssuesStatisticsFilter;
+import org.gitlab4j.api.models.LinkType;
 import org.gitlab4j.api.models.MergeRequest;
 import org.gitlab4j.api.models.Participant;
 import org.gitlab4j.api.models.TimeStats;
@@ -889,10 +890,31 @@ public Stream<Issue> getIssueLinksStream(Object projectIdOrPath, Long issueIid)
      */
     public IssueLink createIssueLink(Object projectIdOrPath, Long issueIid,
             Object targetProjectIdOrPath, Long targetIssueIid) throws GitLabApiException {
+        return createIssueLink(projectIdOrPath, issueIid, targetProjectIdOrPath, targetIssueIid, null);
+    }
+
+    /**
+     * Creates a two-way relation between two issues. User must be allowed to update both issues in order to succeed.
+     *
+     * <p>NOTE: Only available in GitLab Starter, GitLab Bronze, and higher tiers.</p>
+     *
+     * <pre><code>GitLab Endpoint: POST /projects/:id/issues/:issue_iid/links</code></pre>
+     *
+     * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance
+     * @param issueIid the internal ID of a project's issue
+     * @param targetProjectIdOrPath the project in the form of an Long(ID), String(path), or Project instance of the target project
+     * @param targetIssueIid the internal ID of a target project’s issue
+     * @param linkType the type of the relation (optional), defaults to {@link LinkType#RELATES_TO}.
+     * @return an instance of IssueLink holding the link relationship
+     * @throws GitLabApiException if any exception occurs
+     */
+    public IssueLink createIssueLink(Object projectIdOrPath, Long issueIid,
+            Object targetProjectIdOrPath, Long targetIssueIid, LinkType linkType) throws GitLabApiException {
 
         GitLabApiForm formData = new GitLabApiForm()
                 .withParam("target_project_id", getProjectIdOrPath(targetProjectIdOrPath), true)
-                .withParam("target_issue_iid", targetIssueIid, true);
+                .withParam("target_issue_iid", targetIssueIid, true)
+                .withParam("link_type", linkType, false);
 
         Response response = post(Response.Status.OK, formData.asMap(),
                 "projects", getProjectIdOrPath(projectIdOrPath), "issues", issueIid, "links");

src/main/java/org/gitlab4j/api/Pager.java

@@ -69,7 +69,7 @@ public class Pager<T> implements Iterator<List<T>>, Constants {
      * @param pathArgs HTTP path arguments
      * @throws GitLabApiException if any error occurs
      */
-    Pager(AbstractApi api, Class<T> type, int itemsPerPage, MultivaluedMap<String, String> queryParams, Object... pathArgs) throws GitLabApiException {
+    public Pager(AbstractApi api, Class<T> type, int itemsPerPage, MultivaluedMap<String, String> queryParams, Object... pathArgs) throws GitLabApiException {
 
         javaType = mapper.getTypeFactory().constructCollectionType(List.class, type);
 

src/main/java/org/gitlab4j/api/RepositorySubmodulesApi.java

@@ -0,0 +1,42 @@
+package org.gitlab4j.api;
+
+import jakarta.ws.rs.core.Response;
+
+import org.gitlab4j.api.models.Commit;
+
+/**
+ * <p>This class provides an entry point to all the GitLab API repository submodules calls.
+ * For more information on the repository APIs see:</p>
+ *
+ * @see <a href="https://docs.gitlab.com/ee/api/repository_submodules.html">Repository Submodules API</a>
+ */
+public class RepositorySubmodulesApi extends AbstractApi {
+
+    public RepositorySubmodulesApi(GitLabApi gitLabApi) {
+        super(gitLabApi);
+    }
+
+    /**
+     * Update existing submodule reference in repository.
+     *
+     * <pre><code>GitLab Endpoint: PUT /projects/:id/repository/submodules/:submodule</code></pre>
+     *
+     * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance
+     * @param submodule full path to the submodule
+     * @param branch name of the branch to commit into
+     * @param commitSha full commit SHA to update the submodule to
+     * @param commitMessage commit message (optional). If no message is provided, a default is set
+     * @return the created commit
+     * @throws GitLabApiException if any exception occurs
+     */
+    public Commit updateExistingSubmoduleReference(Object projectIdOrPath, String submodule, String branch, String commitSha, String commitMessage) throws GitLabApiException {
+        GitLabApiForm formData = new GitLabApiForm()
+                .withParam("branch", branch, true)
+                .withParam("commit_sha", commitSha, true)
+                .withParam("commit_message", commitMessage);
+        Response response = put(Response.Status.OK, formData.asMap(), "projects",
+                getProjectIdOrPath(projectIdOrPath), "repository", "submodules", urlEncode(submodule));
+        return (response.readEntity(Commit.class));
+    }
+
+}