com.azure.messaging.eventhubs.models

Class EventHubConnectionStringProperties

java.lang.Object

com.azure.messaging.eventhubs.models.EventHubConnectionStringProperties

public final class EventHubConnectionStringProperties
extends Object

A utility class that parses a connection string into sections. An Event Hubs connection string is a set of key-value pairs separated by semi-colon. A typical example is "Endpoint=sb://foo.EventHub.windows.net/;SharedAccessKeyName=someKeyName;SharedAccessKey=someKeyValue".

A connection may have the following sections:

• Endpoint, which is mandatory. The hostname part of it is the "Fully qualified namespace".
• SharedAccessKeyName and SharedAccessKey, optional, used to authenticate the access to the EventHub.
• SharedAccessSignature, optional, an alternative way to authenticate the access to the EventHub.
• EntityPath, optional, the queue name or the topic name under the service namespace

When you have an Event Hubs connection string, you can use EventHubClientBuilder.connectionString(String) to build a client. If you'd like to use a TokenCredential to access an Event Hub, you can use this utility class to get the fully qualified namespace and entity path from the connection string and then use EventHubClientBuilder.credential(String, String, TokenCredential).

See Also:

EventHubClientBuilder.connectionString(String, String)

Method Summary

Modifier and Type	Method and Description
String	getEndpoint() Gets the "Endpoint" value of the connection string.
String	getEntityPath() Gets the "EntityPath" value of the connection string.
String	getFullyQualifiedNamespace() Gets the fully qualified namespace, or hostname, from the connection string "Endpoint" section.
String	getSharedAccessKey() Gets the "SharedAccessSignature" section of the connection string.
String	getSharedAccessKeyName() Gets the "SharedAccessKeyName" section of the connection string.
static EventHubConnectionStringProperties	parse(String connectionString) Parse a Event Hub connection string into an instance of this class.

Methods inherited from class java.lang.Object

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

Method Detail

parse

public static EventHubConnectionStringProperties parse(String connectionString)

Parse a Event Hub connection string into an instance of this class.

Parameters:

connectionString - The connection string to be parsed.

Returns:

An instance of this class.

Throws:

NullPointerException - if connectionString is null.

IllegalArgumentException - if the connectionString is empty or malformed.

getEntityPath

public String getEntityPath()

Gets the "EntityPath" value of the connection string.

Returns:

The entity path, or null if the connection string doesn't have an "EntityPath".

getEndpoint

public String getEndpoint()

Gets the "Endpoint" value of the connection string.

Returns:

The endpoint.

getFullyQualifiedNamespace

public String getFullyQualifiedNamespace()

Gets the fully qualified namespace, or hostname, from the connection string "Endpoint" section.

Returns:

The fully qualified namespace.

getSharedAccessKeyName

public String getSharedAccessKeyName()

Gets the "SharedAccessKeyName" section of the connection string.

Returns:

The shared access key name, or null if the connection string doesn't have a "SharedAccessKeyName".

getSharedAccessKey

public String getSharedAccessKey()

Gets the "SharedAccessSignature" section of the connection string.

Returns:

The shared access key value, or null if the connection string doesn't have a "SharedAccessSignature".