Dark Mode

A complete configuration reference for undefined.

Configuration information is passed to the PulsarConnectionFactory constructor:

  • 1

Configuration information can also be passed as a JSON encoded string:

  • 1
Configuration EntryRequiredTypeDefault valueMeaningNotes
webServiceUrl yesString http://localhost:8080 (default)Main Pulsar HTTP endpointMust be customized as required for Pulsar standalone instances that are not running on localhost.
brokerServiceUrl noStringIf not specified, for Pulsar standalone instances running on localhost, defaults to the same value as webServiceUrl , http://localhost:8080 . Can also be specified as pulsar://localhost:6650 for Pulsar standalone instances on localhost.The URL to connect to the Pulsar broker or proxyThe brokerServiceUrl must be specified for Astra Streaming. Must be customized as required for Pulsar standalone instances that are not running on localhost.
enableTransaction nobooleanfalseEnable transactions enableTransaction defaults to false because transaction support is not enabled by default in Pulsar 2.7 and the client won't be able to connect to a cluster that does not enable transactions.
jms.enableClientSideEmulation nobooleanfalseEnable emulated featuresEnable features that are not supported directly by the Pulsar Broker but are emulated on the client side.
jms.acknowledgeRejectedMessages nobooleanfalseForce acknowledgment of filtered messages on shared subscriptionsBy default, filtered messages are negatively acknowledged on shared subscriptions. If this flag is true , they are acknowledged in order to skip them definitively.
jms.clientId noStringempty stringAdministratively assigned clientId (see the JMS specs)The default value assigned to every Connection.
producerConfig noMap<String,Object>Empty MapAdditional configuration for each Pulsar Producer
consumerConfig noMap<String,Object>Empty MapAdditional configuration for each Pulsar Consumer
jms.systemNamespace noStringpublic/defaultDefault Pulsar namespace in which temporary destinations and destinations without an explicit namespace are created.
jms.queueSubscriptionName noStringjms-queueName of the system subscription used to emulate JMS Queues.
jms.topicSharedSubscriptionType noSharedKey_SharedFailoverShared
Type of subscription for Shared Consumers jms.useExclusiveSubscriptionsForSimpleConsumers nobooleantrue
Use an Exclusive subscription for Topic consumersSet this to false to enable Delayed Messages. jms.usePulsarAdmin nobooleantrue
Allow the client to use the Pulsar Admin APISet this to false if your client cannot access the Admin HTTP API. jms.forceDeleteTemporaryDestinations nobooleanfalse
Force the deletion of temporary destinationsUse the Pulsar API to force the deletion even if the temporary destination has active subscriptions. jms.waitForServerStartupTimeout nonumber60000

All other options are passed as configurations to the Pulsar Client and the Pulsar Admin client, allowing you to configure additional Pulsar features, including security.

Implementation details

Please refer to Implementation details in order to read about how undefined emulates some features that are not directly supported by Pulsar.

  • Pulsar Jms Quickstart Sa: Create a simple command line Java JMS client that connects to a local Pulsar installation.
  • Pulsar Jms Quickstart Astra: Create a simple command line Java JMS client that connects to an Astra Streaming instance.
  • Pulsar Jms Install: Install undefined in your own JMS project.
  • Pulsar Jms Mappings: Understand Pulsar concepts in the context of JMS.
  • Pulsar Jms Implementation: Understand key implementation details for undefined.
  • Pulsar Jms Faq: Frequently asked questions about undefined.
  • *undefined Github repo*