org.apache.pulsar.broker.service

Interface TopicPoliciesService

All Known Implementing Classes:

SystemTopicBasedTopicPoliciesService, TopicPoliciesService.TopicPoliciesServiceDisabled

public interface TopicPoliciesService

Topic policies service.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	TopicPoliciesService.TopicPoliciesServiceDisabled

Field Summary

Fields

Modifier and Type	Field and Description
static long	DEFAULT_GET_TOPIC_POLICY_TIMEOUT
static TopicPoliciesService	DISABLED

Method Summary

Modifier and Type	Method and Description
CompletableFuture<Void>	addOwnedNamespaceBundleAsync(NamespaceBundle namespaceBundle) Add owned namespace bundle async.
default void	clean(org.apache.pulsar.common.naming.TopicName topicName) clean cache and listeners in TopicPolicies and so on.
CompletableFuture<Void>	deleteTopicPoliciesAsync(org.apache.pulsar.common.naming.TopicName topicName) Delete policies for a topic async.
org.apache.pulsar.common.policies.data.TopicPolicies	getTopicPolicies(org.apache.pulsar.common.naming.TopicName topicName) Get policies for a topic async.
default CompletableFuture<Optional<org.apache.pulsar.common.policies.data.TopicPolicies>>	getTopicPoliciesAsyncWithRetry(org.apache.pulsar.common.naming.TopicName topicName, Backoff backoff, ScheduledExecutorService scheduledExecutorService) When getting TopicPolicies, if the initialization has not been completed, we will go back off and try again until time out.
CompletableFuture<org.apache.pulsar.common.policies.data.TopicPolicies>	getTopicPoliciesBypassCacheAsync(org.apache.pulsar.common.naming.TopicName topicName) Get policies for a topic without cache async.
org.apache.pulsar.common.policies.data.TopicPolicies	getTopicPoliciesIfExists(org.apache.pulsar.common.naming.TopicName topicName) Get policies from current cache.
void	registerListener(org.apache.pulsar.common.naming.TopicName topicName, TopicPolicyListener<org.apache.pulsar.common.policies.data.TopicPolicies> listener)
CompletableFuture<Void>	removeOwnedNamespaceBundleAsync(NamespaceBundle namespaceBundle) Remove owned namespace bundle async.
void	start() Start the topic policy service.
void	unregisterListener(org.apache.pulsar.common.naming.TopicName topicName, TopicPolicyListener<org.apache.pulsar.common.policies.data.TopicPolicies> listener)
CompletableFuture<Void>	updateTopicPoliciesAsync(org.apache.pulsar.common.naming.TopicName topicName, org.apache.pulsar.common.policies.data.TopicPolicies policies) Update policies for a topic async.

Field Detail

DISABLED

static final TopicPoliciesService DISABLED

DEFAULT_GET_TOPIC_POLICY_TIMEOUT

static final long DEFAULT_GET_TOPIC_POLICY_TIMEOUT

See Also:

Constant Field Values

Method Detail

deleteTopicPoliciesAsync

CompletableFuture<Void> deleteTopicPoliciesAsync(org.apache.pulsar.common.naming.TopicName topicName)

Delete policies for a topic async.

Parameters:

topicName - topic name

updateTopicPoliciesAsync

CompletableFuture<Void> updateTopicPoliciesAsync(org.apache.pulsar.common.naming.TopicName topicName,
                                                 org.apache.pulsar.common.policies.data.TopicPolicies policies)

Update policies for a topic async.

Parameters:

topicName - topic name

policies - policies for the topic name

getTopicPolicies

org.apache.pulsar.common.policies.data.TopicPolicies getTopicPolicies(org.apache.pulsar.common.naming.TopicName topicName)
                                                               throws BrokerServiceException.TopicPoliciesCacheNotInitException

Get policies for a topic async.

Parameters:

topicName - topic name

Returns:

future of the topic policies

Throws:

BrokerServiceException.TopicPoliciesCacheNotInitException

getTopicPoliciesIfExists

org.apache.pulsar.common.policies.data.TopicPolicies getTopicPoliciesIfExists(org.apache.pulsar.common.naming.TopicName topicName)

Get policies from current cache.

Parameters:

topicName - topic name

Returns:

the topic policies

getTopicPoliciesAsyncWithRetry

default CompletableFuture<Optional<org.apache.pulsar.common.policies.data.TopicPolicies>> getTopicPoliciesAsyncWithRetry(org.apache.pulsar.common.naming.TopicName topicName,
                                                                                                                         Backoff backoff,
                                                                                                                         ScheduledExecutorService scheduledExecutorService)

When getting TopicPolicies, if the initialization has not been completed, we will go back off and try again until time out.

Parameters:

topicName - topic name

backoff - back off policy

Returns:

CompletableFuture>

getTopicPoliciesBypassCacheAsync

CompletableFuture<org.apache.pulsar.common.policies.data.TopicPolicies> getTopicPoliciesBypassCacheAsync(org.apache.pulsar.common.naming.TopicName topicName)

Get policies for a topic without cache async.

Parameters:

topicName - topic name

Returns:

future of the topic policies

addOwnedNamespaceBundleAsync

CompletableFuture<Void> addOwnedNamespaceBundleAsync(NamespaceBundle namespaceBundle)

Add owned namespace bundle async.

Parameters:

namespaceBundle - namespace bundle

removeOwnedNamespaceBundleAsync

CompletableFuture<Void> removeOwnedNamespaceBundleAsync(NamespaceBundle namespaceBundle)

Remove owned namespace bundle async.

Parameters:

namespaceBundle - namespace bundle

start

void start()

Start the topic policy service.

registerListener

void registerListener(org.apache.pulsar.common.naming.TopicName topicName,
                      TopicPolicyListener<org.apache.pulsar.common.policies.data.TopicPolicies> listener)

unregisterListener

void unregisterListener(org.apache.pulsar.common.naming.TopicName topicName,
                        TopicPolicyListener<org.apache.pulsar.common.policies.data.TopicPolicies> listener)

clean

default void clean(org.apache.pulsar.common.naming.TopicName topicName)

clean cache and listeners in TopicPolicies and so on.

Parameters:

topicName -