Package com.couchbase.client.java.manager.eventing

Class EventingFunctionManager

java.lang.Object

com.couchbase.client.java.manager.eventing.EventingFunctionManager

@Uncommitted
public class EventingFunctionManager
extends Object

Performs management operations on EventingFunctions.

Constructor Summary

Constructors

Constructor	Description
EventingFunctionManager(AsyncEventingFunctionManager asyncManager)	Creates a new EventingFunctionManager.

Method Summary

Modifier and Type	Method	Description
void	deployFunction(String name)	Deploys an EventingFunction identified by its name.
void	deployFunction(String name, DeployFunctionOptions options)	Deploys an EventingFunction identified by its name with custom options.
void	dropFunction(String name)	Removes a EventingFunction by its name if it exists.
void	dropFunction(String name, DropFunctionOptions options)	Removes a EventingFunction by its name if it exists with custom options.
EventingStatus	functionsStatus()	Retrieves helpful status information about all functions currently created on the cluster.
EventingStatus	functionsStatus(FunctionsStatusOptions options)	Retrieves helpful status information about all functions currently created on the cluster with custom options.
List<EventingFunction>	getAllFunctions()	Retrieves all EventingFunctions currently stored on the server.
List<EventingFunction>	getAllFunctions(GetAllFunctionsOptions options)	Retrieves all EventingFunctions currently stored on the server with custom options.
EventingFunction	getFunction(String name)	Retrieves a EventingFunction by its name.
EventingFunction	getFunction(String name, GetFunctionOptions options)	Retrieves a EventingFunction by its name with custom options.
void	pauseFunction(String name)	Pauses an EventingFunction identified by its name.
void	pauseFunction(String name, PauseFunctionOptions options)	Pauses an EventingFunction identified by its name with custom options.
void	resumeFunction(String name)	Resumes an EventingFunction identified by its name.
void	resumeFunction(String name, ResumeFunctionOptions options)	Resumes an EventingFunction identified by its name with custom options.
void	undeployFunction(String name)	Undeploys an EventingFunction identified by its name.
void	undeployFunction(String name, UndeployFunctionOptions options)	Undeploys an EventingFunction identified by its name with custom options.
void	upsertFunction(EventingFunction function)	Inserts or replaces a EventingFunction.
void	upsertFunction(EventingFunction function, UpsertFunctionOptions options)	Inserts or replaces a EventingFunction with custom options.

Methods inherited from class java.lang.Object

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

Constructor Detail

EventingFunctionManager

@Internal
public EventingFunctionManager(AsyncEventingFunctionManager asyncManager)

Creates a new EventingFunctionManager.

This API is not intended to be called by the user directly, use Cluster.eventingFunctions() instead.

Parameters:

asyncManager - the underlying async manager that performs the ops.

Method Detail

upsertFunction

public void upsertFunction(EventingFunction function)

Inserts or replaces a EventingFunction.

The eventing management API defines that if a function is stored which name does not exist yet, it will be inserted. If the name already exists, the function will be replaced with its new equivalent and the properties changed.

Operations which change the runtime-state of a function (i.e. deploy / undeploy / pause / resume) should not be modified through this method, but rather by using those methods directly (i.e. deployFunction(String)).

Parameters:

function - the function to be inserted or replaced.

Throws:

EventingFunctionCompilationFailureException - if the function body cannot be compiled.

CollectionNotFoundException - if the specified collection or scope does not exist.

BucketNotFoundException - if the specified bucket does not exist.

EventingFunctionIdenticalKeyspaceException - if the source and metadata keyspace are the same.

CouchbaseException - if any other generic unhandled/unexpected errors.

upsertFunction

public void upsertFunction(EventingFunction function,
                           UpsertFunctionOptions options)

Inserts or replaces a EventingFunction with custom options.

The eventing management API defines that if a function is stored which name does not exist yet, it will be inserted. If the name already exists, the function will be replaced with its new equivalent and the properties changed.

Operations which change the runtime-state of a function (i.e. deploy / undeploy / pause / resume) should not be modified through this method, but rather by using those methods directly (i.e. deployFunction(String)).

Parameters:

function - the function to be inserted or replaced.

options - the custom options to apply.

Throws:

EventingFunctionCompilationFailureException - if the function body cannot be compiled.

CollectionNotFoundException - if the specified collection or scope does not exist.

BucketNotFoundException - if the specified bucket does not exist.

EventingFunctionIdenticalKeyspaceException - if the source and metadata keyspace are the same.

CouchbaseException - if any other generic unhandled/unexpected errors.

getFunction

public EventingFunction getFunction(String name)

Retrieves a EventingFunction by its name.

Parameters:

name - the name of the function to retrieve.

Returns:

the eventing function found.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

CouchbaseException - if any other generic unhandled/unexpected errors.

getFunction

public EventingFunction getFunction(String name,
                                    GetFunctionOptions options)

Retrieves a EventingFunction by its name with custom options.

Parameters:

name - the name of the function to retrieve.

options - the custom options to apply.

Returns:

the eventing function found.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

CouchbaseException - if any other generic unhandled/unexpected errors.

getAllFunctions

public List<EventingFunction> getAllFunctions()

Retrieves all EventingFunctions currently stored on the server.

If no functions are found, an empty list is returned.

Returns:

eventing functions found or an empty list.

Throws:

CouchbaseException - if any other generic unhandled/unexpected errors.

getAllFunctions

public List<EventingFunction> getAllFunctions(GetAllFunctionsOptions options)

Retrieves all EventingFunctions currently stored on the server with custom options.

If no functions are found, an empty list is returned.

Parameters:

options - the custom options to apply.

Returns:

eventing functions found or an empty list.

Throws:

CouchbaseException - if any other generic unhandled/unexpected errors.

dropFunction

public void dropFunction(String name)

Removes a EventingFunction by its name if it exists.

Note that due to a bug on the server, depending on which version is used, both a EventingFunctionNotFoundException or a EventingFunctionNotDeployedException can be thrown if a function does not exist.

Parameters:

name - the name of the function to drop.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

EventingFunctionNotDeployedException - if the function is not found on the server (see above).

EventingFunctionDeployedException - if the function is currently deployed (undeploy first).

CouchbaseException - if any other generic unhandled/unexpected errors.

dropFunction

public void dropFunction(String name,
                         DropFunctionOptions options)

Removes a EventingFunction by its name if it exists with custom options.

Note that due to a bug on the server, depending on which version is used, both a EventingFunctionNotFoundException or a EventingFunctionNotDeployedException can be thrown if a function does not exist.

Parameters:

name - the name of the function to drop.

options - the custom options to apply.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

EventingFunctionNotDeployedException - if the function is not found on the server (see above).

EventingFunctionDeployedException - if the function is currently deployed (undeploy first).

CouchbaseException - if any other generic unhandled/unexpected errors.

deployFunction

public void deployFunction(String name)

Deploys an EventingFunction identified by its name.

Calling this method effectively moves the function from state EventingFunctionDeploymentStatus.UNDEPLOYED to state EventingFunctionDeploymentStatus.DEPLOYED.

Parameters:

name - the name of the function to deploy.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

EventingFunctionNotBootstrappedException - if the function is not bootstrapped yet (after creating it).

CouchbaseException - if any other generic unhandled/unexpected errors.

deployFunction

public void deployFunction(String name,
                           DeployFunctionOptions options)

Deploys an EventingFunction identified by its name with custom options.

Calling this method effectively moves the function from state EventingFunctionDeploymentStatus.UNDEPLOYED to state EventingFunctionDeploymentStatus.DEPLOYED.

Parameters:

name - the name of the function to deploy.

options - the custom options to apply.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

EventingFunctionNotBootstrappedException - if the function is not bootstrapped yet (after creating it).

CouchbaseException - if any other generic unhandled/unexpected errors.

undeployFunction

public void undeployFunction(String name)

Undeploys an EventingFunction identified by its name.

Calling this method effectively moves the function from state EventingFunctionDeploymentStatus.DEPLOYED to state EventingFunctionDeploymentStatus.UNDEPLOYED.

Note that due to a bug on the server, depending on which version is used, both a EventingFunctionNotFoundException or a EventingFunctionNotDeployedException can be thrown if a function does not exist.

Parameters:

name - the name of the function to undeploy.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

EventingFunctionNotDeployedException - if the function is not found on the server (see above).

CouchbaseException - if any other generic unhandled/unexpected errors.

undeployFunction

public void undeployFunction(String name,
                             UndeployFunctionOptions options)

Undeploys an EventingFunction identified by its name with custom options.

Calling this method effectively moves the function from state EventingFunctionDeploymentStatus.DEPLOYED to state EventingFunctionDeploymentStatus.UNDEPLOYED.

Note that due to a bug on the server, depending on which version is used, both a EventingFunctionNotFoundException or a EventingFunctionNotDeployedException can be thrown if a function does not exist.

Parameters:

name - the name of the function to undeploy.

options - the custom options to apply.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

EventingFunctionNotDeployedException - if the function is not found on the server (see above).

CouchbaseException - if any other generic unhandled/unexpected errors.

pauseFunction

public void pauseFunction(String name)

Pauses an EventingFunction identified by its name.

Calling this method effectively moves the function from state EventingFunctionProcessingStatus.RUNNING to state EventingFunctionProcessingStatus.PAUSED.

Parameters:

name - the name of the function to pause.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

EventingFunctionNotBootstrappedException - if the function is not bootstrapped yet (after creating it).

CouchbaseException - if any other generic unhandled/unexpected errors.

pauseFunction

public void pauseFunction(String name,
                          PauseFunctionOptions options)

Pauses an EventingFunction identified by its name with custom options.

Calling this method effectively moves the function from state EventingFunctionProcessingStatus.RUNNING to state EventingFunctionProcessingStatus.PAUSED.

Parameters:

name - the name of the function to pause.

options - the custom options to apply.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

EventingFunctionNotBootstrappedException - if the function is not bootstrapped yet (after creating it).

CouchbaseException - if any other generic unhandled/unexpected errors.

resumeFunction

public void resumeFunction(String name)

Resumes an EventingFunction identified by its name.

Calling this method effectively moves the function from state EventingFunctionProcessingStatus.PAUSED to state EventingFunctionProcessingStatus.RUNNING.

Note that due to a bug on the server, depending on which version is used, both a EventingFunctionNotFoundException or a EventingFunctionNotDeployedException can be thrown if a function does not exist.

Parameters:

name - the name of the function to resume.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

EventingFunctionNotDeployedException - if the function is not found on the server (see above).

CouchbaseException - if any other generic unhandled/unexpected errors.

resumeFunction

public void resumeFunction(String name,
                           ResumeFunctionOptions options)

Resumes an EventingFunction identified by its name with custom options.

Calling this method effectively moves the function from state EventingFunctionProcessingStatus.PAUSED to state EventingFunctionProcessingStatus.RUNNING.

Note that due to a bug on the server, depending on which version is used, both a EventingFunctionNotFoundException or a EventingFunctionNotDeployedException can be thrown if a function does not exist.

Parameters:

name - the name of the function to resume.

options - the custom options to apply.

Throws:

EventingFunctionNotFoundException - if the function is not found on the server.

EventingFunctionNotDeployedException - if the function is not found on the server (see above).

CouchbaseException - if any other generic unhandled/unexpected errors.

functionsStatus

public EventingStatus functionsStatus()

Retrieves helpful status information about all functions currently created on the cluster.

Returns:

the eventing status.

Throws:

CouchbaseException - if any other generic unhandled/unexpected errors.

functionsStatus

public EventingStatus functionsStatus(FunctionsStatusOptions options)

Retrieves helpful status information about all functions currently created on the cluster with custom options.

Parameters:

options - the custom options to apply.

Returns:

the eventing status.

Throws:

CouchbaseException - if any other generic unhandled/unexpected errors.