From 97b02a15fd3e38b2f061f463a987dad09484c2ff Mon Sep 17 00:00:00 2001 From: George Orfanidis Date: Tue, 28 May 2024 13:51:35 +0200 Subject: [PATCH 1/4] update Project model Include issue template and merge request template --- .../java/org/gitlab4j/api/ProjectApi.java | 1203 +++++++++-------- .../java/org/gitlab4j/api/models/Project.java | 19 + 2 files changed, 631 insertions(+), 591 deletions(-) diff --git a/src/main/java/org/gitlab4j/api/ProjectApi.java b/src/main/java/org/gitlab4j/api/ProjectApi.java index de1954cbc..9a4380fbc 100644 --- a/src/main/java/org/gitlab4j/api/ProjectApi.java +++ b/src/main/java/org/gitlab4j/api/ProjectApi.java @@ -38,6 +38,7 @@ import javax.ws.rs.core.MediaType; import javax.ws.rs.core.MultivaluedMap; import javax.ws.rs.core.Response; + import org.gitlab4j.api.GitLabApi.ApiVersion; import org.gitlab4j.api.models.AccessLevel; import org.gitlab4j.api.models.AccessRequest; @@ -135,13 +136,13 @@ public Optional getOptionalProjectStatistics(Object projectIdOrP */ public List getProjects() throws GitLabApiException { - String url = this.gitLabApi.getGitLabServerUrl(); - if (url.startsWith("https://gitlab.com")) { - GitLabApi.getLogger().warning("Fetching all projects from " + url + - " may take many hours to complete, use Pager getProjects(int) instead."); - } + String url = this.gitLabApi.getGitLabServerUrl(); + if (url.startsWith("https://gitlab.com")) { + GitLabApi.getLogger().warning("Fetching all projects from " + url + + " may take many hours to complete, use Pager getProjects(int) instead."); + } - return (getProjects(getDefaultPerPage()).all()); + return (getProjects(getDefaultPerPage()).all()); } /** @@ -149,14 +150,15 @@ public List getProjects() throws GitLabApiException { * * 
GitLab Endpoint: GET /projects
* - * @param page the page to get + * @param page the page to get * @param perPage the number of projects per page * @return a list of projects accessible by the authenticated user * @throws GitLabApiException if any exception occurs */ public List getProjects(int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects"); - return (response.readEntity(new GenericType>() { })); + return (response.readEntity(new GenericType>() { + })); } /** @@ -181,7 +183,7 @@ public Pager getProjects(int itemsPerPage) throws GitLabApiException { * @throws GitLabApiException if any exception occurs */ public Stream getProjectsStream() throws GitLabApiException { - return (getProjects(getDefaultPerPage()).stream()); + return (getProjects(getDefaultPerPage()).stream()); } /** @@ -190,30 +192,30 @@ public Stream getProjectsStream() throws GitLabApiException { * * 
GitLab Endpoint: GET /projects
* - * @param archived limit by archived status + * @param archived limit by archived status * @param visibility limit by visibility public, internal, or private - * @param orderBy return projects ordered by id, name, path, created_at, updated_at, or last_activity_at fields, default is created_at - * @param sort return projects sorted in asc or desc order. Default is desc - * @param search return list of projects matching the search criteria - * @param simple return only the ID, URL, name, and path of each project - * @param owned limit by projects owned by the current user + * @param orderBy return projects ordered by id, name, path, created_at, updated_at, or last_activity_at fields, default is created_at + * @param sort return projects sorted in asc or desc order. Default is desc + * @param search return list of projects matching the search criteria + * @param simple return only the ID, URL, name, and path of each project + * @param owned limit by projects owned by the current user * @param membership limit by projects that the current user is a member of - * @param starred limit by projects starred by the current user + * @param starred limit by projects starred by the current user * @param statistics include project statistics * @return a list of projects accessible by the authenticated user and matching the supplied parameters * @throws GitLabApiException if any exception occurs - * @deprecated Will be removed in version 6.0, replaced by {@link #getProjects(Boolean, Visibility, - * Constants.ProjectOrderBy, Constants.SortOrder, String, Boolean, Boolean, Boolean, Boolean, Boolean)} + * @deprecated Will be removed in version 6.0, replaced by {@link #getProjects(Boolean, Visibility, + * Constants.ProjectOrderBy, Constants.SortOrder, String, Boolean, Boolean, Boolean, Boolean, Boolean)} */ @Deprecated public List getProjects(Boolean archived, Visibility visibility, String orderBy, - String sort, String search, Boolean simple, Boolean owned, Boolean membership, - Boolean starred, Boolean statistics) throws GitLabApiException { + String sort, String search, Boolean simple, Boolean owned, Boolean membership, + Boolean starred, Boolean statistics) throws GitLabApiException { ProjectOrderBy projectOrderBy = ProjectOrderBy.valueOf(orderBy); SortOrder sortOrder = SortOrder.valueOf(sort); return (getProjects(archived, visibility, projectOrderBy, sortOrder, search, simple, - owned, membership, starred, statistics, getDefaultPerPage()).all()); + owned, membership, starred, statistics, getDefaultPerPage()).all()); } /** @@ -222,26 +224,26 @@ public List getProjects(Boolean archived, Visibility visibility, String * * 
GitLab Endpoint: GET /projects
* - * @param archived limit by archived status + * @param archived limit by archived status * @param visibility limit by visibility public, internal, or private - * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or - * LAST_ACTIVITY_AT fields, default is CREATED_AT - * @param sort return projects sorted in asc or desc order. Default is desc - * @param search return list of projects matching the search criteria - * @param simple return only the ID, URL, name, and path of each project - * @param owned limit by projects owned by the current user + * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or + * LAST_ACTIVITY_AT fields, default is CREATED_AT + * @param sort return projects sorted in asc or desc order. Default is desc + * @param search return list of projects matching the search criteria + * @param simple return only the ID, URL, name, and path of each project + * @param owned limit by projects owned by the current user * @param membership limit by projects that the current user is a member of - * @param starred limit by projects starred by the current user + * @param starred limit by projects starred by the current user * @param statistics include project statistics * @return a list of projects accessible by the authenticated user and matching the supplied parameters * @throws GitLabApiException if any exception occurs */ public List getProjects(Boolean archived, Visibility visibility, ProjectOrderBy orderBy, - SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, - Boolean starred, Boolean statistics) throws GitLabApiException { + SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, + Boolean starred, Boolean statistics) throws GitLabApiException { return (getProjects(archived, visibility, orderBy, sort, search, simple, - owned, membership, starred, statistics, getDefaultPerPage()).all()); + owned, membership, starred, statistics, getDefaultPerPage()).all()); } /** @@ -250,42 +252,43 @@ public List getProjects(Boolean archived, Visibility visibility, Projec * * 
GitLab Endpoint: GET /projects
* - * @param archived limit by archived status + * @param archived limit by archived status * @param visibility limit by visibility public, internal, or private - * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or - * LAST_ACTIVITY_AT fields, default is CREATED_AT - * @param sort return projects sorted in asc or desc order. Default is desc - * @param search return list of projects matching the search criteria - * @param simple return only the ID, URL, name, and path of each project - * @param owned limit by projects owned by the current user + * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or + * LAST_ACTIVITY_AT fields, default is CREATED_AT + * @param sort return projects sorted in asc or desc order. Default is desc + * @param search return list of projects matching the search criteria + * @param simple return only the ID, URL, name, and path of each project + * @param owned limit by projects owned by the current user * @param membership limit by projects that the current user is a member of - * @param starred limit by projects starred by the current user + * @param starred limit by projects starred by the current user * @param statistics include project statistics - * @param page the page to get - * @param perPage the number of projects per page + * @param page the page to get + * @param perPage the number of projects per page * @return a list of projects accessible by the authenticated user and matching the supplied parameters * @throws GitLabApiException if any exception occurs */ public List getProjects(Boolean archived, Visibility visibility, ProjectOrderBy orderBy, - SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, - Boolean starred, Boolean statistics, int page, int perPage) throws GitLabApiException { + SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, + Boolean starred, Boolean statistics, int page, int perPage) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("archived", archived) - .withParam("visibility", visibility) - .withParam("order_by", orderBy) - .withParam("sort", sort) - .withParam("search", search) - .withParam("simple", simple) - .withParam("owned", owned) - .withParam("membership", membership) - .withParam("starred", starred) - .withParam("statistics", statistics) - .withParam(PAGE_PARAM, page) - .withParam(PER_PAGE_PARAM, perPage); + .withParam("archived", archived) + .withParam("visibility", visibility) + .withParam("order_by", orderBy) + .withParam("sort", sort) + .withParam("search", search) + .withParam("simple", simple) + .withParam("owned", owned) + .withParam("membership", membership) + .withParam("starred", starred) + .withParam("statistics", statistics) + .withParam(PAGE_PARAM, page) + .withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -294,36 +297,36 @@ public List getProjects(Boolean archived, Visibility visibility, Projec * * 
GitLab Endpoint: GET /projects
* - * @param archived limit by archived status - * @param visibility limit by visibility public, internal, or private - * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or - * LAST_ACTIVITY_AT fields, default is CREATED_AT - * @param sort return projects sorted in asc or desc order. Default is desc - * @param search return list of projects matching the search criteria - * @param simple return only the ID, URL, name, and path of each project - * @param owned limit by projects owned by the current user - * @param membership limit by projects that the current user is a member of - * @param starred limit by projects starred by the current user - * @param statistics include project statistics + * @param archived limit by archived status + * @param visibility limit by visibility public, internal, or private + * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or + * LAST_ACTIVITY_AT fields, default is CREATED_AT + * @param sort return projects sorted in asc or desc order. Default is desc + * @param search return list of projects matching the search criteria + * @param simple return only the ID, URL, name, and path of each project + * @param owned limit by projects owned by the current user + * @param membership limit by projects that the current user is a member of + * @param starred limit by projects starred by the current user + * @param statistics include project statistics * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of projects accessible by the authenticated user and matching the supplied parameters * @throws GitLabApiException if any exception occurs */ public Pager getProjects(Boolean archived, Visibility visibility, ProjectOrderBy orderBy, - SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, - Boolean starred, Boolean statistics, int itemsPerPage) throws GitLabApiException { + SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, + Boolean starred, Boolean statistics, int itemsPerPage) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("archived", archived) - .withParam("visibility", visibility) - .withParam("order_by", orderBy) - .withParam("sort", sort) - .withParam("search", search) - .withParam("simple", simple) - .withParam("owned", owned) - .withParam("membership", membership) - .withParam("starred", starred) - .withParam("statistics", statistics); + .withParam("archived", archived) + .withParam("visibility", visibility) + .withParam("order_by", orderBy) + .withParam("sort", sort) + .withParam("search", search) + .withParam("simple", simple) + .withParam("owned", owned) + .withParam("membership", membership) + .withParam("starred", starred) + .withParam("statistics", statistics); return (new Pager(this, Project.class, itemsPerPage, formData.asMap(), "projects")); } @@ -346,16 +349,17 @@ public List getProjects(String search) throws GitLabApiException { * * 
GitLab Endpoint: GET /projects?search=search
* - * @param search the project name search criteria - * @param page the page to get + * @param search the project name search criteria + * @param page the page to get * @param perPage the number of projects per page * @return a list of projects accessible by the authenticated user that match the provided search string * @throws GitLabApiException if any exception occurs */ public List getProjects(String search, int page, int perPage) throws GitLabApiException { - Form formData = new GitLabApiForm().withParam("search", search).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); + Form formData = new GitLabApiForm().withParam("search", search).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -363,7 +367,7 @@ public List getProjects(String search, int page, int perPage) throws Gi * * 
GitLab Endpoint: GET /projects?search=search
* - * @param search the project name search criteria + * @param search the project name search criteria * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of projects accessible by the authenticated user that match the provided search string * @throws GitLabApiException if any exception occurs @@ -403,15 +407,16 @@ public List getMemberProjects() throws GitLabApiException { * * 
GitLab Endpoint: GET /projects?membership=true
* - * @param page the page to get + * @param page the page to get * @param perPage the number of projects per page * @return a list of projects that the authenticated user is a member of * @throws GitLabApiException if any exception occurs */ public List getMemberProjects(int page, int perPage) throws GitLabApiException { - Form formData = new GitLabApiForm().withParam("membership", true).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); + Form formData = new GitLabApiForm().withParam("membership", true).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -457,15 +462,16 @@ public List getOwnedProjects() throws GitLabApiException { * * 
GitLab Endpoint: GET /projects?owned=true
* - * @param page the page to get + * @param page the page to get * @param perPage the number of projects per page * @return a list of projects owned by the authenticated user * @throws GitLabApiException if any exception occurs */ public List getOwnedProjects(int page, int perPage) throws GitLabApiException { - Form formData = new GitLabApiForm().withParam("owned", true).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); + Form formData = new GitLabApiForm().withParam("owned", true).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -511,7 +517,7 @@ public List getStarredProjects() throws GitLabApiException { * * 
GitLab Endpoint: GET /projects?starred=true
* - * @param page the page to get + * @param page the page to get * @param perPage the number of projects per page * @return a list of projects starred by the authenticated user * @throws GitLabApiException if any exception occurs @@ -519,7 +525,8 @@ public List getStarredProjects() throws GitLabApiException { public List getStarredProjects(int page, int perPage) throws GitLabApiException { Form formData = new GitLabApiForm().withParam("starred", true).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -567,8 +574,8 @@ public List getProjects(ProjectFilter filter) throws GitLabApiException * * 
GitLab Endpoint: GET /projects
* - * @param filter the ProjectFilter instance holding the filter values for the query - * @param page the page to get + * @param filter the ProjectFilter instance holding the filter values for the query + * @param page the page to get * @param perPage the number of projects per page * @return a list of all visible projects across GitLab for the authenticated use * @throws GitLabApiException if any exception occurs @@ -576,7 +583,8 @@ public List getProjects(ProjectFilter filter) throws GitLabApiException public List getProjects(ProjectFilter filter, int page, int perPage) throws GitLabApiException { GitLabApiForm formData = filter.getQueryParams(page, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -584,7 +592,7 @@ public List getProjects(ProjectFilter filter, int page, int perPage) th * * 
GitLab Endpoint: GET /projects
* - * @param filter the ProjectFilter instance holding the filter values for the query + * @param filter the ProjectFilter instance holding the filter values for the query * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of all visible projects across GitLab for the authenticated use * @throws GitLabApiException if any exception occurs @@ -613,7 +621,7 @@ public Stream getProjectsStream(ProjectFilter filter) throws GitLabApiE * 
GitLab Endpoint: GET /users/:user_id/projects
* * @param userIdOrUsername the user ID, username of the user, or a User instance holding the user ID or username - * @param filter the ProjectFilter instance holding the filter values for the query + * @param filter the ProjectFilter instance holding the filter values for the query * @return a list of visible projects owned by the given user * @throws GitLabApiException if any exception occurs */ @@ -627,17 +635,18 @@ public List getUserProjects(Object userIdOrUsername, ProjectFilter filt * 
GitLab Endpoint: GET /users/:user_id/projects
* * @param userIdOrUsername the user ID, username of the user, or a User instance holding the user ID or username - * @param filter the ProjectFilter instance holding the filter values for the query - * @param page the page to get - * @param perPage the number of projects per page + * @param filter the ProjectFilter instance holding the filter values for the query + * @param page the page to get + * @param perPage the number of projects per page * @return a list of visible projects owned by the given user * @throws GitLabApiException if any exception occurs */ public List getUserProjects(Object userIdOrUsername, ProjectFilter filter, int page, int perPage) throws GitLabApiException { GitLabApiForm formData = filter.getQueryParams(page, perPage); Response response = get(Response.Status.OK, formData.asMap(), - "users", getUserIdOrUsername(userIdOrUsername), "projects"); - return (response.readEntity(new GenericType>() {})); + "users", getUserIdOrUsername(userIdOrUsername), "projects"); + return (response.readEntity(new GenericType>() { + })); } /** @@ -646,15 +655,15 @@ public List getUserProjects(Object userIdOrUsername, ProjectFilter filt * 
GitLab Endpoint: GET /users/:user_id/projects
* * @param userIdOrUsername the user ID, username of the user, or a User instance holding the user ID or username - * @param filter the ProjectFilter instance holding the filter values for the query - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param filter the ProjectFilter instance holding the filter values for the query + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of visible projects owned by the given user * @throws GitLabApiException if any exception occurs */ public Pager getUserProjects(Object userIdOrUsername, ProjectFilter filter, int itemsPerPage) throws GitLabApiException { GitLabApiForm formData = filter.getQueryParams(); return (new Pager(this, Project.class, itemsPerPage, formData.asMap(), - "users", getUserIdOrUsername(userIdOrUsername), "projects")); + "users", getUserIdOrUsername(userIdOrUsername), "projects")); } /** @@ -663,7 +672,7 @@ public Pager getUserProjects(Object userIdOrUsername, ProjectFilter fil * 
GitLab Endpoint: GET /users/:user_id/projects
* * @param userIdOrUsername the user ID, username of the user, or a User instance holding the user ID or username - * @param filter the ProjectFilter instance holding the filter values for the query + * @param filter the ProjectFilter instance holding the filter values for the query * @return a Stream of visible projects owned by the given user * @throws GitLabApiException if any exception occurs */ @@ -681,7 +690,7 @@ public Stream getUserProjectsStream(Object userIdOrUsername, ProjectFil * @throws GitLabApiException if any exception occurs */ public Project getProject(Object projectIdOrPath) throws GitLabApiException { - return (getProject(projectIdOrPath, null, null, null)); + return (getProject(projectIdOrPath, null, null, null)); } /** @@ -705,13 +714,13 @@ public Optional getOptionalProject(Object projectIdOrPath) { * * 
GitLab Endpoint: GET /projects/:id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param includeStatistics include project statistics * @return the specified project * @throws GitLabApiException if any exception occurs */ public Project getProject(Object projectIdOrPath, Boolean includeStatistics) throws GitLabApiException { - return (getProject(projectIdOrPath, includeStatistics, null, null)); + return (getProject(projectIdOrPath, includeStatistics, null, null)); } /** @@ -719,7 +728,7 @@ public Project getProject(Object projectIdOrPath, Boolean includeStatistics) thr * * 
GitLab Endpoint: GET /projects/:id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param includeStatistics include project statistics * @return an Optional instance with the specified project as a value */ @@ -736,21 +745,21 @@ public Optional getOptionalProject(Object projectIdOrPath, Boolean incl * * 
GitLab Endpoint: GET /projects/:id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param includeStatistics include project statistics - * @param includeLicense include project license data + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param includeStatistics include project statistics + * @param includeLicense include project license data * @param withCustomAttributes include custom attributes in response (admins only) * @return the specified project * @throws GitLabApiException if any exception occurs */ public Project getProject(Object projectIdOrPath, Boolean includeStatistics, - Boolean includeLicense, Boolean withCustomAttributes) throws GitLabApiException { + Boolean includeLicense, Boolean withCustomAttributes) throws GitLabApiException { Form formData = new GitLabApiForm() - .withParam("statistics", includeStatistics) - .withParam("license", includeLicense) - .withParam("with_custom_attributes", withCustomAttributes); + .withParam("statistics", includeStatistics) + .withParam("license", includeLicense) + .withParam("with_custom_attributes", withCustomAttributes); Response response = get(Response.Status.OK, formData.asMap(), - "projects", getProjectIdOrPath(projectIdOrPath)); + "projects", getProjectIdOrPath(projectIdOrPath)); return (response.readEntity(Project.class)); } @@ -759,17 +768,17 @@ public Project getProject(Object projectIdOrPath, Boolean includeStatistics, * * 
GitLab Endpoint: GET /projects/:id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param includeStatistics include project statistics - * @param includeLicense include project license data + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param includeStatistics include project statistics + * @param includeLicense include project license data * @param withCustomAttributes include custom attributes in response (admins only) * @return an Optional instance with the specified project as a value */ public Optional getOptionalProject(Object projectIdOrPath, Boolean includeStatistics, - Boolean includeLicense, Boolean withCustomAttributes) { + Boolean includeLicense, Boolean withCustomAttributes) { try { return (Optional.ofNullable(getProject(projectIdOrPath, - includeStatistics, includeLicense, withCustomAttributes))); + includeStatistics, includeLicense, withCustomAttributes))); } catch (GitLabApiException glae) { return (GitLabApi.createOptionalFromException(glae)); } @@ -781,7 +790,7 @@ public Optional getOptionalProject(Object projectIdOrPath, Boolean incl * 
GitLab Endpoint: GET /projects/:id
* * @param namespace the name of the project namespace or group - * @param project the name of the project to get + * @param project the name of the project to get * @return the specified project * @throws GitLabApiException if any exception occurs */ @@ -812,7 +821,7 @@ public Project getProject(String namespace, String project) throws GitLabApiExce * 
GitLab Endpoint: GET /projects/:id
* * @param namespace the name of the project namespace or group - * @param project the name of the project + * @param project the name of the project * @return an Optional instance with the specified project as a value */ public Optional getOptionalProject(String namespace, String project) { @@ -828,8 +837,8 @@ public Optional getOptionalProject(String namespace, String project) { * * 
GitLab Endpoint: GET /projects/:id
* - * @param namespace the name of the project namespace or group - * @param project the name of the project to get + * @param namespace the name of the project namespace or group + * @param project the name of the project to get * @param includeStatistics include project statistics * @return the specified project * @throws GitLabApiException if any exception occurs @@ -861,8 +870,8 @@ public Project getProject(String namespace, String project, Boolean includeStati * * 
GitLab Endpoint: GET /projects/:id
* - * @param namespace the name of the project namespace or group - * @param project the name of the project + * @param namespace the name of the project namespace or group + * @param project the name of the project * @param includeStatistics include project statistics * @return an Optional instance with the specified project as a value */ @@ -892,7 +901,7 @@ public Project createProject(Long namespaceId, String projectName) throws GitLab * Create a new project belonging to the namespace ID and project configuration. A namespace ID is either a user or group ID. * * @param namespaceId the namespace ID to create the project under - * @param project the Project instance holding the new project configuration + * @param project the Project instance holding the new project configuration * @return the created project * @throws GitLabApiException if any exception occurs */ @@ -930,9 +939,9 @@ public Project createProject(String projectName) throws GitLabApiException { */ public Project createProject(String name, String path) throws GitLabApiException { - if ((name == null || name.trim().isEmpty()) && (path == null || path.trim().isEmpty())) { - throw new RuntimeException("Either name or path must be specified."); - } + if ((name == null || name.trim().isEmpty()) && (path == null || path.trim().isEmpty())) { + throw new RuntimeException("Either name or path must be specified."); + } GitLabApiForm formData = new GitLabApiForm().withParam("name", name).withParam("path", path); Response response = post(Response.Status.CREATED, formData, "projects"); @@ -953,7 +962,7 @@ public Project createProject(Project project) throws GitLabApiException { /** * Creates new project owned by the current user. The following properties on the Project instance * are utilized in the creation of the project: - * + *

* name (name or path are required) - new project name * path (name or path are required) - new project path * defaultBranch (optional) - master by default @@ -984,7 +993,7 @@ public Project createProject(Project project) throws GitLabApiException { * ciConfigPath (optional) - Set path to CI configuration file * squashOption (optional) - set squash option for merge requests * - * @param project the Project instance with the configuration for the new project + * @param project the Project instance with the configuration for the new project * @param importUrl the URL to import the repository from * @return a Project instance with the newly created project info * @throws GitLabApiException if any exception occurs @@ -1008,7 +1017,7 @@ public Project createProject(Project project, String importUrl) throws GitLabApi .withParam("default_branch", project.getDefaultBranch()) .withParam("description", project.getDescription()) .withParam("issues_enabled", project.getIssuesEnabled()) - .withParam("merge_method", project.getMergeMethod()) + .withParam("merge_method", project.getMergeMethod()) .withParam("merge_requests_enabled", project.getMergeRequestsEnabled()) .withParam("jobs_enabled", project.getJobsEnabled()) .withParam("wiki_enabled", project.getWikiEnabled()) @@ -1081,8 +1090,8 @@ public Project createProject(Project project, String importUrl) throws GitLabApi */ public InputStream getAvatar(Object projectIdOrPath) throws GitLabApiException { - Response response = getWithAccepts(Response.Status.OK, null, MediaType.MEDIA_TYPE_WILDCARD, - "projects", getProjectIdOrPath(projectIdOrPath), "avatar"); + Response response = getWithAccepts(Response.Status.OK, null, MediaType.MEDIA_TYPE_WILDCARD, + "projects", getProjectIdOrPath(projectIdOrPath), "avatar"); return (response.readEntity(InputStream.class)); } @@ -1090,26 +1099,26 @@ public InputStream getAvatar(Object projectIdOrPath) throws GitLabApiException { /** * Creates a Project * - * @param name The name of the project - * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) - * @param description A description for the project, null otherwise - * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default + * @param name The name of the project + * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) + * @param description A description for the project, null otherwise + * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default * @param mergeRequestsEnabled Whether Merge Requests should be enabled, otherwise null indicates to use GitLab default - * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default - * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default - * @param visibility The visibility of the project, otherwise null indicates to use GitLab default - * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default - * @param importUrl The Import URL for the project, otherwise null + * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default + * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default + * @param visibility The visibility of the project, otherwise null indicates to use GitLab default + * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default + * @param importUrl The Import URL for the project, otherwise null * @return the GitLab Project * @throws GitLabApiException if any exception occurs */ public Project createProject(String name, Long namespaceId, String description, Boolean issuesEnabled, Boolean mergeRequestsEnabled, - Boolean wikiEnabled, Boolean snippetsEnabled, Visibility visibility, Integer visibilityLevel, String importUrl) throws GitLabApiException { + Boolean wikiEnabled, Boolean snippetsEnabled, Visibility visibility, Integer visibilityLevel, String importUrl) throws GitLabApiException { if (isApiVersion(ApiVersion.V3)) { Boolean isPublic = Visibility.PUBLIC == visibility; return (createProject(name, namespaceId, description, issuesEnabled, mergeRequestsEnabled, - wikiEnabled, snippetsEnabled, isPublic, visibilityLevel, importUrl)); + wikiEnabled, snippetsEnabled, isPublic, visibilityLevel, importUrl)); } if (name == null || name.trim().length() == 0) { @@ -1117,16 +1126,16 @@ public Project createProject(String name, Long namespaceId, String description, } GitLabApiForm formData = new GitLabApiForm() - .withParam("name", name, true) - .withParam("namespace_id", namespaceId) - .withParam("description", description) - .withParam("issues_enabled", issuesEnabled) - .withParam("merge_requests_enabled", mergeRequestsEnabled) - .withParam("wiki_enabled", wikiEnabled) - .withParam("snippets_enabled", snippetsEnabled) - .withParam("visibility_level", visibilityLevel) - .withParam("visibility", visibility) - .withParam("import_url", importUrl); + .withParam("name", name, true) + .withParam("namespace_id", namespaceId) + .withParam("description", description) + .withParam("issues_enabled", issuesEnabled) + .withParam("merge_requests_enabled", mergeRequestsEnabled) + .withParam("wiki_enabled", wikiEnabled) + .withParam("snippets_enabled", snippetsEnabled) + .withParam("visibility_level", visibilityLevel) + .withParam("visibility", visibility) + .withParam("import_url", importUrl); Response response = post(Response.Status.CREATED, formData, "projects"); return (response.readEntity(Project.class)); @@ -1135,28 +1144,28 @@ public Project createProject(String name, Long namespaceId, String description, /** * Creates a Project * - * @param name The name of the project - * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) - * @param description A description for the project, null otherwise - * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default - * @param mergeRequestsEnabled Whether Merge Requests should be enabled, otherwise null indicates to use GitLab default - * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default - * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default - * @param visibility The visibility of the project, otherwise null indicates to use GitLab default - * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default + * @param name The name of the project + * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) + * @param description A description for the project, null otherwise + * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default + * @param mergeRequestsEnabled Whether Merge Requests should be enabled, otherwise null indicates to use GitLab default + * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default + * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default + * @param visibility The visibility of the project, otherwise null indicates to use GitLab default + * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default * @param printingMergeRequestLinkEnabled Show link to create/view merge request when pushing from the command line - * @param importUrl The Import URL for the project, otherwise null + * @param importUrl The Import URL for the project, otherwise null * @return the GitLab Project * @throws GitLabApiException if any exception occurs */ public Project createProject(String name, Long namespaceId, String description, Boolean issuesEnabled, Boolean mergeRequestsEnabled, - Boolean wikiEnabled, Boolean snippetsEnabled, Visibility visibility, Integer visibilityLevel, - Boolean printingMergeRequestLinkEnabled, String importUrl) throws GitLabApiException { + Boolean wikiEnabled, Boolean snippetsEnabled, Visibility visibility, Integer visibilityLevel, + Boolean printingMergeRequestLinkEnabled, String importUrl) throws GitLabApiException { if (isApiVersion(ApiVersion.V3)) { Boolean isPublic = Visibility.PUBLIC == visibility; return (createProject(name, namespaceId, description, issuesEnabled, mergeRequestsEnabled, - wikiEnabled, snippetsEnabled, isPublic, visibilityLevel, importUrl)); + wikiEnabled, snippetsEnabled, isPublic, visibilityLevel, importUrl)); } if (name == null || name.trim().length() == 0) { @@ -1164,17 +1173,17 @@ public Project createProject(String name, Long namespaceId, String description, } GitLabApiForm formData = new GitLabApiForm() - .withParam("name", name, true) - .withParam("namespace_id", namespaceId) - .withParam("description", description) - .withParam("issues_enabled", issuesEnabled) - .withParam("merge_requests_enabled", mergeRequestsEnabled) - .withParam("wiki_enabled", wikiEnabled) - .withParam("snippets_enabled", snippetsEnabled) - .withParam("visibility_level", visibilityLevel) - .withParam("visibility", visibility) - .withParam("printing_merge_request_link_enabled", printingMergeRequestLinkEnabled) - .withParam("import_url", importUrl); + .withParam("name", name, true) + .withParam("namespace_id", namespaceId) + .withParam("description", description) + .withParam("issues_enabled", issuesEnabled) + .withParam("merge_requests_enabled", mergeRequestsEnabled) + .withParam("wiki_enabled", wikiEnabled) + .withParam("snippets_enabled", snippetsEnabled) + .withParam("visibility_level", visibilityLevel) + .withParam("visibility", visibility) + .withParam("printing_merge_request_link_enabled", printingMergeRequestLinkEnabled) + .withParam("import_url", importUrl); Response response = post(Response.Status.CREATED, formData, "projects"); return (response.readEntity(Project.class)); @@ -1183,39 +1192,39 @@ public Project createProject(String name, Long namespaceId, String description, /** * Creates a Project * - * @param name The name of the project - * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) - * @param description A description for the project, null otherwise - * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default + * @param name The name of the project + * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) + * @param description A description for the project, null otherwise + * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default * @param mergeRequestsEnabled Whether Merge Requests should be enabled, otherwise null indicates to use GitLab default - * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default - * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default - * @param isPublic Whether the project is public or private, if true same as setting visibilityLevel = 20, otherwise null indicates to use GitLab default - * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default - * @param importUrl The Import URL for the project, otherwise null + * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default + * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default + * @param isPublic Whether the project is public or private, if true same as setting visibilityLevel = 20, otherwise null indicates to use GitLab default + * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default + * @param importUrl The Import URL for the project, otherwise null * @return the GitLab Project * @throws GitLabApiException if any exception occurs * @deprecated As of release 4.2.0, replaced by {@link #createProject(String, Long, String, Boolean, Boolean, - * Boolean, Boolean, Visibility, Integer, String)} + * Boolean, Boolean, Visibility, Integer, String)} */ @Deprecated public Project createProject(String name, Long namespaceId, String description, Boolean issuesEnabled, Boolean mergeRequestsEnabled, - Boolean wikiEnabled, Boolean snippetsEnabled, Boolean isPublic, Integer visibilityLevel, String importUrl) throws GitLabApiException { + Boolean wikiEnabled, Boolean snippetsEnabled, Boolean isPublic, Integer visibilityLevel, String importUrl) throws GitLabApiException { if (name == null || name.trim().length() == 0) { return (null); } GitLabApiForm formData = new GitLabApiForm() - .withParam("name", name, true) - .withParam("namespace_id", namespaceId) - .withParam("description", description) - .withParam("issues_enabled", issuesEnabled) - .withParam("merge_requests_enabled", mergeRequestsEnabled) - .withParam("wiki_enabled", wikiEnabled) - .withParam("snippets_enabled", snippetsEnabled) - .withParam("visibility_level", visibilityLevel) - .withParam("import_url", importUrl); + .withParam("name", name, true) + .withParam("namespace_id", namespaceId) + .withParam("description", description) + .withParam("issues_enabled", issuesEnabled) + .withParam("merge_requests_enabled", mergeRequestsEnabled) + .withParam("wiki_enabled", wikiEnabled) + .withParam("snippets_enabled", snippetsEnabled) + .withParam("visibility_level", visibilityLevel) + .withParam("import_url", importUrl); if (isApiVersion(ApiVersion.V3)) { formData.withParam("public", isPublic); @@ -1230,11 +1239,11 @@ public Project createProject(String name, Long namespaceId, String description, /** * Create a new project from a template, belonging to the namespace ID. A namespace ID is either a user or group ID. * - * @param namespaceId the namespace ID to create the project under - * @param projectName the name of the project top create + * @param namespaceId the namespace ID to create the project under + * @param projectName the name of the project top create * @param groupWithProjectTemplatesId Id of the Gitlab Group, which contains the relevant templates. - * @param templateName name of the template to use - * @param visibility Visibility of the new create project + * @param templateName name of the template to use + * @param visibility Visibility of the new create project * @return the created project * @throws GitLabApiException if any exception occurs */ @@ -1245,8 +1254,7 @@ public Project createProjectFromTemplate(Integer namespaceId, String projectName .withParam("use_custom_template", true) .withParam("group_with_project_templates_id", groupWithProjectTemplatesId, true) .withParam("template_name", templateName, true) - .withParam("visibility", visibility) - ; + .withParam("visibility", visibility); Response response = post(Response.Status.CREATED, formData, "projects"); return (response.readEntity(Project.class)); } @@ -1254,7 +1262,7 @@ public Project createProjectFromTemplate(Integer namespaceId, String projectName /** * Updates a project. The following properties on the Project instance * are utilized in the edit of the project, null values are not updated: - * + *

* id (required) - existing project id, either id or path must be provided * name (optional) - project name * path (optional) - project path, either id or path must be provided @@ -1284,12 +1292,12 @@ public Project createProjectFromTemplate(Integer namespaceId, String projectName * ciConfigPath (optional) - Set path to CI configuration file * ciForwardDeploymentEnabled (optional) - When a new deployment job starts, skip older deployment jobs that are still pending * squashOption (optional) - set squash option for merge requests - * + *

* NOTE: The following parameters specified by the GitLab API edit project are not supported: - * import_url - * tag_list array - * avatar - * initialize_with_readme + * import_url + * tag_list array + * avatar + * initialize_with_readme * * @param project the Project instance with the configuration for the new project * @return a Project instance with the newly updated project info @@ -1310,7 +1318,7 @@ public Project updateProject(Project project) throws GitLabApiException { .withParam("default_branch", project.getDefaultBranch()) .withParam("description", project.getDescription()) .withParam("issues_enabled", project.getIssuesEnabled()) - .withParam("merge_method", project.getMergeMethod()) + .withParam("merge_method", project.getMergeMethod()) .withParam("merge_requests_enabled", project.getMergeRequestsEnabled()) .withParam("jobs_enabled", project.getJobsEnabled()) .withParam("wiki_enabled", project.getWikiEnabled()) @@ -1355,6 +1363,8 @@ public Project updateProject(Project project) throws GitLabApiException { formData.withParam("issue_branch_template", project.getIssueBranchTemplate()); formData.withParam("merge_commit_template", project.getMergeCommitTemplate()); formData.withParam("squash_commit_template", project.getSquashCommitTemplate()); + formData.withParam("merge_requests_template", project.getMergeRequestsTemplate()); + formData.withParam("issues_template", project.getIssuesTemplate()); if (project.getTagList() != null && !project.getTagList().isEmpty()) { formData.withParam("tag_list", String.join(",", project.getTagList())); @@ -1430,9 +1440,9 @@ public Project forkProject(Object projectIdOrPath, Long namespaceId) throws GitL */ public Project forkProject(Object projectIdOrPath, String namespace, String path, String name) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("namespace", namespace, true) - .withParam("path", path) - .withParam("name", name); + .withParam("namespace", namespace, true) + .withParam("path", path) + .withParam("name", name); Response.Status expectedStatus = (isApiVersion(ApiVersion.V3) ? Response.Status.OK : Response.Status.CREATED); Response response = post(expectedStatus, formData, "projects", getProjectIdOrPath(projectIdOrPath), "fork"); return (response.readEntity(Project.class)); @@ -1443,15 +1453,14 @@ public Project forkProject(Object projectIdOrPath, String namespace, String path * * 

GitLab Endpoint: POST /projects/:id/fork/:forkFromId
* - * * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param forkedFromId the ID of the project that was forked from + * @param forkedFromId the ID of the project that was forked from * @return the updated Project instance * @throws GitLabApiException if any exception occurs */ public Project createForkedFromRelationship(Object projectIdOrPath, Long forkedFromId) throws GitLabApiException { Response.Status expectedStatus = (isApiVersion(ApiVersion.V3) ? Response.Status.OK : Response.Status.CREATED); - Response response = post(expectedStatus, (Form)null, "projects", this.getProjectIdOrPath(projectIdOrPath), "fork", forkedFromId); + Response response = post(expectedStatus, (Form) null, "projects", this.getProjectIdOrPath(projectIdOrPath), "fork", forkedFromId); return (response.readEntity(Project.class)); } @@ -1487,14 +1496,15 @@ public List getMembers(Object projectIdOrPath) throws GitLabApiException * 
GitLab Endpoint: GET /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param page the page to get - * @param perPage the number of Member instances per page + * @param page the page to get + * @param perPage the number of Member instances per page * @return the members belonging to the specified project * @throws GitLabApiException if any exception occurs */ public List getMembers(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "members"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -1503,7 +1513,7 @@ public List getMembers(Object projectIdOrPath, int page, int perPage) th * 
GitLab Endpoint: GET /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return the members belonging to the specified project * @throws GitLabApiException if any exception occurs */ @@ -1549,17 +1559,18 @@ public List getAllMembers(Object projectIdOrPath) throws GitLabApiExcept * 
GitLab Endpoint: GET /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param page the page to get - * @param perPage the number of Member instances per page + * @param page the page to get + * @param perPage the number of Member instances per page * @return the project members viewable by the authenticated user, including inherited members through ancestor groups * @throws GitLabApiException if any exception occurs - * @deprecated Will be removed in version 6.0 + * @deprecated Will be removed in version 6.0 */ @Deprecated public List getAllMembers(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), - "projects", getProjectIdOrPath(projectIdOrPath), "members", "all"); - return (response.readEntity(new GenericType>() {})); + "projects", getProjectIdOrPath(projectIdOrPath), "members", "all"); + return (response.readEntity(new GenericType>() { + })); } /** @@ -1571,7 +1582,7 @@ public List getAllMembers(Object projectIdOrPath, int page, int perPage) * 
GitLab Endpoint: GET /projects/:id/members/all
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the project members viewable by the authenticated user, * including inherited members through ancestor groups * @throws GitLabApiException if any exception occurs @@ -1606,8 +1617,8 @@ public Stream getAllMembersStream(Object projectIdOrPath) throws GitLabA * 
GitLab Endpoint: GET /projects/:id/members/all
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param query a query string to search for members - * @param userIds filter the results on the given user IDs + * @param query a query string to search for members + * @param userIds filter the results on the given user IDs * @return the project members viewable by the authenticated user, including inherited members through ancestor groups * @throws GitLabApiException if any exception occurs */ @@ -1624,9 +1635,9 @@ public List getAllMembers(Object projectIdOrPath, String query, ListGitLab Endpoint: GET /projects/:id/members/all * * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param query a query string to search for members - * @param userIds filter the results on the given user IDs - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param query a query string to search for members + * @param userIds filter the results on the given user IDs + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the project members viewable by the authenticated user, * including inherited members through ancestor groups * @throws GitLabApiException if any exception occurs @@ -1634,7 +1645,7 @@ public List getAllMembers(Object projectIdOrPath, String query, List getAllMembers(Object projectIdOrPath, String query, List userIds, int itemsPerPage) throws GitLabApiException { GitLabApiForm form = new GitLabApiForm().withParam("query", query).withParam("user_ids", userIds); return (new Pager(this, Member.class, itemsPerPage, form.asMap(), - "projects", getProjectIdOrPath(projectIdOrPath), "members", "all")); + "projects", getProjectIdOrPath(projectIdOrPath), "members", "all")); } /** @@ -1646,8 +1657,8 @@ public Pager getAllMembers(Object projectIdOrPath, String query, ListGitLab Endpoint: GET /projects/:id/members/all * * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param query a query string to search for members - * @param userIds filter the results on the given user IDs + * @param query a query string to search for members + * @param userIds filter the results on the given user IDs * @return a Stream of the project members viewable by the authenticated user, * including inherited members through ancestor groups * @throws GitLabApiException if any exception occurs @@ -1662,7 +1673,7 @@ public Stream getAllMembersStream(Object projectIdOrPath, String query, * 
GitLab Endpoint: GET /projects/:id/members/:user_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member + * @param userId the user ID of the member * @return the member specified by the project ID/user ID pair * @throws GitLabApiException if any exception occurs */ @@ -1676,10 +1687,10 @@ public Member getMember(Object projectIdOrPath, Long userId) throws GitLabApiExc * 
GitLab Endpoint: GET /projects/:id/members/:user_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member + * @param userId the user ID of the member * @return the member specified by the project ID/user ID pair */ - public Optional getOptionalMember(Object projectIdOrPath, Long userId) { + public Optional getOptionalMember(Object projectIdOrPath, Long userId) { try { return (Optional.ofNullable(getMember(projectIdOrPath, userId, false))); } catch (GitLabApiException glae) { @@ -1692,8 +1703,8 @@ public Optional getOptionalMember(Object projectIdOrPath, Long userId) * * 
GitLab Endpoint: GET /projects/:id/members/all/:user_id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param userId the user ID of the member * @param includeInherited if true will the member even if inherited thru an ancestor group * @return the member specified by the project ID/user ID pair * @throws GitLabApiException if any exception occurs @@ -1713,12 +1724,12 @@ public Member getMember(Object projectIdOrPath, Long userId, Boolean includeInhe * * 
GitLab Endpoint: GET /projects/:id/members/all/:user_id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param userId the user ID of the member * @param includeInherited if true will the member even if inherited thru an ancestor group * @return the member specified by the project ID/user ID pair as the value of an Optional */ - public Optional getOptionalMember(Object projectIdOrPath, Long userId, Boolean includeInherited) { + public Optional getOptionalMember(Object projectIdOrPath, Long userId, Boolean includeInherited) { try { return (Optional.ofNullable(getMember(projectIdOrPath, userId, includeInherited))); } catch (GitLabApiException glae) { @@ -1734,8 +1745,8 @@ public Optional getOptionalMember(Object projectIdOrPath, Long userId, B * 
GitLab Endpoint: POST /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to add, required - * @param accessLevel the access level for the new member, required + * @param userId the user ID of the member to add, required + * @param accessLevel the access level for the new member, required * @return the added member * @throws GitLabApiException if any exception occurs */ @@ -1751,8 +1762,8 @@ public Member addMember(Object projectIdOrPath, Long userId, Integer accessLevel * 
GitLab Endpoint: POST /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to add, required - * @param accessLevel the access level for the new member, required + * @param userId the user ID of the member to add, required + * @param accessLevel the access level for the new member, required * @return the added member * @throws GitLabApiException if any exception occurs */ @@ -1768,9 +1779,9 @@ public Member addMember(Object projectIdOrPath, Long userId, AccessLevel accessL * 
GitLab Endpoint: POST /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to add - * @param accessLevel the access level for the new member - * @param expiresAt the date the membership in the group will expire + * @param userId the user ID of the member to add + * @param accessLevel the access level for the new member + * @param expiresAt the date the membership in the group will expire * @return the added member * @throws GitLabApiException if any exception occurs */ @@ -1786,17 +1797,17 @@ public Member addMember(Object projectIdOrPath, Long userId, AccessLevel accessL * 
GitLab Endpoint: POST /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to add - * @param accessLevel the access level for the new member - * @param expiresAt the date the membership in the group will expire + * @param userId the user ID of the member to add + * @param accessLevel the access level for the new member + * @param expiresAt the date the membership in the group will expire * @return the added member * @throws GitLabApiException if any exception occurs */ public Member addMember(Object projectIdOrPath, Long userId, Integer accessLevel, Date expiresAt) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("user_id", userId, true) - .withParam("access_level", accessLevel, true) - .withParam("expires_at", expiresAt, false); + .withParam("user_id", userId, true) + .withParam("access_level", accessLevel, true) + .withParam("expires_at", expiresAt, false); Response response = post(Response.Status.CREATED, formData, "projects", getProjectIdOrPath(projectIdOrPath), "members"); return (response.readEntity(Member.class)); } @@ -1807,8 +1818,8 @@ public Member addMember(Object projectIdOrPath, Long userId, Integer accessLevel * 
GitLab Endpoint: PUT /projects/:projectId/members/:userId
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to update, required - * @param accessLevel the new access level for the member, required + * @param userId the user ID of the member to update, required + * @param accessLevel the new access level for the member, required * @return the updated member * @throws GitLabApiException if any exception occurs */ @@ -1822,8 +1833,8 @@ public Member updateMember(Object projectIdOrPath, Long userId, Integer accessLe * 
GitLab Endpoint: PUT /projects/:projectId/members/:userId
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to update, required - * @param accessLevel the new access level for the member, required + * @param userId the user ID of the member to update, required + * @param accessLevel the new access level for the member, required * @return the updated member * @throws GitLabApiException if any exception occurs */ @@ -1837,9 +1848,9 @@ public Member updateMember(Object projectIdOrPath, Long userId, AccessLevel acce * 
GitLab Endpoint: PUT /projects/:projectId/members/:userId
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to update, required - * @param accessLevel the new access level for the member, required - * @param expiresAt the date the membership in the group will expire, optional + * @param userId the user ID of the member to update, required + * @param accessLevel the new access level for the member, required + * @param expiresAt the date the membership in the group will expire, optional * @return the updated member * @throws GitLabApiException if any exception occurs */ @@ -1853,16 +1864,16 @@ public Member updateMember(Object projectIdOrPath, Long userId, AccessLevel acce * 
GitLab Endpoint: PUT /projects/:projectId/members/:userId
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param userId the user ID of the member to update, required - * @param accessLevel the new access level for the member, required - * @param expiresAt the date the membership in the group will expire, optional + * @param userId the user ID of the member to update, required + * @param accessLevel the new access level for the member, required + * @param expiresAt the date the membership in the group will expire, optional * @return the updated member * @throws GitLabApiException if any exception occurs */ public Member updateMember(Object projectIdOrPath, Long userId, Integer accessLevel, Date expiresAt) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("access_level", accessLevel, true) - .withParam("expires_at", expiresAt, false); + .withParam("access_level", accessLevel, true) + .withParam("expires_at", expiresAt, false); Response response = put(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "members", userId); return (response.readEntity(Member.class)); } @@ -1873,7 +1884,7 @@ public Member updateMember(Object projectIdOrPath, Long userId, Integer accessLe * 
GitLab Endpoint: DELETE /projects/:id/members/:user_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param userId the user ID of the member to remove + * @param userId the user ID of the member to remove * @throws GitLabApiException if any exception occurs */ public void removeMember(Object projectIdOrPath, Long userId) throws GitLabApiException { @@ -1900,7 +1911,7 @@ public List getProjectUsers(Object projectIdOrPath) throws GitLabAp * 
GitLab Endpoint: GET /projects/:id/users
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the users matching the search string and belonging to the specified project and its parent groups * @throws GitLabApiException if any exception occurs */ @@ -1928,7 +1939,7 @@ public Stream getProjectUsersStream(Object projectIdOrPath) throws * 
GitLab Endpoint: GET /projects/:id/users
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param search the string to match specific users + * @param search the string to match specific users * @return the users matching the search string and belonging to the specified project and its parent groups * @throws GitLabApiException if any exception occurs */ @@ -1943,15 +1954,15 @@ public List getProjectUsers(Object projectIdOrPath, String search) * 
GitLab Endpoint: GET /projects/:id/users
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param search the string to match specific users - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param search the string to match specific users + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the users matching the search string and belonging to the specified project and its parent groups * @throws GitLabApiException if any exception occurs */ public Pager getProjectUsers(Object projectIdOrPath, String search, int itemsPerPage) throws GitLabApiException { MultivaluedMap params = (search != null ? new GitLabApiForm().withParam("search", search).asMap() : null); return (new Pager(this, ProjectUser.class, itemsPerPage, params, - "projects", getProjectIdOrPath(projectIdOrPath), "users")); + "projects", getProjectIdOrPath(projectIdOrPath), "users")); } /** @@ -1961,7 +1972,7 @@ public Pager getProjectUsers(Object projectIdOrPath, String search, * 
GitLab Endpoint: GET /projects/:id/users
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param search the string to match specific users + * @param search the string to match specific users * @return a Stream of the users matching the search string and belonging to the specified project and its parent groups * @throws GitLabApiException if any exception occurs */ @@ -1988,7 +1999,7 @@ public List getProjectGroups(Object projectIdOrPath) throws GitLab * 
GitLab Endpoint: GET /projects/:id/groups
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the ancestor groups for a given project * @throws GitLabApiException if any exception occurs */ @@ -2015,7 +2026,7 @@ public Stream getProjectGroupsStream(Object projectIdOrPath) throw * 
GitLab Endpoint: GET /projects/:id/groups
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param filter the ProjectGroupsFilter to match against + * @param filter the ProjectGroupsFilter to match against * @return the ancestor groups for a given project * @throws GitLabApiException if any exception occurs */ @@ -2029,8 +2040,8 @@ public List getProjectGroups(Object projectIdOrPath, ProjectGroups * 
GitLab Endpoint: GET /projects/:id/groups
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param filter the ProjectGroupsFilter to match against - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param filter the ProjectGroupsFilter to match against + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the ancestor groups for a given project * @throws GitLabApiException if any exception occurs */ @@ -2045,7 +2056,7 @@ public Pager getProjectGroups(Object projectIdOrPath, ProjectGroup * 
GitLab Endpoint: GET /projects/:id/groups
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param filter the ProjectGroupsFilter to match against + * @param filter the ProjectGroupsFilter to match against * @return a Stream of the ancestor groups for a given project * @throws GitLabApiException if any exception occurs */ @@ -2072,14 +2083,15 @@ public List getProjectEvents(Object projectIdOrPath) throws GitLabApiExce * 
GitLab Endpoint: GET /projects/:id/events
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of Event instances per page + * @param page the page to get + * @param perPage the number of Event instances per page * @return the project events for the specified project * @throws GitLabApiException if any exception occurs */ public List getProjectEvents(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "events"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -2088,7 +2100,7 @@ public List getProjectEvents(Object projectIdOrPath, int page, int perPag * 
GitLab Endpoint: GET /projects/:id/events
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of project events for the specified project * @throws GitLabApiException if any exception occurs */ @@ -2128,14 +2140,15 @@ public List getHooks(Object projectIdOrPath) throws GitLabApiExcept * 
GitLab Endpoint: GET /projects/:id/hooks
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of ProjectHook instances per page + * @param page the page to get + * @param perPage the number of ProjectHook instances per page * @return a list of project hooks for the specified project in the specified page range * @throws GitLabApiException if any exception occurs */ public List getHooks(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "hooks"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -2144,7 +2157,7 @@ public List getHooks(Object projectIdOrPath, int page, int perPage) * 
GitLab Endpoint: GET /projects/:id/hooks
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of project hooks for the specified project * @throws GitLabApiException if any exception occurs */ @@ -2171,7 +2184,7 @@ public Stream getHooksStream(Object projectIdOrPath) throws GitLabA * 
GitLab Endpoint: GET /projects/:id/hooks/:hook_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param hookId the ID of the hook to get + * @param hookId the ID of the hook to get * @return the project hook for the specified project ID/hook ID pair * @throws GitLabApiException if any exception occurs */ @@ -2186,7 +2199,7 @@ public ProjectHook getHook(Object projectIdOrPath, Long hookId) throws GitLabApi * 
GitLab Endpoint: GET /projects/:id/hooks/:hook_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param hookId the ID of the hook to get + * @param hookId the ID of the hook to get * @return the project hook for the specified project ID/hook ID pair as an Optional instance */ public Optional getOptionalHook(Object projectIdOrPath, Long hookId) { @@ -2202,36 +2215,36 @@ public Optional getOptionalHook(Object projectIdOrPath, Long hookId * * 
GitLab Endpoint: POST /projects/:id/hooks
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param url the callback URL for the hook - * @param enabledHooks a ProjectHook instance specifying which hooks to enable + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param url the callback URL for the hook + * @param enabledHooks a ProjectHook instance specifying which hooks to enable * @param enableSslVerification enable SSL verification - * @param secretToken the secret token to pass back to the hook + * @param secretToken the secret token to pass back to the hook * @return the added ProjectHook instance * @throws GitLabApiException if any exception occurs */ public ProjectHook addHook(Object projectIdOrPath, String url, ProjectHook enabledHooks, - Boolean enableSslVerification, String secretToken) throws GitLabApiException { + Boolean enableSslVerification, String secretToken) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("url", url, true) - .withParam("push_events", enabledHooks.getPushEvents(), false) - .withParam("push_events_branch_filter", enabledHooks.getPushEventsBranchFilter(), false) - .withParam("issues_events", enabledHooks.getIssuesEvents(), false) - .withParam("confidential_issues_events", enabledHooks.getConfidentialIssuesEvents(), false) - .withParam("merge_requests_events", enabledHooks.getMergeRequestsEvents(), false) - .withParam("tag_push_events", enabledHooks.getTagPushEvents(), false) - .withParam("note_events", enabledHooks.getNoteEvents(), false) - .withParam("confidential_note_events", enabledHooks.getConfidentialNoteEvents(), false) - .withParam("job_events", enabledHooks.getJobEvents(), false) - .withParam("pipeline_events", enabledHooks.getPipelineEvents(), false) - .withParam("wiki_page_events", enabledHooks.getWikiPageEvents(), false) - .withParam("enable_ssl_verification", enableSslVerification, false) - .withParam("repository_update_events", enabledHooks.getRepositoryUpdateEvents(), false) - .withParam("deployment_events", enabledHooks.getDeploymentEvents(), false) - .withParam("releases_events", enabledHooks.getReleasesEvents(), false) - .withParam("deployment_events", enabledHooks.getDeploymentEvents(), false) - .withParam("token", secretToken, false); + .withParam("url", url, true) + .withParam("push_events", enabledHooks.getPushEvents(), false) + .withParam("push_events_branch_filter", enabledHooks.getPushEventsBranchFilter(), false) + .withParam("issues_events", enabledHooks.getIssuesEvents(), false) + .withParam("confidential_issues_events", enabledHooks.getConfidentialIssuesEvents(), false) + .withParam("merge_requests_events", enabledHooks.getMergeRequestsEvents(), false) + .withParam("tag_push_events", enabledHooks.getTagPushEvents(), false) + .withParam("note_events", enabledHooks.getNoteEvents(), false) + .withParam("confidential_note_events", enabledHooks.getConfidentialNoteEvents(), false) + .withParam("job_events", enabledHooks.getJobEvents(), false) + .withParam("pipeline_events", enabledHooks.getPipelineEvents(), false) + .withParam("wiki_page_events", enabledHooks.getWikiPageEvents(), false) + .withParam("enable_ssl_verification", enableSslVerification, false) + .withParam("repository_update_events", enabledHooks.getRepositoryUpdateEvents(), false) + .withParam("deployment_events", enabledHooks.getDeploymentEvents(), false) + .withParam("releases_events", enabledHooks.getReleasesEvents(), false) + .withParam("deployment_events", enabledHooks.getDeploymentEvents(), false) + .withParam("token", secretToken, false); Response response = post(Response.Status.CREATED, formData, "projects", getProjectIdOrPath(projectIdOrPath), "hooks"); return (response.readEntity(ProjectHook.class)); } @@ -2242,42 +2255,42 @@ public ProjectHook addHook(Object projectIdOrPath, String url, ProjectHook enabl * * 
GitLab Endpoint: POST /projects/:id/hooks
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param url the callback URL for the hook - * @param doPushEvents flag specifying whether to do push events - * @param doIssuesEvents flag specifying whether to do issues events + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param url the callback URL for the hook + * @param doPushEvents flag specifying whether to do push events + * @param doIssuesEvents flag specifying whether to do issues events * @param doMergeRequestsEvents flag specifying whether to do merge requests events * @return the added ProjectHook instance * @throws GitLabApiException if any exception occurs */ public ProjectHook addHook(Object projectIdOrPath, String url, boolean doPushEvents, - boolean doIssuesEvents, boolean doMergeRequestsEvents) throws GitLabApiException { + boolean doIssuesEvents, boolean doMergeRequestsEvents) throws GitLabApiException { return addHook(projectIdOrPath, url, doPushEvents, doIssuesEvents, doMergeRequestsEvents, null); } - + /** * Adds a hook to project. * Convenience method for {@link #addHook(Object, String, ProjectHook, Boolean, String)} * * 
GitLab Endpoint: POST /projects/:id/hooks
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param url the callback URL for the hook - * @param doPushEvents flag specifying whether to do push events - * @param doIssuesEvents flag specifying whether to do issues events + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param url the callback URL for the hook + * @param doPushEvents flag specifying whether to do push events + * @param doIssuesEvents flag specifying whether to do issues events * @param doMergeRequestsEvents flag specifying whether to do merge requests events - * @param doNoteEvents flag specifying whether to do note events + * @param doNoteEvents flag specifying whether to do note events * @return the added ProjectHook instance * @throws GitLabApiException if any exception occurs */ public ProjectHook addHook(Object projectIdOrPath, String url, Boolean doPushEvents, - Boolean doIssuesEvents, Boolean doMergeRequestsEvents, Boolean doNoteEvents) throws GitLabApiException { + Boolean doIssuesEvents, Boolean doMergeRequestsEvents, Boolean doNoteEvents) throws GitLabApiException { ProjectHook enabledHooks = new ProjectHook() .withPushEvents(doPushEvents) .withIssuesEvents(doIssuesEvents) .withMergeRequestsEvents(doMergeRequestsEvents) .withNoteEvents(doNoteEvents); - return addHook(projectIdOrPath, url, enabledHooks , null, null); + return addHook(projectIdOrPath, url, enabledHooks, null, null); } /** @@ -2286,7 +2299,7 @@ public ProjectHook addHook(Object projectIdOrPath, String url, Boolean doPushEve * 
GitLab Endpoint: DELETE /projects/:id/hooks/:hook_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param hookId the project hook ID to delete + * @param hookId the project hook ID to delete * @throws GitLabApiException if any exception occurs */ public void deleteHook(Object projectIdOrPath, Long hookId) throws GitLabApiException { @@ -2361,8 +2374,8 @@ public List getIssues(Object projectIdOrPath) throws GitLabApiException { * 
GitLab Endpoint: GET /projects/:id/issues
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of issues per page + * @param page the page to get + * @param perPage the number of issues per page * @return the list of issues in the specified range * @throws GitLabApiException if any exception occurs * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#getIssues(Object, int, int)} @@ -2370,7 +2383,8 @@ public List getIssues(Object projectIdOrPath) throws GitLabApiException { @Deprecated public List getIssues(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "issues"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -2379,7 +2393,7 @@ public List getIssues(Object projectIdOrPath, int page, int perPage) thro * 
GitLab Endpoint: GET /projects/:id/issues
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of issues per page + * @param itemsPerPage the number of issues per page * @return the list of issues in the specified range * @throws GitLabApiException if any exception occurs * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#getIssues(Object, int)} @@ -2410,10 +2424,10 @@ public Stream getIssuesStream(Object projectIdOrPath) throws GitLabApiExc * 
GitLab Endpoint: GET /projects/:id/issues/:issue_iid
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param issueId the internal ID of a project's issue + * @param issueId the internal ID of a project's issue * @return the specified Issue instance * @throws GitLabApiException if any exception occurs - * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#getIssue(Object, Long)} + * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#getIssue(Object, Long)} */ @Deprecated public Issue getIssue(Object projectIdOrPath, Long issueId) throws GitLabApiException { @@ -2427,9 +2441,9 @@ public Issue getIssue(Object projectIdOrPath, Long issueId) throws GitLabApiExce * 
GitLab Endpoint: DELETE /projects/:id/issues/:issue_iid
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param issueId the internal ID of a project's issue + * @param issueId the internal ID of a project's issue * @throws GitLabApiException if any exception occurs - * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#deleteIssue(Object, Long)} + * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#deleteIssue(Object, Long)} */ @Deprecated public void deleteIssue(Object projectIdOrPath, Long issueId) throws GitLabApiException { @@ -2456,14 +2470,15 @@ public List getSnippets(Object projectIdOrPath) throws GitLabApiExcepti * 
GitLab Endpoint: GET /projects/:id/snippets
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of snippets per page + * @param page the page to get + * @param perPage the number of snippets per page * @return a list of project's snippets for the specified range * @throws GitLabApiException if any exception occurs */ public List getSnippets(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "snippets"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -2472,7 +2487,7 @@ public List getSnippets(Object projectIdOrPath, int page, int perPage) * 
GitLab Endpoint: GET /projects/:id/snippets
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of snippets per page + * @param itemsPerPage the number of snippets per page * @return the Pager of snippets * @throws GitLabApiException if any exception occurs */ @@ -2499,7 +2514,7 @@ public Stream getSnippetsStream(Object projectIdOrPath) throws GitLabAp * 
GitLab Endpoint: GET /projects/:id/snippets/:snippet_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param snippetId the ID of the project's snippet + * @param snippetId the ID of the project's snippet * @return the specified project Snippet * @throws GitLabApiException if any exception occurs */ @@ -2514,7 +2529,7 @@ public Snippet getSnippet(Object projectIdOrPath, Long snippetId) throws GitLabA * 
GitLab Endpoint: GET /projects/:id/snippets/:snippet_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param snippetId the ID of the project's snippet + * @param snippetId the ID of the project's snippet * @return the specified project Snippet as an Optional instance */ public Optional getOptionalSnippet(Object projectIdOrPath, Long snippetId) { @@ -2531,25 +2546,25 @@ public Optional getOptionalSnippet(Object projectIdOrPath, Long snippet * 
GitLab Endpoint: POST /projects/:id/snippets
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param title the title of a snippet, required - * @param filename the name of a snippet file, required - * @param description the description of a snippet, optional - * @param content the content of a snippet, required - * @param visibility the snippet's visibility, required + * @param title the title of a snippet, required + * @param filename the name of a snippet file, required + * @param description the description of a snippet, optional + * @param content the content of a snippet, required + * @param visibility the snippet's visibility, required * @return a Snippet instance with info on the created snippet * @throws GitLabApiException if any exception occurs */ public Snippet createSnippet(Object projectIdOrPath, String title, String filename, String description, - String content, Visibility visibility) throws GitLabApiException { + String content, Visibility visibility) throws GitLabApiException { try { GitLabApiForm form = new GitLabApiForm() - .withParam("title", title, true) - .withParam("file_name", filename, true) - .withParam("description", description) - .withParam("content", content, true) - .withParam("visibility", visibility, true); + .withParam("title", title, true) + .withParam("file_name", filename, true) + .withParam("description", description) + .withParam("content", content, true) + .withParam("visibility", visibility, true); Response response = post(Response.Status.CREATED, form, "projects", getProjectIdOrPath(projectIdOrPath), "snippets"); return (response.readEntity(Snippet.class)); @@ -2562,11 +2577,11 @@ public Snippet createSnippet(Object projectIdOrPath, String title, String filena } GitLabApiForm form = new GitLabApiForm() - .withParam("title", title, true) - .withParam("file_name", filename, true) - .withParam("description", description) - .withParam("code", content, true) - .withParam("visibility", visibility, true); + .withParam("title", title, true) + .withParam("file_name", filename, true) + .withParam("description", description) + .withParam("code", content, true) + .withParam("visibility", visibility, true); Response response = post(Response.Status.CREATED, form, "projects", getProjectIdOrPath(projectIdOrPath), "snippets"); return (response.readEntity(Snippet.class)); @@ -2579,24 +2594,24 @@ public Snippet createSnippet(Object projectIdOrPath, String title, String filena * 
GitLab Endpoint: PUT /projects/:id/snippets/:snippet_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param snippetId the ID of a project's snippet, required - * @param title the title of a snippet, optional - * @param filename the name of a snippet file, optional - * @param description the description of a snippet, optioptionalonal - * @param code the content of a snippet, optional - * @param visibility the snippet's visibility, reqoptionaluired + * @param snippetId the ID of a project's snippet, required + * @param title the title of a snippet, optional + * @param filename the name of a snippet file, optional + * @param description the description of a snippet, optioptionalonal + * @param code the content of a snippet, optional + * @param visibility the snippet's visibility, reqoptionaluired * @return a Snippet instance with info on the updated snippet * @throws GitLabApiException if any exception occurs */ public Snippet updateSnippet(Object projectIdOrPath, Long snippetId, String title, String filename, String description, - String code, Visibility visibility) throws GitLabApiException { + String code, Visibility visibility) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("title", title) - .withParam("file_name", filename) - .withParam("description", description) - .withParam("code", code) - .withParam("visibility", visibility); + .withParam("title", title) + .withParam("file_name", filename) + .withParam("description", description) + .withParam("code", code) + .withParam("visibility", visibility); Response response = put(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "snippets", snippetId); return (response.readEntity(Snippet.class)); @@ -2622,7 +2637,7 @@ public void deleteSnippet(Object projectIdOrPath, Long snippetId) throws GitLabA * 
GitLab Endpoint: GET /projects/:id/snippets/:snippet_id/raw
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param snippetId the ID of the project's snippet + * @param snippetId the ID of the project's snippet * @return the raw project snippet plain text as an Optional instance * @throws GitLabApiException if any exception occurs */ @@ -2637,7 +2652,7 @@ public String getRawSnippetContent(Object projectIdOrPath, Long snippetId) throw * 
GitLab Endpoint: GET /projects/:id/snippets/:snippet_id/raw
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param snippetId the ID of the project's snippet + * @param snippetId the ID of the project's snippet * @return the raw project snippet plain text as an Optional instance */ public Optional getOptionalRawSnippetContent(Object projectIdOrPath, Long snippetId) { @@ -2654,13 +2669,13 @@ public Optional getOptionalRawSnippetContent(Object projectIdOrPath, Lon * 
GitLab Endpoint: POST /projects/:id/share
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param groupId the ID of the group to share with, required - * @param accessLevel the permissions level to grant the group, required - * @param expiresAt the share expiration date, optional + * @param groupId the ID of the group to share with, required + * @param accessLevel the permissions level to grant the group, required + * @param expiresAt the share expiration date, optional * @throws GitLabApiException if any exception occurs */ public void shareProject(Object projectIdOrPath, Long groupId, AccessLevel accessLevel, Date expiresAt) - throws GitLabApiException { + throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() .withParam("group_id", groupId, true) .withParam("group_access", accessLevel, true) @@ -2674,7 +2689,7 @@ public void shareProject(Object projectIdOrPath, Long groupId, AccessLevel acces * 
GitLab Endpoint: DELETE /projects/:id/share/:group_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param groupId the ID of the group to unshare, required + * @param groupId the ID of the group to unshare, required * @throws GitLabApiException if any exception occurs */ public void unshareProject(Object projectIdOrPath, Long groupId) throws GitLabApiException { @@ -2692,7 +2707,7 @@ public void unshareProject(Object projectIdOrPath, Long groupId) throws GitLabAp * @throws GitLabApiException if any exception occurs */ public Project archiveProject(Object projectIdOrPath) - throws GitLabApiException { + throws GitLabApiException { Response response = post(Response.Status.CREATED, (new GitLabApiForm()), "projects", getProjectIdOrPath(projectIdOrPath), "archive"); return (response.readEntity(Project.class)); } @@ -2707,7 +2722,7 @@ public Project archiveProject(Object projectIdOrPath) * @throws GitLabApiException if any exception occurs */ public Project unarchiveProject(Object projectIdOrPath) - throws GitLabApiException { + throws GitLabApiException { Response response = post(Response.Status.CREATED, (new GitLabApiForm()), "projects", getProjectIdOrPath(projectIdOrPath), "unarchive"); return (response.readEntity(Project.class)); } @@ -2718,7 +2733,7 @@ public Project unarchiveProject(Object projectIdOrPath) * 
GitLab Endpoint: POST /projects/:id/uploads
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param fileToUpload the File instance of the file to upload, required + * @param fileToUpload the File instance of the file to upload, required * @return a FileUpload instance with information on the just uploaded file * @throws GitLabApiException if any exception occurs */ @@ -2732,8 +2747,8 @@ public FileUpload uploadFile(Object projectIdOrPath, File fileToUpload) throws G * 
GitLab Endpoint: POST /projects/:id/uploads
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param fileToUpload the File instance of the file to upload, required - * @param mediaType unused; will be removed in the next major version + * @param fileToUpload the File instance of the file to upload, required + * @param mediaType unused; will be removed in the next major version * @return a FileUpload instance with information on the just uploaded file * @throws GitLabApiException if any exception occurs */ @@ -2749,9 +2764,9 @@ public FileUpload uploadFile(Object projectIdOrPath, File fileToUpload, String m * 
GitLab Endpoint: POST /projects/:id/uploads
* * @param projectIdOrPath the project in the form of an Integer(ID), String(path), or Project instance, required - * @param inputStream the data to upload, required - * @param filename The filename of the file to upload - * @param mediaType unused; will be removed in the next major version + * @param inputStream the data to upload, required + * @param filename The filename of the file to upload + * @param mediaType unused; will be removed in the next major version * @return a FileUpload instance with information on the just uploaded file * @throws GitLabApiException if any exception occurs */ @@ -2778,10 +2793,10 @@ public PushRules getPushRules(Object projectIdOrPath) throws GitLabApiException * Adds a push rule to a specified project. * * 
GitLab Endpoint: POST /projects/:id/push_rule
- * + *

* The following properties on the PushRules instance are utilized in the creation of the push rule: * - * + * * denyDeleteTag (optional) - Deny deleting a tag * memberCheck (optional) - Restrict commits by author (email) to existing GitLab users * preventSecrets (optional) - GitLab will reject any files that are likely to contain secrets @@ -2793,10 +2808,10 @@ public PushRules getPushRules(Object projectIdOrPath) throws GitLabApiException * maxFileSize (optional) - Maximum file size (MB) * commitCommitterCheck (optional) - Users can only push commits to this repository that were committed with one of their own verified emails. * rejectUnsignedCommits (optional) - Reject commit when it is not signed through GPG - * + * * * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param pushRule the PushRule instance containing the push rule configuration to add + * @param pushRule the PushRule instance containing the push rule configuration to add * @return a PushRules instance with the newly created push rule info * @throws GitLabApiException if any exception occurs */ @@ -2822,10 +2837,10 @@ public PushRules createPushRules(Object projectIdOrPath, PushRules pushRule) thr * Updates a push rule for the specified project. * * 

GitLab Endpoint: PUT /projects/:id/push_rule/:push_rule_id
- * + *

* The following properties on the PushRules instance are utilized when updating the push rule: * - * + * * denyDeleteTag (optional) - Deny deleting a tag * memberCheck (optional) - Restrict commits by author (email) to existing GitLab users * preventSecrets (optional) - GitLab will reject any files that are likely to contain secrets @@ -2837,10 +2852,10 @@ public PushRules createPushRules(Object projectIdOrPath, PushRules pushRule) thr * maxFileSize (optional) - Maximum file size (MB) * commitCommitterCheck (optional) - Users can only push commits to this repository that were committed with one of their own verified emails. * rejectUnsignedCommits (optional) - Reject commit when it is not signed through GPG - * + * * * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param pushRule the PushRules instance containing the push rule configuration to update + * @param pushRule the PushRules instance containing the push rule configuration to update * @return a PushRules instance with the newly created push rule info * @throws GitLabApiException if any exception occurs */ @@ -2894,14 +2909,15 @@ public List getForks(Object projectIdOrPath) throws GitLabApiException * 

GitLab Endpoint: GET /projects/:id/forks
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of projects per page + * @param page the page to get + * @param perPage the number of projects per page * @return a List of forked projects * @throws GitLabApiException if any exception occurs */ public List getForks(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { - Response response = get(Response.Status.OK, getPageQueryParams(page, perPage),"projects", getProjectIdOrPath(projectIdOrPath), "forks"); - return (response.readEntity(new GenericType>() { })); + Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "forks"); + return (response.readEntity(new GenericType>() { + })); } /** @@ -2910,7 +2926,7 @@ public List getForks(Object projectIdOrPath, int page, int perPage) thr * 
GitLab Endpoint: GET /projects/:id/forks
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of projects * @throws GitLabApiException if any exception occurs */ @@ -2973,7 +2989,8 @@ public Project unstarProject(Object projectIdOrPath) throws GitLabApiException { */ public Map getProjectLanguages(Object projectIdOrPath) throws GitLabApiException { Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "languages"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -2982,7 +2999,7 @@ public Map getProjectLanguages(Object projectIdOrPath) throws Git * 
GitLab Endpoint: PUT /projects/:id/transfer.
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param namespace the namespace to transfer the project to + * @param namespace the namespace to transfer the project to * @return the updated Project * @throws GitLabApiException if any exception occurs */ @@ -2998,13 +3015,13 @@ public Project transferProject(Object projectIdOrPath, String namespace) throws * 
GitLab Endpoint: PUT /projects/:id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param avatarFile the File instance of the avatar file to upload + * @param avatarFile the File instance of the avatar file to upload * @return the updated Project instance * @throws GitLabApiException if any exception occurs */ public Project setProjectAvatar(Object projectIdOrPath, File avatarFile) throws GitLabApiException { Response response = putUpload(Response.Status.OK, - "avatar", avatarFile, "projects", getProjectIdOrPath(projectIdOrPath)); + "avatar", avatarFile, "projects", getProjectIdOrPath(projectIdOrPath)); return (response.readEntity(Project.class)); } @@ -3014,8 +3031,8 @@ public Project setProjectAvatar(Object projectIdOrPath, File avatarFile) throws * 
GET /projects/:id/audit_events
* * @param projectIdOrPath the project ID, path of the project, or a project instance holding the project ID or path - * @param created_after Project audit events created on or after the given time. - * @param created_before Project audit events created on or before the given time. + * @param created_after Project audit events created on or after the given time. + * @param created_before Project audit events created on or before the given time. * @return a List of project Audit events * @throws GitLabApiException if any exception occurs */ @@ -3029,18 +3046,18 @@ public List getAuditEvents(Object projectIdOrPath, Date created_afte * 
GET /projects/:id/audit_events
* * @param projectIdOrPath the project ID, path of the project, or a Project instance holding the project ID or path - * @param created_after Project audit events created on or after the given time. - * @param created_before Project audit events created on or before the given time. - * @param itemsPerPage the number of Audit Event instances that will be fetched per page + * @param created_after Project audit events created on or after the given time. + * @param created_before Project audit events created on or before the given time. + * @param itemsPerPage the number of Audit Event instances that will be fetched per page * @return a Pager of project Audit events * @throws GitLabApiException if any exception occurs */ public Pager getAuditEvents(Object projectIdOrPath, Date created_after, Date created_before, int itemsPerPage) throws GitLabApiException { Form form = new GitLabApiForm() - .withParam("created_before", ISO8601.toString(created_before, false)) - .withParam("created_after", ISO8601.toString(created_after, false)); + .withParam("created_before", ISO8601.toString(created_before, false)) + .withParam("created_after", ISO8601.toString(created_after, false)); return (new Pager(this, AuditEvent.class, itemsPerPage, form.asMap(), - "projects", getProjectIdOrPath(projectIdOrPath), "audit_events")); + "projects", getProjectIdOrPath(projectIdOrPath), "audit_events")); } /** @@ -3049,8 +3066,8 @@ public Pager getAuditEvents(Object projectIdOrPath, Date created_aft * 
GET /projects/:id/audit_events
* * @param projectIdOrPath the project ID, path of the project, or a Project instance holding the project ID or path - * @param created_after Project audit events created on or after the given time. - * @param created_before Project audit events created on or before the given time. + * @param created_after Project audit events created on or after the given time. + * @param created_before Project audit events created on or before the given time. * @return a Stream of project Audit events * @throws GitLabApiException if any exception occurs */ @@ -3064,7 +3081,7 @@ public Stream getAuditEventsStream(Object projectIdOrPath, Date crea * 
GitLab Endpoint: GET /projects/:id/audit_events/:id_audit_event
* * @param projectIdOrPath the project ID, path of the project, or a Project instance holding the project ID or path - * @param auditEventId the auditEventId, required + * @param auditEventId the auditEventId, required * @return the project Audit event * @throws GitLabApiException if any exception occurs */ @@ -3092,14 +3109,15 @@ public List getVariables(Object projectIdOrPath) throws GitLabApiExcep * 
GitLab Endpoint: GET /projects/:id/variables
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of Variable instances per page + * @param page the page to get + * @param perPage the number of Variable instances per page * @return a list of variables belonging to the specified project in the specified page range * @throws GitLabApiException if any exception occurs */ public List getVariables(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "variables"); - return (response.readEntity(new GenericType>() {})); + return (response.readEntity(new GenericType>() { + })); } /** @@ -3108,7 +3126,7 @@ public List getVariables(Object projectIdOrPath, int page, int perPage * 
GitLab Endpoint: GET /projects/:id/variables
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of Variable instances that will be fetched per page + * @param itemsPerPage the number of Variable instances that will be fetched per page * @return a Pager of variables belonging to the specified project * @throws GitLabApiException if any exception occurs */ @@ -3135,13 +3153,13 @@ public Stream getVariablesStream(Object projectIdOrPath) throws GitLab * 
GitLab Endpoint: GET /projects/:id/variables/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required + * @param key the key of an existing variable, required * @return the Variable instance for the specified variable * @throws GitLabApiException if any exception occurs */ public Variable getVariable(Object projectIdOrPath, String key) throws GitLabApiException { - Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "variables", key); - return (response.readEntity(Variable.class)); + Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "variables", key); + return (response.readEntity(Variable.class)); } /** @@ -3150,7 +3168,7 @@ public Variable getVariable(Object projectIdOrPath, String key) throws GitLabApi * 
GitLab Endpoint: GET /projects/:id/variables/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required + * @param key the key of an existing variable, required * @return the Variable for the specified variable as an Optional instance */ public Optional getOptionalVariable(Object projectIdOrPath, String key) { @@ -3167,9 +3185,9 @@ public Optional getOptionalVariable(Object projectIdOrPath, String key * 
GitLab Endpoint: POST /projects/:id/variables
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required - * @param value the value for the variable, required - * @param isProtected whether the variable is protected, optional + * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required + * @param value the value for the variable, required + * @param isProtected whether the variable is protected, optional * @return a Variable instance with the newly created variable * @throws GitLabApiException if any exception occurs during execution */ @@ -3184,10 +3202,10 @@ public Variable createVariable(Object projectIdOrPath, String key, String value, * * 
GitLab Endpoint: POST /projects/:id/variables
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required - * @param value the value for the variable, required - * @param isProtected whether the variable is protected, optional + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required + * @param value the value for the variable, required + * @param isProtected whether the variable is protected, optional * @param environmentScope the environment_scope of the variable, optional * @return a Variable instance with the newly created variable * @throws GitLabApiException if any exception occurs during execution @@ -3204,16 +3222,16 @@ public Variable createVariable(Object projectIdOrPath, String key, String value, * 
GitLab Endpoint: POST /projects/:id/variables
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required - * @param value the value for the variable, required - * @param variableType the type of variable. Available types are: env_var (default) and file - * @param isProtected whether the variable is protected, optional - * @param isMasked whether the variable is masked, optional + * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required + * @param value the value for the variable, required + * @param variableType the type of variable. Available types are: env_var (default) and file + * @param isProtected whether the variable is protected, optional + * @param isMasked whether the variable is masked, optional * @return a Variable instance with the newly created variable * @throws GitLabApiException if any exception occurs during execution */ public Variable createVariable(Object projectIdOrPath, String key, String value, Variable.Type variableType, - Boolean isProtected, Boolean isMasked) throws GitLabApiException { + Boolean isProtected, Boolean isMasked) throws GitLabApiException { return createVariable(projectIdOrPath, key, value, variableType, isProtected, isMasked, null); } @@ -3224,26 +3242,26 @@ public Variable createVariable(Object projectIdOrPath, String key, String value, * * 
GitLab Endpoint: POST /projects/:id/variables
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required - * @param value the value for the variable, required - * @param variableType the type of variable. Available types are: env_var (default) and file - * @param isProtected whether the variable is protected, optional - * @param isMasked whether the variable is masked, optional + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required + * @param value the value for the variable, required + * @param variableType the type of variable. Available types are: env_var (default) and file + * @param isProtected whether the variable is protected, optional + * @param isMasked whether the variable is masked, optional * @param environmentScope the environment_scope of the variable, optional * @return a Variable instance with the newly created variable * @throws GitLabApiException if any exception occurs during execution */ public Variable createVariable(Object projectIdOrPath, String key, String value, Variable.Type variableType, - Boolean isProtected, Boolean isMasked, String environmentScope) throws GitLabApiException { + Boolean isProtected, Boolean isMasked, String environmentScope) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("key", key, true) - .withParam("value", value, true) - .withParam("variable_type", variableType) - .withParam("protected", isProtected) - .withParam("masked", isMasked) - .withParam("environment_scope", environmentScope); + .withParam("key", key, true) + .withParam("value", value, true) + .withParam("variable_type", variableType) + .withParam("protected", isProtected) + .withParam("masked", isMasked) + .withParam("environment_scope", environmentScope); Response response = post(Response.Status.CREATED, formData, "projects", getProjectIdOrPath(projectIdOrPath), "variables"); return (response.readEntity(Variable.class)); } @@ -3254,9 +3272,9 @@ public Variable createVariable(Object projectIdOrPath, String key, String value, * 
GitLab Endpoint: PUT /projects/:id/variables/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required - * @param value the value for the variable, required - * @param isProtected whether the variable is protected, optional + * @param key the key of an existing variable, required + * @param value the value for the variable, required + * @param isProtected whether the variable is protected, optional * @return a Variable instance with the updated variable * @throws GitLabApiException if any exception occurs during execution */ @@ -3271,10 +3289,10 @@ public Variable updateVariable(Object projectIdOrPath, String key, String value, * * 
GitLab Endpoint: PUT /projects/:id/variables/:key
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required - * @param value the value for the variable, required - * @param isProtected whether the variable is protected, optional + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param key the key of an existing variable, required + * @param value the value for the variable, required + * @param isProtected whether the variable is protected, optional * @param environmentScope the environment_scope of the variable, optional. * @return a Variable instance with the updated variable * @throws GitLabApiException if any exception occurs during execution @@ -3291,16 +3309,16 @@ public Variable updateVariable(Object projectIdOrPath, String key, String value, * 
GitLab Endpoint: PUT /projects/:id/variables/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required - * @param value the value for the variable, required - * @param variableType the type of variable. Available types are: env_var (default) and file - * @param isProtected whether the variable is protected, optional - * @param masked whether the variable is masked, optional + * @param key the key of an existing variable, required + * @param value the value for the variable, required + * @param variableType the type of variable. Available types are: env_var (default) and file + * @param isProtected whether the variable is protected, optional + * @param masked whether the variable is masked, optional * @return a Variable instance with the updated variable * @throws GitLabApiException if any exception occurs during execution */ public Variable updateVariable(Object projectIdOrPath, String key, String value, Variable.Type variableType, - Boolean isProtected, Boolean masked) throws GitLabApiException { + Boolean isProtected, Boolean masked) throws GitLabApiException { return updateVariable(projectIdOrPath, key, value, variableType, isProtected, masked, null); } @@ -3311,25 +3329,25 @@ public Variable updateVariable(Object projectIdOrPath, String key, String value, * * 
GitLab Endpoint: PUT /projects/:id/variables/:key
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required - * @param value the value for the variable, required - * @param variableType the type of variable. Available types are: env_var (default) and file - * @param isProtected whether the variable is protected, optional - * @param masked whether the variable is masked, optional + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param key the key of an existing variable, required + * @param value the value for the variable, required + * @param variableType the type of variable. Available types are: env_var (default) and file + * @param isProtected whether the variable is protected, optional + * @param masked whether the variable is masked, optional * @param environmentScope the environment_scope of the variable, optional. * @return a Variable instance with the updated variable * @throws GitLabApiException if any exception occurs during execution */ public Variable updateVariable(Object projectIdOrPath, String key, String value, Variable.Type variableType, - Boolean isProtected, Boolean masked, String environmentScope) throws GitLabApiException { + Boolean isProtected, Boolean masked, String environmentScope) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("value", value, true) - .withParam("variable_type", variableType) - .withParam("protected", isProtected) - .withParam("masked", masked) - .withParam("environment_scope", environmentScope); + .withParam("value", value, true) + .withParam("variable_type", variableType) + .withParam("protected", isProtected) + .withParam("masked", masked) + .withParam("environment_scope", environmentScope); Response response = putWithFormData(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "variables", key); return (response.readEntity(Variable.class)); } @@ -3340,7 +3358,7 @@ public Variable updateVariable(Object projectIdOrPath, String key, String value, * 
GitLab Endpoint: DELETE /projects/:id/variables/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required + * @param key the key of an existing variable, required * @throws GitLabApiException if any exception occurs */ public void deleteVariable(Object projectIdOrPath, String key) throws GitLabApiException { @@ -3366,7 +3384,7 @@ public List getAccessRequests(Object projectIdOrPath) throws GitL * 
GitLab Endpoint: GET /projects/:id/access_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of AccessRequest instances that will be fetched per page + * @param itemsPerPage the number of AccessRequest instances that will be fetched per page * @return a Pager of project AccessRequest instances accessible by the authenticated user * @throws GitLabApiException if any exception occurs */ @@ -3384,7 +3402,7 @@ public Pager getAccessRequests(Object projectIdOrPath, int itemsP * @throws GitLabApiException if any exception occurs */ public Stream getAccessRequestsStream(Object projectIdOrPath) throws GitLabApiException { - return (getAccessRequests(projectIdOrPath, getDefaultPerPage()).stream()); + return (getAccessRequests(projectIdOrPath, getDefaultPerPage()).stream()); } /** @@ -3397,7 +3415,7 @@ public Stream getAccessRequestsStream(Object projectIdOrPath) thr * @throws GitLabApiException if any exception occurs */ public AccessRequest requestAccess(Object projectIdOrPath) throws GitLabApiException { - Response response = post(Response.Status.CREATED, (Form)null, "projects", getProjectIdOrPath(projectIdOrPath), "access_requests"); + Response response = post(Response.Status.CREATED, (Form) null, "projects", getProjectIdOrPath(projectIdOrPath), "access_requests"); return (response.readEntity(AccessRequest.class)); } @@ -3407,15 +3425,15 @@ public AccessRequest requestAccess(Object projectIdOrPath) throws GitLabApiExcep * 
GitLab Endpoint: PUT /projects/:id/access_requests/:user_id/approve
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID to approve access for - * @param accessLevel the access level the user is approved for, if null will be developer (30) + * @param userId the user ID to approve access for + * @param accessLevel the access level the user is approved for, if null will be developer (30) * @return the approved AccessRequest instance * @throws GitLabApiException if any exception occurs */ public AccessRequest approveAccessRequest(Object projectIdOrPath, Long userId, AccessLevel accessLevel) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm().withParam("access_level", accessLevel); Response response = this.putWithFormData(Response.Status.CREATED, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "access_requests", userId, "approve"); + "projects", getProjectIdOrPath(projectIdOrPath), "access_requests", userId, "approve"); return (response.readEntity(AccessRequest.class)); } @@ -3425,12 +3443,12 @@ public AccessRequest approveAccessRequest(Object projectIdOrPath, Long userId, A * 
GitLab Endpoint: DELETE /projects/:id/access_requests/:user_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID to deny access for + * @param userId the user ID to deny access for * @throws GitLabApiException if any exception occurs */ public void denyAccessRequest(Object projectIdOrPath, Long userId) throws GitLabApiException { delete(Response.Status.NO_CONTENT, null, - "projects", getProjectIdOrPath(projectIdOrPath), "access_requests", userId); + "projects", getProjectIdOrPath(projectIdOrPath), "access_requests", userId); } /** @@ -3455,7 +3473,7 @@ public void triggerHousekeeping(Object projectIdOrPath) throws GitLabApiExceptio * @throws GitLabApiException if any exception occurs */ public List getBadges(Object projectIdOrPath) throws GitLabApiException { - return getBadges(projectIdOrPath, null); + return getBadges(projectIdOrPath, null); } /** @@ -3464,14 +3482,15 @@ public List getBadges(Object projectIdOrPath) throws GitLabApiException { * 
GitLab Endpoint: GET /projects/:id/badges?name=:name
* * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param bagdeName The name to filter on (case-sensitive), ignored if null. + * @param bagdeName The name to filter on (case-sensitive), ignored if null. * @return All badges of the GitLab item, case insensitively filtered on name. * @throws GitLabApiException If any problem is encountered */ public List getBadges(Object projectIdOrPath, String bagdeName) throws GitLabApiException { - Form queryParam = new GitLabApiForm().withParam("name", bagdeName); - Response response = get(Response.Status.OK, queryParam.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "badges"); - return (response.readEntity(new GenericType>() {})); + Form queryParam = new GitLabApiForm().withParam("name", bagdeName); + Response response = get(Response.Status.OK, queryParam.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "badges"); + return (response.readEntity(new GenericType>() { + })); } /** @@ -3480,13 +3499,13 @@ public List getBadges(Object projectIdOrPath, String bagdeName) throws Gi * 
GitLab Endpoint: GET /projects/:id/badges/:badge_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param badgeId the ID of the badge to get + * @param badgeId the ID of the badge to get * @return a Badge instance for the specified project/badge ID pair * @throws GitLabApiException if any exception occurs */ public Badge getBadge(Object projectIdOrPath, Long badgeId) throws GitLabApiException { - Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "badges", badgeId); - return (response.readEntity(Badge.class)); + Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "badges", badgeId); + return (response.readEntity(Badge.class)); } /** @@ -3495,15 +3514,15 @@ public Badge getBadge(Object projectIdOrPath, Long badgeId) throws GitLabApiExce * 
GitLab Endpoint: GET /projects/:id/badges/:badge_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param badgeId the ID of the badge to get + * @param badgeId the ID of the badge to get * @return an Optional instance with the specified badge as the value */ public Optional getOptionalBadge(Object projectIdOrPath, Long badgeId) { - try { - return (Optional.ofNullable(getBadge(projectIdOrPath, badgeId))); - } catch (GitLabApiException glae) { - return (GitLabApi.createOptionalFromException(glae)); - } + try { + return (Optional.ofNullable(getBadge(projectIdOrPath, badgeId))); + } catch (GitLabApiException glae) { + return (GitLabApi.createOptionalFromException(glae)); + } } /** @@ -3512,13 +3531,13 @@ public Optional getOptionalBadge(Object projectIdOrPath, Long badgeId) { * 
GitLab Endpoint: POST /projects/:id/badges
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param linkUrl the URL of the badge link - * @param imageUrl the URL of the image link + * @param linkUrl the URL of the badge link + * @param imageUrl the URL of the image link * @return a Badge instance for the added badge * @throws GitLabApiException if any exception occurs */ public Badge addBadge(Object projectIdOrPath, String linkUrl, String imageUrl) throws GitLabApiException { - return addBadge(projectIdOrPath, null, linkUrl, imageUrl); + return addBadge(projectIdOrPath, null, linkUrl, imageUrl); } /** @@ -3527,19 +3546,19 @@ public Badge addBadge(Object projectIdOrPath, String linkUrl, String imageUrl) t * 
GitLab Endpoint: POST /projects/:id/badges
* * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param name The name to give the badge (may be null) - * @param linkUrl the URL of the badge link - * @param imageUrl the URL of the image link + * @param name The name to give the badge (may be null) + * @param linkUrl the URL of the badge link + * @param imageUrl the URL of the image link * @return A Badge instance for the added badge * @throws GitLabApiException if any exception occurs */ public Badge addBadge(Object projectIdOrPath, String name, String linkUrl, String imageUrl) throws GitLabApiException { - GitLabApiForm formData = new GitLabApiForm() - .withParam("name", name, false) - .withParam("link_url", linkUrl, true) - .withParam("image_url", imageUrl, true); - Response response = post(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "badges"); - return (response.readEntity(Badge.class)); + GitLabApiForm formData = new GitLabApiForm() + .withParam("name", name, false) + .withParam("link_url", linkUrl, true) + .withParam("image_url", imageUrl, true); + Response response = post(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "badges"); + return (response.readEntity(Badge.class)); } /** @@ -3548,14 +3567,14 @@ public Badge addBadge(Object projectIdOrPath, String name, String linkUrl, Strin * 
GitLab Endpoint: PUT /projects/:id/badges
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param badgeId the ID of the badge to get - * @param linkUrl the URL of the badge link - * @param imageUrl the URL of the image link + * @param badgeId the ID of the badge to get + * @param linkUrl the URL of the badge link + * @param imageUrl the URL of the image link * @return a Badge instance for the editted badge * @throws GitLabApiException if any exception occurs */ public Badge editBadge(Object projectIdOrPath, Long badgeId, String linkUrl, String imageUrl) throws GitLabApiException { - return (editBadge(projectIdOrPath, badgeId, null, linkUrl, imageUrl)); + return (editBadge(projectIdOrPath, badgeId, null, linkUrl, imageUrl)); } /** @@ -3564,10 +3583,10 @@ public Badge editBadge(Object projectIdOrPath, Long badgeId, String linkUrl, Str * 
GitLab Endpoint: PUT /projects/:id/badges
* * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param badgeId the ID of the badge to edit - * @param name The name of the badge to edit (may be null) - * @param linkUrl the URL of the badge link - * @param imageUrl the URL of the image link + * @param badgeId the ID of the badge to edit + * @param name The name of the badge to edit (may be null) + * @param linkUrl the URL of the badge link + * @param imageUrl the URL of the image link * @return a Badge instance for the editted badge * @throws GitLabApiException if any exception occurs */ @@ -3586,11 +3605,11 @@ public Badge editBadge(Object projectIdOrPath, Long badgeId, String name, String * 
GitLab Endpoint: DELETE /projects/:id/badges/:badge_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param badgeId the ID of the badge to remove + * @param badgeId the ID of the badge to remove * @throws GitLabApiException if any exception occurs */ public void removeBadge(Object projectIdOrPath, Long badgeId) throws GitLabApiException { - delete(Response.Status.NO_CONTENT, null, "projects", getProjectIdOrPath(projectIdOrPath), "badges", badgeId); + delete(Response.Status.NO_CONTENT, null, "projects", getProjectIdOrPath(projectIdOrPath), "badges", badgeId); } /** @@ -3599,17 +3618,17 @@ public void removeBadge(Object projectIdOrPath, Long badgeId) throws GitLabApiEx * 
GitLab Endpoint: GET /projects/:id/badges/render
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param linkUrl the URL of the badge link - * @param imageUrl the URL of the image link + * @param linkUrl the URL of the badge link + * @param imageUrl the URL of the image link * @return a Badge instance for the rendered badge * @throws GitLabApiException if any exception occurs */ - public Badge previewBadge(Object projectIdOrPath, String linkUrl, String imageUrl) throws GitLabApiException { - GitLabApiForm formData = new GitLabApiForm() - .withParam("link_url", linkUrl, true) - .withParam("image_url", imageUrl, true); - Response response = get(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "badges", "render"); - return (response.readEntity(Badge.class)); + public Badge previewBadge(Object projectIdOrPath, String linkUrl, String imageUrl) throws GitLabApiException { + GitLabApiForm formData = new GitLabApiForm() + .withParam("link_url", linkUrl, true) + .withParam("image_url", imageUrl, true); + Response response = get(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "badges", "render"); + return (response.readEntity(Badge.class)); } /** @@ -3634,12 +3653,12 @@ public ProjectApprovalsConfig getApprovalsConfiguration(Object projectIdOrPath) * 
GitLab Endpoint: POST /projects/:id/approvals
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param config a ProjectApprovalsConfig instance with the approval configuration + * @param config a ProjectApprovalsConfig instance with the approval configuration * @return a ProjectApprovalsConfig instance with the project's approvals configuration * @throws GitLabApiException if any exception occurs */ public ProjectApprovalsConfig setApprovalsConfiguration(Object projectIdOrPath, ProjectApprovalsConfig config) throws GitLabApiException { - GitLabApiForm formData = config.getForm(); + GitLabApiForm formData = config.getForm(); Response response = post(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "approvals"); return (response.readEntity(ProjectApprovalsConfig.class)); } @@ -3665,14 +3684,14 @@ public List getApprovalRules(Object projectIdOrPath) throws GitLab * 
GitLab Endpoint: GET /projects/:id/approval_rules
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of ApprovalRule instances that will be fetched per page + * @param itemsPerPage the number of ApprovalRule instances that will be fetched per page * @return a Pager of ApprovalRuke instances for the specified project. * @throws GitLabApiException if any exception occurs */ public Pager getApprovalRules(Object projectIdOrPath, int itemsPerPage) throws GitLabApiException { - return (new Pager(this, ApprovalRule.class, itemsPerPage, null, - "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules")); + return (new Pager(this, ApprovalRule.class, itemsPerPage, null, + "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules")); } /** @@ -3696,14 +3715,14 @@ public Stream getApprovalRulesStream(Object projectIdOrPath) throw * 
GitLab Endpoint: POST /projects/:id/approval_rules
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param params the ApprovalRuleParams instance holding the parameters for the approval rule + * @param params the ApprovalRuleParams instance holding the parameters for the approval rule * @return a ApprovalRule instance with approval configuration * @throws GitLabApiException if any exception occurs */ public ApprovalRule createApprovalRule(Object projectIdOrPath, ApprovalRuleParams params) throws GitLabApiException { GitLabApiForm formData = params.getForm(); Response response = post(Response.Status.OK, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules"); + "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules"); return (response.readEntity(ApprovalRule.class)); } @@ -3714,8 +3733,8 @@ public ApprovalRule createApprovalRule(Object projectIdOrPath, ApprovalRuleParam * 
GitLab Endpoint: PUT /projects/:id/approval_rules/:approval_rule_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param approvalRuleId the ID of the approval rule - * @param params the ApprovalRuleParams instance holding the parameters for the approval rule update + * @param approvalRuleId the ID of the approval rule + * @param params the ApprovalRuleParams instance holding the parameters for the approval rule update * @return a ApprovalRule instance with approval configuration * @throws GitLabApiException if any exception occurs */ @@ -3727,7 +3746,7 @@ public ApprovalRule updateApprovalRule(Object projectIdOrPath, Long approvalRule GitLabApiForm formData = params.getForm(); Response response = putWithFormData(Response.Status.OK, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules", approvalRuleId); + "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules", approvalRuleId); return (response.readEntity(ApprovalRule.class)); } @@ -3738,7 +3757,7 @@ public ApprovalRule updateApprovalRule(Object projectIdOrPath, Long approvalRule * 
GitLab Endpoint: DELETE /projects/:id/approval_rules/:approval_rule_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param approvalRuleId the ID of the approval rule + * @param approvalRuleId the ID of the approval rule * @throws GitLabApiException if any exception occurs */ public void deleteApprovalRule(Object projectIdOrPath, Long approvalRuleId) throws GitLabApiException { @@ -3769,13 +3788,13 @@ public List getCustomAttributes(final Object projectIdOrPath) t * 
GitLab Endpoint: GET /projects/:id/custom_attributes
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of items per page + * @param itemsPerPage the number of items per page * @return a Pager of project's custom attributes * @throws GitLabApiException if any exception occurs */ public Pager getCustomAttributes(final Object projectIdOrPath, int itemsPerPage) throws GitLabApiException { return (new Pager(this, CustomAttribute.class, itemsPerPage, null, - "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes")); + "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes")); } /** @@ -3797,13 +3816,13 @@ public Stream getCustomAttributesStream(final Object projectIdO * 
GitLab Endpoint: GET /projects/:id/custom_attributes/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param key the key for the custom attribute + * @param key the key for the custom attribute * @return a CustomAttribute instance for the specified key * @throws GitLabApiException if any exception occurs */ public CustomAttribute getCustomAttribute(final Object projectIdOrPath, final String key) throws GitLabApiException { - Response response = get(Response.Status.OK, null, - "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes", key); + Response response = get(Response.Status.OK, null, + "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes", key); return (response.readEntity(CustomAttribute.class)); } @@ -3813,7 +3832,7 @@ public CustomAttribute getCustomAttribute(final Object projectIdOrPath, final St * 
GitLab Endpoint: GET /projects/:id/custom_attributes/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key for the custom attribute, required + * @param key the key for the custom attribute, required * @return an Optional instance with the value for a single custom attribute for the specified project */ public Optional geOptionalCustomAttribute(final Object projectIdOrPath, final String key) { @@ -3831,8 +3850,8 @@ public Optional geOptionalCustomAttribute(final Object projectI * 
GitLab Endpoint: PUT /projects/:id/custom_attributes/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param key the key for the custom attribute - * @param value the value for the customAttribute + * @param key the key for the custom attribute + * @param value the value for the customAttribute * @return a CustomAttribute instance for the updated or created custom attribute * @throws GitLabApiException if any exception occurs */ @@ -3847,7 +3866,7 @@ public CustomAttribute setCustomAttribute(final Object projectIdOrPath, final St GitLabApiForm formData = new GitLabApiForm().withParam("value", value); Response response = putWithFormData(Response.Status.OK, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes", key); + "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes", key); return (response.readEntity(CustomAttribute.class)); } @@ -3857,7 +3876,7 @@ public CustomAttribute setCustomAttribute(final Object projectIdOrPath, final St * 
GitLab Endpoint: DELETE /projects/:id/custom_attributes/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param key the key of the custom attribute to delete + * @param key the key of the custom attribute to delete * @throws GitLabApiException if any exception occurs */ public void deleteCustomAttribute(final Object projectIdOrPath, final String key) throws GitLabApiException { @@ -3888,13 +3907,13 @@ public List getRemoteMirrors(final Object projectIdOrPath) throws * 
GitLab Endpoint: GET /projects/:id/remote_mirrors
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of items per page + * @param itemsPerPage the number of items per page * @return a Pager of project's remote mirrors * @throws GitLabApiException if any exception occurs */ public Pager getRemoteMirrors(final Object projectIdOrPath, int itemsPerPage) throws GitLabApiException { return (new Pager(this, RemoteMirror.class, itemsPerPage, null, - "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors")); + "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors")); } /** @@ -3916,23 +3935,23 @@ public Stream getRemoteMirrorsStream(final Object projectIdOrPath) * * 
GitLab Endpoint: POST /projects/:id/remote_mirrors
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param url the URL of the remote repository to be mirrored - * @param enabled determines if the mirror is enabled + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param url the URL of the remote repository to be mirrored + * @param enabled determines if the mirror is enabled * @param onlyProtectedBranches determines if only protected branches are mirrored - * @param keepDivergentRefs determines if divergent refs are skipped + * @param keepDivergentRefs determines if divergent refs are skipped * @return a RemoteMirror instance with remote mirror configuration * @throws GitLabApiException if any exception occurs */ public RemoteMirror createRemoteMirror(Object projectIdOrPath, String url, Boolean enabled, - Boolean onlyProtectedBranches, Boolean keepDivergentRefs) throws GitLabApiException { + Boolean onlyProtectedBranches, Boolean keepDivergentRefs) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("url", url, true) - .withParam("enabled", enabled) - .withParam("only_protected_branches", onlyProtectedBranches) - .withParam("keep_divergent_refs", keepDivergentRefs); + .withParam("url", url, true) + .withParam("enabled", enabled) + .withParam("only_protected_branches", onlyProtectedBranches) + .withParam("keep_divergent_refs", keepDivergentRefs); Response response = post(Response.Status.OK, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors"); + "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors"); return (response.readEntity(RemoteMirror.class)); } @@ -3941,23 +3960,23 @@ public RemoteMirror createRemoteMirror(Object projectIdOrPath, String url, Boole * * 
GitLab Endpoint: PUT /projects/:id/remote_mirrors/:mirror_id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param mirrorId the ID of the remote mirror - * @param enabled determines if the mirror is enabled + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param mirrorId the ID of the remote mirror + * @param enabled determines if the mirror is enabled * @param onlyProtectedBranches determines if only protected branches are mirrored - * @param keepDivergentRefs determines if divergent refs are skipped + * @param keepDivergentRefs determines if divergent refs are skipped * @return a RemoteMirror instance with the updated remote mirror configuration * @throws GitLabApiException if any exception occurs */ public RemoteMirror updateRemoteMirror(Object projectIdOrPath, Long mirrorId, Boolean enabled, - Boolean onlyProtectedBranches, Boolean keepDivergentRefs) throws GitLabApiException { + Boolean onlyProtectedBranches, Boolean keepDivergentRefs) throws GitLabApiException { - GitLabApiForm formData = new GitLabApiForm() - .withParam("enabled", enabled) - .withParam("only_protected_branches", onlyProtectedBranches) - .withParam("keep_divergent_refs", keepDivergentRefs); + GitLabApiForm formData = new GitLabApiForm() + .withParam("enabled", enabled) + .withParam("only_protected_branches", onlyProtectedBranches) + .withParam("keep_divergent_refs", keepDivergentRefs); Response response = putWithFormData(Response.Status.OK, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors", mirrorId); + "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors", mirrorId); return (response.readEntity(RemoteMirror.class)); } @@ -3970,7 +3989,8 @@ public RemoteMirror updateRemoteMirror(Object projectIdOrPath, Long mirrorId, Bo */ public List listProjectAccessTokens(Object projectIdOrPath) throws GitLabApiException { Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "access_tokens"); - return (response.readEntity(new GenericType>() { })); + return (response.readEntity(new GenericType>() { + })); } /** @@ -3978,7 +3998,7 @@ public List listProjectAccessTokens(Object projectIdOrPath) * Only working with GitLab 14.10 and above. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param tokenId the id of the token + * @param tokenId the id of the token * @return the ProjectAccessToken. The token attribute of the object is unset. * @throws GitLabApiException if any exception occurs */ @@ -3991,10 +4011,10 @@ public ProjectAccessToken getProjectAccessToken(Object projectIdOrPath, Long tok * Creates a new project access token. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param name the name of the token - * @param scopes the scope of the token - * @param expiresAt the date when the token should expire - * @param accessLevel The access level of the token is optional. It can either be 10, 20, 30, 40, or 50. + * @param name the name of the token + * @param scopes the scope of the token + * @param expiresAt the date when the token should expire + * @param accessLevel The access level of the token is optional. It can either be 10, 20, 30, 40, or 50. * @return the newly created ProjectAccessToken. The lastUsedAt attribute of each object is unset. * @throws GitLabApiException if any exception occurs */ @@ -4014,9 +4034,9 @@ public ProjectAccessToken createProjectAccessToken(Object projectIdOrPath, Strin * The default value for the accessLevel is used. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param name the name of the token - * @param scopes the scope of the token - * @param expiresAt the date when the token should expire + * @param name the name of the token + * @param scopes the scope of the token + * @param expiresAt the date when the token should expire * @return the newly created ProjectAccessToken. The lastUsedAt attribute of each object is unset. * @throws GitLabApiException if any exception occurs */ @@ -4037,28 +4057,28 @@ public ProjectAccessToken createProjectAccessToken(Object projectIdOrPath, Strin * Only working with GitLab 16.0 and above. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param tokenId the id + * @param tokenId the id * @return the newly created ProjectAccessToken. * @throws GitLabApiException if any exception occurs */ public ProjectAccessToken rotateProjectAccessToken(Object projectIdOrPath, Long tokenId) throws GitLabApiException { return rotateProjectAccessToken(projectIdOrPath, tokenId, null); } - + /** * Rotates the given project access token. * The token is revoked and a new one which will expire in one week is created to replace it. * Only working with GitLab 16.0 and above. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param tokenId the id - * @param expiresAt Expiration date of the access token + * @param tokenId the id + * @param expiresAt Expiration date of the access token * @return the newly created ProjectAccessToken. * @throws GitLabApiException if any exception occurs */ public ProjectAccessToken rotateProjectAccessToken(Object projectIdOrPath, Long tokenId, Date expiresAt) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("expires_at", ISO8601.dateOnly(expiresAt)); + .withParam("expires_at", ISO8601.dateOnly(expiresAt)); Response response = post(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "access_tokens", tokenId, "rotate"); return (response.readEntity(ProjectAccessToken.class)); @@ -4068,7 +4088,7 @@ public ProjectAccessToken rotateProjectAccessToken(Object projectIdOrPath, Long * Revokes the project access token. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param tokenId the id of the token, which should be revoked + * @param tokenId the id of the token, which should be revoked * @throws GitLabApiException if any exception occurs */ public void revokeProjectAccessToken(Object projectIdOrPath, Long tokenId) throws GitLabApiException { @@ -4081,13 +4101,14 @@ public void revokeProjectAccessToken(Object projectIdOrPath, Long tokenId) throw * 
GitLab Endpoint: GET /projects/:id/iterations
* * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param filter the iteration filter + * @param filter the iteration filter * @return the list of project iterations * @throws GitLabApiException if any exception occurs */ public List listProjectIterations(Object projectIdOrPath, IterationFilter filter) throws GitLabApiException { - MultivaluedMap queryParams = (filter == null) ? null : filter.getQueryParams().asMap(); + MultivaluedMap queryParams = (filter == null) ? null : filter.getQueryParams().asMap(); Response response = get(Response.Status.OK, queryParams, "projects", getProjectIdOrPath(projectIdOrPath), "iterations"); - return (response.readEntity(new GenericType>() { })); + return (response.readEntity(new GenericType>() { + })); } } diff --git a/src/main/java/org/gitlab4j/api/models/Project.java b/src/main/java/org/gitlab4j/api/models/Project.java index b475f6d70..05e4f6d81 100644 --- a/src/main/java/org/gitlab4j/api/models/Project.java +++ b/src/main/java/org/gitlab4j/api/models/Project.java @@ -119,6 +119,9 @@ public String toString() { private String mergeCommitTemplate; private String squashCommitTemplate; private String issueBranchTemplate; + private String mergeRequestsTemplate; + private String issuesTemplate; + @JsonProperty("_links") private Map links; @@ -950,6 +953,22 @@ public void setIssueBranchTemplate(String issueBranchTemplate) { this.issueBranchTemplate = issueBranchTemplate; } + public String getMergeRequestsTemplate() { + return mergeRequestsTemplate; + } + + public void setMergeRequestsTemplate(String mergeRequestsTemplate) { + this.mergeRequestsTemplate = mergeRequestsTemplate; + } + + public String getIssuesTemplate() { + return issuesTemplate; + } + + public void setIssuesTemplate(String issuesTemplate) { + this.issuesTemplate = issuesTemplate; + } + public Map getLinks() { return links; } From 7fd5d50f39582fe0754001db1a41abd54f7c078e Mon Sep 17 00:00:00 2001 From: George Orfanidis Date: Tue, 28 May 2024 13:59:55 +0200 Subject: [PATCH 2/4] fix code format --- .../java/org/gitlab4j/api/ProjectApi.java | 1199 ++++++++--------- 1 file changed, 589 insertions(+), 610 deletions(-) diff --git a/src/main/java/org/gitlab4j/api/ProjectApi.java b/src/main/java/org/gitlab4j/api/ProjectApi.java index 9a4380fbc..1d7bf7faf 100644 --- a/src/main/java/org/gitlab4j/api/ProjectApi.java +++ b/src/main/java/org/gitlab4j/api/ProjectApi.java @@ -38,7 +38,6 @@ import javax.ws.rs.core.MediaType; import javax.ws.rs.core.MultivaluedMap; import javax.ws.rs.core.Response; - import org.gitlab4j.api.GitLabApi.ApiVersion; import org.gitlab4j.api.models.AccessLevel; import org.gitlab4j.api.models.AccessRequest; @@ -136,13 +135,13 @@ public Optional getOptionalProjectStatistics(Object projectIdOrP */ public List getProjects() throws GitLabApiException { - String url = this.gitLabApi.getGitLabServerUrl(); - if (url.startsWith("https://gitlab.com")) { - GitLabApi.getLogger().warning("Fetching all projects from " + url + - " may take many hours to complete, use Pager getProjects(int) instead."); - } + String url = this.gitLabApi.getGitLabServerUrl(); + if (url.startsWith("https://gitlab.com")) { + GitLabApi.getLogger().warning("Fetching all projects from " + url + + " may take many hours to complete, use Pager getProjects(int) instead."); + } - return (getProjects(getDefaultPerPage()).all()); + return (getProjects(getDefaultPerPage()).all()); } /** @@ -150,15 +149,14 @@ public List getProjects() throws GitLabApiException { * * 
GitLab Endpoint: GET /projects
* - * @param page the page to get + * @param page the page to get * @param perPage the number of projects per page * @return a list of projects accessible by the authenticated user * @throws GitLabApiException if any exception occurs */ public List getProjects(int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() { })); } /** @@ -183,7 +181,7 @@ public Pager getProjects(int itemsPerPage) throws GitLabApiException { * @throws GitLabApiException if any exception occurs */ public Stream getProjectsStream() throws GitLabApiException { - return (getProjects(getDefaultPerPage()).stream()); + return (getProjects(getDefaultPerPage()).stream()); } /** @@ -192,30 +190,30 @@ public Stream getProjectsStream() throws GitLabApiException { * * 
GitLab Endpoint: GET /projects
* - * @param archived limit by archived status + * @param archived limit by archived status * @param visibility limit by visibility public, internal, or private - * @param orderBy return projects ordered by id, name, path, created_at, updated_at, or last_activity_at fields, default is created_at - * @param sort return projects sorted in asc or desc order. Default is desc - * @param search return list of projects matching the search criteria - * @param simple return only the ID, URL, name, and path of each project - * @param owned limit by projects owned by the current user + * @param orderBy return projects ordered by id, name, path, created_at, updated_at, or last_activity_at fields, default is created_at + * @param sort return projects sorted in asc or desc order. Default is desc + * @param search return list of projects matching the search criteria + * @param simple return only the ID, URL, name, and path of each project + * @param owned limit by projects owned by the current user * @param membership limit by projects that the current user is a member of - * @param starred limit by projects starred by the current user + * @param starred limit by projects starred by the current user * @param statistics include project statistics * @return a list of projects accessible by the authenticated user and matching the supplied parameters * @throws GitLabApiException if any exception occurs - * @deprecated Will be removed in version 6.0, replaced by {@link #getProjects(Boolean, Visibility, - * Constants.ProjectOrderBy, Constants.SortOrder, String, Boolean, Boolean, Boolean, Boolean, Boolean)} + * @deprecated Will be removed in version 6.0, replaced by {@link #getProjects(Boolean, Visibility, + * Constants.ProjectOrderBy, Constants.SortOrder, String, Boolean, Boolean, Boolean, Boolean, Boolean)} */ @Deprecated public List getProjects(Boolean archived, Visibility visibility, String orderBy, - String sort, String search, Boolean simple, Boolean owned, Boolean membership, - Boolean starred, Boolean statistics) throws GitLabApiException { + String sort, String search, Boolean simple, Boolean owned, Boolean membership, + Boolean starred, Boolean statistics) throws GitLabApiException { ProjectOrderBy projectOrderBy = ProjectOrderBy.valueOf(orderBy); SortOrder sortOrder = SortOrder.valueOf(sort); return (getProjects(archived, visibility, projectOrderBy, sortOrder, search, simple, - owned, membership, starred, statistics, getDefaultPerPage()).all()); + owned, membership, starred, statistics, getDefaultPerPage()).all()); } /** @@ -224,26 +222,26 @@ public List getProjects(Boolean archived, Visibility visibility, String * * 
GitLab Endpoint: GET /projects
* - * @param archived limit by archived status + * @param archived limit by archived status * @param visibility limit by visibility public, internal, or private - * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or - * LAST_ACTIVITY_AT fields, default is CREATED_AT - * @param sort return projects sorted in asc or desc order. Default is desc - * @param search return list of projects matching the search criteria - * @param simple return only the ID, URL, name, and path of each project - * @param owned limit by projects owned by the current user + * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or + * LAST_ACTIVITY_AT fields, default is CREATED_AT + * @param sort return projects sorted in asc or desc order. Default is desc + * @param search return list of projects matching the search criteria + * @param simple return only the ID, URL, name, and path of each project + * @param owned limit by projects owned by the current user * @param membership limit by projects that the current user is a member of - * @param starred limit by projects starred by the current user + * @param starred limit by projects starred by the current user * @param statistics include project statistics * @return a list of projects accessible by the authenticated user and matching the supplied parameters * @throws GitLabApiException if any exception occurs */ public List getProjects(Boolean archived, Visibility visibility, ProjectOrderBy orderBy, - SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, - Boolean starred, Boolean statistics) throws GitLabApiException { + SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, + Boolean starred, Boolean statistics) throws GitLabApiException { return (getProjects(archived, visibility, orderBy, sort, search, simple, - owned, membership, starred, statistics, getDefaultPerPage()).all()); + owned, membership, starred, statistics, getDefaultPerPage()).all()); } /** @@ -252,43 +250,42 @@ public List getProjects(Boolean archived, Visibility visibility, Projec * * 
GitLab Endpoint: GET /projects
* - * @param archived limit by archived status + * @param archived limit by archived status * @param visibility limit by visibility public, internal, or private - * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or - * LAST_ACTIVITY_AT fields, default is CREATED_AT - * @param sort return projects sorted in asc or desc order. Default is desc - * @param search return list of projects matching the search criteria - * @param simple return only the ID, URL, name, and path of each project - * @param owned limit by projects owned by the current user + * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or + * LAST_ACTIVITY_AT fields, default is CREATED_AT + * @param sort return projects sorted in asc or desc order. Default is desc + * @param search return list of projects matching the search criteria + * @param simple return only the ID, URL, name, and path of each project + * @param owned limit by projects owned by the current user * @param membership limit by projects that the current user is a member of - * @param starred limit by projects starred by the current user + * @param starred limit by projects starred by the current user * @param statistics include project statistics - * @param page the page to get - * @param perPage the number of projects per page + * @param page the page to get + * @param perPage the number of projects per page * @return a list of projects accessible by the authenticated user and matching the supplied parameters * @throws GitLabApiException if any exception occurs */ public List getProjects(Boolean archived, Visibility visibility, ProjectOrderBy orderBy, - SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, - Boolean starred, Boolean statistics, int page, int perPage) throws GitLabApiException { + SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, + Boolean starred, Boolean statistics, int page, int perPage) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("archived", archived) - .withParam("visibility", visibility) - .withParam("order_by", orderBy) - .withParam("sort", sort) - .withParam("search", search) - .withParam("simple", simple) - .withParam("owned", owned) - .withParam("membership", membership) - .withParam("starred", starred) - .withParam("statistics", statistics) - .withParam(PAGE_PARAM, page) - .withParam(PER_PAGE_PARAM, perPage); + .withParam("archived", archived) + .withParam("visibility", visibility) + .withParam("order_by", orderBy) + .withParam("sort", sort) + .withParam("search", search) + .withParam("simple", simple) + .withParam("owned", owned) + .withParam("membership", membership) + .withParam("starred", starred) + .withParam("statistics", statistics) + .withParam(PAGE_PARAM, page) + .withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -297,36 +294,36 @@ public List getProjects(Boolean archived, Visibility visibility, Projec * * 
GitLab Endpoint: GET /projects
* - * @param archived limit by archived status - * @param visibility limit by visibility public, internal, or private - * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or - * LAST_ACTIVITY_AT fields, default is CREATED_AT - * @param sort return projects sorted in asc or desc order. Default is desc - * @param search return list of projects matching the search criteria - * @param simple return only the ID, URL, name, and path of each project - * @param owned limit by projects owned by the current user - * @param membership limit by projects that the current user is a member of - * @param starred limit by projects starred by the current user - * @param statistics include project statistics + * @param archived limit by archived status + * @param visibility limit by visibility public, internal, or private + * @param orderBy return projects ordered by ID, NAME, PATH, CREATED_AT, UPDATED_AT, or + * LAST_ACTIVITY_AT fields, default is CREATED_AT + * @param sort return projects sorted in asc or desc order. Default is desc + * @param search return list of projects matching the search criteria + * @param simple return only the ID, URL, name, and path of each project + * @param owned limit by projects owned by the current user + * @param membership limit by projects that the current user is a member of + * @param starred limit by projects starred by the current user + * @param statistics include project statistics * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of projects accessible by the authenticated user and matching the supplied parameters * @throws GitLabApiException if any exception occurs */ public Pager getProjects(Boolean archived, Visibility visibility, ProjectOrderBy orderBy, - SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, - Boolean starred, Boolean statistics, int itemsPerPage) throws GitLabApiException { + SortOrder sort, String search, Boolean simple, Boolean owned, Boolean membership, + Boolean starred, Boolean statistics, int itemsPerPage) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("archived", archived) - .withParam("visibility", visibility) - .withParam("order_by", orderBy) - .withParam("sort", sort) - .withParam("search", search) - .withParam("simple", simple) - .withParam("owned", owned) - .withParam("membership", membership) - .withParam("starred", starred) - .withParam("statistics", statistics); + .withParam("archived", archived) + .withParam("visibility", visibility) + .withParam("order_by", orderBy) + .withParam("sort", sort) + .withParam("search", search) + .withParam("simple", simple) + .withParam("owned", owned) + .withParam("membership", membership) + .withParam("starred", starred) + .withParam("statistics", statistics); return (new Pager(this, Project.class, itemsPerPage, formData.asMap(), "projects")); } @@ -349,17 +346,16 @@ public List getProjects(String search) throws GitLabApiException { * * 
GitLab Endpoint: GET /projects?search=search
* - * @param search the project name search criteria - * @param page the page to get + * @param search the project name search criteria + * @param page the page to get * @param perPage the number of projects per page * @return a list of projects accessible by the authenticated user that match the provided search string * @throws GitLabApiException if any exception occurs */ public List getProjects(String search, int page, int perPage) throws GitLabApiException { - Form formData = new GitLabApiForm().withParam("search", search).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); + Form formData = new GitLabApiForm().withParam("search", search).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -367,7 +363,7 @@ public List getProjects(String search, int page, int perPage) throws Gi * * 
GitLab Endpoint: GET /projects?search=search
* - * @param search the project name search criteria + * @param search the project name search criteria * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of projects accessible by the authenticated user that match the provided search string * @throws GitLabApiException if any exception occurs @@ -407,16 +403,15 @@ public List getMemberProjects() throws GitLabApiException { * * 
GitLab Endpoint: GET /projects?membership=true
* - * @param page the page to get + * @param page the page to get * @param perPage the number of projects per page * @return a list of projects that the authenticated user is a member of * @throws GitLabApiException if any exception occurs */ public List getMemberProjects(int page, int perPage) throws GitLabApiException { - Form formData = new GitLabApiForm().withParam("membership", true).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); + Form formData = new GitLabApiForm().withParam("membership", true).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -462,16 +457,15 @@ public List getOwnedProjects() throws GitLabApiException { * * 
GitLab Endpoint: GET /projects?owned=true
* - * @param page the page to get + * @param page the page to get * @param perPage the number of projects per page * @return a list of projects owned by the authenticated user * @throws GitLabApiException if any exception occurs */ public List getOwnedProjects(int page, int perPage) throws GitLabApiException { - Form formData = new GitLabApiForm().withParam("owned", true).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); + Form formData = new GitLabApiForm().withParam("owned", true).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -517,7 +511,7 @@ public List getStarredProjects() throws GitLabApiException { * * 
GitLab Endpoint: GET /projects?starred=true
* - * @param page the page to get + * @param page the page to get * @param perPage the number of projects per page * @return a list of projects starred by the authenticated user * @throws GitLabApiException if any exception occurs @@ -525,8 +519,7 @@ public List getStarredProjects() throws GitLabApiException { public List getStarredProjects(int page, int perPage) throws GitLabApiException { Form formData = new GitLabApiForm().withParam("starred", true).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -574,8 +567,8 @@ public List getProjects(ProjectFilter filter) throws GitLabApiException * * 
GitLab Endpoint: GET /projects
* - * @param filter the ProjectFilter instance holding the filter values for the query - * @param page the page to get + * @param filter the ProjectFilter instance holding the filter values for the query + * @param page the page to get * @param perPage the number of projects per page * @return a list of all visible projects across GitLab for the authenticated use * @throws GitLabApiException if any exception occurs @@ -583,8 +576,7 @@ public List getProjects(ProjectFilter filter) throws GitLabApiException public List getProjects(ProjectFilter filter, int page, int perPage) throws GitLabApiException { GitLabApiForm formData = filter.getQueryParams(page, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -592,7 +584,7 @@ public List getProjects(ProjectFilter filter, int page, int perPage) th * * 
GitLab Endpoint: GET /projects
* - * @param filter the ProjectFilter instance holding the filter values for the query + * @param filter the ProjectFilter instance holding the filter values for the query * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of all visible projects across GitLab for the authenticated use * @throws GitLabApiException if any exception occurs @@ -621,7 +613,7 @@ public Stream getProjectsStream(ProjectFilter filter) throws GitLabApiE * 
GitLab Endpoint: GET /users/:user_id/projects
* * @param userIdOrUsername the user ID, username of the user, or a User instance holding the user ID or username - * @param filter the ProjectFilter instance holding the filter values for the query + * @param filter the ProjectFilter instance holding the filter values for the query * @return a list of visible projects owned by the given user * @throws GitLabApiException if any exception occurs */ @@ -635,18 +627,17 @@ public List getUserProjects(Object userIdOrUsername, ProjectFilter filt * 
GitLab Endpoint: GET /users/:user_id/projects
* * @param userIdOrUsername the user ID, username of the user, or a User instance holding the user ID or username - * @param filter the ProjectFilter instance holding the filter values for the query - * @param page the page to get - * @param perPage the number of projects per page + * @param filter the ProjectFilter instance holding the filter values for the query + * @param page the page to get + * @param perPage the number of projects per page * @return a list of visible projects owned by the given user * @throws GitLabApiException if any exception occurs */ public List getUserProjects(Object userIdOrUsername, ProjectFilter filter, int page, int perPage) throws GitLabApiException { GitLabApiForm formData = filter.getQueryParams(page, perPage); Response response = get(Response.Status.OK, formData.asMap(), - "users", getUserIdOrUsername(userIdOrUsername), "projects"); - return (response.readEntity(new GenericType>() { - })); + "users", getUserIdOrUsername(userIdOrUsername), "projects"); + return (response.readEntity(new GenericType>() {})); } /** @@ -655,15 +646,15 @@ public List getUserProjects(Object userIdOrUsername, ProjectFilter filt * 
GitLab Endpoint: GET /users/:user_id/projects
* * @param userIdOrUsername the user ID, username of the user, or a User instance holding the user ID or username - * @param filter the ProjectFilter instance holding the filter values for the query - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param filter the ProjectFilter instance holding the filter values for the query + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of visible projects owned by the given user * @throws GitLabApiException if any exception occurs */ public Pager getUserProjects(Object userIdOrUsername, ProjectFilter filter, int itemsPerPage) throws GitLabApiException { GitLabApiForm formData = filter.getQueryParams(); return (new Pager(this, Project.class, itemsPerPage, formData.asMap(), - "users", getUserIdOrUsername(userIdOrUsername), "projects")); + "users", getUserIdOrUsername(userIdOrUsername), "projects")); } /** @@ -672,7 +663,7 @@ public Pager getUserProjects(Object userIdOrUsername, ProjectFilter fil * 
GitLab Endpoint: GET /users/:user_id/projects
* * @param userIdOrUsername the user ID, username of the user, or a User instance holding the user ID or username - * @param filter the ProjectFilter instance holding the filter values for the query + * @param filter the ProjectFilter instance holding the filter values for the query * @return a Stream of visible projects owned by the given user * @throws GitLabApiException if any exception occurs */ @@ -690,7 +681,7 @@ public Stream getUserProjectsStream(Object userIdOrUsername, ProjectFil * @throws GitLabApiException if any exception occurs */ public Project getProject(Object projectIdOrPath) throws GitLabApiException { - return (getProject(projectIdOrPath, null, null, null)); + return (getProject(projectIdOrPath, null, null, null)); } /** @@ -714,13 +705,13 @@ public Optional getOptionalProject(Object projectIdOrPath) { * * 
GitLab Endpoint: GET /projects/:id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param includeStatistics include project statistics * @return the specified project * @throws GitLabApiException if any exception occurs */ public Project getProject(Object projectIdOrPath, Boolean includeStatistics) throws GitLabApiException { - return (getProject(projectIdOrPath, includeStatistics, null, null)); + return (getProject(projectIdOrPath, includeStatistics, null, null)); } /** @@ -728,7 +719,7 @@ public Project getProject(Object projectIdOrPath, Boolean includeStatistics) thr * * 
GitLab Endpoint: GET /projects/:id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param includeStatistics include project statistics * @return an Optional instance with the specified project as a value */ @@ -745,21 +736,21 @@ public Optional getOptionalProject(Object projectIdOrPath, Boolean incl * * 
GitLab Endpoint: GET /projects/:id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param includeStatistics include project statistics - * @param includeLicense include project license data + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param includeStatistics include project statistics + * @param includeLicense include project license data * @param withCustomAttributes include custom attributes in response (admins only) * @return the specified project * @throws GitLabApiException if any exception occurs */ public Project getProject(Object projectIdOrPath, Boolean includeStatistics, - Boolean includeLicense, Boolean withCustomAttributes) throws GitLabApiException { + Boolean includeLicense, Boolean withCustomAttributes) throws GitLabApiException { Form formData = new GitLabApiForm() - .withParam("statistics", includeStatistics) - .withParam("license", includeLicense) - .withParam("with_custom_attributes", withCustomAttributes); + .withParam("statistics", includeStatistics) + .withParam("license", includeLicense) + .withParam("with_custom_attributes", withCustomAttributes); Response response = get(Response.Status.OK, formData.asMap(), - "projects", getProjectIdOrPath(projectIdOrPath)); + "projects", getProjectIdOrPath(projectIdOrPath)); return (response.readEntity(Project.class)); } @@ -768,17 +759,17 @@ public Project getProject(Object projectIdOrPath, Boolean includeStatistics, * * 
GitLab Endpoint: GET /projects/:id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param includeStatistics include project statistics - * @param includeLicense include project license data + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param includeStatistics include project statistics + * @param includeLicense include project license data * @param withCustomAttributes include custom attributes in response (admins only) * @return an Optional instance with the specified project as a value */ public Optional getOptionalProject(Object projectIdOrPath, Boolean includeStatistics, - Boolean includeLicense, Boolean withCustomAttributes) { + Boolean includeLicense, Boolean withCustomAttributes) { try { return (Optional.ofNullable(getProject(projectIdOrPath, - includeStatistics, includeLicense, withCustomAttributes))); + includeStatistics, includeLicense, withCustomAttributes))); } catch (GitLabApiException glae) { return (GitLabApi.createOptionalFromException(glae)); } @@ -790,7 +781,7 @@ public Optional getOptionalProject(Object projectIdOrPath, Boolean incl * 
GitLab Endpoint: GET /projects/:id
* * @param namespace the name of the project namespace or group - * @param project the name of the project to get + * @param project the name of the project to get * @return the specified project * @throws GitLabApiException if any exception occurs */ @@ -821,7 +812,7 @@ public Project getProject(String namespace, String project) throws GitLabApiExce * 
GitLab Endpoint: GET /projects/:id
* * @param namespace the name of the project namespace or group - * @param project the name of the project + * @param project the name of the project * @return an Optional instance with the specified project as a value */ public Optional getOptionalProject(String namespace, String project) { @@ -837,8 +828,8 @@ public Optional getOptionalProject(String namespace, String project) { * * 
GitLab Endpoint: GET /projects/:id
* - * @param namespace the name of the project namespace or group - * @param project the name of the project to get + * @param namespace the name of the project namespace or group + * @param project the name of the project to get * @param includeStatistics include project statistics * @return the specified project * @throws GitLabApiException if any exception occurs @@ -870,8 +861,8 @@ public Project getProject(String namespace, String project, Boolean includeStati * * 
GitLab Endpoint: GET /projects/:id
* - * @param namespace the name of the project namespace or group - * @param project the name of the project + * @param namespace the name of the project namespace or group + * @param project the name of the project * @param includeStatistics include project statistics * @return an Optional instance with the specified project as a value */ @@ -901,7 +892,7 @@ public Project createProject(Long namespaceId, String projectName) throws GitLab * Create a new project belonging to the namespace ID and project configuration. A namespace ID is either a user or group ID. * * @param namespaceId the namespace ID to create the project under - * @param project the Project instance holding the new project configuration + * @param project the Project instance holding the new project configuration * @return the created project * @throws GitLabApiException if any exception occurs */ @@ -939,9 +930,9 @@ public Project createProject(String projectName) throws GitLabApiException { */ public Project createProject(String name, String path) throws GitLabApiException { - if ((name == null || name.trim().isEmpty()) && (path == null || path.trim().isEmpty())) { - throw new RuntimeException("Either name or path must be specified."); - } + if ((name == null || name.trim().isEmpty()) && (path == null || path.trim().isEmpty())) { + throw new RuntimeException("Either name or path must be specified."); + } GitLabApiForm formData = new GitLabApiForm().withParam("name", name).withParam("path", path); Response response = post(Response.Status.CREATED, formData, "projects"); @@ -962,7 +953,7 @@ public Project createProject(Project project) throws GitLabApiException { /** * Creates new project owned by the current user. The following properties on the Project instance * are utilized in the creation of the project: - *

+ * * name (name or path are required) - new project name * path (name or path are required) - new project path * defaultBranch (optional) - master by default @@ -993,7 +984,7 @@ public Project createProject(Project project) throws GitLabApiException { * ciConfigPath (optional) - Set path to CI configuration file * squashOption (optional) - set squash option for merge requests * - * @param project the Project instance with the configuration for the new project + * @param project the Project instance with the configuration for the new project * @param importUrl the URL to import the repository from * @return a Project instance with the newly created project info * @throws GitLabApiException if any exception occurs @@ -1017,7 +1008,7 @@ public Project createProject(Project project, String importUrl) throws GitLabApi .withParam("default_branch", project.getDefaultBranch()) .withParam("description", project.getDescription()) .withParam("issues_enabled", project.getIssuesEnabled()) - .withParam("merge_method", project.getMergeMethod()) + .withParam("merge_method", project.getMergeMethod()) .withParam("merge_requests_enabled", project.getMergeRequestsEnabled()) .withParam("jobs_enabled", project.getJobsEnabled()) .withParam("wiki_enabled", project.getWikiEnabled()) @@ -1090,8 +1081,8 @@ public Project createProject(Project project, String importUrl) throws GitLabApi */ public InputStream getAvatar(Object projectIdOrPath) throws GitLabApiException { - Response response = getWithAccepts(Response.Status.OK, null, MediaType.MEDIA_TYPE_WILDCARD, - "projects", getProjectIdOrPath(projectIdOrPath), "avatar"); + Response response = getWithAccepts(Response.Status.OK, null, MediaType.MEDIA_TYPE_WILDCARD, + "projects", getProjectIdOrPath(projectIdOrPath), "avatar"); return (response.readEntity(InputStream.class)); } @@ -1099,26 +1090,26 @@ public InputStream getAvatar(Object projectIdOrPath) throws GitLabApiException { /** * Creates a Project * - * @param name The name of the project - * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) - * @param description A description for the project, null otherwise - * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default + * @param name The name of the project + * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) + * @param description A description for the project, null otherwise + * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default * @param mergeRequestsEnabled Whether Merge Requests should be enabled, otherwise null indicates to use GitLab default - * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default - * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default - * @param visibility The visibility of the project, otherwise null indicates to use GitLab default - * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default - * @param importUrl The Import URL for the project, otherwise null + * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default + * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default + * @param visibility The visibility of the project, otherwise null indicates to use GitLab default + * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default + * @param importUrl The Import URL for the project, otherwise null * @return the GitLab Project * @throws GitLabApiException if any exception occurs */ public Project createProject(String name, Long namespaceId, String description, Boolean issuesEnabled, Boolean mergeRequestsEnabled, - Boolean wikiEnabled, Boolean snippetsEnabled, Visibility visibility, Integer visibilityLevel, String importUrl) throws GitLabApiException { + Boolean wikiEnabled, Boolean snippetsEnabled, Visibility visibility, Integer visibilityLevel, String importUrl) throws GitLabApiException { if (isApiVersion(ApiVersion.V3)) { Boolean isPublic = Visibility.PUBLIC == visibility; return (createProject(name, namespaceId, description, issuesEnabled, mergeRequestsEnabled, - wikiEnabled, snippetsEnabled, isPublic, visibilityLevel, importUrl)); + wikiEnabled, snippetsEnabled, isPublic, visibilityLevel, importUrl)); } if (name == null || name.trim().length() == 0) { @@ -1126,16 +1117,16 @@ public Project createProject(String name, Long namespaceId, String description, } GitLabApiForm formData = new GitLabApiForm() - .withParam("name", name, true) - .withParam("namespace_id", namespaceId) - .withParam("description", description) - .withParam("issues_enabled", issuesEnabled) - .withParam("merge_requests_enabled", mergeRequestsEnabled) - .withParam("wiki_enabled", wikiEnabled) - .withParam("snippets_enabled", snippetsEnabled) - .withParam("visibility_level", visibilityLevel) - .withParam("visibility", visibility) - .withParam("import_url", importUrl); + .withParam("name", name, true) + .withParam("namespace_id", namespaceId) + .withParam("description", description) + .withParam("issues_enabled", issuesEnabled) + .withParam("merge_requests_enabled", mergeRequestsEnabled) + .withParam("wiki_enabled", wikiEnabled) + .withParam("snippets_enabled", snippetsEnabled) + .withParam("visibility_level", visibilityLevel) + .withParam("visibility", visibility) + .withParam("import_url", importUrl); Response response = post(Response.Status.CREATED, formData, "projects"); return (response.readEntity(Project.class)); @@ -1144,28 +1135,28 @@ public Project createProject(String name, Long namespaceId, String description, /** * Creates a Project * - * @param name The name of the project - * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) - * @param description A description for the project, null otherwise - * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default - * @param mergeRequestsEnabled Whether Merge Requests should be enabled, otherwise null indicates to use GitLab default - * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default - * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default - * @param visibility The visibility of the project, otherwise null indicates to use GitLab default - * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default + * @param name The name of the project + * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) + * @param description A description for the project, null otherwise + * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default + * @param mergeRequestsEnabled Whether Merge Requests should be enabled, otherwise null indicates to use GitLab default + * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default + * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default + * @param visibility The visibility of the project, otherwise null indicates to use GitLab default + * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default * @param printingMergeRequestLinkEnabled Show link to create/view merge request when pushing from the command line - * @param importUrl The Import URL for the project, otherwise null + * @param importUrl The Import URL for the project, otherwise null * @return the GitLab Project * @throws GitLabApiException if any exception occurs */ public Project createProject(String name, Long namespaceId, String description, Boolean issuesEnabled, Boolean mergeRequestsEnabled, - Boolean wikiEnabled, Boolean snippetsEnabled, Visibility visibility, Integer visibilityLevel, - Boolean printingMergeRequestLinkEnabled, String importUrl) throws GitLabApiException { + Boolean wikiEnabled, Boolean snippetsEnabled, Visibility visibility, Integer visibilityLevel, + Boolean printingMergeRequestLinkEnabled, String importUrl) throws GitLabApiException { if (isApiVersion(ApiVersion.V3)) { Boolean isPublic = Visibility.PUBLIC == visibility; return (createProject(name, namespaceId, description, issuesEnabled, mergeRequestsEnabled, - wikiEnabled, snippetsEnabled, isPublic, visibilityLevel, importUrl)); + wikiEnabled, snippetsEnabled, isPublic, visibilityLevel, importUrl)); } if (name == null || name.trim().length() == 0) { @@ -1173,17 +1164,17 @@ public Project createProject(String name, Long namespaceId, String description, } GitLabApiForm formData = new GitLabApiForm() - .withParam("name", name, true) - .withParam("namespace_id", namespaceId) - .withParam("description", description) - .withParam("issues_enabled", issuesEnabled) - .withParam("merge_requests_enabled", mergeRequestsEnabled) - .withParam("wiki_enabled", wikiEnabled) - .withParam("snippets_enabled", snippetsEnabled) - .withParam("visibility_level", visibilityLevel) - .withParam("visibility", visibility) - .withParam("printing_merge_request_link_enabled", printingMergeRequestLinkEnabled) - .withParam("import_url", importUrl); + .withParam("name", name, true) + .withParam("namespace_id", namespaceId) + .withParam("description", description) + .withParam("issues_enabled", issuesEnabled) + .withParam("merge_requests_enabled", mergeRequestsEnabled) + .withParam("wiki_enabled", wikiEnabled) + .withParam("snippets_enabled", snippetsEnabled) + .withParam("visibility_level", visibilityLevel) + .withParam("visibility", visibility) + .withParam("printing_merge_request_link_enabled", printingMergeRequestLinkEnabled) + .withParam("import_url", importUrl); Response response = post(Response.Status.CREATED, formData, "projects"); return (response.readEntity(Project.class)); @@ -1192,39 +1183,39 @@ public Project createProject(String name, Long namespaceId, String description, /** * Creates a Project * - * @param name The name of the project - * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) - * @param description A description for the project, null otherwise - * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default + * @param name The name of the project + * @param namespaceId The Namespace for the new project, otherwise null indicates to use the GitLab default (user) + * @param description A description for the project, null otherwise + * @param issuesEnabled Whether Issues should be enabled, otherwise null indicates to use GitLab default * @param mergeRequestsEnabled Whether Merge Requests should be enabled, otherwise null indicates to use GitLab default - * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default - * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default - * @param isPublic Whether the project is public or private, if true same as setting visibilityLevel = 20, otherwise null indicates to use GitLab default - * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default - * @param importUrl The Import URL for the project, otherwise null + * @param wikiEnabled Whether a Wiki should be enabled, otherwise null indicates to use GitLab default + * @param snippetsEnabled Whether Snippets should be enabled, otherwise null indicates to use GitLab default + * @param isPublic Whether the project is public or private, if true same as setting visibilityLevel = 20, otherwise null indicates to use GitLab default + * @param visibilityLevel The visibility level of the project, otherwise null indicates to use GitLab default + * @param importUrl The Import URL for the project, otherwise null * @return the GitLab Project * @throws GitLabApiException if any exception occurs * @deprecated As of release 4.2.0, replaced by {@link #createProject(String, Long, String, Boolean, Boolean, - * Boolean, Boolean, Visibility, Integer, String)} + * Boolean, Boolean, Visibility, Integer, String)} */ @Deprecated public Project createProject(String name, Long namespaceId, String description, Boolean issuesEnabled, Boolean mergeRequestsEnabled, - Boolean wikiEnabled, Boolean snippetsEnabled, Boolean isPublic, Integer visibilityLevel, String importUrl) throws GitLabApiException { + Boolean wikiEnabled, Boolean snippetsEnabled, Boolean isPublic, Integer visibilityLevel, String importUrl) throws GitLabApiException { if (name == null || name.trim().length() == 0) { return (null); } GitLabApiForm formData = new GitLabApiForm() - .withParam("name", name, true) - .withParam("namespace_id", namespaceId) - .withParam("description", description) - .withParam("issues_enabled", issuesEnabled) - .withParam("merge_requests_enabled", mergeRequestsEnabled) - .withParam("wiki_enabled", wikiEnabled) - .withParam("snippets_enabled", snippetsEnabled) - .withParam("visibility_level", visibilityLevel) - .withParam("import_url", importUrl); + .withParam("name", name, true) + .withParam("namespace_id", namespaceId) + .withParam("description", description) + .withParam("issues_enabled", issuesEnabled) + .withParam("merge_requests_enabled", mergeRequestsEnabled) + .withParam("wiki_enabled", wikiEnabled) + .withParam("snippets_enabled", snippetsEnabled) + .withParam("visibility_level", visibilityLevel) + .withParam("import_url", importUrl); if (isApiVersion(ApiVersion.V3)) { formData.withParam("public", isPublic); @@ -1239,11 +1230,11 @@ public Project createProject(String name, Long namespaceId, String description, /** * Create a new project from a template, belonging to the namespace ID. A namespace ID is either a user or group ID. * - * @param namespaceId the namespace ID to create the project under - * @param projectName the name of the project top create + * @param namespaceId the namespace ID to create the project under + * @param projectName the name of the project top create * @param groupWithProjectTemplatesId Id of the Gitlab Group, which contains the relevant templates. - * @param templateName name of the template to use - * @param visibility Visibility of the new create project + * @param templateName name of the template to use + * @param visibility Visibility of the new create project * @return the created project * @throws GitLabApiException if any exception occurs */ @@ -1254,7 +1245,8 @@ public Project createProjectFromTemplate(Integer namespaceId, String projectName .withParam("use_custom_template", true) .withParam("group_with_project_templates_id", groupWithProjectTemplatesId, true) .withParam("template_name", templateName, true) - .withParam("visibility", visibility); + .withParam("visibility", visibility) + ; Response response = post(Response.Status.CREATED, formData, "projects"); return (response.readEntity(Project.class)); } @@ -1262,7 +1254,7 @@ public Project createProjectFromTemplate(Integer namespaceId, String projectName /** * Updates a project. The following properties on the Project instance * are utilized in the edit of the project, null values are not updated: - *

+ * * id (required) - existing project id, either id or path must be provided * name (optional) - project name * path (optional) - project path, either id or path must be provided @@ -1292,12 +1284,12 @@ public Project createProjectFromTemplate(Integer namespaceId, String projectName * ciConfigPath (optional) - Set path to CI configuration file * ciForwardDeploymentEnabled (optional) - When a new deployment job starts, skip older deployment jobs that are still pending * squashOption (optional) - set squash option for merge requests - *

+ * * NOTE: The following parameters specified by the GitLab API edit project are not supported: - * import_url - * tag_list array - * avatar - * initialize_with_readme + * import_url + * tag_list array + * avatar + * initialize_with_readme * * @param project the Project instance with the configuration for the new project * @return a Project instance with the newly updated project info @@ -1318,7 +1310,7 @@ public Project updateProject(Project project) throws GitLabApiException { .withParam("default_branch", project.getDefaultBranch()) .withParam("description", project.getDescription()) .withParam("issues_enabled", project.getIssuesEnabled()) - .withParam("merge_method", project.getMergeMethod()) + .withParam("merge_method", project.getMergeMethod()) .withParam("merge_requests_enabled", project.getMergeRequestsEnabled()) .withParam("jobs_enabled", project.getJobsEnabled()) .withParam("wiki_enabled", project.getWikiEnabled()) @@ -1363,8 +1355,6 @@ public Project updateProject(Project project) throws GitLabApiException { formData.withParam("issue_branch_template", project.getIssueBranchTemplate()); formData.withParam("merge_commit_template", project.getMergeCommitTemplate()); formData.withParam("squash_commit_template", project.getSquashCommitTemplate()); - formData.withParam("merge_requests_template", project.getMergeRequestsTemplate()); - formData.withParam("issues_template", project.getIssuesTemplate()); if (project.getTagList() != null && !project.getTagList().isEmpty()) { formData.withParam("tag_list", String.join(",", project.getTagList())); @@ -1440,9 +1430,9 @@ public Project forkProject(Object projectIdOrPath, Long namespaceId) throws GitL */ public Project forkProject(Object projectIdOrPath, String namespace, String path, String name) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("namespace", namespace, true) - .withParam("path", path) - .withParam("name", name); + .withParam("namespace", namespace, true) + .withParam("path", path) + .withParam("name", name); Response.Status expectedStatus = (isApiVersion(ApiVersion.V3) ? Response.Status.OK : Response.Status.CREATED); Response response = post(expectedStatus, formData, "projects", getProjectIdOrPath(projectIdOrPath), "fork"); return (response.readEntity(Project.class)); @@ -1453,14 +1443,15 @@ public Project forkProject(Object projectIdOrPath, String namespace, String path * * 

GitLab Endpoint: POST /projects/:id/fork/:forkFromId
* + * * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param forkedFromId the ID of the project that was forked from + * @param forkedFromId the ID of the project that was forked from * @return the updated Project instance * @throws GitLabApiException if any exception occurs */ public Project createForkedFromRelationship(Object projectIdOrPath, Long forkedFromId) throws GitLabApiException { Response.Status expectedStatus = (isApiVersion(ApiVersion.V3) ? Response.Status.OK : Response.Status.CREATED); - Response response = post(expectedStatus, (Form) null, "projects", this.getProjectIdOrPath(projectIdOrPath), "fork", forkedFromId); + Response response = post(expectedStatus, (Form)null, "projects", this.getProjectIdOrPath(projectIdOrPath), "fork", forkedFromId); return (response.readEntity(Project.class)); } @@ -1496,15 +1487,14 @@ public List getMembers(Object projectIdOrPath) throws GitLabApiException * 
GitLab Endpoint: GET /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param page the page to get - * @param perPage the number of Member instances per page + * @param page the page to get + * @param perPage the number of Member instances per page * @return the members belonging to the specified project * @throws GitLabApiException if any exception occurs */ public List getMembers(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "members"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -1513,7 +1503,7 @@ public List getMembers(Object projectIdOrPath, int page, int perPage) th * 
GitLab Endpoint: GET /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return the members belonging to the specified project * @throws GitLabApiException if any exception occurs */ @@ -1559,18 +1549,17 @@ public List getAllMembers(Object projectIdOrPath) throws GitLabApiExcept * 
GitLab Endpoint: GET /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param page the page to get - * @param perPage the number of Member instances per page + * @param page the page to get + * @param perPage the number of Member instances per page * @return the project members viewable by the authenticated user, including inherited members through ancestor groups * @throws GitLabApiException if any exception occurs - * @deprecated Will be removed in version 6.0 + * @deprecated Will be removed in version 6.0 */ @Deprecated public List getAllMembers(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), - "projects", getProjectIdOrPath(projectIdOrPath), "members", "all"); - return (response.readEntity(new GenericType>() { - })); + "projects", getProjectIdOrPath(projectIdOrPath), "members", "all"); + return (response.readEntity(new GenericType>() {})); } /** @@ -1582,7 +1571,7 @@ public List getAllMembers(Object projectIdOrPath, int page, int perPage) * 
GitLab Endpoint: GET /projects/:id/members/all
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the project members viewable by the authenticated user, * including inherited members through ancestor groups * @throws GitLabApiException if any exception occurs @@ -1617,8 +1606,8 @@ public Stream getAllMembersStream(Object projectIdOrPath) throws GitLabA * 
GitLab Endpoint: GET /projects/:id/members/all
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param query a query string to search for members - * @param userIds filter the results on the given user IDs + * @param query a query string to search for members + * @param userIds filter the results on the given user IDs * @return the project members viewable by the authenticated user, including inherited members through ancestor groups * @throws GitLabApiException if any exception occurs */ @@ -1635,9 +1624,9 @@ public List getAllMembers(Object projectIdOrPath, String query, ListGitLab Endpoint: GET /projects/:id/members/all * * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param query a query string to search for members - * @param userIds filter the results on the given user IDs - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param query a query string to search for members + * @param userIds filter the results on the given user IDs + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the project members viewable by the authenticated user, * including inherited members through ancestor groups * @throws GitLabApiException if any exception occurs @@ -1645,7 +1634,7 @@ public List getAllMembers(Object projectIdOrPath, String query, List getAllMembers(Object projectIdOrPath, String query, List userIds, int itemsPerPage) throws GitLabApiException { GitLabApiForm form = new GitLabApiForm().withParam("query", query).withParam("user_ids", userIds); return (new Pager(this, Member.class, itemsPerPage, form.asMap(), - "projects", getProjectIdOrPath(projectIdOrPath), "members", "all")); + "projects", getProjectIdOrPath(projectIdOrPath), "members", "all")); } /** @@ -1657,8 +1646,8 @@ public Pager getAllMembers(Object projectIdOrPath, String query, ListGitLab Endpoint: GET /projects/:id/members/all * * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param query a query string to search for members - * @param userIds filter the results on the given user IDs + * @param query a query string to search for members + * @param userIds filter the results on the given user IDs * @return a Stream of the project members viewable by the authenticated user, * including inherited members through ancestor groups * @throws GitLabApiException if any exception occurs @@ -1673,7 +1662,7 @@ public Stream getAllMembersStream(Object projectIdOrPath, String query, * 
GitLab Endpoint: GET /projects/:id/members/:user_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member + * @param userId the user ID of the member * @return the member specified by the project ID/user ID pair * @throws GitLabApiException if any exception occurs */ @@ -1687,10 +1676,10 @@ public Member getMember(Object projectIdOrPath, Long userId) throws GitLabApiExc * 
GitLab Endpoint: GET /projects/:id/members/:user_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member + * @param userId the user ID of the member * @return the member specified by the project ID/user ID pair */ - public Optional getOptionalMember(Object projectIdOrPath, Long userId) { + public Optional getOptionalMember(Object projectIdOrPath, Long userId) { try { return (Optional.ofNullable(getMember(projectIdOrPath, userId, false))); } catch (GitLabApiException glae) { @@ -1703,8 +1692,8 @@ public Optional getOptionalMember(Object projectIdOrPath, Long userId) { * * 
GitLab Endpoint: GET /projects/:id/members/all/:user_id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param userId the user ID of the member * @param includeInherited if true will the member even if inherited thru an ancestor group * @return the member specified by the project ID/user ID pair * @throws GitLabApiException if any exception occurs @@ -1724,12 +1713,12 @@ public Member getMember(Object projectIdOrPath, Long userId, Boolean includeInhe * * 
GitLab Endpoint: GET /projects/:id/members/all/:user_id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param userId the user ID of the member * @param includeInherited if true will the member even if inherited thru an ancestor group * @return the member specified by the project ID/user ID pair as the value of an Optional */ - public Optional getOptionalMember(Object projectIdOrPath, Long userId, Boolean includeInherited) { + public Optional getOptionalMember(Object projectIdOrPath, Long userId, Boolean includeInherited) { try { return (Optional.ofNullable(getMember(projectIdOrPath, userId, includeInherited))); } catch (GitLabApiException glae) { @@ -1745,8 +1734,8 @@ public Optional getOptionalMember(Object projectIdOrPath, Long userId, B * 
GitLab Endpoint: POST /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to add, required - * @param accessLevel the access level for the new member, required + * @param userId the user ID of the member to add, required + * @param accessLevel the access level for the new member, required * @return the added member * @throws GitLabApiException if any exception occurs */ @@ -1762,8 +1751,8 @@ public Member addMember(Object projectIdOrPath, Long userId, Integer accessLevel * 
GitLab Endpoint: POST /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to add, required - * @param accessLevel the access level for the new member, required + * @param userId the user ID of the member to add, required + * @param accessLevel the access level for the new member, required * @return the added member * @throws GitLabApiException if any exception occurs */ @@ -1779,9 +1768,9 @@ public Member addMember(Object projectIdOrPath, Long userId, AccessLevel accessL * 
GitLab Endpoint: POST /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to add - * @param accessLevel the access level for the new member - * @param expiresAt the date the membership in the group will expire + * @param userId the user ID of the member to add + * @param accessLevel the access level for the new member + * @param expiresAt the date the membership in the group will expire * @return the added member * @throws GitLabApiException if any exception occurs */ @@ -1797,17 +1786,17 @@ public Member addMember(Object projectIdOrPath, Long userId, AccessLevel accessL * 
GitLab Endpoint: POST /projects/:id/members
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to add - * @param accessLevel the access level for the new member - * @param expiresAt the date the membership in the group will expire + * @param userId the user ID of the member to add + * @param accessLevel the access level for the new member + * @param expiresAt the date the membership in the group will expire * @return the added member * @throws GitLabApiException if any exception occurs */ public Member addMember(Object projectIdOrPath, Long userId, Integer accessLevel, Date expiresAt) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("user_id", userId, true) - .withParam("access_level", accessLevel, true) - .withParam("expires_at", expiresAt, false); + .withParam("user_id", userId, true) + .withParam("access_level", accessLevel, true) + .withParam("expires_at", expiresAt, false); Response response = post(Response.Status.CREATED, formData, "projects", getProjectIdOrPath(projectIdOrPath), "members"); return (response.readEntity(Member.class)); } @@ -1818,8 +1807,8 @@ public Member addMember(Object projectIdOrPath, Long userId, Integer accessLevel * 
GitLab Endpoint: PUT /projects/:projectId/members/:userId
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to update, required - * @param accessLevel the new access level for the member, required + * @param userId the user ID of the member to update, required + * @param accessLevel the new access level for the member, required * @return the updated member * @throws GitLabApiException if any exception occurs */ @@ -1833,8 +1822,8 @@ public Member updateMember(Object projectIdOrPath, Long userId, Integer accessLe * 
GitLab Endpoint: PUT /projects/:projectId/members/:userId
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to update, required - * @param accessLevel the new access level for the member, required + * @param userId the user ID of the member to update, required + * @param accessLevel the new access level for the member, required * @return the updated member * @throws GitLabApiException if any exception occurs */ @@ -1848,9 +1837,9 @@ public Member updateMember(Object projectIdOrPath, Long userId, AccessLevel acce * 
GitLab Endpoint: PUT /projects/:projectId/members/:userId
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID of the member to update, required - * @param accessLevel the new access level for the member, required - * @param expiresAt the date the membership in the group will expire, optional + * @param userId the user ID of the member to update, required + * @param accessLevel the new access level for the member, required + * @param expiresAt the date the membership in the group will expire, optional * @return the updated member * @throws GitLabApiException if any exception occurs */ @@ -1864,16 +1853,16 @@ public Member updateMember(Object projectIdOrPath, Long userId, AccessLevel acce * 
GitLab Endpoint: PUT /projects/:projectId/members/:userId
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param userId the user ID of the member to update, required - * @param accessLevel the new access level for the member, required - * @param expiresAt the date the membership in the group will expire, optional + * @param userId the user ID of the member to update, required + * @param accessLevel the new access level for the member, required + * @param expiresAt the date the membership in the group will expire, optional * @return the updated member * @throws GitLabApiException if any exception occurs */ public Member updateMember(Object projectIdOrPath, Long userId, Integer accessLevel, Date expiresAt) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("access_level", accessLevel, true) - .withParam("expires_at", expiresAt, false); + .withParam("access_level", accessLevel, true) + .withParam("expires_at", expiresAt, false); Response response = put(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "members", userId); return (response.readEntity(Member.class)); } @@ -1884,7 +1873,7 @@ public Member updateMember(Object projectIdOrPath, Long userId, Integer accessLe * 
GitLab Endpoint: DELETE /projects/:id/members/:user_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param userId the user ID of the member to remove + * @param userId the user ID of the member to remove * @throws GitLabApiException if any exception occurs */ public void removeMember(Object projectIdOrPath, Long userId) throws GitLabApiException { @@ -1911,7 +1900,7 @@ public List getProjectUsers(Object projectIdOrPath) throws GitLabAp * 
GitLab Endpoint: GET /projects/:id/users
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the users matching the search string and belonging to the specified project and its parent groups * @throws GitLabApiException if any exception occurs */ @@ -1939,7 +1928,7 @@ public Stream getProjectUsersStream(Object projectIdOrPath) throws * 
GitLab Endpoint: GET /projects/:id/users
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param search the string to match specific users + * @param search the string to match specific users * @return the users matching the search string and belonging to the specified project and its parent groups * @throws GitLabApiException if any exception occurs */ @@ -1954,15 +1943,15 @@ public List getProjectUsers(Object projectIdOrPath, String search) * 
GitLab Endpoint: GET /projects/:id/users
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param search the string to match specific users - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param search the string to match specific users + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the users matching the search string and belonging to the specified project and its parent groups * @throws GitLabApiException if any exception occurs */ public Pager getProjectUsers(Object projectIdOrPath, String search, int itemsPerPage) throws GitLabApiException { MultivaluedMap params = (search != null ? new GitLabApiForm().withParam("search", search).asMap() : null); return (new Pager(this, ProjectUser.class, itemsPerPage, params, - "projects", getProjectIdOrPath(projectIdOrPath), "users")); + "projects", getProjectIdOrPath(projectIdOrPath), "users")); } /** @@ -1972,7 +1961,7 @@ public Pager getProjectUsers(Object projectIdOrPath, String search, * 
GitLab Endpoint: GET /projects/:id/users
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param search the string to match specific users + * @param search the string to match specific users * @return a Stream of the users matching the search string and belonging to the specified project and its parent groups * @throws GitLabApiException if any exception occurs */ @@ -1999,7 +1988,7 @@ public List getProjectGroups(Object projectIdOrPath) throws GitLab * 
GitLab Endpoint: GET /projects/:id/groups
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the ancestor groups for a given project * @throws GitLabApiException if any exception occurs */ @@ -2026,7 +2015,7 @@ public Stream getProjectGroupsStream(Object projectIdOrPath) throw * 
GitLab Endpoint: GET /projects/:id/groups
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param filter the ProjectGroupsFilter to match against + * @param filter the ProjectGroupsFilter to match against * @return the ancestor groups for a given project * @throws GitLabApiException if any exception occurs */ @@ -2040,8 +2029,8 @@ public List getProjectGroups(Object projectIdOrPath, ProjectGroups * 
GitLab Endpoint: GET /projects/:id/groups
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param filter the ProjectGroupsFilter to match against - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param filter the ProjectGroupsFilter to match against + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of the ancestor groups for a given project * @throws GitLabApiException if any exception occurs */ @@ -2056,7 +2045,7 @@ public Pager getProjectGroups(Object projectIdOrPath, ProjectGroup * 
GitLab Endpoint: GET /projects/:id/groups
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param filter the ProjectGroupsFilter to match against + * @param filter the ProjectGroupsFilter to match against * @return a Stream of the ancestor groups for a given project * @throws GitLabApiException if any exception occurs */ @@ -2083,15 +2072,14 @@ public List getProjectEvents(Object projectIdOrPath) throws GitLabApiExce * 
GitLab Endpoint: GET /projects/:id/events
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of Event instances per page + * @param page the page to get + * @param perPage the number of Event instances per page * @return the project events for the specified project * @throws GitLabApiException if any exception occurs */ public List getProjectEvents(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "events"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -2100,7 +2088,7 @@ public List getProjectEvents(Object projectIdOrPath, int page, int perPag * 
GitLab Endpoint: GET /projects/:id/events
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of project events for the specified project * @throws GitLabApiException if any exception occurs */ @@ -2140,15 +2128,14 @@ public List getHooks(Object projectIdOrPath) throws GitLabApiExcept * 
GitLab Endpoint: GET /projects/:id/hooks
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of ProjectHook instances per page + * @param page the page to get + * @param perPage the number of ProjectHook instances per page * @return a list of project hooks for the specified project in the specified page range * @throws GitLabApiException if any exception occurs */ public List getHooks(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "hooks"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -2157,7 +2144,7 @@ public List getHooks(Object projectIdOrPath, int page, int perPage) * 
GitLab Endpoint: GET /projects/:id/hooks
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of project hooks for the specified project * @throws GitLabApiException if any exception occurs */ @@ -2184,7 +2171,7 @@ public Stream getHooksStream(Object projectIdOrPath) throws GitLabA * 
GitLab Endpoint: GET /projects/:id/hooks/:hook_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param hookId the ID of the hook to get + * @param hookId the ID of the hook to get * @return the project hook for the specified project ID/hook ID pair * @throws GitLabApiException if any exception occurs */ @@ -2199,7 +2186,7 @@ public ProjectHook getHook(Object projectIdOrPath, Long hookId) throws GitLabApi * 
GitLab Endpoint: GET /projects/:id/hooks/:hook_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param hookId the ID of the hook to get + * @param hookId the ID of the hook to get * @return the project hook for the specified project ID/hook ID pair as an Optional instance */ public Optional getOptionalHook(Object projectIdOrPath, Long hookId) { @@ -2215,36 +2202,36 @@ public Optional getOptionalHook(Object projectIdOrPath, Long hookId * * 
GitLab Endpoint: POST /projects/:id/hooks
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param url the callback URL for the hook - * @param enabledHooks a ProjectHook instance specifying which hooks to enable + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param url the callback URL for the hook + * @param enabledHooks a ProjectHook instance specifying which hooks to enable * @param enableSslVerification enable SSL verification - * @param secretToken the secret token to pass back to the hook + * @param secretToken the secret token to pass back to the hook * @return the added ProjectHook instance * @throws GitLabApiException if any exception occurs */ public ProjectHook addHook(Object projectIdOrPath, String url, ProjectHook enabledHooks, - Boolean enableSslVerification, String secretToken) throws GitLabApiException { + Boolean enableSslVerification, String secretToken) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("url", url, true) - .withParam("push_events", enabledHooks.getPushEvents(), false) - .withParam("push_events_branch_filter", enabledHooks.getPushEventsBranchFilter(), false) - .withParam("issues_events", enabledHooks.getIssuesEvents(), false) - .withParam("confidential_issues_events", enabledHooks.getConfidentialIssuesEvents(), false) - .withParam("merge_requests_events", enabledHooks.getMergeRequestsEvents(), false) - .withParam("tag_push_events", enabledHooks.getTagPushEvents(), false) - .withParam("note_events", enabledHooks.getNoteEvents(), false) - .withParam("confidential_note_events", enabledHooks.getConfidentialNoteEvents(), false) - .withParam("job_events", enabledHooks.getJobEvents(), false) - .withParam("pipeline_events", enabledHooks.getPipelineEvents(), false) - .withParam("wiki_page_events", enabledHooks.getWikiPageEvents(), false) - .withParam("enable_ssl_verification", enableSslVerification, false) - .withParam("repository_update_events", enabledHooks.getRepositoryUpdateEvents(), false) - .withParam("deployment_events", enabledHooks.getDeploymentEvents(), false) - .withParam("releases_events", enabledHooks.getReleasesEvents(), false) - .withParam("deployment_events", enabledHooks.getDeploymentEvents(), false) - .withParam("token", secretToken, false); + .withParam("url", url, true) + .withParam("push_events", enabledHooks.getPushEvents(), false) + .withParam("push_events_branch_filter", enabledHooks.getPushEventsBranchFilter(), false) + .withParam("issues_events", enabledHooks.getIssuesEvents(), false) + .withParam("confidential_issues_events", enabledHooks.getConfidentialIssuesEvents(), false) + .withParam("merge_requests_events", enabledHooks.getMergeRequestsEvents(), false) + .withParam("tag_push_events", enabledHooks.getTagPushEvents(), false) + .withParam("note_events", enabledHooks.getNoteEvents(), false) + .withParam("confidential_note_events", enabledHooks.getConfidentialNoteEvents(), false) + .withParam("job_events", enabledHooks.getJobEvents(), false) + .withParam("pipeline_events", enabledHooks.getPipelineEvents(), false) + .withParam("wiki_page_events", enabledHooks.getWikiPageEvents(), false) + .withParam("enable_ssl_verification", enableSslVerification, false) + .withParam("repository_update_events", enabledHooks.getRepositoryUpdateEvents(), false) + .withParam("deployment_events", enabledHooks.getDeploymentEvents(), false) + .withParam("releases_events", enabledHooks.getReleasesEvents(), false) + .withParam("deployment_events", enabledHooks.getDeploymentEvents(), false) + .withParam("token", secretToken, false); Response response = post(Response.Status.CREATED, formData, "projects", getProjectIdOrPath(projectIdOrPath), "hooks"); return (response.readEntity(ProjectHook.class)); } @@ -2255,16 +2242,16 @@ public ProjectHook addHook(Object projectIdOrPath, String url, ProjectHook enabl * * 
GitLab Endpoint: POST /projects/:id/hooks
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param url the callback URL for the hook - * @param doPushEvents flag specifying whether to do push events - * @param doIssuesEvents flag specifying whether to do issues events + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param url the callback URL for the hook + * @param doPushEvents flag specifying whether to do push events + * @param doIssuesEvents flag specifying whether to do issues events * @param doMergeRequestsEvents flag specifying whether to do merge requests events * @return the added ProjectHook instance * @throws GitLabApiException if any exception occurs */ public ProjectHook addHook(Object projectIdOrPath, String url, boolean doPushEvents, - boolean doIssuesEvents, boolean doMergeRequestsEvents) throws GitLabApiException { + boolean doIssuesEvents, boolean doMergeRequestsEvents) throws GitLabApiException { return addHook(projectIdOrPath, url, doPushEvents, doIssuesEvents, doMergeRequestsEvents, null); } @@ -2274,23 +2261,23 @@ public ProjectHook addHook(Object projectIdOrPath, String url, boolean doPushEve * * 
GitLab Endpoint: POST /projects/:id/hooks
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param url the callback URL for the hook - * @param doPushEvents flag specifying whether to do push events - * @param doIssuesEvents flag specifying whether to do issues events + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param url the callback URL for the hook + * @param doPushEvents flag specifying whether to do push events + * @param doIssuesEvents flag specifying whether to do issues events * @param doMergeRequestsEvents flag specifying whether to do merge requests events - * @param doNoteEvents flag specifying whether to do note events + * @param doNoteEvents flag specifying whether to do note events * @return the added ProjectHook instance * @throws GitLabApiException if any exception occurs */ public ProjectHook addHook(Object projectIdOrPath, String url, Boolean doPushEvents, - Boolean doIssuesEvents, Boolean doMergeRequestsEvents, Boolean doNoteEvents) throws GitLabApiException { + Boolean doIssuesEvents, Boolean doMergeRequestsEvents, Boolean doNoteEvents) throws GitLabApiException { ProjectHook enabledHooks = new ProjectHook() .withPushEvents(doPushEvents) .withIssuesEvents(doIssuesEvents) .withMergeRequestsEvents(doMergeRequestsEvents) .withNoteEvents(doNoteEvents); - return addHook(projectIdOrPath, url, enabledHooks, null, null); + return addHook(projectIdOrPath, url, enabledHooks , null, null); } /** @@ -2299,7 +2286,7 @@ public ProjectHook addHook(Object projectIdOrPath, String url, Boolean doPushEve * 
GitLab Endpoint: DELETE /projects/:id/hooks/:hook_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param hookId the project hook ID to delete + * @param hookId the project hook ID to delete * @throws GitLabApiException if any exception occurs */ public void deleteHook(Object projectIdOrPath, Long hookId) throws GitLabApiException { @@ -2374,8 +2361,8 @@ public List getIssues(Object projectIdOrPath) throws GitLabApiException { * 
GitLab Endpoint: GET /projects/:id/issues
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of issues per page + * @param page the page to get + * @param perPage the number of issues per page * @return the list of issues in the specified range * @throws GitLabApiException if any exception occurs * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#getIssues(Object, int, int)} @@ -2383,8 +2370,7 @@ public List getIssues(Object projectIdOrPath) throws GitLabApiException { @Deprecated public List getIssues(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "issues"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -2393,7 +2379,7 @@ public List getIssues(Object projectIdOrPath, int page, int perPage) thro * 
GitLab Endpoint: GET /projects/:id/issues
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of issues per page + * @param itemsPerPage the number of issues per page * @return the list of issues in the specified range * @throws GitLabApiException if any exception occurs * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#getIssues(Object, int)} @@ -2424,10 +2410,10 @@ public Stream getIssuesStream(Object projectIdOrPath) throws GitLabApiExc * 
GitLab Endpoint: GET /projects/:id/issues/:issue_iid
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param issueId the internal ID of a project's issue + * @param issueId the internal ID of a project's issue * @return the specified Issue instance * @throws GitLabApiException if any exception occurs - * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#getIssue(Object, Long)} + * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#getIssue(Object, Long)} */ @Deprecated public Issue getIssue(Object projectIdOrPath, Long issueId) throws GitLabApiException { @@ -2441,9 +2427,9 @@ public Issue getIssue(Object projectIdOrPath, Long issueId) throws GitLabApiExce * 
GitLab Endpoint: DELETE /projects/:id/issues/:issue_iid
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param issueId the internal ID of a project's issue + * @param issueId the internal ID of a project's issue * @throws GitLabApiException if any exception occurs - * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#deleteIssue(Object, Long)} + * @deprecated Will be removed in version 6.0, replaced by {@link IssuesApi#deleteIssue(Object, Long)} */ @Deprecated public void deleteIssue(Object projectIdOrPath, Long issueId) throws GitLabApiException { @@ -2470,15 +2456,14 @@ public List getSnippets(Object projectIdOrPath) throws GitLabApiExcepti * 
GitLab Endpoint: GET /projects/:id/snippets
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of snippets per page + * @param page the page to get + * @param perPage the number of snippets per page * @return a list of project's snippets for the specified range * @throws GitLabApiException if any exception occurs */ public List getSnippets(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "snippets"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -2487,7 +2472,7 @@ public List getSnippets(Object projectIdOrPath, int page, int perPage) * 
GitLab Endpoint: GET /projects/:id/snippets
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of snippets per page + * @param itemsPerPage the number of snippets per page * @return the Pager of snippets * @throws GitLabApiException if any exception occurs */ @@ -2514,7 +2499,7 @@ public Stream getSnippetsStream(Object projectIdOrPath) throws GitLabAp * 
GitLab Endpoint: GET /projects/:id/snippets/:snippet_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param snippetId the ID of the project's snippet + * @param snippetId the ID of the project's snippet * @return the specified project Snippet * @throws GitLabApiException if any exception occurs */ @@ -2529,7 +2514,7 @@ public Snippet getSnippet(Object projectIdOrPath, Long snippetId) throws GitLabA * 
GitLab Endpoint: GET /projects/:id/snippets/:snippet_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param snippetId the ID of the project's snippet + * @param snippetId the ID of the project's snippet * @return the specified project Snippet as an Optional instance */ public Optional getOptionalSnippet(Object projectIdOrPath, Long snippetId) { @@ -2546,25 +2531,25 @@ public Optional getOptionalSnippet(Object projectIdOrPath, Long snippet * 
GitLab Endpoint: POST /projects/:id/snippets
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param title the title of a snippet, required - * @param filename the name of a snippet file, required - * @param description the description of a snippet, optional - * @param content the content of a snippet, required - * @param visibility the snippet's visibility, required + * @param title the title of a snippet, required + * @param filename the name of a snippet file, required + * @param description the description of a snippet, optional + * @param content the content of a snippet, required + * @param visibility the snippet's visibility, required * @return a Snippet instance with info on the created snippet * @throws GitLabApiException if any exception occurs */ public Snippet createSnippet(Object projectIdOrPath, String title, String filename, String description, - String content, Visibility visibility) throws GitLabApiException { + String content, Visibility visibility) throws GitLabApiException { try { GitLabApiForm form = new GitLabApiForm() - .withParam("title", title, true) - .withParam("file_name", filename, true) - .withParam("description", description) - .withParam("content", content, true) - .withParam("visibility", visibility, true); + .withParam("title", title, true) + .withParam("file_name", filename, true) + .withParam("description", description) + .withParam("content", content, true) + .withParam("visibility", visibility, true); Response response = post(Response.Status.CREATED, form, "projects", getProjectIdOrPath(projectIdOrPath), "snippets"); return (response.readEntity(Snippet.class)); @@ -2577,11 +2562,11 @@ public Snippet createSnippet(Object projectIdOrPath, String title, String filena } GitLabApiForm form = new GitLabApiForm() - .withParam("title", title, true) - .withParam("file_name", filename, true) - .withParam("description", description) - .withParam("code", content, true) - .withParam("visibility", visibility, true); + .withParam("title", title, true) + .withParam("file_name", filename, true) + .withParam("description", description) + .withParam("code", content, true) + .withParam("visibility", visibility, true); Response response = post(Response.Status.CREATED, form, "projects", getProjectIdOrPath(projectIdOrPath), "snippets"); return (response.readEntity(Snippet.class)); @@ -2594,24 +2579,24 @@ public Snippet createSnippet(Object projectIdOrPath, String title, String filena * 
GitLab Endpoint: PUT /projects/:id/snippets/:snippet_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param snippetId the ID of a project's snippet, required - * @param title the title of a snippet, optional - * @param filename the name of a snippet file, optional - * @param description the description of a snippet, optioptionalonal - * @param code the content of a snippet, optional - * @param visibility the snippet's visibility, reqoptionaluired + * @param snippetId the ID of a project's snippet, required + * @param title the title of a snippet, optional + * @param filename the name of a snippet file, optional + * @param description the description of a snippet, optioptionalonal + * @param code the content of a snippet, optional + * @param visibility the snippet's visibility, reqoptionaluired * @return a Snippet instance with info on the updated snippet * @throws GitLabApiException if any exception occurs */ public Snippet updateSnippet(Object projectIdOrPath, Long snippetId, String title, String filename, String description, - String code, Visibility visibility) throws GitLabApiException { + String code, Visibility visibility) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("title", title) - .withParam("file_name", filename) - .withParam("description", description) - .withParam("code", code) - .withParam("visibility", visibility); + .withParam("title", title) + .withParam("file_name", filename) + .withParam("description", description) + .withParam("code", code) + .withParam("visibility", visibility); Response response = put(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "snippets", snippetId); return (response.readEntity(Snippet.class)); @@ -2637,7 +2622,7 @@ public void deleteSnippet(Object projectIdOrPath, Long snippetId) throws GitLabA * 
GitLab Endpoint: GET /projects/:id/snippets/:snippet_id/raw
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param snippetId the ID of the project's snippet + * @param snippetId the ID of the project's snippet * @return the raw project snippet plain text as an Optional instance * @throws GitLabApiException if any exception occurs */ @@ -2652,7 +2637,7 @@ public String getRawSnippetContent(Object projectIdOrPath, Long snippetId) throw * 
GitLab Endpoint: GET /projects/:id/snippets/:snippet_id/raw
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param snippetId the ID of the project's snippet + * @param snippetId the ID of the project's snippet * @return the raw project snippet plain text as an Optional instance */ public Optional getOptionalRawSnippetContent(Object projectIdOrPath, Long snippetId) { @@ -2669,13 +2654,13 @@ public Optional getOptionalRawSnippetContent(Object projectIdOrPath, Lon * 
GitLab Endpoint: POST /projects/:id/share
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param groupId the ID of the group to share with, required - * @param accessLevel the permissions level to grant the group, required - * @param expiresAt the share expiration date, optional + * @param groupId the ID of the group to share with, required + * @param accessLevel the permissions level to grant the group, required + * @param expiresAt the share expiration date, optional * @throws GitLabApiException if any exception occurs */ public void shareProject(Object projectIdOrPath, Long groupId, AccessLevel accessLevel, Date expiresAt) - throws GitLabApiException { + throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() .withParam("group_id", groupId, true) .withParam("group_access", accessLevel, true) @@ -2689,7 +2674,7 @@ public void shareProject(Object projectIdOrPath, Long groupId, AccessLevel acces * 
GitLab Endpoint: DELETE /projects/:id/share/:group_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param groupId the ID of the group to unshare, required + * @param groupId the ID of the group to unshare, required * @throws GitLabApiException if any exception occurs */ public void unshareProject(Object projectIdOrPath, Long groupId) throws GitLabApiException { @@ -2707,7 +2692,7 @@ public void unshareProject(Object projectIdOrPath, Long groupId) throws GitLabAp * @throws GitLabApiException if any exception occurs */ public Project archiveProject(Object projectIdOrPath) - throws GitLabApiException { + throws GitLabApiException { Response response = post(Response.Status.CREATED, (new GitLabApiForm()), "projects", getProjectIdOrPath(projectIdOrPath), "archive"); return (response.readEntity(Project.class)); } @@ -2722,7 +2707,7 @@ public Project archiveProject(Object projectIdOrPath) * @throws GitLabApiException if any exception occurs */ public Project unarchiveProject(Object projectIdOrPath) - throws GitLabApiException { + throws GitLabApiException { Response response = post(Response.Status.CREATED, (new GitLabApiForm()), "projects", getProjectIdOrPath(projectIdOrPath), "unarchive"); return (response.readEntity(Project.class)); } @@ -2733,7 +2718,7 @@ public Project unarchiveProject(Object projectIdOrPath) * 
GitLab Endpoint: POST /projects/:id/uploads
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param fileToUpload the File instance of the file to upload, required + * @param fileToUpload the File instance of the file to upload, required * @return a FileUpload instance with information on the just uploaded file * @throws GitLabApiException if any exception occurs */ @@ -2747,8 +2732,8 @@ public FileUpload uploadFile(Object projectIdOrPath, File fileToUpload) throws G * 
GitLab Endpoint: POST /projects/:id/uploads
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param fileToUpload the File instance of the file to upload, required - * @param mediaType unused; will be removed in the next major version + * @param fileToUpload the File instance of the file to upload, required + * @param mediaType unused; will be removed in the next major version * @return a FileUpload instance with information on the just uploaded file * @throws GitLabApiException if any exception occurs */ @@ -2764,9 +2749,9 @@ public FileUpload uploadFile(Object projectIdOrPath, File fileToUpload, String m * 
GitLab Endpoint: POST /projects/:id/uploads
* * @param projectIdOrPath the project in the form of an Integer(ID), String(path), or Project instance, required - * @param inputStream the data to upload, required - * @param filename The filename of the file to upload - * @param mediaType unused; will be removed in the next major version + * @param inputStream the data to upload, required + * @param filename The filename of the file to upload + * @param mediaType unused; will be removed in the next major version * @return a FileUpload instance with information on the just uploaded file * @throws GitLabApiException if any exception occurs */ @@ -2793,10 +2778,10 @@ public PushRules getPushRules(Object projectIdOrPath) throws GitLabApiException * Adds a push rule to a specified project. * * 
GitLab Endpoint: POST /projects/:id/push_rule
- *

+ * * The following properties on the PushRules instance are utilized in the creation of the push rule: * - * + * * denyDeleteTag (optional) - Deny deleting a tag * memberCheck (optional) - Restrict commits by author (email) to existing GitLab users * preventSecrets (optional) - GitLab will reject any files that are likely to contain secrets @@ -2808,10 +2793,10 @@ public PushRules getPushRules(Object projectIdOrPath) throws GitLabApiException * maxFileSize (optional) - Maximum file size (MB) * commitCommitterCheck (optional) - Users can only push commits to this repository that were committed with one of their own verified emails. * rejectUnsignedCommits (optional) - Reject commit when it is not signed through GPG - * + * * * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param pushRule the PushRule instance containing the push rule configuration to add + * @param pushRule the PushRule instance containing the push rule configuration to add * @return a PushRules instance with the newly created push rule info * @throws GitLabApiException if any exception occurs */ @@ -2837,10 +2822,10 @@ public PushRules createPushRules(Object projectIdOrPath, PushRules pushRule) thr * Updates a push rule for the specified project. * * 

GitLab Endpoint: PUT /projects/:id/push_rule/:push_rule_id
- *

+ * * The following properties on the PushRules instance are utilized when updating the push rule: * - * + * * denyDeleteTag (optional) - Deny deleting a tag * memberCheck (optional) - Restrict commits by author (email) to existing GitLab users * preventSecrets (optional) - GitLab will reject any files that are likely to contain secrets @@ -2852,10 +2837,10 @@ public PushRules createPushRules(Object projectIdOrPath, PushRules pushRule) thr * maxFileSize (optional) - Maximum file size (MB) * commitCommitterCheck (optional) - Users can only push commits to this repository that were committed with one of their own verified emails. * rejectUnsignedCommits (optional) - Reject commit when it is not signed through GPG - * + * * * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param pushRule the PushRules instance containing the push rule configuration to update + * @param pushRule the PushRules instance containing the push rule configuration to update * @return a PushRules instance with the newly created push rule info * @throws GitLabApiException if any exception occurs */ @@ -2909,15 +2894,14 @@ public List getForks(Object projectIdOrPath) throws GitLabApiException * 

GitLab Endpoint: GET /projects/:id/forks
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of projects per page + * @param page the page to get + * @param perPage the number of projects per page * @return a List of forked projects * @throws GitLabApiException if any exception occurs */ public List getForks(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { - Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "forks"); - return (response.readEntity(new GenericType>() { - })); + Response response = get(Response.Status.OK, getPageQueryParams(page, perPage),"projects", getProjectIdOrPath(projectIdOrPath), "forks"); + return (response.readEntity(new GenericType>() { })); } /** @@ -2926,7 +2910,7 @@ public List getForks(Object projectIdOrPath, int page, int perPage) thr * 
GitLab Endpoint: GET /projects/:id/forks
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of Project instances that will be fetched per page + * @param itemsPerPage the number of Project instances that will be fetched per page * @return a Pager of projects * @throws GitLabApiException if any exception occurs */ @@ -2989,8 +2973,7 @@ public Project unstarProject(Object projectIdOrPath) throws GitLabApiException { */ public Map getProjectLanguages(Object projectIdOrPath) throws GitLabApiException { Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "languages"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -2999,7 +2982,7 @@ public Map getProjectLanguages(Object projectIdOrPath) throws Git * 
GitLab Endpoint: PUT /projects/:id/transfer.
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param namespace the namespace to transfer the project to + * @param namespace the namespace to transfer the project to * @return the updated Project * @throws GitLabApiException if any exception occurs */ @@ -3015,13 +2998,13 @@ public Project transferProject(Object projectIdOrPath, String namespace) throws * 
GitLab Endpoint: PUT /projects/:id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param avatarFile the File instance of the avatar file to upload + * @param avatarFile the File instance of the avatar file to upload * @return the updated Project instance * @throws GitLabApiException if any exception occurs */ public Project setProjectAvatar(Object projectIdOrPath, File avatarFile) throws GitLabApiException { Response response = putUpload(Response.Status.OK, - "avatar", avatarFile, "projects", getProjectIdOrPath(projectIdOrPath)); + "avatar", avatarFile, "projects", getProjectIdOrPath(projectIdOrPath)); return (response.readEntity(Project.class)); } @@ -3031,8 +3014,8 @@ public Project setProjectAvatar(Object projectIdOrPath, File avatarFile) throws * 
GET /projects/:id/audit_events
* * @param projectIdOrPath the project ID, path of the project, or a project instance holding the project ID or path - * @param created_after Project audit events created on or after the given time. - * @param created_before Project audit events created on or before the given time. + * @param created_after Project audit events created on or after the given time. + * @param created_before Project audit events created on or before the given time. * @return a List of project Audit events * @throws GitLabApiException if any exception occurs */ @@ -3046,18 +3029,18 @@ public List getAuditEvents(Object projectIdOrPath, Date created_afte * 
GET /projects/:id/audit_events
* * @param projectIdOrPath the project ID, path of the project, or a Project instance holding the project ID or path - * @param created_after Project audit events created on or after the given time. - * @param created_before Project audit events created on or before the given time. - * @param itemsPerPage the number of Audit Event instances that will be fetched per page + * @param created_after Project audit events created on or after the given time. + * @param created_before Project audit events created on or before the given time. + * @param itemsPerPage the number of Audit Event instances that will be fetched per page * @return a Pager of project Audit events * @throws GitLabApiException if any exception occurs */ public Pager getAuditEvents(Object projectIdOrPath, Date created_after, Date created_before, int itemsPerPage) throws GitLabApiException { Form form = new GitLabApiForm() - .withParam("created_before", ISO8601.toString(created_before, false)) - .withParam("created_after", ISO8601.toString(created_after, false)); + .withParam("created_before", ISO8601.toString(created_before, false)) + .withParam("created_after", ISO8601.toString(created_after, false)); return (new Pager(this, AuditEvent.class, itemsPerPage, form.asMap(), - "projects", getProjectIdOrPath(projectIdOrPath), "audit_events")); + "projects", getProjectIdOrPath(projectIdOrPath), "audit_events")); } /** @@ -3066,8 +3049,8 @@ public Pager getAuditEvents(Object projectIdOrPath, Date created_aft * 
GET /projects/:id/audit_events
* * @param projectIdOrPath the project ID, path of the project, or a Project instance holding the project ID or path - * @param created_after Project audit events created on or after the given time. - * @param created_before Project audit events created on or before the given time. + * @param created_after Project audit events created on or after the given time. + * @param created_before Project audit events created on or before the given time. * @return a Stream of project Audit events * @throws GitLabApiException if any exception occurs */ @@ -3081,7 +3064,7 @@ public Stream getAuditEventsStream(Object projectIdOrPath, Date crea * 
GitLab Endpoint: GET /projects/:id/audit_events/:id_audit_event
* * @param projectIdOrPath the project ID, path of the project, or a Project instance holding the project ID or path - * @param auditEventId the auditEventId, required + * @param auditEventId the auditEventId, required * @return the project Audit event * @throws GitLabApiException if any exception occurs */ @@ -3109,15 +3092,14 @@ public List getVariables(Object projectIdOrPath) throws GitLabApiExcep * 
GitLab Endpoint: GET /projects/:id/variables
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param page the page to get - * @param perPage the number of Variable instances per page + * @param page the page to get + * @param perPage the number of Variable instances per page * @return a list of variables belonging to the specified project in the specified page range * @throws GitLabApiException if any exception occurs */ public List getVariables(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "variables"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() {})); } /** @@ -3126,7 +3108,7 @@ public List getVariables(Object projectIdOrPath, int page, int perPage * 
GitLab Endpoint: GET /projects/:id/variables
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param itemsPerPage the number of Variable instances that will be fetched per page + * @param itemsPerPage the number of Variable instances that will be fetched per page * @return a Pager of variables belonging to the specified project * @throws GitLabApiException if any exception occurs */ @@ -3153,13 +3135,13 @@ public Stream getVariablesStream(Object projectIdOrPath) throws GitLab * 
GitLab Endpoint: GET /projects/:id/variables/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required + * @param key the key of an existing variable, required * @return the Variable instance for the specified variable * @throws GitLabApiException if any exception occurs */ public Variable getVariable(Object projectIdOrPath, String key) throws GitLabApiException { - Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "variables", key); - return (response.readEntity(Variable.class)); + Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "variables", key); + return (response.readEntity(Variable.class)); } /** @@ -3168,7 +3150,7 @@ public Variable getVariable(Object projectIdOrPath, String key) throws GitLabApi * 
GitLab Endpoint: GET /projects/:id/variables/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required + * @param key the key of an existing variable, required * @return the Variable for the specified variable as an Optional instance */ public Optional getOptionalVariable(Object projectIdOrPath, String key) { @@ -3185,9 +3167,9 @@ public Optional getOptionalVariable(Object projectIdOrPath, String key * 
GitLab Endpoint: POST /projects/:id/variables
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required - * @param value the value for the variable, required - * @param isProtected whether the variable is protected, optional + * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required + * @param value the value for the variable, required + * @param isProtected whether the variable is protected, optional * @return a Variable instance with the newly created variable * @throws GitLabApiException if any exception occurs during execution */ @@ -3202,10 +3184,10 @@ public Variable createVariable(Object projectIdOrPath, String key, String value, * * 
GitLab Endpoint: POST /projects/:id/variables
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required - * @param value the value for the variable, required - * @param isProtected whether the variable is protected, optional + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required + * @param value the value for the variable, required + * @param isProtected whether the variable is protected, optional * @param environmentScope the environment_scope of the variable, optional * @return a Variable instance with the newly created variable * @throws GitLabApiException if any exception occurs during execution @@ -3222,16 +3204,16 @@ public Variable createVariable(Object projectIdOrPath, String key, String value, * 
GitLab Endpoint: POST /projects/:id/variables
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required - * @param value the value for the variable, required - * @param variableType the type of variable. Available types are: env_var (default) and file - * @param isProtected whether the variable is protected, optional - * @param isMasked whether the variable is masked, optional + * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required + * @param value the value for the variable, required + * @param variableType the type of variable. Available types are: env_var (default) and file + * @param isProtected whether the variable is protected, optional + * @param isMasked whether the variable is masked, optional * @return a Variable instance with the newly created variable * @throws GitLabApiException if any exception occurs during execution */ public Variable createVariable(Object projectIdOrPath, String key, String value, Variable.Type variableType, - Boolean isProtected, Boolean isMasked) throws GitLabApiException { + Boolean isProtected, Boolean isMasked) throws GitLabApiException { return createVariable(projectIdOrPath, key, value, variableType, isProtected, isMasked, null); } @@ -3242,26 +3224,26 @@ public Variable createVariable(Object projectIdOrPath, String key, String value, * * 
GitLab Endpoint: POST /projects/:id/variables
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required - * @param value the value for the variable, required - * @param variableType the type of variable. Available types are: env_var (default) and file - * @param isProtected whether the variable is protected, optional - * @param isMasked whether the variable is masked, optional + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param key the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required + * @param value the value for the variable, required + * @param variableType the type of variable. Available types are: env_var (default) and file + * @param isProtected whether the variable is protected, optional + * @param isMasked whether the variable is masked, optional * @param environmentScope the environment_scope of the variable, optional * @return a Variable instance with the newly created variable * @throws GitLabApiException if any exception occurs during execution */ public Variable createVariable(Object projectIdOrPath, String key, String value, Variable.Type variableType, - Boolean isProtected, Boolean isMasked, String environmentScope) throws GitLabApiException { + Boolean isProtected, Boolean isMasked, String environmentScope) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("key", key, true) - .withParam("value", value, true) - .withParam("variable_type", variableType) - .withParam("protected", isProtected) - .withParam("masked", isMasked) - .withParam("environment_scope", environmentScope); + .withParam("key", key, true) + .withParam("value", value, true) + .withParam("variable_type", variableType) + .withParam("protected", isProtected) + .withParam("masked", isMasked) + .withParam("environment_scope", environmentScope); Response response = post(Response.Status.CREATED, formData, "projects", getProjectIdOrPath(projectIdOrPath), "variables"); return (response.readEntity(Variable.class)); } @@ -3272,9 +3254,9 @@ public Variable createVariable(Object projectIdOrPath, String key, String value, * 
GitLab Endpoint: PUT /projects/:id/variables/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required - * @param value the value for the variable, required - * @param isProtected whether the variable is protected, optional + * @param key the key of an existing variable, required + * @param value the value for the variable, required + * @param isProtected whether the variable is protected, optional * @return a Variable instance with the updated variable * @throws GitLabApiException if any exception occurs during execution */ @@ -3289,10 +3271,10 @@ public Variable updateVariable(Object projectIdOrPath, String key, String value, * * 
GitLab Endpoint: PUT /projects/:id/variables/:key
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required - * @param value the value for the variable, required - * @param isProtected whether the variable is protected, optional + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param key the key of an existing variable, required + * @param value the value for the variable, required + * @param isProtected whether the variable is protected, optional * @param environmentScope the environment_scope of the variable, optional. * @return a Variable instance with the updated variable * @throws GitLabApiException if any exception occurs during execution @@ -3309,16 +3291,16 @@ public Variable updateVariable(Object projectIdOrPath, String key, String value, * 
GitLab Endpoint: PUT /projects/:id/variables/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required - * @param value the value for the variable, required - * @param variableType the type of variable. Available types are: env_var (default) and file - * @param isProtected whether the variable is protected, optional - * @param masked whether the variable is masked, optional + * @param key the key of an existing variable, required + * @param value the value for the variable, required + * @param variableType the type of variable. Available types are: env_var (default) and file + * @param isProtected whether the variable is protected, optional + * @param masked whether the variable is masked, optional * @return a Variable instance with the updated variable * @throws GitLabApiException if any exception occurs during execution */ public Variable updateVariable(Object projectIdOrPath, String key, String value, Variable.Type variableType, - Boolean isProtected, Boolean masked) throws GitLabApiException { + Boolean isProtected, Boolean masked) throws GitLabApiException { return updateVariable(projectIdOrPath, key, value, variableType, isProtected, masked, null); } @@ -3329,25 +3311,25 @@ public Variable updateVariable(Object projectIdOrPath, String key, String value, * * 
GitLab Endpoint: PUT /projects/:id/variables/:key
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required - * @param value the value for the variable, required - * @param variableType the type of variable. Available types are: env_var (default) and file - * @param isProtected whether the variable is protected, optional - * @param masked whether the variable is masked, optional + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required + * @param key the key of an existing variable, required + * @param value the value for the variable, required + * @param variableType the type of variable. Available types are: env_var (default) and file + * @param isProtected whether the variable is protected, optional + * @param masked whether the variable is masked, optional * @param environmentScope the environment_scope of the variable, optional. * @return a Variable instance with the updated variable * @throws GitLabApiException if any exception occurs during execution */ public Variable updateVariable(Object projectIdOrPath, String key, String value, Variable.Type variableType, - Boolean isProtected, Boolean masked, String environmentScope) throws GitLabApiException { + Boolean isProtected, Boolean masked, String environmentScope) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("value", value, true) - .withParam("variable_type", variableType) - .withParam("protected", isProtected) - .withParam("masked", masked) - .withParam("environment_scope", environmentScope); + .withParam("value", value, true) + .withParam("variable_type", variableType) + .withParam("protected", isProtected) + .withParam("masked", masked) + .withParam("environment_scope", environmentScope); Response response = putWithFormData(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "variables", key); return (response.readEntity(Variable.class)); } @@ -3358,7 +3340,7 @@ public Variable updateVariable(Object projectIdOrPath, String key, String value, * 
GitLab Endpoint: DELETE /projects/:id/variables/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key of an existing variable, required + * @param key the key of an existing variable, required * @throws GitLabApiException if any exception occurs */ public void deleteVariable(Object projectIdOrPath, String key) throws GitLabApiException { @@ -3384,7 +3366,7 @@ public List getAccessRequests(Object projectIdOrPath) throws GitL * 
GitLab Endpoint: GET /projects/:id/access_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of AccessRequest instances that will be fetched per page + * @param itemsPerPage the number of AccessRequest instances that will be fetched per page * @return a Pager of project AccessRequest instances accessible by the authenticated user * @throws GitLabApiException if any exception occurs */ @@ -3402,7 +3384,7 @@ public Pager getAccessRequests(Object projectIdOrPath, int itemsP * @throws GitLabApiException if any exception occurs */ public Stream getAccessRequestsStream(Object projectIdOrPath) throws GitLabApiException { - return (getAccessRequests(projectIdOrPath, getDefaultPerPage()).stream()); + return (getAccessRequests(projectIdOrPath, getDefaultPerPage()).stream()); } /** @@ -3415,7 +3397,7 @@ public Stream getAccessRequestsStream(Object projectIdOrPath) thr * @throws GitLabApiException if any exception occurs */ public AccessRequest requestAccess(Object projectIdOrPath) throws GitLabApiException { - Response response = post(Response.Status.CREATED, (Form) null, "projects", getProjectIdOrPath(projectIdOrPath), "access_requests"); + Response response = post(Response.Status.CREATED, (Form)null, "projects", getProjectIdOrPath(projectIdOrPath), "access_requests"); return (response.readEntity(AccessRequest.class)); } @@ -3425,15 +3407,15 @@ public AccessRequest requestAccess(Object projectIdOrPath) throws GitLabApiExcep * 
GitLab Endpoint: PUT /projects/:id/access_requests/:user_id/approve
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID to approve access for - * @param accessLevel the access level the user is approved for, if null will be developer (30) + * @param userId the user ID to approve access for + * @param accessLevel the access level the user is approved for, if null will be developer (30) * @return the approved AccessRequest instance * @throws GitLabApiException if any exception occurs */ public AccessRequest approveAccessRequest(Object projectIdOrPath, Long userId, AccessLevel accessLevel) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm().withParam("access_level", accessLevel); Response response = this.putWithFormData(Response.Status.CREATED, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "access_requests", userId, "approve"); + "projects", getProjectIdOrPath(projectIdOrPath), "access_requests", userId, "approve"); return (response.readEntity(AccessRequest.class)); } @@ -3443,12 +3425,12 @@ public AccessRequest approveAccessRequest(Object projectIdOrPath, Long userId, A * 
GitLab Endpoint: DELETE /projects/:id/access_requests/:user_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param userId the user ID to deny access for + * @param userId the user ID to deny access for * @throws GitLabApiException if any exception occurs */ public void denyAccessRequest(Object projectIdOrPath, Long userId) throws GitLabApiException { delete(Response.Status.NO_CONTENT, null, - "projects", getProjectIdOrPath(projectIdOrPath), "access_requests", userId); + "projects", getProjectIdOrPath(projectIdOrPath), "access_requests", userId); } /** @@ -3473,7 +3455,7 @@ public void triggerHousekeeping(Object projectIdOrPath) throws GitLabApiExceptio * @throws GitLabApiException if any exception occurs */ public List getBadges(Object projectIdOrPath) throws GitLabApiException { - return getBadges(projectIdOrPath, null); + return getBadges(projectIdOrPath, null); } /** @@ -3482,15 +3464,14 @@ public List getBadges(Object projectIdOrPath) throws GitLabApiException { * 
GitLab Endpoint: GET /projects/:id/badges?name=:name
* * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param bagdeName The name to filter on (case-sensitive), ignored if null. + * @param bagdeName The name to filter on (case-sensitive), ignored if null. * @return All badges of the GitLab item, case insensitively filtered on name. * @throws GitLabApiException If any problem is encountered */ public List getBadges(Object projectIdOrPath, String bagdeName) throws GitLabApiException { - Form queryParam = new GitLabApiForm().withParam("name", bagdeName); - Response response = get(Response.Status.OK, queryParam.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "badges"); - return (response.readEntity(new GenericType>() { - })); + Form queryParam = new GitLabApiForm().withParam("name", bagdeName); + Response response = get(Response.Status.OK, queryParam.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "badges"); + return (response.readEntity(new GenericType>() {})); } /** @@ -3499,13 +3480,13 @@ public List getBadges(Object projectIdOrPath, String bagdeName) throws Gi * 
GitLab Endpoint: GET /projects/:id/badges/:badge_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param badgeId the ID of the badge to get + * @param badgeId the ID of the badge to get * @return a Badge instance for the specified project/badge ID pair * @throws GitLabApiException if any exception occurs */ public Badge getBadge(Object projectIdOrPath, Long badgeId) throws GitLabApiException { - Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "badges", badgeId); - return (response.readEntity(Badge.class)); + Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "badges", badgeId); + return (response.readEntity(Badge.class)); } /** @@ -3514,15 +3495,15 @@ public Badge getBadge(Object projectIdOrPath, Long badgeId) throws GitLabApiExce * 
GitLab Endpoint: GET /projects/:id/badges/:badge_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param badgeId the ID of the badge to get + * @param badgeId the ID of the badge to get * @return an Optional instance with the specified badge as the value */ public Optional getOptionalBadge(Object projectIdOrPath, Long badgeId) { - try { - return (Optional.ofNullable(getBadge(projectIdOrPath, badgeId))); - } catch (GitLabApiException glae) { - return (GitLabApi.createOptionalFromException(glae)); - } + try { + return (Optional.ofNullable(getBadge(projectIdOrPath, badgeId))); + } catch (GitLabApiException glae) { + return (GitLabApi.createOptionalFromException(glae)); + } } /** @@ -3531,13 +3512,13 @@ public Optional getOptionalBadge(Object projectIdOrPath, Long badgeId) { * 
GitLab Endpoint: POST /projects/:id/badges
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param linkUrl the URL of the badge link - * @param imageUrl the URL of the image link + * @param linkUrl the URL of the badge link + * @param imageUrl the URL of the image link * @return a Badge instance for the added badge * @throws GitLabApiException if any exception occurs */ public Badge addBadge(Object projectIdOrPath, String linkUrl, String imageUrl) throws GitLabApiException { - return addBadge(projectIdOrPath, null, linkUrl, imageUrl); + return addBadge(projectIdOrPath, null, linkUrl, imageUrl); } /** @@ -3546,19 +3527,19 @@ public Badge addBadge(Object projectIdOrPath, String linkUrl, String imageUrl) t * 
GitLab Endpoint: POST /projects/:id/badges
* * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param name The name to give the badge (may be null) - * @param linkUrl the URL of the badge link - * @param imageUrl the URL of the image link + * @param name The name to give the badge (may be null) + * @param linkUrl the URL of the badge link + * @param imageUrl the URL of the image link * @return A Badge instance for the added badge * @throws GitLabApiException if any exception occurs */ public Badge addBadge(Object projectIdOrPath, String name, String linkUrl, String imageUrl) throws GitLabApiException { - GitLabApiForm formData = new GitLabApiForm() - .withParam("name", name, false) - .withParam("link_url", linkUrl, true) - .withParam("image_url", imageUrl, true); - Response response = post(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "badges"); - return (response.readEntity(Badge.class)); + GitLabApiForm formData = new GitLabApiForm() + .withParam("name", name, false) + .withParam("link_url", linkUrl, true) + .withParam("image_url", imageUrl, true); + Response response = post(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "badges"); + return (response.readEntity(Badge.class)); } /** @@ -3567,14 +3548,14 @@ public Badge addBadge(Object projectIdOrPath, String name, String linkUrl, Strin * 
GitLab Endpoint: PUT /projects/:id/badges
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param badgeId the ID of the badge to get - * @param linkUrl the URL of the badge link - * @param imageUrl the URL of the image link + * @param badgeId the ID of the badge to get + * @param linkUrl the URL of the badge link + * @param imageUrl the URL of the image link * @return a Badge instance for the editted badge * @throws GitLabApiException if any exception occurs */ public Badge editBadge(Object projectIdOrPath, Long badgeId, String linkUrl, String imageUrl) throws GitLabApiException { - return (editBadge(projectIdOrPath, badgeId, null, linkUrl, imageUrl)); + return (editBadge(projectIdOrPath, badgeId, null, linkUrl, imageUrl)); } /** @@ -3583,10 +3564,10 @@ public Badge editBadge(Object projectIdOrPath, Long badgeId, String linkUrl, Str * 
GitLab Endpoint: PUT /projects/:id/badges
* * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param badgeId the ID of the badge to edit - * @param name The name of the badge to edit (may be null) - * @param linkUrl the URL of the badge link - * @param imageUrl the URL of the image link + * @param badgeId the ID of the badge to edit + * @param name The name of the badge to edit (may be null) + * @param linkUrl the URL of the badge link + * @param imageUrl the URL of the image link * @return a Badge instance for the editted badge * @throws GitLabApiException if any exception occurs */ @@ -3605,11 +3586,11 @@ public Badge editBadge(Object projectIdOrPath, Long badgeId, String name, String * 
GitLab Endpoint: DELETE /projects/:id/badges/:badge_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param badgeId the ID of the badge to remove + * @param badgeId the ID of the badge to remove * @throws GitLabApiException if any exception occurs */ public void removeBadge(Object projectIdOrPath, Long badgeId) throws GitLabApiException { - delete(Response.Status.NO_CONTENT, null, "projects", getProjectIdOrPath(projectIdOrPath), "badges", badgeId); + delete(Response.Status.NO_CONTENT, null, "projects", getProjectIdOrPath(projectIdOrPath), "badges", badgeId); } /** @@ -3618,17 +3599,17 @@ public void removeBadge(Object projectIdOrPath, Long badgeId) throws GitLabApiEx * 
GitLab Endpoint: GET /projects/:id/badges/render
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param linkUrl the URL of the badge link - * @param imageUrl the URL of the image link + * @param linkUrl the URL of the badge link + * @param imageUrl the URL of the image link * @return a Badge instance for the rendered badge * @throws GitLabApiException if any exception occurs */ - public Badge previewBadge(Object projectIdOrPath, String linkUrl, String imageUrl) throws GitLabApiException { - GitLabApiForm formData = new GitLabApiForm() - .withParam("link_url", linkUrl, true) - .withParam("image_url", imageUrl, true); - Response response = get(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "badges", "render"); - return (response.readEntity(Badge.class)); + public Badge previewBadge(Object projectIdOrPath, String linkUrl, String imageUrl) throws GitLabApiException { + GitLabApiForm formData = new GitLabApiForm() + .withParam("link_url", linkUrl, true) + .withParam("image_url", imageUrl, true); + Response response = get(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "badges", "render"); + return (response.readEntity(Badge.class)); } /** @@ -3653,12 +3634,12 @@ public ProjectApprovalsConfig getApprovalsConfiguration(Object projectIdOrPath) * 
GitLab Endpoint: POST /projects/:id/approvals
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param config a ProjectApprovalsConfig instance with the approval configuration + * @param config a ProjectApprovalsConfig instance with the approval configuration * @return a ProjectApprovalsConfig instance with the project's approvals configuration * @throws GitLabApiException if any exception occurs */ public ProjectApprovalsConfig setApprovalsConfiguration(Object projectIdOrPath, ProjectApprovalsConfig config) throws GitLabApiException { - GitLabApiForm formData = config.getForm(); + GitLabApiForm formData = config.getForm(); Response response = post(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "approvals"); return (response.readEntity(ProjectApprovalsConfig.class)); } @@ -3684,14 +3665,14 @@ public List getApprovalRules(Object projectIdOrPath) throws GitLab * 
GitLab Endpoint: GET /projects/:id/approval_rules
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of ApprovalRule instances that will be fetched per page + * @param itemsPerPage the number of ApprovalRule instances that will be fetched per page * @return a Pager of ApprovalRuke instances for the specified project. * @throws GitLabApiException if any exception occurs */ public Pager getApprovalRules(Object projectIdOrPath, int itemsPerPage) throws GitLabApiException { - return (new Pager(this, ApprovalRule.class, itemsPerPage, null, - "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules")); + return (new Pager(this, ApprovalRule.class, itemsPerPage, null, + "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules")); } /** @@ -3715,14 +3696,14 @@ public Stream getApprovalRulesStream(Object projectIdOrPath) throw * 
GitLab Endpoint: POST /projects/:id/approval_rules
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param params the ApprovalRuleParams instance holding the parameters for the approval rule + * @param params the ApprovalRuleParams instance holding the parameters for the approval rule * @return a ApprovalRule instance with approval configuration * @throws GitLabApiException if any exception occurs */ public ApprovalRule createApprovalRule(Object projectIdOrPath, ApprovalRuleParams params) throws GitLabApiException { GitLabApiForm formData = params.getForm(); Response response = post(Response.Status.OK, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules"); + "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules"); return (response.readEntity(ApprovalRule.class)); } @@ -3733,8 +3714,8 @@ public ApprovalRule createApprovalRule(Object projectIdOrPath, ApprovalRuleParam * 
GitLab Endpoint: PUT /projects/:id/approval_rules/:approval_rule_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param approvalRuleId the ID of the approval rule - * @param params the ApprovalRuleParams instance holding the parameters for the approval rule update + * @param approvalRuleId the ID of the approval rule + * @param params the ApprovalRuleParams instance holding the parameters for the approval rule update * @return a ApprovalRule instance with approval configuration * @throws GitLabApiException if any exception occurs */ @@ -3746,7 +3727,7 @@ public ApprovalRule updateApprovalRule(Object projectIdOrPath, Long approvalRule GitLabApiForm formData = params.getForm(); Response response = putWithFormData(Response.Status.OK, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules", approvalRuleId); + "projects", getProjectIdOrPath(projectIdOrPath), "approval_rules", approvalRuleId); return (response.readEntity(ApprovalRule.class)); } @@ -3757,7 +3738,7 @@ public ApprovalRule updateApprovalRule(Object projectIdOrPath, Long approvalRule * 
GitLab Endpoint: DELETE /projects/:id/approval_rules/:approval_rule_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param approvalRuleId the ID of the approval rule + * @param approvalRuleId the ID of the approval rule * @throws GitLabApiException if any exception occurs */ public void deleteApprovalRule(Object projectIdOrPath, Long approvalRuleId) throws GitLabApiException { @@ -3788,13 +3769,13 @@ public List getCustomAttributes(final Object projectIdOrPath) t * 
GitLab Endpoint: GET /projects/:id/custom_attributes
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of items per page + * @param itemsPerPage the number of items per page * @return a Pager of project's custom attributes * @throws GitLabApiException if any exception occurs */ public Pager getCustomAttributes(final Object projectIdOrPath, int itemsPerPage) throws GitLabApiException { return (new Pager(this, CustomAttribute.class, itemsPerPage, null, - "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes")); + "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes")); } /** @@ -3816,13 +3797,13 @@ public Stream getCustomAttributesStream(final Object projectIdO * 
GitLab Endpoint: GET /projects/:id/custom_attributes/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param key the key for the custom attribute + * @param key the key for the custom attribute * @return a CustomAttribute instance for the specified key * @throws GitLabApiException if any exception occurs */ public CustomAttribute getCustomAttribute(final Object projectIdOrPath, final String key) throws GitLabApiException { - Response response = get(Response.Status.OK, null, - "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes", key); + Response response = get(Response.Status.OK, null, + "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes", key); return (response.readEntity(CustomAttribute.class)); } @@ -3832,7 +3813,7 @@ public CustomAttribute getCustomAttribute(final Object projectIdOrPath, final St * 
GitLab Endpoint: GET /projects/:id/custom_attributes/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required - * @param key the key for the custom attribute, required + * @param key the key for the custom attribute, required * @return an Optional instance with the value for a single custom attribute for the specified project */ public Optional geOptionalCustomAttribute(final Object projectIdOrPath, final String key) { @@ -3850,8 +3831,8 @@ public Optional geOptionalCustomAttribute(final Object projectI * 
GitLab Endpoint: PUT /projects/:id/custom_attributes/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param key the key for the custom attribute - * @param value the value for the customAttribute + * @param key the key for the custom attribute + * @param value the value for the customAttribute * @return a CustomAttribute instance for the updated or created custom attribute * @throws GitLabApiException if any exception occurs */ @@ -3866,7 +3847,7 @@ public CustomAttribute setCustomAttribute(final Object projectIdOrPath, final St GitLabApiForm formData = new GitLabApiForm().withParam("value", value); Response response = putWithFormData(Response.Status.OK, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes", key); + "projects", getProjectIdOrPath(projectIdOrPath), "custom_attributes", key); return (response.readEntity(CustomAttribute.class)); } @@ -3876,7 +3857,7 @@ public CustomAttribute setCustomAttribute(final Object projectIdOrPath, final St * 
GitLab Endpoint: DELETE /projects/:id/custom_attributes/:key
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param key the key of the custom attribute to delete + * @param key the key of the custom attribute to delete * @throws GitLabApiException if any exception occurs */ public void deleteCustomAttribute(final Object projectIdOrPath, final String key) throws GitLabApiException { @@ -3907,13 +3888,13 @@ public List getRemoteMirrors(final Object projectIdOrPath) throws * 
GitLab Endpoint: GET /projects/:id/remote_mirrors
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param itemsPerPage the number of items per page + * @param itemsPerPage the number of items per page * @return a Pager of project's remote mirrors * @throws GitLabApiException if any exception occurs */ public Pager getRemoteMirrors(final Object projectIdOrPath, int itemsPerPage) throws GitLabApiException { return (new Pager(this, RemoteMirror.class, itemsPerPage, null, - "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors")); + "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors")); } /** @@ -3935,23 +3916,23 @@ public Stream getRemoteMirrorsStream(final Object projectIdOrPath) * * 
GitLab Endpoint: POST /projects/:id/remote_mirrors
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param url the URL of the remote repository to be mirrored - * @param enabled determines if the mirror is enabled + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param url the URL of the remote repository to be mirrored + * @param enabled determines if the mirror is enabled * @param onlyProtectedBranches determines if only protected branches are mirrored - * @param keepDivergentRefs determines if divergent refs are skipped + * @param keepDivergentRefs determines if divergent refs are skipped * @return a RemoteMirror instance with remote mirror configuration * @throws GitLabApiException if any exception occurs */ public RemoteMirror createRemoteMirror(Object projectIdOrPath, String url, Boolean enabled, - Boolean onlyProtectedBranches, Boolean keepDivergentRefs) throws GitLabApiException { + Boolean onlyProtectedBranches, Boolean keepDivergentRefs) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("url", url, true) - .withParam("enabled", enabled) - .withParam("only_protected_branches", onlyProtectedBranches) - .withParam("keep_divergent_refs", keepDivergentRefs); + .withParam("url", url, true) + .withParam("enabled", enabled) + .withParam("only_protected_branches", onlyProtectedBranches) + .withParam("keep_divergent_refs", keepDivergentRefs); Response response = post(Response.Status.OK, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors"); + "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors"); return (response.readEntity(RemoteMirror.class)); } @@ -3960,23 +3941,23 @@ public RemoteMirror createRemoteMirror(Object projectIdOrPath, String url, Boole * * 
GitLab Endpoint: PUT /projects/:id/remote_mirrors/:mirror_id
* - * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance - * @param mirrorId the ID of the remote mirror - * @param enabled determines if the mirror is enabled + * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance + * @param mirrorId the ID of the remote mirror + * @param enabled determines if the mirror is enabled * @param onlyProtectedBranches determines if only protected branches are mirrored - * @param keepDivergentRefs determines if divergent refs are skipped + * @param keepDivergentRefs determines if divergent refs are skipped * @return a RemoteMirror instance with the updated remote mirror configuration * @throws GitLabApiException if any exception occurs */ public RemoteMirror updateRemoteMirror(Object projectIdOrPath, Long mirrorId, Boolean enabled, - Boolean onlyProtectedBranches, Boolean keepDivergentRefs) throws GitLabApiException { + Boolean onlyProtectedBranches, Boolean keepDivergentRefs) throws GitLabApiException { - GitLabApiForm formData = new GitLabApiForm() - .withParam("enabled", enabled) - .withParam("only_protected_branches", onlyProtectedBranches) - .withParam("keep_divergent_refs", keepDivergentRefs); + GitLabApiForm formData = new GitLabApiForm() + .withParam("enabled", enabled) + .withParam("only_protected_branches", onlyProtectedBranches) + .withParam("keep_divergent_refs", keepDivergentRefs); Response response = putWithFormData(Response.Status.OK, formData, - "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors", mirrorId); + "projects", getProjectIdOrPath(projectIdOrPath), "remote_mirrors", mirrorId); return (response.readEntity(RemoteMirror.class)); } @@ -3989,8 +3970,7 @@ public RemoteMirror updateRemoteMirror(Object projectIdOrPath, Long mirrorId, Bo */ public List listProjectAccessTokens(Object projectIdOrPath) throws GitLabApiException { Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "access_tokens"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() { })); } /** @@ -3998,7 +3978,7 @@ public List listProjectAccessTokens(Object projectIdOrPath) * Only working with GitLab 14.10 and above. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param tokenId the id of the token + * @param tokenId the id of the token * @return the ProjectAccessToken. The token attribute of the object is unset. * @throws GitLabApiException if any exception occurs */ @@ -4011,10 +3991,10 @@ public ProjectAccessToken getProjectAccessToken(Object projectIdOrPath, Long tok * Creates a new project access token. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param name the name of the token - * @param scopes the scope of the token - * @param expiresAt the date when the token should expire - * @param accessLevel The access level of the token is optional. It can either be 10, 20, 30, 40, or 50. + * @param name the name of the token + * @param scopes the scope of the token + * @param expiresAt the date when the token should expire + * @param accessLevel The access level of the token is optional. It can either be 10, 20, 30, 40, or 50. * @return the newly created ProjectAccessToken. The lastUsedAt attribute of each object is unset. * @throws GitLabApiException if any exception occurs */ @@ -4034,9 +4014,9 @@ public ProjectAccessToken createProjectAccessToken(Object projectIdOrPath, Strin * The default value for the accessLevel is used. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param name the name of the token - * @param scopes the scope of the token - * @param expiresAt the date when the token should expire + * @param name the name of the token + * @param scopes the scope of the token + * @param expiresAt the date when the token should expire * @return the newly created ProjectAccessToken. The lastUsedAt attribute of each object is unset. * @throws GitLabApiException if any exception occurs */ @@ -4057,7 +4037,7 @@ public ProjectAccessToken createProjectAccessToken(Object projectIdOrPath, Strin * Only working with GitLab 16.0 and above. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param tokenId the id + * @param tokenId the id * @return the newly created ProjectAccessToken. * @throws GitLabApiException if any exception occurs */ @@ -4071,14 +4051,14 @@ public ProjectAccessToken rotateProjectAccessToken(Object projectIdOrPath, Long * Only working with GitLab 16.0 and above. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param tokenId the id - * @param expiresAt Expiration date of the access token + * @param tokenId the id + * @param expiresAt Expiration date of the access token * @return the newly created ProjectAccessToken. * @throws GitLabApiException if any exception occurs */ public ProjectAccessToken rotateProjectAccessToken(Object projectIdOrPath, Long tokenId, Date expiresAt) throws GitLabApiException { GitLabApiForm formData = new GitLabApiForm() - .withParam("expires_at", ISO8601.dateOnly(expiresAt)); + .withParam("expires_at", ISO8601.dateOnly(expiresAt)); Response response = post(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "access_tokens", tokenId, "rotate"); return (response.readEntity(ProjectAccessToken.class)); @@ -4088,7 +4068,7 @@ public ProjectAccessToken rotateProjectAccessToken(Object projectIdOrPath, Long * Revokes the project access token. * * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param tokenId the id of the token, which should be revoked + * @param tokenId the id of the token, which should be revoked * @throws GitLabApiException if any exception occurs */ public void revokeProjectAccessToken(Object projectIdOrPath, Long tokenId) throws GitLabApiException { @@ -4101,14 +4081,13 @@ public void revokeProjectAccessToken(Object projectIdOrPath, Long tokenId) throw * 
GitLab Endpoint: GET /projects/:id/iterations
* * @param projectIdOrPath the project in the form of a Long(ID), String(path), or Project instance - * @param filter the iteration filter + * @param filter the iteration filter * @return the list of project iterations * @throws GitLabApiException if any exception occurs */ public List listProjectIterations(Object projectIdOrPath, IterationFilter filter) throws GitLabApiException { - MultivaluedMap queryParams = (filter == null) ? null : filter.getQueryParams().asMap(); + MultivaluedMap queryParams = (filter == null) ? null : filter.getQueryParams().asMap(); Response response = get(Response.Status.OK, queryParams, "projects", getProjectIdOrPath(projectIdOrPath), "iterations"); - return (response.readEntity(new GenericType>() { - })); + return (response.readEntity(new GenericType>() { })); } } From aa426cd931bb565d1a292d1843a491aed0cce3c6 Mon Sep 17 00:00:00 2001 From: George Orfanidis Date: Tue, 28 May 2024 14:08:09 +0200 Subject: [PATCH 3/4] fix code format --- src/main/java/org/gitlab4j/api/ProjectApi.java | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/main/java/org/gitlab4j/api/ProjectApi.java b/src/main/java/org/gitlab4j/api/ProjectApi.java index 1d7bf7faf..c7ee346fe 100644 --- a/src/main/java/org/gitlab4j/api/ProjectApi.java +++ b/src/main/java/org/gitlab4j/api/ProjectApi.java @@ -1355,6 +1355,8 @@ public Project updateProject(Project project) throws GitLabApiException { formData.withParam("issue_branch_template", project.getIssueBranchTemplate()); formData.withParam("merge_commit_template", project.getMergeCommitTemplate()); formData.withParam("squash_commit_template", project.getSquashCommitTemplate()); + formData.withParam("merge_requests_template", project.getMergeRequestsTemplate()); + formData.withParam("issues_template", project.getIssuesTemplate()); if (project.getTagList() != null && !project.getTagList().isEmpty()) { formData.withParam("tag_list", String.join(",", project.getTagList())); From 4b6807ff3e1dd4aef99a593b406d059f0d575488 Mon Sep 17 00:00:00 2001 From: George Orfanidis Date: Wed, 29 May 2024 21:34:28 +0200 Subject: [PATCH 4/4] update project.json --- src/test/resources/org/gitlab4j/api/project.json | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/test/resources/org/gitlab4j/api/project.json b/src/test/resources/org/gitlab4j/api/project.json index 27f6bb174..982b3feec 100644 --- a/src/test/resources/org/gitlab4j/api/project.json +++ b/src/test/resources/org/gitlab4j/api/project.json @@ -96,6 +96,8 @@ "merge_commit_template": "Merge branch '%{source_branch}' into '%{target_branch}'", "squash_commit_template": "Commit %{title}", "issue_branch_template" : "issue-%{id}", + "merge_requests_template": "", + "issues_template": "", "autoclose_referenced_issues" : true, "permissions" : { "project_access" : { @@ -125,4 +127,4 @@ "packages_size" : 0 }, "custom_attributes" : [ ] -} \ No newline at end of file +}