Skip to content

Commit 4aac3f9

Browse files
Stop opening links in new windows
1 parent 544910a commit 4aac3f9

File tree

9 files changed

+40
-40
lines changed

9 files changed

+40
-40
lines changed

modules/ROOT/nav.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
1-
** {jms_repo}[Github repo,window=_blank]
1+
** {jms_repo}[Github repo]
22
** xref:pulsar-jms-faq.adoc[]

modules/ROOT/pages/index.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,4 +26,4 @@ Starlight for JMS key features include:
2626
* *xref:examples:pulsar-jms-implementation.adoc[]*: Understand key implementation details for Starlight for JMS.
2727
* *xref:pulsar-jms-faq.adoc[]*: Frequently asked questions about Starlight for JMS.
2828
* *xref:reference:pulsar-jms-reference.adoc[]*: Starlight for JMS configuration reference.
29-
* *{jms_repo}[Starlight for JMS Github repo,window=_blank]*
29+
* *{jms_repo}[Starlight for JMS Github repo]*

modules/ROOT/pages/pulsar-jms-faq.adoc

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,19 @@ Answers to the (arguably) most common Starlight for JMS questions.
66

77
== What is the pricing for Starlight for JMS?
88

9-
Starlight for JMS is free open-source software. Enterprise support is available through https://www.datastax.com/products/luna-streaming[Luna Streaming,window=_blank], the DataStax commercial support offering for Apache Pulsar™.
9+
Starlight for JMS is free open-source software. Enterprise support is available through https://www.datastax.com/products/luna-streaming[Luna Streaming], the DataStax commercial support offering for Apache Pulsar™.
1010

1111
== How is Starlight for JMS licensed?
1212

13-
Starlight for JMS is licensed under https://www.apache.org/licenses/LICENSE-2.0.txt[Apache version 2.0,window=_blank].
13+
Starlight for JMS is licensed under https://www.apache.org/licenses/LICENSE-2.0.txt[Apache version 2.0].
1414

1515
== How can I use Starlight for JMS in a JakartaEE® or JavaEE® application?
1616

17-
You can use the `resourceAdapter` {jms_repo}blob/master/resource-adapter[here,window=_blank].
17+
You can use the `resourceAdapter` {jms_repo}blob/master/resource-adapter[here].
1818

1919
== How can I run the Test Compatibility Kit (TCK)
2020

21-
You can download the TCK https://jakarta.ee/specifications/messaging/2.0/[here,window=_blank]. The repository contains a copy of the TCK that automates the execution of the tests.
21+
You can download the TCK https://jakarta.ee/specifications/messaging/2.0/[here]. The repository contains a copy of the TCK that automates the execution of the tests.
2222

2323
In the tck-executor module you'll find:
2424

@@ -47,9 +47,9 @@ IMPORTANT: Globally unique subscription names are not supported so the correspon
4747

4848
We've provided the following integration examples:
4949

50-
* {jms_repo}blob/master/examples/spring[Spring Boot®,window=_blank]
51-
* {jms_repo}blob/master/examples/payara-micro[Payara Micro®,window=_blank]
52-
* {jms_repo}blob/master/resource-adapter-tests[Apache TomEE®,window=_blank]
50+
* {jms_repo}blob/master/examples/spring[Spring Boot®]
51+
* {jms_repo}blob/master/examples/payara-micro[Payara Micro®]
52+
* {jms_repo}blob/master/resource-adapter-tests[Apache TomEE®]
5353

5454
== How can I build Starlight for JMS from source?
5555

@@ -71,8 +71,8 @@ mvn clean install
7171

7272
== Where can I find additional information on JMS?
7373

74-
Refer to the https://jakarta.ee/specifications/messaging/2.0/[official JMS documentation,window=_blank] in order to learn about JMS.
75-
This https://javaee.github.io/jms-spec/[website,window=_blank] is useful as well as it contains the former JMS 2.0 specifications before the Jakarta transition.
74+
Refer to the https://jakarta.ee/specifications/messaging/2.0/[official JMS documentation] in order to learn about JMS.
75+
This https://javaee.github.io/jms-spec/[website] is useful as well as it contains the former JMS 2.0 specifications before the Jakarta transition.
7676

7777
== What's next?
7878

@@ -82,4 +82,4 @@ This https://javaee.github.io/jms-spec/[website,window=_blank] is useful as well
8282
* *xref:reference:pulsar-jms-mappings.adoc[]*: Understand Pulsar concepts in the context of JMS.
8383
* *xref:examples:pulsar-jms-implementation.adoc[]*: Understand key implementation details for Starlight for JMS.
8484
* *xref:reference:pulsar-jms-reference.adoc[]*: Starlight for JMS configuration reference.
85-
* *{jms_repo}[Starlight for JMS Github repo,window=_blank]*
85+
* *{jms_repo}[Starlight for JMS Github repo]*

modules/examples/pages/pulsar-jms-implementation.adoc

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ When you set a `clientId`, the actual subscription name in Pulsar is constructed
3434

3535
*Dead letter policy* controls Pulsar's handling of messages that can't be processed successfully. Under normal processing conditions, these messages cannot be processed successfully and the consumer cannot move to the next message. +
3636

37-
One solution for this situation is the *dead letter topic* policy. The *dead-letter topic* policy routes the unsuccessful messages to the *dead-letter topic* for storage, so consumers can keep consuming while the unsuccessful messages are stored in the dead-letter topic for processing or evaluation.
37+
One solution for this situation is the *dead letter topic* policy. The *dead-letter topic* policy routes the unsuccessful messages to the *dead-letter topic* for storage, so consumers can keep consuming while the unsuccessful messages are stored in the dead-letter topic for processing or evaluation.
3838

3939
Starlight for JMS allows further configuration of `deadLetterPolicy`. For more on `deadLetterTopic` configuration properties, see xref:reference:pulsar-jms-reference.adoc[].
4040
[source,language-java]
@@ -57,7 +57,7 @@ A message being written to the dead-letter topic is triggered in one of two ways
5757
=== Acknowledgement timeout
5858

5959
In an *acknowledgement timeout*, the broker fails to receive an acknowledgement from a consumer in the amount of time specified in `ackTimeout`. +
60-
The `ackTimeoutRedeliveryBackoff` values control the time between the expiration of `ackTimeout` and the client sending a `redeliver unacknowledged messages` request to the broker.
60+
The `ackTimeoutRedeliveryBackoff` values control the time between the expiration of `ackTimeout` and the client sending a `redeliver unacknowledged messages` request to the broker.
6161
[source,java]
6262
----
6363
Map<String, Object> ackTimeoutRedeliveryBackoff = new HashMap<>();
@@ -84,12 +84,12 @@ Map<String, Object> negativeAckRedeliveryBackoff = new HashMap<>();
8484

8585
A few usage notes on negative acknowledgement in Starlight for JMS:
8686

87-
* Calling `Session.recover()` stops delivery in the session, restarts message delivery with the oldest unacked message, and sends *negative acknowledgements* to the broker for the unacked messages.
87+
* Calling `Session.recover()` stops delivery in the session, restarts message delivery with the oldest unacked message, and sends *negative acknowledgements* to the broker for the unacked messages.
8888

8989
* When using xref:reference:pulsar-jms-reference.adoc[client side emulation] with *JMS Queues* and *Shared Subscriptions*, if a message does not match the xref:pulsar-jms-implementation.adoc#message-selectors[Selector], the JMS Client *negatively acknowledges* the message to let another consume pick up the message. +
9090

9191
* When using xref:pulsar-jms-server-side-filters.adoc[server side filtering] and xref:pulsar-jms-implementation.adoc#message-selectors[Selectors], there is still a chance that a *negative acknowledgement* will be sent when one message in a batch does not match the filter. +
92-
Using *negative acknowledgement* increases the count of deliveries of the message, which can trigger routing to the dead-letter topic if the number exceeds `maxRedeliverCount`. So if you're seeing messages in the dead-letter topic that shouldn't be there, they might be hitting a consumer with a local selector that doesn't match too many times.
92+
Using *negative acknowledgement* increases the count of deliveries of the message, which can trigger routing to the dead-letter topic if the number exceeds `maxRedeliverCount`. So if you're seeing messages in the dead-letter topic that shouldn't be there, they might be hitting a consumer with a local selector that doesn't match too many times.
9393

9494
[#delayed-messages]
9595
== Delayed messages
@@ -98,7 +98,7 @@ In Pulsar, delayed messages are delivered immediately, without respecting the de
9898

9999
If you set `jms.useExclusiveSubscriptionsForSimpleConsumers=false` the client will use a Shared subscription, and the delay is respected.
100100

101-
See https://github.com/apache/pulsar/wiki/PIP-26:-Delayed-Message-Delivery[PIP-26,window=_blank] for details.
101+
See https://github.com/apache/pulsar/wiki/PIP-26:-Delayed-Message-Delivery[PIP-26] for details.
102102

103103
[#global-registry]
104104
== Global registry of subscription names and of `clientIds`
@@ -193,14 +193,14 @@ Ignored fields:
193193
* `JMSXRcvTimestamp`
194194
* `JMSXState`
195195

196-
For more details on JMS properties, refer to section "3.5.9. JMS defined properties" in the https://docs.oracle.com/cd/E19957-01/816-5904-10/816-5904-10.pdf[JMS 2.0 specifications,window=_blank].
196+
For more details on JMS properties, refer to section "3.5.9. JMS defined properties" in the https://docs.oracle.com/cd/E19957-01/816-5904-10/816-5904-10.pdf[JMS 2.0 specifications].
197197

198198
[#transaction-emulation]
199199
== Transaction Emulation
200200

201201
Starlight for JMS and Pulsar fully support JMS transactions, and also support emulating `SESSION_TRANSACTED` behavior without actually performing the transaction's operations.
202202

203-
For example, when porting a JMS application that is using `SESSION_TRANSACTED`, you can emulate `SESSION_TRANSACTED` behavior with the `jms.emulateTransactions` feature.
203+
For example, when porting a JMS application that is using `SESSION_TRANSACTED`, you can emulate `SESSION_TRANSACTED` behavior with the `jms.emulateTransactions` feature.
204204

205205
In `jms.emulateTransactions` mode, when a `SESSION_TRANSACTED` mode is created, the Session behaves like a transacted Session but is not transactional: a produced message is sent immediately, and acknowledgements are sent during `session.commit()`.
206206

@@ -300,7 +300,7 @@ Starlight for JMS emulates the behavior by trying to delete the destination on `
300300
NOTE: Creating a temporary destination requires the client to be allowed to create the destination and also to configure the broker to allow automatic topic creation using `allowAutoTopicCreation=true`.
301301

302302
[#auth-on-creation]
303-
== Username and password authentication
303+
== Username and password authentication
304304

305305
Starlight for JMS currently supports only JWT (JSON Web Token) authentication, but offers an alternate method of registering `authParams` when connections are created. +
306306

@@ -321,10 +321,10 @@ This will pass the `username` and `password` pair into the `PulsarConnectionFact
321321

322322
A few notes on usage: +
323323

324-
* The values of `username` and `password` depend on the authentication type configured in PulsarClient. Using JWT authentication, the values are:
324+
* The values of `username` and `password` depend on the authentication type configured in PulsarClient. Using JWT authentication, the values are:
325325
** `username`: not used
326326
** `password`: `token:XXXX`, where `XXXX` is the JWT token
327-
* Once a username/password pair is used to start a connection, you must use it for *all subsequent calls*.
327+
* Once a username/password pair is used to start a connection, you must use it for *all subsequent calls*.
328328
* Only *one* PulsarClient can be held by a PulsarConnectionFactory.
329329

330330
[#schema-registry]
@@ -338,7 +338,7 @@ Set the `useSchema` flag to `true` with `consumerConfig` to apply schema when co
338338
----
339339
Map<String, Object> consumerConfig = new HashMap<>();
340340
properties.put("consumerConfig", consumerConfig);
341-
341+
342342
Map<String, Object> properties = new HashMap<>();
343343
properties.put("webServiceUrl", cluster.getAddress());
344344
consumerConfig.put("useSchema", true);
@@ -371,7 +371,7 @@ For all other schema types, the consumer will return a `StringObject`.
371371

372372
*Virtual destinations* add support for Consumers to receive messages from multiple destinations, known as *multi-topic subscriptions* in Pulsar.
373373

374-
Multiple topics can be subscribed to using *regular expressions* or static *multi-topic lists*.
374+
Multiple topics can be subscribed to using *regular expressions* or static *multi-topic lists*.
375375

376376
[cols="1,2,2"]
377377
|===
@@ -413,7 +413,7 @@ Even if a consumer is not looking for a message's priority mapping metadata, it
413413
[#jms-priority-mapping]
414414
=== Mapping JMS priority to partitions
415415

416-
The parameter `jms.priorityMapping` controls how priorities are mapped to partitions.
416+
The parameter `jms.priorityMapping` controls how priorities are mapped to partitions.
417417

418418
The `jms.priorityMapping` parameter can be set to `linear` or `non-linear`. The default is `linear`. +
419419

@@ -424,8 +424,8 @@ If you have 20 partitions, priority 0 goes to partitions 0 and 1, priority 1 goe
424424
The benefit of this approach is that you are guaranteed that each priority level is sent to different partitions. +
425425
The drawback is that if you don't use all the priority levels, then some partitions will be left underutilized.
426426

427-
In `jms.priorityMapping = "non-linear"`, the mapping between JMSPriority and the partition id is not linear.
428-
The assumption is that there will be more regular messages than high/low priority messages.
427+
In `jms.priorityMapping = "non-linear"`, the mapping between JMSPriority and the partition id is not linear.
428+
The assumption is that there will be more regular messages than high/low priority messages.
429429

430430
Priorities are divided into 3 classes: low, default, and high priority.
431431

@@ -447,4 +447,4 @@ With non-linear partition mapping, the JMS Client will tend to:
447447
* *xref:reference:pulsar-jms-mappings.adoc[]*: Understand Pulsar concepts in the context of JMS.
448448
* *xref:ROOT:pulsar-jms-faq.adoc[]*: Frequently asked questions about Starlight for JMS.
449449
* *xref:reference:pulsar-jms-reference.adoc[]*: Starlight for JMS configuration reference.
450-
* *{jms_repo}[Starlight for JMS Github repo,window=_blank]*
450+
* *{jms_repo}[Starlight for JMS Github repo]*

modules/examples/pages/pulsar-jms-server-side-filters.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,4 +94,4 @@ For the same reason, Starlight for JMS does not support custom formats like nati
9494
* *xref:pulsar-jms-implementation.adoc[]*: Understand key implementation details for Starlight for JMS.
9595
* *xref:ROOT:pulsar-jms-faq.adoc[]*: Frequently asked questions about Starlight for JMS.
9696
* *xref:reference:pulsar-jms-reference.adoc[]*: Starlight for JMS configuration reference.
97-
* *{jms_repo}[Starlight for JMS Github repo,window=_blank]*
97+
* *{jms_repo}[Starlight for JMS Github repo]*

modules/jms-migration/pages/pulsar-jms-install.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,4 +45,4 @@ You can also use a "fat" JAR that includes all dependencies:
4545
* *xref:examples:pulsar-jms-implementation.adoc[]*: Understand key implementation details for Starlight for JMS.
4646
* *xref:ROOT:pulsar-jms-faq.adoc[]*: Frequently asked questions about Starlight for JMS.
4747
* *xref:reference:pulsar-jms-reference.adoc[]*: Starlight for JMS configuration reference.
48-
* *{jms_repo}[Starlight for JMS Github repo,window=_blank]*
48+
* *{jms_repo}[Starlight for JMS Github repo]*

modules/jms-migration/pages/pulsar-jms-quickstart-sa.adoc

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,17 +11,17 @@ This quick start will get you up and running with a simple command-line Java JMS
1111

1212
== Prerequisites
1313

14-
* https://maven.apache.org/install.html[Apache Maven,window=_blank]
15-
* https://openjdk.java.net/install/[Java OpenJDK 8 or 11,window=_blank]
16-
* A local installation of Apache Pulsar™, either the https://pulsar.apache.org/ja/download/[download binary,window=_blank] or a docker instance.
14+
* https://maven.apache.org/install.html[Apache Maven]
15+
* https://openjdk.java.net/install/[Java OpenJDK 8 or 11]
16+
* A local installation of Apache Pulsar™, either the https://pulsar.apache.org/ja/download/[download binary] or a docker instance.
1717
+
1818
IMPORTANT: If you choose an existing local Pulsar installation, make sure the Pulsar endpoints are \http://localhost:8080 and \http://localhost:6650, otherwise you'll need to modify the initialization properties in the example.
1919

2020
== Install a Pulsar instance using Docker
2121

2222
To install a Docker Pulsar instance:
2323

24-
. Make sure you have https://docs.docker.com/get-docker/[Docker,window=_blank] installed on your platform.
24+
. Make sure you have https://docs.docker.com/get-docker/[Docker] installed on your platform.
2525
. Open a terminal and create a Pulsar Docker instance:
2626
+
2727
[source,language-bash]
@@ -315,4 +315,4 @@ docker rm 5116f0d16eb3
315315
* *xref:examples:pulsar-jms-implementation.adoc[]*: Understand key implementation details for Starlight for JMS.
316316
* *xref:ROOT:pulsar-jms-faq.adoc[]*: Frequently asked questions about Starlight for JMS.
317317
* *xref:reference:pulsar-jms-reference.adoc[]*: Starlight for JMS configuration reference.
318-
* *{jms_repo}[Starlight for JMS Github repo,window=_blank]*
318+
* *{jms_repo}[Starlight for JMS Github repo]*

modules/reference/pages/pulsar-jms-mappings.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -462,7 +462,7 @@ The special `JMSXGroupID` property is defined in the JMS specs as a way to group
462462

463463
Starlight for JMS maps that property to the message key in Pulsar, ensuring that `JMSXGroupID` is used as the routing key.
464464

465-
NOTE: This is the same behavior implemented in https://activemq.apache.org/message-groups[Apache ActiveMQ,window=_blank].
465+
NOTE: This is the same behavior implemented in https://activemq.apache.org/message-groups[Apache ActiveMQ].
466466

467467
== What's next?
468468

@@ -472,4 +472,4 @@ NOTE: This is the same behavior implemented in https://activemq.apache.org/messa
472472
* *xref:examples:pulsar-jms-implementation.adoc[]*: Understand key implementation details for Starlight for JMS.
473473
* *xref:ROOT:pulsar-jms-faq.adoc[]*: Frequently asked questions about Starlight for JMS.
474474
* *xref:pulsar-jms-reference.adoc[]*: Starlight for JMS configuration reference.
475-
* *{jms_repo}[Starlight for JMS Github repo,window=_blank]*
475+
* *{jms_repo}[Starlight for JMS Github repo]*

modules/reference/pages/pulsar-jms-reference.adoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -225,9 +225,9 @@ Must be customized as required for Pulsar standalone instances that are not runn
225225

226226
|===
227227

228-
All other options are passed as configurations to the Pulsar Client and the Pulsar Admin client, allowing you to configure additional Pulsar features, including https://pulsar.apache.org/docs/en/security-tls-keystore/#configuring-clients[security,window=_blank].
228+
All other options are passed as configurations to the Pulsar Client and the Pulsar Admin client, allowing you to configure additional Pulsar features, including https://pulsar.apache.org/docs/en/security-tls-keystore/#configuring-clients[security].
229229

230-
TIP: Please check https://pulsar.apache.org/docs/en/standalone/[Apache Pulsar documentation,window=_blank] for a complete list of configuration options.
230+
TIP: Please check https://pulsar.apache.org/docs/en/standalone/[Apache Pulsar documentation] for a complete list of configuration options.
231231

232232
== Implementation details
233233

@@ -241,4 +241,4 @@ Please refer to xref:examples:pulsar-jms-implementation.adoc[Implementation deta
241241
* *xref:pulsar-jms-mappings.adoc[]*: Understand Pulsar concepts in the context of JMS.
242242
* *xref:examples:pulsar-jms-implementation.adoc[]*: Understand key implementation details for Starlight for JMS.
243243
* *xref:ROOT:pulsar-jms-faq.adoc[]*: Frequently asked questions about Starlight for JMS.
244-
* *{jms_repo}[Starlight for JMS Github repo,window=_blank]*
244+
* *{jms_repo}[Starlight for JMS Github repo]*

0 commit comments

Comments
 (0)