org.bonitasoft.engine.api

Class APIClient

java.lang.Object

org.bonitasoft.engine.api.APIClient

Direct Known Subclasses:

APIClient

public class APIClient
extends Object

Bonita Community Edition APIs client.

• IdentityAPI,
• ProcessAPI,
• ThemeAPI
• CommandAPI,
• ProfileAPI,
• TenantAdministrationAPI,
• PageAPI,
• ApplicationAPI,
• PermissionAPI,
• BusinessDataAPI (deprecated as of 7.3),

Author:

Nicolas Chabanoles

Field Summary

Fields

Modifier and Type	Field and Description
protected APISession	session

Constructor Summary

Constructors

Constructor and Description
APIClient()
APIClient(APISession session)

Method Summary

Modifier and Type	Method and Description
protected <T> T	getAPI(Class<T> apiClass)
ApplicationAPI	getApplicationAPI() Get API to manage Bonita Applications.
BusinessDataAPI	getBusinessDataAPI() Deprecated. as of 7.3, see BusinessDataAPI for replacements
CommandAPI	getCommandAPI() Get API to manage commands and Tenant level dependencies.
PageAPI	getCustomPageAPI() Get API to manage portal pages.
<T extends BusinessObjectDAO> T	getDAO(Class<T> daoInterface) Get an implementation instance of the DAO Interface.
IdentityAPI	getIdentityAPI() Get API to manage the organization, i.e., users, groups and roles.
ApplicationAPI	getLivingApplicationAPI() Get API to manage Living Applications.
protected LoginAPI	getLoginAPI()
protected <T extends LoginAPI> T	getLoginAPI(Class<T> apiClass) This methods serves the purpose to remove confusion between getAPI() when a session is mandatory, and this one, where no session is needed to access the API class.
PermissionAPI	getPermissionAPI() Get API to dynamically check REST API call access right.
ProcessAPI	getProcessAPI() Get API to manage the business processes.
ProfileAPI	getProfileAPI() Get API to manage portal user profiles.
APISession	getSession()
TenantAdministrationAPI	getTenantAdministrationAPI() Get API to manage the tenant your are logged on.
ThemeAPI	getThemeAPI() Get API to manage themes (Portal and mobile).
protected <T extends BusinessObjectDAO> Class<T>	loadClass(Class<T> daoInterface) Loads the class of the BusinessObjectDAO according to its class name.
void	login(String username, String password) Connects a user, identified by his (her) username and password, in order to use API methods of a tenant.
void	logout() Disconnect user from tenant APIs.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

session

protected APISession session

Constructor Detail

APIClient

public APIClient()

APIClient

public APIClient(APISession session)

Method Detail

getSession

public APISession getSession()

getAPI

protected <T> T getAPI(Class<T> apiClass)

getLoginAPI

protected LoginAPI getLoginAPI()

getLoginAPI

protected <T extends LoginAPI> T getLoginAPI(Class<T> apiClass)

This methods serves the purpose to remove confusion between getAPI() when a session is mandatory, and this one, where no session is needed to access the API class.

Type Parameters:

T - The type of the API, extending LoginAPI

Parameters:

apiClass - the API to retrieve

Returns:

the retrieved API

Throws:

IllegalStateException - if the API cannot be retrieved.

login

public void login(String username,
                  String password)
           throws LoginException

Connects a user, identified by his (her) username and password, in order to use API methods of a tenant.

Parameters:

username - the user name

password - the password

Throws:

LoginException - occurs when an exception is thrown during the login (userName does not exist, or couple (userName, password) is incorrect)

Since:

7.2

logout

public void logout()
            throws LogoutException

Disconnect user from tenant APIs.

Throws:

LogoutException

Since:

7.2

getDAO

public <T extends BusinessObjectDAO> T getDAO(Class<T> daoInterface)
                                       throws BusinessObjectDaoCreationException

Get an implementation instance of the DAO Interface.

Parameters:

daoInterface - the interface of the DAO

Returns:

the implementation of the DAO

Throws:

BusinessObjectDaoCreationException - if the factory is not able to instantiate the DAO

loadClass

protected <T extends BusinessObjectDAO> Class<T> loadClass(Class<T> daoInterface)
                                                    throws ClassNotFoundException

Loads the class of the BusinessObjectDAO according to its class name.

The loading is done in the current Thread ClassLoader.

Parameters:

daoInterface - the DAO's interface

Returns:

the Implementation class of the BusinessObjectDAO

Throws:

ClassNotFoundException - if the implementation class name is unknown by the current Thread ClassLoader

getIdentityAPI

public IdentityAPI getIdentityAPI()

Get API to manage the organization, i.e., users, groups and roles.

Since:

7.2

getProcessAPI

public ProcessAPI getProcessAPI()

Get API to manage the business processes.

Since:

7.2

getThemeAPI

public ThemeAPI getThemeAPI()

Get API to manage themes (Portal and mobile).

Since:

7.2

getCommandAPI

public CommandAPI getCommandAPI()

Get API to manage commands and Tenant level dependencies.

Since:

7.2

getProfileAPI

public ProfileAPI getProfileAPI()

Get API to manage portal user profiles.

Since:

7.2

getTenantAdministrationAPI

public TenantAdministrationAPI getTenantAdministrationAPI()

Get API to manage the tenant your are logged on.

Since:

7.2

getCustomPageAPI

public PageAPI getCustomPageAPI()

Get API to manage portal pages.

Since:

7.2

getLivingApplicationAPI

public ApplicationAPI getLivingApplicationAPI()

Get API to manage Living Applications.

Since:

7.2

getPermissionAPI

public PermissionAPI getPermissionAPI()

Get API to dynamically check REST API call access right.

Since:

7.2

getBusinessDataAPI

@Deprecated
public BusinessDataAPI getBusinessDataAPI()

Deprecated. as of 7.3, see BusinessDataAPI for replacements

Get API to access Business Data related to processes.

Since:

7.2

getApplicationAPI

public ApplicationAPI getApplicationAPI()

Get API to manage Bonita Applications.

Since:

7.10