Package org.apache.pulsar.client.impl

Class BinaryProtoLookupService

java.lang.Object

org.apache.pulsar.client.impl.BinaryProtoLookupService

All Implemented Interfaces:

AutoCloseable, LookupService

public class BinaryProtoLookupService
extends Object
implements LookupService

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BinaryProtoLookupService.LookupDataResult

Constructor Summary

Constructors

Constructor	Description
BinaryProtoLookupService(PulsarClientImpl client, String serviceUrl, boolean useTls, ExecutorService scheduleExecutor)	Deprecated. use BinaryProtoLookupService(PulsarClientImpl, String, String, boolean, ExecutorService, ExecutorService) instead.
BinaryProtoLookupService(PulsarClientImpl client, String serviceUrl, String listenerName, boolean useTls, ExecutorService scheduleExecutor)	Deprecated. use BinaryProtoLookupService(PulsarClientImpl, String, String, boolean, ExecutorService, ExecutorService) instead.
BinaryProtoLookupService(PulsarClientImpl client, String serviceUrl, String listenerName, boolean useTls, ExecutorService scheduleExecutor, ExecutorService lookupPinnedExecutor)

Method Summary

Modifier and Type	Method	Description
void	close()
CompletableFuture<org.apache.commons.lang3.tuple.Pair<InetSocketAddress,InetSocketAddress>>	getBroker(TopicName topicName)	Calls broker binaryProto-lookup api to find broker-service address which can serve a given topic.
CompletableFuture<org.apache.pulsar.common.partition.PartitionedTopicMetadata>	getPartitionedTopicMetadata(TopicName topicName, boolean metadataAutoCreationEnabled, boolean useFallbackForNonPIP344Brokers)	calls broker binaryProto-lookup api to get metadata of partitioned-topic.
CompletableFuture<Optional<SchemaInfo>>	getSchema(TopicName topicName)	Returns current SchemaInfo SchemaInfo for a given topic.
CompletableFuture<Optional<SchemaInfo>>	getSchema(TopicName topicName, byte[] version)	Returns specific version SchemaInfo SchemaInfo for a given topic.
String	getServiceUrl()	Returns broker-service lookup api url.
CompletableFuture<GetTopicsResult>	getTopicsUnderNamespace(NamespaceName namespace, CommandGetTopicsOfNamespace.Mode mode, String topicsPattern, String topicsHash)	Returns all the topics that matches for a given namespace.
InetSocketAddress	resolveHost()	Resolves pulsar service url.
void	updateServiceUrl(String serviceUrl)	Instruct the LookupService to switch to a new service URL for all subsequent requests.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.pulsar.client.impl.LookupService

getPartitionedTopicMetadata, getPartitionedTopicMetadata

Constructor Details

BinaryProtoLookupService

@Deprecated
public BinaryProtoLookupService(PulsarClientImpl client,
 String serviceUrl,
 boolean useTls,
 ExecutorService scheduleExecutor)
                         throws PulsarClientException

Deprecated.

use BinaryProtoLookupService(PulsarClientImpl, String, String, boolean, ExecutorService, ExecutorService) instead.

Throws:

PulsarClientException

BinaryProtoLookupService

@Deprecated
public BinaryProtoLookupService(PulsarClientImpl client,
 String serviceUrl,
 String listenerName,
 boolean useTls,
 ExecutorService scheduleExecutor)
                         throws PulsarClientException

Deprecated.

use BinaryProtoLookupService(PulsarClientImpl, String, String, boolean, ExecutorService, ExecutorService) instead.

Throws:

PulsarClientException

BinaryProtoLookupService

public BinaryProtoLookupService(PulsarClientImpl client,
 String serviceUrl,
 String listenerName,
 boolean useTls,
 ExecutorService scheduleExecutor,
 ExecutorService lookupPinnedExecutor)
                         throws PulsarClientException

Throws:

PulsarClientException

Method Details

updateServiceUrl

public void updateServiceUrl(String serviceUrl)
                      throws PulsarClientException

Description copied from interface: LookupService

Instruct the LookupService to switch to a new service URL for all subsequent requests.

Specified by:

updateServiceUrl in interface LookupService

Throws:

PulsarClientException

getBroker

public CompletableFuture<org.apache.commons.lang3.tuple.Pair<InetSocketAddress,InetSocketAddress>> getBroker(TopicName topicName)

Calls broker binaryProto-lookup api to find broker-service address which can serve a given topic.

Specified by:

getBroker in interface LookupService

Parameters:

topicName - topic-name

Returns:

broker-socket-address that serves given topic

getPartitionedTopicMetadata

public CompletableFuture<org.apache.pulsar.common.partition.PartitionedTopicMetadata> getPartitionedTopicMetadata(TopicName topicName,
 boolean metadataAutoCreationEnabled,
 boolean useFallbackForNonPIP344Brokers)

calls broker binaryProto-lookup api to get metadata of partitioned-topic.

Specified by:

getPartitionedTopicMetadata in interface LookupService

useFallbackForNonPIP344Brokers -

If true, fallback to the prior behavior of the method LookupService.getPartitionedTopicMetadata(TopicName) if the broker does not support the PIP-344 feature 'supports_get_partitioned_metadata_without_auto_creation'. This parameter only affects the behavior when is false.

getSchema

public CompletableFuture<Optional<SchemaInfo>> getSchema(TopicName topicName)

Description copied from interface: LookupService

Returns current SchemaInfo SchemaInfo for a given topic.

Specified by:

getSchema in interface LookupService

Parameters:

topicName - topic-name

Returns:

SchemaInfo

getSchema

public CompletableFuture<Optional<SchemaInfo>> getSchema(TopicName topicName,
 byte[] version)

Description copied from interface: LookupService

Returns specific version SchemaInfo SchemaInfo for a given topic.

Specified by:

getSchema in interface LookupService

Parameters:

topicName - topic-name

version - schema info version

Returns:

SchemaInfo

getServiceUrl

public String getServiceUrl()

Description copied from interface: LookupService

Returns broker-service lookup api url.

Specified by:

getServiceUrl in interface LookupService

Returns:

resolveHost

public InetSocketAddress resolveHost()

Description copied from interface: LookupService

Resolves pulsar service url.

Specified by:

resolveHost in interface LookupService

Returns:

the service url resolved to a socket address

getTopicsUnderNamespace

public CompletableFuture<GetTopicsResult> getTopicsUnderNamespace(NamespaceName namespace,
 CommandGetTopicsOfNamespace.Mode mode,
 String topicsPattern,
 String topicsHash)

Description copied from interface: LookupService

Returns all the topics that matches for a given namespace. Note: it relate to the topic name(without the partition suffix). For example: - There is a partitioned topic "tp-a" with two partitions. - tp-a-partition-0 - tp-a-partition-1 - If is "tp-a", the consumer will subscribe to the two partitions. - if is "tp-a-partition-0", the consumer will subscribe nothing.

Specified by:

getTopicsUnderNamespace in interface LookupService

Parameters:

namespace - : namespace-name

Returns:

close

public void close()
           throws Exception

Specified by:

close in interface AutoCloseable

Throws:

Exception