com.starkinfra.CardMethod Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of sdk Show documentation
Welcome to the Stark Infra Java SDK! This tool is made for Java developers who want to easily integrate with our API. This SDK version is compatible with the Stark Infra API v2.
There is a newer version: 0.11.2
Show newest version
package com.starkinfra;

import com.starkinfra.utils.Rest;
import com.starkinfra.utils.Generator;
import com.starkinfra.utils.SubResource;

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


public final class CardMethod extends SubResource {
    /**
     * CardMethod object
     * 
     * CardMethod's codes are used to define methods filters in IssuingRules.
     * 

     * Parameters:
     * code [string]: method's code. Options: "chip", "token", "server", "manual", "contactless"
     * name [string]: method's name. ex: "Token"
     * number [string]: method's number. ex: "81"
     *
     */
    static SubResource.ClassData data = new SubResource.ClassData(CardMethod.class, "CardMethod");

    public String code;
    public String name;
    public String number;

    /**
     * CardMethod object
     * 

     * CardMethod's codes are used to define methods filters in IssuingRules.
     * 

     * Parameters:
     * @param code [string]: method's code. Options: "chip", "token", "server", "manual", "contactless"
     * @param name [string]: method's name. ex: "Token"
     * @param number [string]: method's number. ex: "81"
     */
    public CardMethod(String code, String name, String number){
        this.code = code;
        this.name = name;
        this.number = number;
    }

    /**
     * CardMethod object
     * 

     * CardMethod's codes are used to define methods filters in IssuingRules.
     * 

     * Parameters:
     * @param data map of properties for the creation of the CardMethod
     * code [string]: method's code. Options: "chip", "token", "server", "manual", "contactless"
     * 

     * Attributes (return-only):
     * name [string]: method's name. ex: "Token"
     * number [string]: method's number. ex: "81"
     * @throws Exception error in the request
     */
    public CardMethod(Map data) throws Exception {
        HashMap dataCopy = new HashMap<>(data);

        this.code = (String) dataCopy.remove("code");
        this.name = null;
        this.number = null;

        if (!dataCopy.isEmpty()) {
            throw new Exception("Unknown parameters used in constructor: [" + String.join(", ", dataCopy.keySet()) + "]");
        }
    }

    /**
     * Retrieve CardMethods
     * 

     * Receive a generator of CardMethod objects available in the Stark Infra API
     * 

     * Parameters:
     * @param params map of parameters for the query
     * search [string, default null]: keyword to search for code, name, number or shortCode
     * @param user [Project object, default null]: Project object. Not necessary if StarkInfra.Settings.user was set before function call
     * 

     * Return:
     * @return generator of CardMethod objects with updated attributes
     * @throws Exception error in the request
     */
    public static Generator query(Map params, User user) throws Exception {
        return Rest.getStream(data, params, user);
    }

    /**
     * Retrieve CardMethods
     * 

     * Receive a generator of CardMethod objects available in the Stark Infra API
     * 

     * Parameters:
     * @param params map of parameters for the query
     * search [string, default null]: keyword to search for code, name, number or shortCode
     * 

     * Return:
     * @return generator of CardMethod objects with updated attributes
     * @throws Exception error in the request
     */
    public static Generator query(Map params) throws Exception {
        return Rest.getStream(data, params, null);
    }

    /**
     * Retrieve CardMethods
     * 

     * Receive a generator of CardMethod objects available in the Stark Infra API
     * 

     * Parameters:
     * @param user [Project object, default null]: Project object. Not necessary if StarkInfra.Settings.user was set before function call
     * 

     * Return:
     * @return generator of CardMethod objects with updated attributes
     * @throws Exception error in the request
     */
    public static Generator query(User user) throws Exception{
        return Rest.getStream(data, new HashMap<>(), user);
    }

    /**
     * Retrieve CardMethods
     * 

     * Receive a generator of CardMethod objects available in the Stark Infra API
     * 
     * Return:
     * @return generator of CardMethod objects with updated attributes
     * @throws Exception error in the request
     */
    public static Generator query() throws Exception{
        return Rest.getStream(data, new HashMap<>(), null);
    }
}