org.bonitasoft.web.client.api.CustomUserApi Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of bonita-java-client Show documentation
Java client for Bonita REST API
The newest version!
/** 
 * Copyright (C) 2024 BonitaSoft S.A.
 * BonitaSoft, 32 rue Gustave Eiffel - 38000 Grenoble
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 2.0 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program. If not, see .
 */
package org.bonitasoft.web.client.api;

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

import org.bonitasoft.web.client.invoker.ApiClient;
import org.bonitasoft.web.client.invoker.EncodingUtils;
import org.bonitasoft.web.client.model.ApiResponse;
import org.bonitasoft.web.client.model.CustomUser;

import feign.*;

@jakarta.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.8.0")
public interface CustomUserApi extends ApiClient.Api {

    /**
     * Finds CustomUsers
     * Finds CustomUsers with pagination params and filters **The filter `userId` is mandatory**
     * 
     * @param p index of the page to display (required)
     * @param c maximum number of elements to retrieve (required)
     * @param f can filter on attributes with the format f={filter\\_name}={filter\\_value} with the name/value pair as url encoded string. (optional)
     * @return List<CustomUser>
     */
    @RequestLine("GET /API/customuserinfo/user?p={p}&c={c}&f={f}")
    @Headers({
            "Accept: application/json",
    })
    List searchCustomUsers(@Param("p") Integer p, @Param("c") Integer c, @Param("f") List f);

    /**
     * Finds CustomUsers
     * Similar to searchCustomUsers but it also returns the http response headers .
     * Finds CustomUsers with pagination params and filters **The filter `userId` is mandatory**
     * 
     * @param p index of the page to display (required)
     * @param c maximum number of elements to retrieve (required)
     * @param f can filter on attributes with the format f={filter\\_name}={filter\\_value} with the name/value pair as url encoded string. (optional)
     * @return A ApiResponse that wraps the response boyd and the http headers.
     */
    @RequestLine("GET /API/customuserinfo/user?p={p}&c={c}&f={f}")
    @Headers({
            "Accept: application/json",
    })
    ApiResponse> searchCustomUsersWithHttpInfo(@Param("p") Integer p, @Param("c") Integer c,
            @Param("f") List f);

    /**
     * Finds CustomUsers
     * Finds CustomUsers with pagination params and filters **The filter `userId` is mandatory**
     * Note, this is equivalent to the other searchCustomUsers method,
     * but with the query parameters collected into a single Map parameter. This
     * is convenient for services with optional query parameters, especially when
     * used with the {@link SearchCustomUsersQueryParams} class that allows for
     * building up this map in a fluent style.
     * 
     * @param queryParams Map of query parameters as name-value pairs
     *        The following elements may be specified in the query map:
     *        
     *        p - index of the page to display (required)
     *        c - maximum number of elements to retrieve (required)
     *        f - can filter on attributes with the format f={filter\\_name}={filter\\_value} with the name/value pair as url encoded string.
     *        (optional)
     *        
     * @return List<CustomUser>
     */
    @RequestLine("GET /API/customuserinfo/user?p={p}&c={c}&f={f}")
    @Headers({
            "Accept: application/json",
    })
    List searchCustomUsers(@QueryMap(encoded = true) SearchCustomUsersQueryParams queryParams);

    /**
     * Finds CustomUsers
     * Finds CustomUsers with pagination params and filters **The filter `userId` is mandatory**
     * Note, this is equivalent to the other searchCustomUsers that receives the query parameters as a map,
     * but this one also exposes the Http response headers
     * 
     * @param queryParams Map of query parameters as name-value pairs
     *        The following elements may be specified in the query map:
     *        
     *        p - index of the page to display (required)
     *        c - maximum number of elements to retrieve (required)
     *        f - can filter on attributes with the format f={filter\\_name}={filter\\_value} with the name/value pair as url encoded string.
     *        (optional)
     *        
     * @return List<CustomUser>
     */
    @RequestLine("GET /API/customuserinfo/user?p={p}&c={c}&f={f}")
    @Headers({
            "Accept: application/json",
    })
    ApiResponse> searchCustomUsersWithHttpInfo(
            @QueryMap(encoded = true) SearchCustomUsersQueryParams queryParams);

    /**
     * A convenience class for generating query parameters for the
     * searchCustomUsers method in a fluent style.
     */
    public static class SearchCustomUsersQueryParams extends HashMap {

        public SearchCustomUsersQueryParams p(final Integer value) {
            put("p", EncodingUtils.encode(value));
            return this;
        }

        public SearchCustomUsersQueryParams c(final Integer value) {
            put("c", EncodingUtils.encode(value));
            return this;
        }

        public SearchCustomUsersQueryParams f(final List value) {
            put("f", EncodingUtils.encodeCollection(value, "multi"));
            return this;
        }
    }
}