com.aliction.gitproviders.bitbucket.resources.TeamAPI Maven / Gradle / Ivy

Go to download
package com.aliction.gitproviders.bitbucket.resources;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

import javax.ws.rs.core.Response;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.aliction.gitproviders.bitbucket.client.BitbucketV2API;
import com.aliction.gitproviders.bitbucket.exceptions.BitbucketException;
import com.aliction.gitproviders.bitbucket.exceptions.BitbucketGetTeamException;
import com.aliction.gitproviders.bitbucket.exceptions.BitbucketPageException;
import com.aliction.gitproviders.bitbucket.objects.BitbucketRole;
import com.aliction.gitproviders.bitbucket.objects.BitbucketTeam;

/**
 * The class for the team resource
 * @author Aly Ibrahim
 * Date: Oct 25, 2019
 *
 */
public class TeamAPI extends BaseAPI {

    private static final Logger LOGGER = LoggerFactory.getLogger(TeamAPI.class);
    private static final String CONTROLLER = "teams";

    /**
     * 
     * @param bitbucket - BitbucketV2API object
     */
    public TeamAPI(BitbucketV2API bitbucket) {
        super(bitbucket);
    }

    /**
     * The method return team object with the team details
     * Resource /2.0/teams/{username}
     * @param team - BitbucketTeam object
     * @return team object
     */
    public BitbucketTeam getTeamInfo(String team) {
        String URL = BuildURL(new String[]{CONTROLLER, team});
        BitbucketTeam teamObj = null;
        try {
            teamObj = Validate(Get(URL), BitbucketTeam.class);
        } catch (BitbucketException exp) {
            exp.printStackTrace();
        }
        return teamObj;
    }

    /**
     * The method return the teams that the user belongs to and is filtered by the input role
     * Resource /2.0/teams?q=role={role}
     * @param role - logged user role are defined by the enum {admin, collaborator, member}
     * @return list of team objects
     * @throws BitbucketPageException - Exception for validating page response
     * @throws BitbucketGetTeamException - Exception for getting team object
     */
    public List getUserTeams(BitbucketRole role) throws BitbucketPageException, BitbucketGetTeamException {
        List teams = null;
        Map queryParam = null;
        if (role != null) {
            queryParam = new HashMap();
            queryParam.put("role", role.toString());
        }
        String URL = BuildURL(new String[]{CONTROLLER});
        Response response = Get(URL, null, queryParam);
        try {
            teams = getPaginatedObjects(response, BitbucketTeam.class);
        } catch (BitbucketException exp) {
            throw new BitbucketGetTeamException(exp.getMessage());
        }
        return teams;
    }
}