org.apache.pulsar.broker.service

Interface Topic

All Known Implementing Classes:

AbstractTopic, NonPersistentTopic, PersistentTopic, SystemTopic

public interface Topic

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Topic.PublishContext

Method Summary

Modifier and Type	Method and Description
void	addProducer(Producer producer)
CompletableFuture<org.apache.pulsar.common.protocol.schema.SchemaVersion>	addSchema(org.apache.pulsar.common.protocol.schema.SchemaData schema) Add a schema to the topic.
CompletableFuture<Void>	addSchemaIfIdleOrCheckCompatible(org.apache.pulsar.common.protocol.schema.SchemaData schema) If the topic is idle (no producers, no entries, no subscribers and no existing schema), add the passed schema to the topic.
void	checkBackloggedCursors() Activate cursors those caught up backlog-threshold entries and deactivate slow cursors which are creating backlog.
void	checkDeduplicationSnapshot()
void	checkGC()
void	checkInactiveSubscriptions()
void	checkMessageDeduplicationInfo()
void	checkMessageExpiry()
CompletableFuture<Void>	checkReplication()
CompletableFuture<Void>	checkSchemaCompatibleForConsumer(org.apache.pulsar.common.protocol.schema.SchemaData schema) Check if schema is compatible with current topic schema.
void	checkTopicPublishThrottlingRate()
CompletableFuture<Void>	close(boolean closeWithoutWaitingClientDisconnect)
CompletableFuture<Subscription>	createSubscription(String subscriptionName, org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.InitialPosition initialPosition, boolean replicateSubscriptionState)
CompletableFuture<Void>	delete()
CompletableFuture<Void>	deleteForcefully()
CompletableFuture<org.apache.pulsar.common.protocol.schema.SchemaVersion>	deleteSchema() Delete the schema if this topic has a schema defined for it.
void	disableCnxAutoRead()
void	enableCnxAutoRead()
CompletableFuture<Void>	endTxn(org.apache.pulsar.client.api.transaction.TxnID txnID, int txnAction, List<org.apache.pulsar.common.api.proto.PulsarApi.MessageIdData> sendMessageIdList) End the transaction in this topic.
org.apache.pulsar.common.policies.data.BacklogQuota	getBacklogQuota()
default Optional<DispatchRateLimiter>	getDispatchRateLimiter()
CompletableFuture<org.apache.pulsar.common.policies.data.PersistentTopicInternalStats>	getInternalStats(boolean includeLedgerMetadata)
CompletableFuture<org.apache.pulsar.client.api.MessageId>	getLastMessageId()
Position	getLastPosition()
String	getName()
Map<String,Producer>	getProducers()
org.apache.pulsar.common.util.collections.ConcurrentOpenHashMap<String,? extends Replicator>	getReplicators()
boolean	getSchemaValidationEnforced()
org.apache.pulsar.common.policies.data.TopicStats	getStats(boolean getPreciseBacklog, boolean subscriptionBacklogSize)
Subscription	getSubscription(String subscription)
org.apache.pulsar.common.util.collections.ConcurrentOpenHashMap<String,? extends Subscription>	getSubscriptions()
CompletableFuture<TransactionBuffer>	getTransactionBuffer(boolean createIfMissing) Get the $TransactionBuffer of this Topic.
CompletableFuture<Boolean>	hasSchema() Whether a topic has had a schema defined for it.
void	incrementPublishCount(int numOfMessages, long msgSizeInBytes)
boolean	isBacklogQuotaExceeded(String producerName)
boolean	isBrokerPublishRateExceeded()
boolean	isEncryptionRequired()
boolean	isPublishRateExceeded()
boolean	isReplicated()
default boolean	isSystemTopic()
boolean	isTopicPublishRateExceeded(int msgSize, int numMessages)
CompletableFuture<Void>	onPoliciesUpdate(org.apache.pulsar.common.policies.data.Policies data)
void	publishMessage(io.netty.buffer.ByteBuf headersAndPayload, Topic.PublishContext callback)
void	publishTxnMessage(org.apache.pulsar.client.api.transaction.TxnID txnID, io.netty.buffer.ByteBuf headersAndPayload, Topic.PublishContext publishContext) Publish Transaction message to this Topic's TransactionBuffer
void	recordAddLatency(long latency, TimeUnit unit) record add-latency
void	removeProducer(Producer producer)
void	resetBrokerPublishCountAndEnableReadIfRequired(boolean doneReset)
void	resetTopicPublishCountAndEnableReadIfRequired()
CompletableFuture<Consumer>	subscribe(TransportCnx cnx, String subscriptionName, long consumerId, org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.SubType subType, int priorityLevel, String consumerName, boolean isDurable, org.apache.pulsar.client.api.MessageId startMessageId, Map<String,String> metadata, boolean readCompacted, org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.InitialPosition initialPosition, long startMessageRollbackDurationSec, boolean replicateSubscriptionState, org.apache.pulsar.common.api.proto.PulsarApi.KeySharedMeta keySharedMeta)
CompletableFuture<Void>	unsubscribe(String subName)
void	updateRates(NamespaceStats nsStats, org.apache.pulsar.policies.data.loadbalancer.NamespaceBundleStats currentBundleStats, StatsOutputStream topicStatsStream, ClusterReplicationMetrics clusterReplicationMetrics, String namespaceName, boolean hydratePublishers)

Method Detail

publishMessage

void publishMessage(io.netty.buffer.ByteBuf headersAndPayload,
                    Topic.PublishContext callback)

addProducer

void addProducer(Producer producer)
          throws BrokerServiceException

Throws:

BrokerServiceException

removeProducer

void removeProducer(Producer producer)

recordAddLatency

void recordAddLatency(long latency,
                      TimeUnit unit)

record add-latency

subscribe

CompletableFuture<Consumer> subscribe(TransportCnx cnx,
                                      String subscriptionName,
                                      long consumerId,
                                      org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.SubType subType,
                                      int priorityLevel,
                                      String consumerName,
                                      boolean isDurable,
                                      org.apache.pulsar.client.api.MessageId startMessageId,
                                      Map<String,String> metadata,
                                      boolean readCompacted,
                                      org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.InitialPosition initialPosition,
                                      long startMessageRollbackDurationSec,
                                      boolean replicateSubscriptionState,
                                      org.apache.pulsar.common.api.proto.PulsarApi.KeySharedMeta keySharedMeta)

createSubscription

CompletableFuture<Subscription> createSubscription(String subscriptionName,
                                                   org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.InitialPosition initialPosition,
                                                   boolean replicateSubscriptionState)

unsubscribe

CompletableFuture<Void> unsubscribe(String subName)

getSubscriptions

org.apache.pulsar.common.util.collections.ConcurrentOpenHashMap<String,? extends Subscription> getSubscriptions()

delete

CompletableFuture<Void> delete()

getProducers

Map<String,Producer> getProducers()

getName

String getName()

checkReplication

CompletableFuture<Void> checkReplication()

close

CompletableFuture<Void> close(boolean closeWithoutWaitingClientDisconnect)

checkGC

void checkGC()

checkInactiveSubscriptions

void checkInactiveSubscriptions()

checkBackloggedCursors

void checkBackloggedCursors()

Activate cursors those caught up backlog-threshold entries and deactivate slow cursors which are creating backlog.

checkDeduplicationSnapshot

void checkDeduplicationSnapshot()

checkMessageExpiry

void checkMessageExpiry()

checkMessageDeduplicationInfo

void checkMessageDeduplicationInfo()

checkTopicPublishThrottlingRate

void checkTopicPublishThrottlingRate()

incrementPublishCount

void incrementPublishCount(int numOfMessages,
                           long msgSizeInBytes)

resetTopicPublishCountAndEnableReadIfRequired

void resetTopicPublishCountAndEnableReadIfRequired()

resetBrokerPublishCountAndEnableReadIfRequired

void resetBrokerPublishCountAndEnableReadIfRequired(boolean doneReset)

isPublishRateExceeded

boolean isPublishRateExceeded()

isTopicPublishRateExceeded

boolean isTopicPublishRateExceeded(int msgSize,
                                   int numMessages)

isBrokerPublishRateExceeded

boolean isBrokerPublishRateExceeded()

disableCnxAutoRead

void disableCnxAutoRead()

enableCnxAutoRead

void enableCnxAutoRead()

onPoliciesUpdate

CompletableFuture<Void> onPoliciesUpdate(org.apache.pulsar.common.policies.data.Policies data)

isBacklogQuotaExceeded

boolean isBacklogQuotaExceeded(String producerName)

isEncryptionRequired

boolean isEncryptionRequired()

getSchemaValidationEnforced

boolean getSchemaValidationEnforced()

isReplicated

boolean isReplicated()

getBacklogQuota

org.apache.pulsar.common.policies.data.BacklogQuota getBacklogQuota()

updateRates

void updateRates(NamespaceStats nsStats,
                 org.apache.pulsar.policies.data.loadbalancer.NamespaceBundleStats currentBundleStats,
                 StatsOutputStream topicStatsStream,
                 ClusterReplicationMetrics clusterReplicationMetrics,
                 String namespaceName,
                 boolean hydratePublishers)

getSubscription

Subscription getSubscription(String subscription)

getReplicators

org.apache.pulsar.common.util.collections.ConcurrentOpenHashMap<String,? extends Replicator> getReplicators()

getStats

org.apache.pulsar.common.policies.data.TopicStats getStats(boolean getPreciseBacklog,
                                                           boolean subscriptionBacklogSize)

getInternalStats

CompletableFuture<org.apache.pulsar.common.policies.data.PersistentTopicInternalStats> getInternalStats(boolean includeLedgerMetadata)

getLastPosition

Position getLastPosition()

getLastMessageId

CompletableFuture<org.apache.pulsar.client.api.MessageId> getLastMessageId()

hasSchema

CompletableFuture<Boolean> hasSchema()

Whether a topic has had a schema defined for it.

addSchema

CompletableFuture<org.apache.pulsar.common.protocol.schema.SchemaVersion> addSchema(org.apache.pulsar.common.protocol.schema.SchemaData schema)

Add a schema to the topic. This will fail if the new schema is incompatible with the current schema.

deleteSchema

CompletableFuture<org.apache.pulsar.common.protocol.schema.SchemaVersion> deleteSchema()

Delete the schema if this topic has a schema defined for it.

checkSchemaCompatibleForConsumer

CompletableFuture<Void> checkSchemaCompatibleForConsumer(org.apache.pulsar.common.protocol.schema.SchemaData schema)

Check if schema is compatible with current topic schema.

addSchemaIfIdleOrCheckCompatible

CompletableFuture<Void> addSchemaIfIdleOrCheckCompatible(org.apache.pulsar.common.protocol.schema.SchemaData schema)

If the topic is idle (no producers, no entries, no subscribers and no existing schema), add the passed schema to the topic. Otherwise, check that the passed schema is compatible with what the topic already has.

deleteForcefully

CompletableFuture<Void> deleteForcefully()

getDispatchRateLimiter

default Optional<DispatchRateLimiter> getDispatchRateLimiter()

isSystemTopic

default boolean isSystemTopic()

getTransactionBuffer

CompletableFuture<TransactionBuffer> getTransactionBuffer(boolean createIfMissing)

Get the $TransactionBuffer of this Topic.

Parameters:

createIfMissing - Create the TransactionBuffer if missing.

Returns:

TransactionBuffer CompletableFuture

publishTxnMessage

void publishTxnMessage(org.apache.pulsar.client.api.transaction.TxnID txnID,
                       io.netty.buffer.ByteBuf headersAndPayload,
                       Topic.PublishContext publishContext)

Publish Transaction message to this Topic's TransactionBuffer

Parameters:

txnID - Transaction Id

headersAndPayload - Message data

publishContext - Publish context

endTxn

CompletableFuture<Void> endTxn(org.apache.pulsar.client.api.transaction.TxnID txnID,
                               int txnAction,
                               List<org.apache.pulsar.common.api.proto.PulsarApi.MessageIdData> sendMessageIdList)

End the transaction in this topic.

Parameters:

txnID - Transaction id

txnAction - Transaction action.

Returns: