step.client

Class StepClient

java.lang.Object

step.client.StepClient

All Implemented Interfaces:

Closeable, AutoCloseable

public class StepClient
extends Object
implements Closeable

This class provides a single point of access to the STEP services.

Field Summary

Fields

Modifier and Type	Field and Description
protected step.client.credentials.ControllerCredentials	credentials

Constructor Summary

Constructors

Constructor and Description
StepClient() Creates a new StepClient and logins to the controller using the controller host and credentials provided by SyspropCredendialsBuilder
StepClient(step.client.credentials.ControllerCredentials controllerCredentials) Creates a new StepClient and logins to the controller using the credentials provided as argument
StepClient(String controllerUrl) Creates a new StepClient and logins to the controller without credentials (for controller that have disabled authentication)
StepClient(String controllerUrl, String username, String password) Creates a new StepClient and logins to the controller using the credentials provided as argument

Method Summary

Modifier and Type	Method and Description
void	close()
List<Tenant>	getAvailableTenants()
step.client.controller.ControllerServicesClient	getControllerServicesClient()
Tenant	getCurrentTenant()
RemoteEventBrokerClient	getEventBrokerClient()
step.client.executions.RemoteExecutionManager	getExecutionManager()
step.functions.execution.FunctionExecutionService	getFunctionExecutionService()
step.client.functions.RemoteFunctionManager	getFunctionManager()
FunctionPackageClient	getFunctionPackageClient()
MultitenancyClient	getMultitenancyClient()
PlanBuilders	getPlanBuilders() Deprecated. This method will be removed in future releases. To create a Plan programmatically use PlanBuilder.create() instead. To parse a plain text plan use PlanParser directly
PlanRunners	getPlanRunners() Deprecated. This method will be removed in future releases. To run a plan locally use ExecutionEngine directly. To run a plan located on your controller use RemoteExecutionManager
step.client.accessors.RemotePlanAccessor	getPlans()
step.client.accessors.RemoteAccessors	getRemoteAccessors()
step.client.resources.RemoteResourceManager	getResourceManager()
step.client.repository.StagingRepositoryClient	getStagingRepositoryClient() Deprecated. The staging client is deprecated and will be removed in future releases. All executions are now providing an isolated context thus making the Staging repository useless.
void	selectTenant(String tenantName) Select a specific tenant.

Methods inherited from class java.lang.Object

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

Field Detail

credentials

protected final step.client.credentials.ControllerCredentials credentials

Constructor Detail

StepClient

public StepClient()

Creates a new StepClient and logins to the controller using the controller host and credentials provided by SyspropCredendialsBuilder

StepClient

public StepClient(String controllerUrl)

Creates a new StepClient and logins to the controller without credentials (for controller that have disabled authentication)

Parameters:

controllerUrl - the URL of the controller (for instance: http://mycontroller.com)

StepClient

public StepClient(String controllerUrl,
                  String username,
                  String password)

Creates a new StepClient and logins to the controller using the credentials provided as argument

Parameters:

controllerUrl - the URL of the controller (for instance: http://mycontroller.com)

username - the username to be used to login to the controller

password - the password to be used to login to the controller

StepClient

public StepClient(step.client.credentials.ControllerCredentials controllerCredentials)

Creates a new StepClient and logins to the controller using the credentials provided as argument

Parameters:

controllerCredentials - the complex object already containing all of the login information

Method Detail

selectTenant

public void selectTenant(String tenantName)
                  throws Exception

Select a specific tenant. This is function is equivalent to the selection of a tenant in GUI on the right corner

Parameters:

tenantName - the name of the tenant to be selected. In the GUI this is the name of tenant as displayed in the dropdown

Throws:

Exception

getAvailableTenants

public List<Tenant> getAvailableTenants()

Returns:

the list of tenants available in the current session

getCurrentTenant

public Tenant getCurrentTenant()

Returns:

the current tenant

getMultitenancyClient

public MultitenancyClient getMultitenancyClient()

Returns:

the MultitenancyClient. Use this client for advanced tenant operations

getPlanBuilders

public PlanBuilders getPlanBuilders()

Deprecated. This method will be removed in future releases. To create a Plan programmatically use PlanBuilder.create() instead. To parse a plain text plan use PlanParser directly

Returns:

the available Plan builders to build Plan instances

getPlans

public step.client.accessors.RemotePlanAccessor getPlans()

Returns:

the PlanRepository to access the Plans listed under "Plans"

getPlanRunners

public PlanRunners getPlanRunners()

Deprecated. This method will be removed in future releases. To run a plan locally use ExecutionEngine directly. To run a plan located on your controller use RemoteExecutionManager

Returns:

the available plan runners for execution of "Plans"

getFunctionPackageClient

public FunctionPackageClient getFunctionPackageClient()

Returns:

the FunctionPackageClient to add/delete FunctionPackages and thus add/delete Functions aka Keywords in batch

getFunctionManager

public step.client.functions.RemoteFunctionManager getFunctionManager()

Returns:

the function manager to add/delete/get functions (aka Keywords)

getFunctionExecutionService

public step.functions.execution.FunctionExecutionService getFunctionExecutionService()

Returns:

the function execution service to run functions remotely. For advanced users only.

getResourceManager

public step.client.resources.RemoteResourceManager getResourceManager()

Returns:

the resource manager to upload resources (Keyword files, etc) to the controller

getExecutionManager

public step.client.executions.RemoteExecutionManager getExecutionManager()

Returns:

the execution manager to start/stop/monitor executions

getEventBrokerClient

public RemoteEventBrokerClient getEventBrokerClient()

Returns:

a client for the EventBroker of the controller

getRemoteAccessors

public step.client.accessors.RemoteAccessors getRemoteAccessors()

Returns:

the remote accessors to access low-level entities directly. For advanced users only.

getStagingRepositoryClient

public step.client.repository.StagingRepositoryClient getStagingRepositoryClient()

Deprecated. The staging client is deprecated and will be removed in future releases. All executions are now providing an isolated context thus making the Staging repository useless.

Returns:

the staging client to run fully isolated executions on the controller

getControllerServicesClient

public step.client.controller.ControllerServicesClient getControllerServicesClient()

Returns:

a client for the miscellaneous controller services

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException