public static final ObjectMapper MAPPER = new ObjectMapper().configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);

private static final String API_NAMESPACE = "/api/v4";

private static final String PARAM_SUDO = "sudo";

private static final String PARAM_MAX_ITEMS_PER_PAGE = new Pagination().withPerPage(Pagination.MAX_ITEMS_PER_PAGE).toString();

private final String hostUrl;

private final String apiToken;

private final TokenType tokenType;

private AuthMethod authMethod;

private boolean ignoreCertificateErrors = false;

private Proxy proxy;

private int requestTimeout = 0;

private String userAgent = GitlabAPI.class.getCanonicalName() + "/" + System.getProperty("java.version");

private GitlabAPI(String hostUrl, String apiToken, TokenType tokenType, AuthMethod method) {

this.hostUrl = hostUrl.endsWith("/") ? hostUrl.replaceAll("/$", "") : hostUrl;

this.apiToken = apiToken;

this.tokenType = tokenType;

this.authMethod = method;

}

public static GitlabSession connect(String hostUrl, String username, String password) throws IOException {

String tailUrl = GitlabSession.URL;

GitlabAPI api = connect(hostUrl, null, null, null);

return api.dispatch().with("login", username).with("password", password)

.to(tailUrl, GitlabSession.class);

}

public static GitlabAPI connect(String hostUrl, String apiToken) {

return new GitlabAPI(hostUrl, apiToken, TokenType.PRIVATE_TOKEN, AuthMethod.HEADER);

}

public static GitlabAPI connect(String hostUrl, String apiToken, TokenType tokenType) {

return new GitlabAPI(hostUrl, apiToken, tokenType, AuthMethod.HEADER);

}

public static GitlabAPI connect(String hostUrl, String apiToken, TokenType tokenType, AuthMethod method) {

return new GitlabAPI(hostUrl, apiToken, tokenType, method);

}

public GitlabAPI ignoreCertificateErrors(boolean ignoreCertificateErrors) {

this.ignoreCertificateErrors = ignoreCertificateErrors;

return this;

}

public GitlabAPI proxy(Proxy proxy) {

this.proxy = proxy;

return this;

}

public int getRequestTimeout() {

return requestTimeout;

}

public GitlabAPI setRequestTimeout(int requestTimeout) {

this.requestTimeout = requestTimeout;

return this;

}

public GitlabHTTPRequestor retrieve() {

return new GitlabHTTPRequestor(this).authenticate(apiToken, tokenType, authMethod);

}

public GitlabHTTPRequestor dispatch() {

return new GitlabHTTPRequestor(this).authenticate(apiToken, tokenType, authMethod).method("POST");

}

public boolean isIgnoreCertificateErrors() {

return ignoreCertificateErrors;

}

public Proxy getProxy() {

return proxy;

}

public URL getAPIUrl(String tailAPIUrl) throws IOException {

if (!tailAPIUrl.startsWith("/")) {

tailAPIUrl = "/" + tailAPIUrl;

}

return new URL(hostUrl + API_NAMESPACE + tailAPIUrl);

}

public URL getUrl(String tailAPIUrl) throws IOException {

if (!tailAPIUrl.startsWith("/")) {

tailAPIUrl = "/" + tailAPIUrl;

}

return new URL(hostUrl + tailAPIUrl);

}

public List<GitlabUser> getUsers() throws IOException {

String tailUrl = GitlabUser.URL + PARAM_MAX_ITEMS_PER_PAGE;

return retrieve().getAll(tailUrl, GitlabUser[].class);

}

/**

public List<GitlabUser> findUsers(String emailOrUsername) throws IOException {

List<GitlabUser> users = new ArrayList<GitlabUser>();

if (emailOrUsername != null && !emailOrUsername.equals("")) {

String tailUrl = GitlabUser.URL + "?search=" + emailOrUsername;

GitlabUser[] response = retrieve().to(tailUrl, GitlabUser[].class);

users = Arrays.asList(response);

}

return users;

}

/**

public GitlabUser getUser() throws IOException {

String tailUrl = GitlabUser.USER_URL;

return retrieve().to(tailUrl, GitlabUser.class);

}

public GitlabUser getUser(Integer userId) throws IOException {

String tailUrl = GitlabUser.URL + "/" + userId;

return retrieve().to(tailUrl, GitlabUser.class);

}

public GitlabUser getUserViaSudo(String username) throws IOException {

String tailUrl = GitlabUser.USER_URL + "?" + PARAM_SUDO + "=" + username;

return retrieve().to(tailUrl, GitlabUser.class);

}

/**

public GitlabUser createUser(String email, String password, String username,

String fullName, String skypeId, String linkedIn,

String twitter, String website_url, Integer projects_limit,

String extern_uid, String extern_provider_name,

String bio, Boolean isAdmin, Boolean can_create_group,

Boolean skip_confirmation) throws IOException {

Query query = new Query()

.append("email", email)

.appendIf("skip_confirmation", skip_confirmation)

.appendIf("password", password)

.appendIf("username", username)

.appendIf("name", fullName)

.appendIf("skype", skypeId)

.appendIf("linkedin", linkedIn)

.appendIf("twitter", twitter)

.appendIf("website_url", website_url)

.appendIf("projects_limit", projects_limit)

.appendIf("extern_uid", extern_uid)

.appendIf("provider", extern_provider_name)

.appendIf("bio", bio)

.appendIf("admin", isAdmin)

.appendIf("can_create_group", can_create_group);

String tailUrl = GitlabUser.USERS_URL + query.toString();

return dispatch().to(tailUrl, GitlabUser.class);

}

/**

public GitlabUser createUser(CreateUserRequest request) throws IOException {

String tailUrl = GitlabUser.USERS_URL + request.toQuery().toString();

return dispatch().to(tailUrl, GitlabUser.class);

}

/**

public GitlabUser updateUser(Integer targetUserId,

String email, String password, String username,

String fullName, String skypeId, String linkedIn,

String twitter, String website_url, Integer projects_limit,

String extern_uid, String extern_provider_name,

String bio, Boolean isAdmin, Boolean can_create_group) throws IOException {

Query query = new Query()

.append("email", email)

.appendIf("password", password)

.appendIf("username", username)

.appendIf("name", fullName)

.appendIf("skype", skypeId)

.appendIf("linkedin", linkedIn)

.appendIf("twitter", twitter)

.appendIf("website_url", website_url)

.appendIf("projects_limit", projects_limit)

.appendIf("extern_uid", extern_uid)

.appendIf("provider", extern_provider_name)

.appendIf("bio", bio)

.appendIf("admin", isAdmin)

.appendIf("can_create_group", can_create_group);

String tailUrl = GitlabUser.USERS_URL + "/" + targetUserId + query.toString();

return retrieve().method("PUT").to(tailUrl, GitlabUser.class);

}

/**

public void blockUser(Integer targetUserId) throws IOException {

String tailUrl = GitlabUser.USERS_URL + "/" + targetUserId + GitlabUser.BLOCK_URL;

retrieve().method("POST").to(tailUrl, Void.class);

}

/**

public void unblockUser(Integer targetUserId) throws IOException {

String tailUrl = GitlabUser.USERS_URL + "/" + targetUserId + GitlabUser.UNBLOCK_URL;

retrieve().method("POST").to(tailUrl, Void.class);

}

/**

public GitlabSSHKey createSSHKey(Integer targetUserId, String title, String key) throws IOException {

Query query = new Query()

.append("title", title)

.append("key", key);

String tailUrl = GitlabUser.USERS_URL + "/" + targetUserId + GitlabSSHKey.KEYS_URL + query.toString();

return dispatch().to(tailUrl, GitlabSSHKey.class);

}

/**

public void deleteSSHKey(Integer targetUserId, Integer targetKeyId) throws IOException {

String tailUrl = GitlabUser.USERS_URL + "/" + targetUserId + GitlabSSHKey.KEYS_URL + "/" + targetKeyId;

retrieve().method("DELETE").to(tailUrl, Void.class);

}

/**

public List<GitlabSSHKey> getSSHKeys(Integer targetUserId) throws IOException {

String tailUrl = GitlabUser.USERS_URL + "/" + targetUserId + GitlabSSHKey.KEYS_URL;

return Arrays.asList(retrieve().to(tailUrl, GitlabSSHKey[].class));

}

/**

public GitlabSSHKey getSSHKey(Integer keyId) throws IOException {

String tailUrl = GitlabSSHKey.KEYS_URL + "/" + keyId;

return retrieve().to(tailUrl, GitlabSSHKey.class);

}

/**

public void deleteUser(Integer targetUserId) throws IOException {

String tailUrl = GitlabUser.USERS_URL + "/" + targetUserId;

retrieve().method("DELETE").to(tailUrl, Void.class);

}

public GitlabGroup getGroup(Integer groupId) throws IOException {

return getGroup(groupId.toString());

}

/**

public GitlabGroup getGroup(String path) throws IOException {

String tailUrl = GitlabGroup.URL + "/" + URLEncoder.encode(path, "UTF-8");

return retrieve().to(tailUrl, GitlabGroup.class);

}

public List<GitlabGroup> getGroups() throws IOException {

return getGroupsViaSudo(null, new Pagination().withPerPage(Pagination.MAX_ITEMS_PER_PAGE));

}

public List<GitlabGroup> getGroupsViaSudo(String username, Pagination pagination) throws IOException {

String tailUrl = GitlabGroup.URL;

Query query = new Query()

.appendIf(PARAM_SUDO, username);

if (pagination != null) {

query.mergeWith(pagination.asQuery());

}

return retrieve().getAll(tailUrl + query.toString(), GitlabGroup[].class);

}

/**

public List<GitlabProject> getGroupProjects(GitlabGroup group) throws IOException {

return getGroupProjects(group.getId());

}

/**

public List<GitlabProject> getGroupProjects(Integer groupId) throws IOException {

String tailUrl = GitlabGroup.URL + "/" + groupId + GitlabProject.URL + PARAM_MAX_ITEMS_PER_PAGE;

return retrieve().getAll(tailUrl, GitlabProject[].class);

}

/**

public List<GitlabGroupMember> getGroupMembers(GitlabGroup group) throws IOException {

return getGroupMembers(group.getId());

}

/**

public List<GitlabGroupMember> getGroupMembers(Integer groupId) throws IOException {

String tailUrl = GitlabGroup.URL + "/" + groupId + GitlabGroupMember.URL + PARAM_MAX_ITEMS_PER_PAGE;

return retrieve().getAll(tailUrl, GitlabGroupMember[].class);

}

/**

public GitlabGroup createGroup(String name) throws IOException {

return createGroup(name, name);

}

/**

public GitlabGroup createGroup(String name, String path) throws IOException {

return createGroup(name, path, null, null, null);

}

/**

public GitlabGroup createGroupViaSudo(String name, String path, GitlabUser sudoUser) throws IOException {

return createGroup(name, path, null, null, sudoUser);

}

/**

public GitlabGroup createGroup(String name, String path, String ldapCn, GitlabAccessLevel ldapAccess) throws IOException {

return createGroup(name, path, ldapCn, ldapAccess, null);

}

/**

public GitlabGroup createGroup(CreateGroupRequest request, GitlabUser sudoUser) throws IOException {

Query query = request.toQuery();

query.appendIf(PARAM_SUDO, sudoUser != null ? sudoUser.getId() : null);

String tailUrl = GitlabGroup.URL + query.toString();

return dispatch().to(tailUrl, GitlabGroup.class);

}

/**

public GitlabGroup createGroup(String name, String path, String ldapCn, GitlabAccessLevel ldapAccess, GitlabUser sudoUser) throws IOException {

return createGroup(name, path, ldapCn, ldapAccess, sudoUser, null);

}

/**

public GitlabGroup createGroup(String name, String path, String ldapCn, GitlabAccessLevel ldapAccess, GitlabUser sudoUser, Integer parentId) throws IOException {

Query query = new Query()

.append("name", name)

.append("path", path)

.appendIf("ldap_cn", ldapCn)

.appendIf("ldap_access", ldapAccess)

.appendIf(PARAM_SUDO, sudoUser != null ? sudoUser.getId() : null)

.appendIf("parent_id", parentId);

String tailUrl = GitlabGroup.URL + query.toString();

return dispatch().to(tailUrl, GitlabGroup.class);

}

/**

public GitlabGroupMember addGroupMember(GitlabGroup group, GitlabUser user, GitlabAccessLevel accessLevel) throws IOException {

return addGroupMember(group.getId(), user.getId(), accessLevel);

}

/**

public GitlabGroupMember addGroupMember(Integer groupId, Integer userId, GitlabAccessLevel accessLevel) throws IOException {

Query query = new Query()

.appendIf("id", groupId)

.appendIf("user_id", userId)

.appendIf("access_level", accessLevel);

String tailUrl = GitlabGroup.URL + "/" + groupId + GitlabProjectMember.URL + query.toString();

return dispatch().to(tailUrl, GitlabGroupMember.class);

}

/**

public void deleteGroupMember(GitlabGroup group, GitlabUser user) throws IOException {

deleteGroupMember(group.getId(), user.getId());

}

/**

public void deleteGroupMember(Integer groupId, Integer userId) throws IOException {

String tailUrl = GitlabGroup.URL + "/" + groupId + "/" + GitlabGroupMember.URL + "/" + userId;

retrieve().method("DELETE").to(tailUrl, Void.class);

}

/**

public void deleteGroup(Integer groupId) throws IOException {

String tailUrl = GitlabGroup.URL + "/" + groupId;

retrieve().method("DELETE").to(tailUrl, Void.class);

}

/**

public List<GitlabProject> getAllProjects() throws IOException {

String tailUrl = GitlabProject.URL;

return retrieve().getAll(tailUrl, GitlabProject[].class);

}

/**

public GitlabProject getProject(Serializable projectId) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(projectId);

return retrieve().to(tailUrl, GitlabProject.class);

}

/**

public GitlabProject getProject(String namespace, String projectName) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeGroupId(namespace) + "%2F" + sanitizeProjectId(projectName);

return retrieve().to(tailUrl, GitlabProject.class);

}

/*

public String getProjectJson(Serializable projectId) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(projectId);

return retrieve().to(tailUrl, String.class);

}

/*

public String getProjectJson(String namespace, String projectName) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeGroupId(namespace) + "%2F" + sanitizeProjectId(projectName);

return retrieve().to(tailUrl, String.class);

}

/**

public List<GitlabProject> getProjects() throws IOException {

String tailUrl = GitlabProject.URL + PARAM_MAX_ITEMS_PER_PAGE;

return retrieve().getAll(tailUrl, GitlabProject[].class);

}

/**

public List<GitlabProject> getProjectsWithPagination(int page, int perPage) throws IOException {

Pagination pagination = new Pagination()

.withPage(page)

.withPerPage(perPage);

return getProjectsWithPagination(pagination);

}

/**

public List<GitlabProject> getProjectsWithPagination(Pagination pagination) throws IOException {

StringBuilder tailUrl = new StringBuilder(GitlabProject.URL);

if (pagination != null) {

Query query = pagination.asQuery();

tailUrl.append(query.toString());

}

return Arrays.asList(retrieve().method("GET").to(tailUrl.toString(), GitlabProject[].class));

}

/**

public List<GitlabProject> getOwnedProjects() throws IOException {

Query query = new Query().append("owner", "true");

query.mergeWith(new Pagination().withPerPage(Pagination.MAX_ITEMS_PER_PAGE).asQuery());

String tailUrl = GitlabProject.URL + query.toString();

return retrieve().getAll(tailUrl, GitlabProject[].class);

}

/**

public List<GitlabProject> getMembershipProjects() throws IOException {

Query query = new Query().append("membership", "true");

query.mergeWith(new Pagination().withPerPage(Pagination.MAX_ITEMS_PER_PAGE).asQuery());

String tailUrl = GitlabProject.URL + query.toString();

return retrieve().getAll(tailUrl, GitlabProject[].class);

}

/**

public List<GitlabProject> getStarredProjects() throws IOException {

Query query = new Query().append("starred", "true");

query.mergeWith(new Pagination().withPerPage(Pagination.MAX_ITEMS_PER_PAGE).asQuery());

String tailUrl = GitlabProject.URL + query.toString();

return retrieve().getAll(tailUrl, GitlabProject[].class);

}

/**

public List<GitlabProject> getProjectsViaSudo(GitlabUser user) throws IOException {

Query query = new Query()

.appendIf(PARAM_SUDO, user.getId());

query.mergeWith(new Pagination().withPerPage(Pagination.MAX_ITEMS_PER_PAGE).asQuery());

String tailUrl = GitlabProject.URL + query.toString();

return retrieve().getAll(tailUrl, GitlabProject[].class);

}

/**

public List<GitlabProject> getProjectsViaSudoWithPagination(GitlabUser user, int page, int perPage) throws IOException {

Pagination pagination = new Pagination()

.withPage(page)

.withPerPage(perPage);

return getProjectsViaSudoWithPagination(user, pagination);

}

/**

public List<GitlabProject> getProjectsViaSudoWithPagination(GitlabUser user, Pagination pagination) throws IOException {

StringBuilder tailUrl = new StringBuilder(GitlabProject.URL);

Query query = new Query()

.appendIf(PARAM_SUDO, user.getId());

if (pagination != null) {

query.mergeWith(pagination.asQuery());

}

tailUrl.append(query.toString());

return Arrays.asList(retrieve().method("GET").to(tailUrl.toString(), GitlabProject[].class));

}

/**

public List<GitlabNamespace> getNamespaces() throws IOException {

String tailUrl = GitlabNamespace.URL + PARAM_MAX_ITEMS_PER_PAGE;

return retrieve().getAll(tailUrl, GitlabNamespace[].class);

}

/**

public GitlabUpload uploadFile(GitlabProject project, File file) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(project.getId()) + GitlabUpload.URL;

return dispatch().withAttachment("file", file).to(tailUrl, GitlabUpload.class);

}

/**

public List<GitlabJob> getProjectJobs(GitlabProject project) throws IOException {

return getProjectJobs(project.getId());

}

/**

public List<GitlabJob> getProjectJobs(Integer projectId) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(projectId) + GitlabJob.URL + PARAM_MAX_ITEMS_PER_PAGE;

return retrieve().getAll(tailUrl, GitlabJob[].class);

}

/**

public List<GitlabJob> getPipelineJobs(GitlabProject project, Integer pipelineId) throws IOException {

return getPipelineJobs(project.getId(), pipelineId);

}

/**

public List<GitlabJob> getPipelineJobs(Integer projectId, Integer pipelineId) {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(projectId) + GitlabPipeline.URL + "/" + sanitizeId(pipelineId, "PipelineID") + GitlabJob.URL + PARAM_MAX_ITEMS_PER_PAGE;

return retrieve().getAll(tailUrl, GitlabJob[].class);

}

/**

public GitlabJob cancelJob(Integer projectId, Integer jobId) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(projectId) + GitlabJob.URL + "/" + sanitizeId(jobId, "JobID") + "/cancel";

return dispatch().to(tailUrl, GitlabJob.class);

}

/**

public GitlabJob retryJob(Integer projectId, Integer jobId) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(projectId) + GitlabJob.URL + "/" + sanitizeId(jobId, "JobID") + "/retry";

return dispatch().to(tailUrl, GitlabJob.class);

}

/**

public GitlabJob eraseJob(Integer projectId, Integer jobId) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(projectId) + GitlabJob.URL + "/" + sanitizeId(jobId, "JobID") + "/erase";

return dispatch().to(tailUrl, GitlabJob.class);

}

/**

public GitlabJob playJob(Integer projectId, Integer jobId) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(projectId) + GitlabJob.URL + "/" + sanitizeId(jobId, "JobID") + "/play";

return dispatch().to(tailUrl, GitlabJob.class);

}

/**

public GitlabJob getProjectJob(Integer projectId, Integer jobId) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(projectId) + GitlabJob.URL + "/" + jobId;

return retrieve().to(tailUrl, GitlabJob.class);

}

/**

public byte[] getJobArtifact(GitlabProject project, GitlabJob job) throws IOException {

return getJobArtifact(project.getId(), job.getId());

}

/**

public byte[] getJobArtifact(Integer projectId, Integer jobId) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(projectId) + GitlabJob.URL + "/" + jobId + "/artifacts";

return retrieve().to(tailUrl, byte[].class);

}

/**

public byte[] getJobTrace(GitlabProject project, GitlabJob job) throws IOException {

return getJobArtifact(project.getId(), job.getId());

}

/**

public byte[] getJobTrace(Integer projectId, Integer jobId) throws IOException {

String tailUrl = GitlabProject.URL + "/" + sanitizeProjectId(projectId) + GitlabJob.URL + "/" + jobId + "/trace";

return retrieve().to(tailUrl, byte[].class);

}

/**