Package 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	Description
HttpLookupService(ClientConfigurationData conf, io.netty.channel.EventLoopGroup eventLoopGroup)

Method Summary

Modifier and Type	Method	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<org.apache.pulsar.common.partition.PartitionedTopicMetadata>	getPartitionedTopicMetadata(TopicName topicName, boolean metadataAutoCreationEnabled, boolean useFallbackForNonPIP344Brokers)	1.Get the partitions if the topic exists.
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

HttpLookupService

public HttpLookupService(ClientConfigurationData conf,
 io.netty.channel.EventLoopGroup eventLoopGroup)
                  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 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<org.apache.pulsar.common.partition.PartitionedTopicMetadata> getPartitionedTopicMetadata(TopicName topicName,
 boolean metadataAutoCreationEnabled,
 boolean useFallbackForNonPIP344Brokers)

1.Get the partitions if the topic exists. Return "{partition: n}" if a partitioned topic exists; return "{partition: 0}" if a non-partitioned topic exists. 2. When is "false," neither partitioned topic nor non-partitioned topic does not exist. You will get a PulsarClientException.NotFoundException or a PulsarClientException.TopicDoesNotExistException. 2-1. You will get a PulsarClientException.NotSupportedException with metadataAutoCreationEnabled=false on an old broker version which does not support getting partitions without partitioned metadata auto-creation. 3.When is "true," it will trigger an auto-creation for this topic(using the default topic auto-creation strategy you set for the broker), and the corresponding result is returned. For the result, see case 1.

Specified by:

getPartitionedTopicMetadata in interface LookupService

Parameters:

useFallbackForNonPIP344Brokers - HttpLookupService ignores this parameter

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:

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