From bc57369c6386e64815f64adc84027dfe944c96d9 Mon Sep 17 00:00:00 2001 From: Ryan Schmitt Date: Thu, 4 Dec 2025 20:50:48 -0800 Subject: [PATCH] Add UDS examples --- .../httpcomponents-client-5.6.x/examples-async.md | 8 ++++++-- src/site/markdown/httpcomponents-client-5.6.x/examples.md | 6 +++++- 2 files changed, 11 insertions(+), 3 deletions(-) diff --git a/src/site/markdown/httpcomponents-client-5.6.x/examples-async.md b/src/site/markdown/httpcomponents-client-5.6.x/examples-async.md index 0f560da..559c50b 100644 --- a/src/site/markdown/httpcomponents-client-5.6.x/examples-async.md +++ b/src/site/markdown/httpcomponents-client-5.6.x/examples-async.md @@ -51,7 +51,7 @@ HttpClient Examples (Async) - [Multiplexed HTTP/2 exchanges](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp2ServerPush.java) -This example demonstrates handling of HTTP/2 message exchanges pushed by the server. + This example demonstrates handling of HTTP/2 message exchanges pushed by the server. - [Client authentication](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientAuthentication.java) @@ -82,4 +82,8 @@ This example demonstrates handling of HTTP/2 message exchanges pushed by the ser - [Virtual HTTPS / SNI](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientSNI.java) - This example demonstrates how to use SNI to send requests to a virtual HTTPS endpoint using the async I/O. \ No newline at end of file + This example demonstrates how to use SNI to send requests to a virtual HTTPS endpoint using the async I/O. + +- [Unix domain sockets](https://github.com/apache/httpcomponents-client/blob/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/UnixDomainSocketAsync.java) + + This example demonstrates how to connect to a local daemon (in this case, the Docker daemon) over a Unix domain socket. Note that this requires Java 17+. On older versions of Java, Unix domain sockets are only supported with [classic I/O](examples.md) and require an additional dependency on JUnixSocket. diff --git a/src/site/markdown/httpcomponents-client-5.6.x/examples.md b/src/site/markdown/httpcomponents-client-5.6.x/examples.md index 4371344..2ed3026 100644 --- a/src/site/markdown/httpcomponents-client-5.6.x/examples.md +++ b/src/site/markdown/httpcomponents-client-5.6.x/examples.md @@ -116,4 +116,8 @@ HttpClient Examples (Classic) - [Virtual HTTPS / SNI](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientSNI.java) - This example demonstrates how to use SNI to send requests to a virtual HTTPS endpoint using the classic I/O. \ No newline at end of file + This example demonstrates how to use SNI to send requests to a virtual HTTPS endpoint using the classic I/O. + +- [Unix domain sockets](https://github.com/apache/httpcomponents-client/blob/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/UnixDomainSocket.java) + + This example demonstrates how to connect to a local daemon (in this case, the Docker daemon) over a Unix domain socket. Note that this requires either Java 17+ or a dependency on [JUnixSocket](https://mvnrepository.com/artifact/com.kohlschutter.junixsocket/junixsocket-core).