org.apache.pulsar.client.impl

Class HttpLookupService

java.lang.Object

org.apache.pulsar.client.impl.HttpLookupService

All Implemented Interfaces:

AutoCloseable, LookupService

public class HttpLookupService
extends Object
implements LookupService

Constructor Summary

Constructors

Constructor and Description
HttpLookupService(ClientConfigurationData conf, io.netty.channel.EventLoopGroup eventLoopGroup)

Method Summary

Modifier and Type	Method and Description
void	close()
CompletableFuture<org.apache.commons.lang3.tuple.Pair<InetSocketAddress,InetSocketAddress>>	getBroker(TopicName topicName) Calls http-lookup api to find broker-service address which can serve a given topic.
CompletableFuture<PartitionedTopicMetadata>	getPartitionedTopicMetadata(TopicName topicName) Returns PartitionedTopicMetadata for a given 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<List<String>>	getTopicsUnderNamespace(NamespaceName namespace, PulsarApi.CommandGetTopicsOfNamespace.Mode mode) Returns all the topics name for a given namespace.
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

Constructor Detail

HttpLookupService

public HttpLookupService(ClientConfigurationData conf,
                         io.netty.channel.EventLoopGroup eventLoopGroup)
                  throws PulsarClientException

Throws:

PulsarClientException

Method Detail

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 http-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<PartitionedTopicMetadata> getPartitionedTopicMetadata(TopicName topicName)

Description copied from interface: LookupService

Returns PartitionedTopicMetadata for a given topic.

Specified by:

getPartitionedTopicMetadata in interface LookupService

Parameters:

topicName - topic-name

Returns:

getServiceUrl

public String getServiceUrl()

Description copied from interface: LookupService

Returns broker-service lookup api url.

Specified by:

getServiceUrl in interface LookupService

Returns:

getTopicsUnderNamespace

public CompletableFuture<List<String>> getTopicsUnderNamespace(NamespaceName namespace,
                                                               PulsarApi.CommandGetTopicsOfNamespace.Mode mode)

Description copied from interface: LookupService

Returns all the topics name for a given namespace.

Specified by:

getTopicsUnderNamespace in interface LookupService

Parameters:

namespace - : namespace-name

Returns:

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

close

public void close()
           throws Exception

Specified by:

close in interface AutoCloseable

Throws:

Exception