mirror of
https://github.com/taigrr/nats.docs
synced 2025-01-18 04:03:23 -08:00
updating docs
This commit is contained in:
@@ -2341,10 +2341,10 @@
|
||||
<section class="normal markdown-section">
|
||||
|
||||
<h1 id="relation-to-nats"><a name="relation-to-nats" class="plugin-anchor" href="#relation-to-nats"><i class="fa fa-link" aria-hidden="true"></i></a>Relation to NATS</h1>
|
||||
<p>NATS Streaming Server by default embeds a <a href="https://github.com/nats-io/nats-server" target="_blank">NATS</a> server. That is, the Streaming server is not a server per-se, but instead, a client to a NATS Server.<br>
|
||||
It means that Streaming clients are not directly connected to the streaming server, but instead communicate with the streaming server <em>through</em> NATS Server.</p>
|
||||
<p>NATS Streaming Server by default embeds a <a href="https://github.com/nats-io/nats-server" target="_blank">NATS</a> server. That is, the Streaming server is not a server per-se, but instead, a client to a NATS Server.</p>
|
||||
<p>It means that Streaming clients are not directly connected to the streaming server, but instead communicate with the streaming server <em>through</em> NATS Server.</p>
|
||||
<p>This detail is important when it comes to Streaming clients connections to the Streaming server. Indeed, since there is no direct connection, the server knows if a client is connected based on heartbeats.</p>
|
||||
<p><strong><em>It is therefore strongly recommended for clients to close their connection when the application exit, otherwise the server will consider these clients connected (sending data, etc...) until it detects missing heartbeats.</em></strong></p>
|
||||
<p><strong><em>It is therefore strongly recommended for clients to close their connection when the application exits, otherwise the server will consider these clients connected (sending data, etc...) until it detects missing heartbeats.</em></strong></p>
|
||||
<p>The streaming server creates internal subscriptions on specific subjects to communicate with its clients and/or other servers.</p>
|
||||
<p>Note that NATS clients and NATS Streaming clients cannot exchange data between each other. That is, if a streaming client publishes on <code>foo</code>, a NATS client subscribing on that same subject will not receive the messages. Streaming messages are NATS messages made of a protobuf. The streaming server is expected to send ACKs back to producers and receive ACKs from consumers. If messages were freely exchanged with the NATS clients, this would cause problems.</p>
|
||||
|
||||
@@ -2390,7 +2390,7 @@ It means that Streaming clients are not directly connected to the streaming serv
|
||||
<script>
|
||||
var gitbook = gitbook || [];
|
||||
gitbook.push(function() {
|
||||
gitbook.page.hasChanged({"page":{"title":"Relation to NATS","level":"6.1.1","depth":2,"next":{"title":"Client Connections","level":"6.2","depth":1,"path":"nats_streaming/client-connections.md","ref":"nats_streaming/client-connections.md","articles":[]},"previous":{"title":"Introduction","level":"6.1","depth":1,"path":"nats_streaming/intro.md","ref":"nats_streaming/intro.md","articles":[{"title":"Relation to NATS","level":"6.1.1","depth":2,"path":"nats_streaming/relation-to-nats.md","ref":"nats_streaming/relation-to-nats.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/relation-to-nats.md","mtime":"2019-05-30T22:52:52.331Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-07-25T22:29:27.003Z"},"basePath":"..","book":{"language":""}});
|
||||
gitbook.page.hasChanged({"page":{"title":"Relation to NATS","level":"6.1.1","depth":2,"next":{"title":"Client Connections","level":"6.2","depth":1,"path":"nats_streaming/client-connections.md","ref":"nats_streaming/client-connections.md","articles":[]},"previous":{"title":"Introduction","level":"6.1","depth":1,"path":"nats_streaming/intro.md","ref":"nats_streaming/intro.md","articles":[{"title":"Relation to NATS","level":"6.1.1","depth":2,"path":"nats_streaming/relation-to-nats.md","ref":"nats_streaming/relation-to-nats.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/relation-to-nats.md","mtime":"2019-08-13T14:25:46.281Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-08-13T14:26:56.704Z"},"basePath":"..","book":{"language":""}});
|
||||
});
|
||||
</script>
|
||||
</div>
|
||||
|
||||
Reference in New Issue
Block a user