org.apache.pulsar.io.core

Interface ConnectorContext

All Known Subinterfaces:

SinkContext, SourceContext

@InterfaceAudience.Public
 @InterfaceStability.Stable
public interface ConnectorContext

Interface for a connector providing information about environment where it is running. It also allows to propagate information, such as logs, metrics, states, back to the Pulsar environment.

Method Summary

Modifier and Type	Method and Description
void	deleteState(String key) Delete the state value for the key.
CompletableFuture<Void>	deleteStateAsync(String key) Delete the state value for the key, but don't wait for the operation to be completed
long	getCounter(String key) Retrieve the counter value for the key.
CompletableFuture<Long>	getCounterAsync(String key) Retrieve the counter value for the key, but don't wait for the operation to be completed
int	getInstanceId() The id of the instance that invokes this source.
org.slf4j.Logger	getLogger() The logger object that can be used to log in a sink
String	getNamespace() The namespace this source belongs to.
int	getNumInstances() Get the number of instances that invoke this source.
String	getSecret(String secretName) Get the secret associated with this key
ByteBuffer	getState(String key) Retrieve the state value for the key.
CompletableFuture<ByteBuffer>	getStateAsync(String key) Retrieve the state value for the key, but don't wait for the operation to be completed
default <S extends StateStore> S	getStateStore(String name) Get the state store with the provided store name.
String	getTenant() The tenant this source belongs to.
void	incrCounter(String key, long amount) Increment the builtin distributed counter referred by key.
CompletableFuture<Void>	incrCounterAsync(String key, long amount) Increment the builtin distributed counter referred by key but dont wait for the completion of the increment operation
void	putState(String key, ByteBuffer value) Update the state value for the key.
CompletableFuture<Void>	putStateAsync(String key, ByteBuffer value) Update the state value for the key, but don't wait for the operation to be completed
void	recordMetric(String metricName, double value) Record a user defined metric

Method Detail

getInstanceId

int getInstanceId()

The id of the instance that invokes this source.

Returns:

the instance id

getNumInstances

int getNumInstances()

Get the number of instances that invoke this source.

Returns:

the number of instances that invoke this source.

recordMetric

void recordMetric(String metricName,
                  double value)

Record a user defined metric

Parameters:

metricName - The name of the metric

value - The value of the metric

getTenant

String getTenant()

The tenant this source belongs to.

Returns:

the tenant this source belongs to

getNamespace

String getNamespace()

The namespace this source belongs to.

Returns:

the namespace this source belongs to

getLogger

org.slf4j.Logger getLogger()

The logger object that can be used to log in a sink

Returns:

the logger object

getSecret

String getSecret(String secretName)

Get the secret associated with this key

Parameters:

secretName - The name of the secret

Returns:

The secret if anything was found or null

getStateStore

default <S extends StateStore> S getStateStore(String name)

Get the state store with the provided store name.

Type Parameters:

S - the type of interface of the store to return

Parameters:

name - the state store name

Returns:

the state store instance.

Throws:

ClassCastException - if the return type isn't a type or interface of the actual returned store.

incrCounter

void incrCounter(String key,
                 long amount)

Increment the builtin distributed counter referred by key.

Parameters:

key - The name of the key

amount - The amount to be incremented

incrCounterAsync

CompletableFuture<Void> incrCounterAsync(String key,
                                         long amount)

Increment the builtin distributed counter referred by key but dont wait for the completion of the increment operation

Parameters:

key - The name of the key

amount - The amount to be incremented

getCounter

long getCounter(String key)

Retrieve the counter value for the key.

Parameters:

key - name of the key

Returns:

the amount of the counter value for this key

getCounterAsync

CompletableFuture<Long> getCounterAsync(String key)

Retrieve the counter value for the key, but don't wait for the operation to be completed

Parameters:

key - name of the key

Returns:

the amount of the counter value for this key

putState

void putState(String key,
              ByteBuffer value)

Update the state value for the key.

Parameters:

key - name of the key

value - state value of the key

putStateAsync

CompletableFuture<Void> putStateAsync(String key,
                                      ByteBuffer value)

Update the state value for the key, but don't wait for the operation to be completed

Parameters:

key - name of the key

value - state value of the key

getState

ByteBuffer getState(String key)

Retrieve the state value for the key.

Parameters:

key - name of the key

Returns:

the state value for the key.

getStateAsync

CompletableFuture<ByteBuffer> getStateAsync(String key)

Retrieve the state value for the key, but don't wait for the operation to be completed

Parameters:

key - name of the key

Returns:

the state value for the key.

deleteState

void deleteState(String key)

Delete the state value for the key.

Parameters:

key - name of the key

deleteStateAsync

CompletableFuture<Void> deleteStateAsync(String key)

Delete the state value for the key, but don't wait for the operation to be completed

Parameters:

key - name of the key