This is an automated email from the ASF dual-hosted git repository.
technoboy pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/pulsar.git
The following commit(s) were added to refs/heads/master by this push:
new c702be1af0d [improve][pip] PIP-307: Support subscribing multi topics
for WebSocket (#21390)
c702be1af0d is described below
commit c702be1af0d029de55a6ace1b04f2eea0ceaa7d8
Author: Jiwei Guo <[email protected]>
AuthorDate: Tue Oct 24 15:05:10 2023 +0800
[improve][pip] PIP-307: Support subscribing multi topics for WebSocket
(#21390)
---
pip/pip_307.md | 30 ++++++++++++++++++++++++++++++
1 file changed, 30 insertions(+)
diff --git a/pip/pip_307.md b/pip/pip_307.md
new file mode 100644
index 00000000000..6371983592b
--- /dev/null
+++ b/pip/pip_307.md
@@ -0,0 +1,30 @@
+# Background knowledge
+
+WebSocket currently only supports the consumption of a single topic, which
cannot satisfy users' consumption scenarios of multiple topics.
+
+# Motivation
+
+Supports consumption of multiple topics or pattern topics.
+
+
+# Detailed Design
+
+Currently, the topic name is specified through path for consumption, like:
+```
+/ws/v2/consumer/persistent/my-property/my-ns/my-topic/my-subscription
+```
+If we want to support subscribing multi-topics, adding parameters will be
confusing. Therefore, add a new v3 request path as follows:
+
+For consumption of pattern-topics:
+```
+/ws/v3/consumer/subscription?topicsPattern="a.*"
+```
+For consumption of multi-topics:
+```
+/ws/v3/consumer/subscription?topics="a,b,c"
+```
+
+# Links
+
+* Mailing List discussion thread:
https://lists.apache.org/thread/co8396ywny161x91dffzvxlt993mo1ht
+* Mailing List voting thread:
https://lists.apache.org/thread/lk28o483y351s7m44p018320gq3g4507
