All Downloads are FREE. Search and download functionalities are using the official Maven repository.

net.leanix.mtm.api.UsersApi Maven / Gradle / Ivy

/*
* The MIT License (MIT)	 
*
* Copyright (c) 2015 LeanIX GmbH
* 
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
* 
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
* 
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/

package net.leanix.mtm.api;

import net.leanix.dropkit.api.Client;
import net.leanix.dropkit.api.ApiException;
import net.leanix.dropkit.api.ValidationException;
import net.leanix.dropkit.api.Response;

import javax.ws.rs.core.MultivaluedHashMap;
import javax.ws.rs.core.MediaType;
import com.sun.jersey.api.client.UniformInterfaceException;
import net.leanix.mtm.api.models.User;
import net.leanix.mtm.api.models.PermissionListResponse;
import net.leanix.mtm.api.models.Credentials;
import net.leanix.mtm.api.models.EventListResponse;
import net.leanix.mtm.api.models.UserResponse;
import net.leanix.mtm.api.models.UserListResponse;
import net.leanix.mtm.api.models.SettingListResponse;
import java.util.*;

public class UsersApi
{
	private Client apiClient;
	
	public UsersApi(Client client)
	{
            if (client == null)
                throw new IllegalArgumentException("client is null");
            
            this.apiClient = client;
	}
	
	public Client getClient()
	{
		return this.apiClient;
	}

	/**
         * getPermissions.
         * Endpoint to list the user permissions.
         *
         * @throws ApiException
         */
	public PermissionListResponse getPermissions (String id, String sort) throws ApiException
	{
            // verify required params are set
            if(id == null )
            {
                throw new ApiException(400, "missing required params");
            }
            // create path and map variables
            String path = "/users/{id}/permissions".replaceAll("\\{format\\}","json").replaceAll("\\{" + "id" + "\\}", id.toString());

            // query params
            Map queryParams = new HashMap();
            if(!"null".equals(String.valueOf(sort)))
            queryParams.put("sort", String.valueOf(sort));
            Map headerParams = new HashMap();
            try
            {
                return apiClient.resource(path)
                    .queryParams(new MultivaluedHashMap(queryParams))
                    .method("GET", PermissionListResponse.class);
            }
            catch (UniformInterfaceException ex)
            {
                if(ex.getResponse().getStatus() == 404)
                {
                    return null;
                }
                else if(ex.getResponse().getStatus() == 422)
                {
                    throw new ValidationException(ex.getResponse().getEntity(Response.class));
                }
                else
                {
                    throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
                }
            }
	}
        
	/**
         * getSettings.
         * Endpoint to list the user specific settings.
         *
         * @throws ApiException
         */
	public SettingListResponse getSettings (String id, String type) throws ApiException
	{
            // verify required params are set
            if(id == null )
            {
                throw new ApiException(400, "missing required params");
            }
            // create path and map variables
            String path = "/users/{id}/settings".replaceAll("\\{format\\}","json").replaceAll("\\{" + "id" + "\\}", id.toString());

            // query params
            Map queryParams = new HashMap();
            if(!"null".equals(String.valueOf(type)))
            queryParams.put("type", String.valueOf(type));
            Map headerParams = new HashMap();
            try
            {
                return apiClient.resource(path)
                    .queryParams(new MultivaluedHashMap(queryParams))
                    .method("GET", SettingListResponse.class);
            }
            catch (UniformInterfaceException ex)
            {
                if(ex.getResponse().getStatus() == 404)
                {
                    return null;
                }
                else if(ex.getResponse().getStatus() == 422)
                {
                    throw new ValidationException(ex.getResponse().getEntity(Response.class));
                }
                else
                {
                    throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
                }
            }
	}
        
	/**
         * Reset Password.
         * Endpoint to finish the reset the password process, can only be accessed by systems.
         *
         * @throws ApiException
         */
	public UserResponse setPassword (String id, Credentials body, String code) throws ApiException
	{
            // verify required params are set
            if(id == null )
            {
                throw new ApiException(400, "missing required params");
            }
            // create path and map variables
            String path = "/users/{id}/passwords".replaceAll("\\{format\\}","json").replaceAll("\\{" + "id" + "\\}", id.toString());

            // query params
            Map queryParams = new HashMap();
            if(!"null".equals(String.valueOf(code)))
            queryParams.put("code", String.valueOf(code));
            Map headerParams = new HashMap();
            try
            {
                return apiClient.resource(path)
                    .queryParams(new MultivaluedHashMap(queryParams))
                    .type(MediaType.APPLICATION_JSON).method("POST", UserResponse.class, body);
            }
            catch (UniformInterfaceException ex)
            {
                if(ex.getResponse().getStatus() == 404)
                {
                    return null;
                }
                else if(ex.getResponse().getStatus() == 422)
                {
                    throw new ValidationException(ex.getResponse().getEntity(Response.class));
                }
                else
                {
                    throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
                }
            }
	}
        
	/**
         * User.
         * List or search all users.
         *
         * @throws ApiException
         */
	public UserListResponse getUsers (String email, String q, String sort, Integer page, Integer size) throws ApiException
	{
            // create path and map variables
            String path = "/users".replaceAll("\\{format\\}","json");

            // query params
            Map queryParams = new HashMap();
            if(!"null".equals(String.valueOf(email)))
            queryParams.put("email", String.valueOf(email));
            if(!"null".equals(String.valueOf(q)))
            queryParams.put("q", String.valueOf(q));
            if(!"null".equals(String.valueOf(page)))
            queryParams.put("page", String.valueOf(page));
            if(!"null".equals(String.valueOf(size)))
            queryParams.put("size", String.valueOf(size));
            if(!"null".equals(String.valueOf(sort)))
            queryParams.put("sort", String.valueOf(sort));
            Map headerParams = new HashMap();
            try
            {
                return apiClient.resource(path)
                    .queryParams(new MultivaluedHashMap(queryParams))
                    .method("GET", UserListResponse.class);
            }
            catch (UniformInterfaceException ex)
            {
                if(ex.getResponse().getStatus() == 404)
                {
                    return null;
                }
                else if(ex.getResponse().getStatus() == 422)
                {
                    throw new ValidationException(ex.getResponse().getEntity(Response.class));
                }
                else
                {
                    throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
                }
            }
	}
        
	/**
         * createUser.
         * Create a user
         *
         * @throws ApiException
         */
	public UserResponse createUser (String id, User body) throws ApiException
	{
            // verify required params are set
            if(id == null )
            {
                throw new ApiException(400, "missing required params");
            }
            // create path and map variables
            String path = "/users".replaceAll("\\{format\\}","json").replaceAll("\\{" + "id" + "\\}", id.toString());

            // query params
            Map queryParams = new HashMap();
            Map headerParams = new HashMap();
            try
            {
                return apiClient.resource(path)
                    .queryParams(new MultivaluedHashMap(queryParams))
                    .type(MediaType.APPLICATION_JSON).method("POST", UserResponse.class, body);
            }
            catch (UniformInterfaceException ex)
            {
                if(ex.getResponse().getStatus() == 404)
                {
                    return null;
                }
                else if(ex.getResponse().getStatus() == 422)
                {
                    throw new ValidationException(ex.getResponse().getEntity(Response.class));
                }
                else
                {
                    throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
                }
            }
	}
        
	/**
         * getEvents.
         * Retrieves all events for an user (date must be ISO 8601 formatted)
         *
         * @throws ApiException
         */
	public EventListResponse getEvents (String id, String since, String sort, Integer page, Integer size) throws ApiException
	{
            // verify required params are set
            if(id == null )
            {
                throw new ApiException(400, "missing required params");
            }
            // create path and map variables
            String path = "/users/{id}/events".replaceAll("\\{format\\}","json").replaceAll("\\{" + "id" + "\\}", id.toString());

            // query params
            Map queryParams = new HashMap();
            if(!"null".equals(String.valueOf(since)))
            queryParams.put("since", String.valueOf(since));
            if(!"null".equals(String.valueOf(page)))
            queryParams.put("page", String.valueOf(page));
            if(!"null".equals(String.valueOf(size)))
            queryParams.put("size", String.valueOf(size));
            if(!"null".equals(String.valueOf(sort)))
            queryParams.put("sort", String.valueOf(sort));
            Map headerParams = new HashMap();
            try
            {
                return apiClient.resource(path)
                    .queryParams(new MultivaluedHashMap(queryParams))
                    .method("GET", EventListResponse.class);
            }
            catch (UniformInterfaceException ex)
            {
                if(ex.getResponse().getStatus() == 404)
                {
                    return null;
                }
                else if(ex.getResponse().getStatus() == 422)
                {
                    throw new ValidationException(ex.getResponse().getEntity(Response.class));
                }
                else
                {
                    throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
                }
            }
	}
        
	/**
         * getUser.
         * Returns user data.
         *
         * @throws ApiException
         */
	public UserResponse getUser (String id) throws ApiException
	{
            // verify required params are set
            if(id == null )
            {
                throw new ApiException(400, "missing required params");
            }
            // create path and map variables
            String path = "/users/{id}".replaceAll("\\{format\\}","json").replaceAll("\\{" + "id" + "\\}", id.toString());

            // query params
            Map queryParams = new HashMap();
            Map headerParams = new HashMap();
            try
            {
                return apiClient.resource(path)
                    .queryParams(new MultivaluedHashMap(queryParams))
                    .method("GET", UserResponse.class);
            }
            catch (UniformInterfaceException ex)
            {
                if(ex.getResponse().getStatus() == 404)
                {
                    return null;
                }
                else if(ex.getResponse().getStatus() == 422)
                {
                    throw new ValidationException(ex.getResponse().getEntity(Response.class));
                }
                else
                {
                    throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
                }
            }
	}
        
	/**
         * updateUser.
         * Update a user
         *
         * @throws ApiException
         */
	public UserResponse updateUser (String id, User body) throws ApiException
	{
            // verify required params are set
            if(id == null )
            {
                throw new ApiException(400, "missing required params");
            }
            // create path and map variables
            String path = "/users/{id}".replaceAll("\\{format\\}","json").replaceAll("\\{" + "id" + "\\}", id.toString());

            // query params
            Map queryParams = new HashMap();
            Map headerParams = new HashMap();
            try
            {
                return apiClient.resource(path)
                    .queryParams(new MultivaluedHashMap(queryParams))
                    .type(MediaType.APPLICATION_JSON).method("PUT", UserResponse.class, body);
            }
            catch (UniformInterfaceException ex)
            {
                if(ex.getResponse().getStatus() == 404)
                {
                    return null;
                }
                else if(ex.getResponse().getStatus() == 422)
                {
                    throw new ValidationException(ex.getResponse().getEntity(Response.class));
                }
                else
                {
                    throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
                }
            }
	}
        
	/**
         * deleteUser.
         * Delete an user.
         *
         * @throws ApiException
         */
	public UserResponse deleteUser (String id) throws ApiException
	{
            // verify required params are set
            if(id == null )
            {
                throw new ApiException(400, "missing required params");
            }
            // create path and map variables
            String path = "/users/{id}".replaceAll("\\{format\\}","json").replaceAll("\\{" + "id" + "\\}", id.toString());

            // query params
            Map queryParams = new HashMap();
            Map headerParams = new HashMap();
            try
            {
                return apiClient.resource(path)
                    .queryParams(new MultivaluedHashMap(queryParams))
                    .method("DELETE", UserResponse.class);
            }
            catch (UniformInterfaceException ex)
            {
                if(ex.getResponse().getStatus() == 404)
                {
                    return null;
                }
                else if(ex.getResponse().getStatus() == 422)
                {
                    throw new ValidationException(ex.getResponse().getEntity(Response.class));
                }
                else
                {
                    throw new ApiException(ex.getResponse().getStatus(), ex.getResponse().toString());
                }
            }
	}
        
	}





© 2015 - 2025 Weber Informatics LLC | Privacy Policy