浏览代码

Docs: Explain closing the high level client

It looks like we weren't clear on when and why you should close the high
level client and folks were closing it after every request which is not
efficient. This explains why you should close the client and when so
this shouldn't be as common.

Closes #32001
Nik Everett 7 年之前
父节点
当前提交
9822a6f911
共有 1 个文件被更改,包括 5 次插入6 次删除
  1. 5 6
      docs/java-rest/high-level/getting-started.asciidoc

+ 5 - 6
docs/java-rest/high-level/getting-started.asciidoc

@@ -130,12 +130,11 @@ include-tagged::{doc-tests}/MiscellaneousDocumentationIT.java[rest-high-level-cl
 --------------------------------------------------
 
 The high-level client will internally create the low-level client used to
-perform requests based on the provided builder, and manage its lifecycle.
-
-The high-level client instance needs to be closed when no longer needed so that
-all the resources used by it get properly released, as well as the underlying
-http client instance and its threads. This can be done through the `close`
-method, which will close the internal `RestClient` instance.
+perform requests based on the provided builder. That low-level client
+maintains a pool of connections and starts some threads so you should
+close the high-level client when you are well and truly done with
+it and it will in turn close the internal low-level client to free those
+resources. This can be done through the `close`:
 
 ["source","java",subs="attributes,callouts,macros"]
 --------------------------------------------------