User.java

package co.gem.round;

import co.gem.round.patchboard.Client;
import co.gem.round.patchboard.Resource;
import com.google.gson.JsonElement;
import com.google.gson.JsonObject;

import java.io.IOException;
import java.util.Map;

/**
 * Gem users are the objects that interact with wallets.  When creating a user, the user will have a default wallet
 * but users can also have multiple wallets over time.  Users also have their own tokens which are used for various
 * authentication schemes.
 * @author Julian Del Vergel de Dios (julian@gem.co) on 12/18/14.
 */
public class User extends Base {
    public User(Resource resource, Round round) {
        super(resource, round);
    }
    public User(Resource resource, Round round, JsonObject attributes) { super(resource, round, attributes); }

    /**
     * Getter all the wallets belonging to a user. Returns populated WalletCollection object. To
     * retrieve reference without fetching wallets use 'wallets(false)'
     * @return WalletCollection
     * @throws IOException
     * @throws Client.UnexpectedStatusCodeException
     * @see co.gem.round.WalletCollection
     */
    public WalletCollection wallets() throws
            IOException, Client.UnexpectedStatusCodeException {
        return wallets(true);
    }

    /**
     * Getter for WalletCollection associated with a user.
     * @param fetch boolean used to determine whether to populate collection
     * @return WalletCollection
     * @throws IOException
     * @throws Client.UnexpectedStatusCodeException
     * @see co.gem.round.WalletCollection
     */
    public WalletCollection wallets(boolean fetch) throws
            IOException, Client.UnexpectedStatusCodeException {
        Resource resource = this.resource.subresource("wallets");
        WalletCollection wallets = new WalletCollection(resource, round);
        if (fetch) {
            wallets.fetch();
        }
        return wallets;
    }

    public Devices devices() throws
            IOException, Client.UnexpectedStatusCodeException {
        if (this.resource.subresource("devices") != null) {
            return new Devices(this.resource.subresource("devices"), this.round);
        }
        return this.round.deviceQuery(this.email());
    }

    /**
     * Getter for the default wallet of a user
     * @return Wallet
     * @throws IOException
     * @throws Client.UnexpectedStatusCodeException
     */
    public Wallet wallet()
            throws IOException, Client.UnexpectedStatusCodeException {
        Resource resource = this.resource.subresource("default_wallet");
        Wallet defaultWallet = new Wallet(resource, round, null);
        defaultWallet.fetch();
        return defaultWallet;
    }

    /**
     * Getter for email for a user
     * @return String email address
     */
    public String email() {
        return getString("email");
    }

    /**
     * Getter for first name for a user
     * @return String first name
     */
    public String firstName() {
        return getString("first_name");
    }

    /**
     * Getter for last name for a user
     * @return String last name
     */
    public String lastName() {
        return getString("last_name");
    }

    /**
     * Getter for the user token which is used in various authentication schemes
     * @return String user token
     */
    public String userToken() {
        return getString("user_token");
    }

    /**
     * Getter for the Gem API url of a user
     * @return String
     */
    public String userUrl() {
        return getString("url");
    }

    public String redirectUri() {
        return getString("redirect_uri");
    }
}