{"id":12420,"date":"2025-10-19T18:14:02","date_gmt":"2025-10-19T10:14:02","guid":{"rendered":"https:\/\/www.chenqing.work\/?p=12420"},"modified":"2025-10-19T20:29:01","modified_gmt":"2025-10-19T12:29:01","slug":"%e8%af%91-jep-321%ef%bc%9ahttp-client-api","status":"publish","type":"post","link":"https:\/\/www.chenqing.work\/?p=12420","title":{"rendered":"\u8bd1 | JEP 321: HTTP Client API"},"content":{"rendered":"\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1920\" height=\"1280\" src=\"https:\/\/www.chenqing.work\/wp-content\/uploads\/2025\/10\/partha-sarathi-kar-wgd01jJiFBU-unsplash.jpg\" alt=\"\" class=\"wp-image-12481\"\/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/www.chenqing.work\/?p=12299\" data-type=\"link\" data-id=\"https:\/\/www.chenqing.work\/?p=12299\">\u8bd1 | JEP 517: HTTP\/3 for the HTTP Client API<\/a><\/li>\n\n\n\n<li>\u8bd1 | JEP 321: HTTP Client API   \ud83d\udc48 bro, you are here<\/li>\n\n\n\n<li><a href=\"https:\/\/www.chenqing.work\/?p=12484\" data-type=\"link\" data-id=\"https:\/\/www.chenqing.work\/?p=12484\">\u8bd1 | JEP 110: HTTP\/2 Client (Incubator)<\/a><\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p>\u539f\u6587\uff1a<a href=\"https:\/\/openjdk.org\/jeps\/321\" data-type=\"link\" data-id=\"https:\/\/openjdk.org\/jeps\/321\">JEP 321: HTTP Client API<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u6458\u8981<\/h2>\n\n\n\n<p>\u5728 JDK 10 \u4e2d\u6807\u51c6\u5316\u5728 JDK 9 \u4e2d\u901a\u8fc7 JEP 110 \u5b75\u5316\u7684 HTTP Client API\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u76ee\u6807<\/h2>\n\n\n\n<p>\u5728 JEP 110 \u7684\u76ee\u6807\u4e4b\u4e0a\uff0c\u8fd8\u5c06\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u5c06\u5728\u5b75\u5316\u7248 API \u4e2d\u6536\u5230\u7684\u53cd\u9988\u7eb3\u5165\u8003\u8651\uff1b<\/li>\n\n\n\n<li>\u57fa\u4e8e\u5b75\u5316\u7248 API\uff0c\u5728 java.net.http \u5305\u4e2d\u63d0\u4f9b\u6807\u51c6 API\uff1b<\/li>\n\n\n\n<li>\u79fb\u9664\u5b75\u5316\u7248 API\u3002<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">\u52a8\u673a<\/h2>\n\n\n\n<p>\u548c JEP 110 \u7684\u52a8\u673a\u4e00\u81f4\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u63cf\u8ff0<\/h2>\n\n\n\n<p>\u672c\u63d0\u6848\u76ee\u6807\u5728\u4e8e\u6807\u51c6\u5316\u5728 JDK9 \u4e2d\u5f15\u5165\u7684\u5b75\u5316\u7248  HTTP Client API\uff0c\u5e76\u5bf9 JDK10 \u4e2d\u7684\u7248\u672c\u8fdb\u884c\u66f4\u65b0\u3002\u5b75\u5316\u7248 API       \u6536\u5230\u4e86\u5f88\u591a\u53cd\u9988\uff0c\u5e76\u636e\u6b64\u8fdb\u884c\u4e86\u91cd\u5927\u7684\u6539\u8fdb\uff0c\u4f46\u9876\u5c42\u7edd\u5927\u90e8\u5206\u4fdd\u6301\u539f\u6837\u3002\u901a\u8fc7 CompletableFutures \u63d0\u4f9b\u4e86\u975e\u963b\u585e\u7684\u8bf7\u6c42\u3001\u54cd\u5e94\u8bed\u4e49\uff0c\u4ee5\u4fbf\u88ab\u4e32\u8054\u8d77\u6765\u89e6\u53d1\u540e\u7eed\u4f9d\u8d56\u5b83\u7684\u52a8\u4f5c\u3002\u8bf7\u6c42\u4f53\u548c\u54cd\u5e94\u4f53\u7684\u80cc\u538b\u3001\u6d41\u63a7\u901a\u8fc7\u5e73\u53f0\u7684\u54cd\u5e94\u5f0f\u6d41\u8fdb\u884c\u652f\u6301 \u2014\u2014 \u5728 java.util.concurrent.Flow API \u4e2d\u3002<\/p>\n\n\n\n<p>\u867d\u7136\u5728 JDK9\u3001JDK10 \u4e2d\u8fdb\u884c\u4e86\u5b75\u5316\uff0c\u4f46\u5b9e\u73b0\u51e0\u4e4e\u5168\u90e8\u91cd\u5199\u4e86\u3002\u73b0\u5728\u7684\u5b9e\u73b0\u662f\u5b8c\u5168\u5f02\u6b65\u7684\uff08\u57fa\u4e8e HTTP\/1.1 \u7684\u4e0a\u4e00\u7248\u662f\u963b\u585e\u5f0f\u7684\uff09\u3002RX \u6d41\u6982\u5ff5\u5df2\u7ecf\u88ab\u6574\u5408\u8fdb\u5b9e\u73b0\u4e2d\uff0c\u7ec8\u7ed3\u4e86\u5f88\u591a\u4e3a\u652f\u6301 HTTP\/2 \u800c\u5f15\u5165\u7684\u5b9a\u5236\u6982\u5ff5\u3002\u73b0\u5728\u53ef\u4ee5\u66f4\u5bb9\u6613\u5730\u8ffd\u8e2a\u6570\u636e\u6d41\uff0c\u4ece\u7528\u6237\u5c42\u7684\u8bf7\u6c42\u53d1\u9001\u8005\u5230\u54cd\u5e94\u7684\u8ba2\u9605\u8005\u76f4\u81f3\u5e95\u5c42\u7684\u5957\u63a5\u5b57\u3002\u8fd9\u5927\u5927\u51cf\u5c11\u4e86\u4ee3\u7801\u4e2d\u6982\u5ff5\u7684\u6570\u91cf\u548c\u590d\u6742\u5ea6\uff0c\u6700\u5927\u5316\u4e86\u5728 HTTP\/1.1 \u548c HTTP\/2 \u4e4b\u95f4\u8fdb\u884c\u590d\u7528\u7684\u53ef\u80fd\u3002<\/p>\n\n\n\n<p>\u6807\u51c6\u5316\u540e\u7684 API \u7684\u6a21\u5757\u540d\u548c\u5305\u540d\u4e3a java.net.http\u3002<\/p>\n\n\n\n<p><strong>\u76f8\u6bd4 JDK10 \u4e2d\u5b75\u5316\u7248 API \u7684\u53d8\u5316<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>BodyPublisher\u3001BodyHandler\u3001BodySubscriber \u7684\u9884\u5b9a\u4e49\u5b9e\u73b0\u2014\u2014\u901a\u8fc7\u9759\u6001\u5de5\u5382\u65b9\u6cd5\u521b\u5efa\uff0c\u5df2\u7ecf\u88ab\u79fb\u5230\u9694\u79bb\u7684\u4e0d\u53ef\u5b9e\u4f8b\u5316\u5de5\u5177\u5de5\u5382\u7c7b\u4e2d\uff0c\u5e76\u6309\u590d\u6570\u547d\u540d\u7ea6\u5b9a\u8fdb\u884c\u547d\u540d\u3002\u63d0\u9ad8\u4e86\u8fd9\u4e9b\u5173\u8054\u5c0f\u63a5\u53e3\u7684\u53ef\u8bfb\u6027\u3002<\/li>\n\n\n\n<li>\u9759\u6001\u5de5\u5382\u65b9\u6cd5\u540d\u79f0\u4e5f\u8fdb\u884c\u4e86\u66f4\u65b0\uff0c\u547d\u540d\u9075\u5faa\u4e86\u4ee5\u4e0b\u7c97\u7c92\u5ea6\u7b56\u7565\n<ul class=\"wp-block-list\">\n<li>fromXxx\uff1a\u6765\u81ea\u6807\u51c6 Subscriber \u7684\u9002\u914d\u5668\uff0c\u5982\u4f20\u5165\u4e00\u4e2a Flow.Subscriber\uff0c\u8fd4\u56de\u4e00\u4e2a BodySubscriber\u3002<\/li>\n\n\n\n<li>ofXxx\uff1a\u521b\u5efa\u9884\u5b9a\u4e49\u4f53 [ Publisher \u6216 Handler \u6216 Subscriber ] \u7684\u5de5\u5382\u7c7b\uff0c\u8fd9\u4e9b\u9884\u5b9a\u4e49\u4f53\u6267\u884c\u4e00\u4e9b\u516c\u5171\u4efb\u52a1\uff0c\u5982\u628a\u54cd\u5e94\u4f53\u8f6c\u6362\u4e3a String \u6216\u6d41\u5f0f\u5199\u5165\u6587\u4ef6\u3002<\/li>\n\n\n\n<li>other\uff1a\u7ec4\u5408\u5668\uff08\u8f93\u5165\u4e00\u4e2a BodySubscriber\uff0c\u8fd4\u56de\u4e00\u4e2a BodySubscriber\uff09\u6216\u8005\u5176\u4ed6\u6709\u7528\u5de5\u4f5c\u3002<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>\u6dfb\u52a0\u4e86\u4e00\u4e9b BodyHandlers \u548c\u5bf9\u5e94\u7684 BodySubscribers \uff0c\u63d0\u5347\u4e86\u4e00\u4e9b\u516c\u5171\u573a\u666f\u7684\u53ef\u7528\u6027\uff1a\n<ul class=\"wp-block-list\">\n<li>discard(Object replacement) \u7ec4\u5408\u4e86\u5ffd\u7565\u54cd\u5e94\u4f53\u548c\u4f7f\u7528\u7ed9\u5b9a\u5185\u5bb9\u66ff\u6362\u7684\u80fd\u529b\u3002\u53cd\u9988\u8868\u660e\u8fd9\u6837\u4f1a\u5f15\u8d77\u8bef\u89e3\u3002\u8be5\u65b9\u6cd5\u5df2\u7ecf\u88ab\u79fb\u9664\uff0c\u4ee3\u4e4b\u4ee5 2 \u4e2a\u72ec\u7acb\u7684 handler\uff1a1\uff09discarding() \u548c 2\uff09replacing(Object replacement)\u3002<\/li>\n\n\n\n<li>\u6dfb\u52a0 ofLines() \u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u8fd4\u56de\u4e00\u4e2a BodyHandler&lt;Stream&lt;String&gt;&gt;\uff0c\u4ee5\u652f\u6301\u5c06\u6d41\u5f0f\u54cd\u5e94\u8f6c\u4e3a\u4e00\u4e2a\u884c\u6d41\u2014\u2014\u4e00\u884c\u4e00\u884c\u7684\u6d41\u3002\u63d0\u4f9b\u548c BufferedReader.lines() \u7c7b\u4f3c\u7684\u8bed\u4e49\u3002<\/li>\n\n\n\n<li>\u6dfb\u52a0 fromLineSubscriber \u65b9\u6cd5\uff0c\u652f\u6301\u9002\u914d\u5c06\u54cd\u5e94\u4f53\u8f6c\u4e3a\u57fa\u4e8e\u884c\u6d41\u7684\u4e00\u4e2a Flow.Subscriber\u3002<\/li>\n\n\n\n<li>\u6dfb\u52a0 BodySubscriber.mapping \u7528\u4e8e\u4ece\u4e00\u79cd\u54cd\u5e94\u4f53\u683c\u5f0f\u6620\u5c04\u5230\u53e6\u4e00\u79cd\u683c\u5f0f\u7684\u901a\u7528\u7528\u9014\u3002<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>push \u539f\u8bed\u88ab\u91cd\u65b0\u652f\u6301\uff0c\u4ee5\u51cf\u5c11\u5bf9 API \u7684\u5f71\u54cd\uff0c\u66f4\u7b26\u5408\u901a\u5e38\u7684\u8bf7\u6c42\/\u54cd\u5e94\u3002\u7279\u522b\u662f\uff0cMultiSubscriber \u548c MultiResultMap \u90fd\u88ab\u79fb\u9664\u4e86\u3002\u76ee\u524d\u5728\u51fd\u6570\u5f0f\u63a5\u53e3\u4e2d\u5904\u7406 push \u539f\u8bed\u3002\u5728\u53d1\u9001\u52a8\u4f5c\u8fc7\u7a0b\u4e2d\uff0c\u53ef\u4ee5\u9009\u62e9\u7ed9\u51fa\u4e00\u4e2a PushPromiseHandler\u3002<\/li>\n\n\n\n<li>HttpClient.Redirect \u7684\u7b56\u7565\u88ab\u7b80\u5316\u4e86\uff0c\u4f7f\u7528 NORMAL \u66ff\u6362\u4e86 SAME_PROTOCOL \u548c SECURE \u7b56\u7565\u3002\u53ef\u4ee5\u770b\u5230\u4e4b\u524d\u547d\u540d\u4e3a SECURE \u5e76\u4e0d\u8d34\u5408\uff0c\u5e94\u91cd\u65b0\u547d\u540d\u4e3a NORMAL\uff0c\u66f4\u9002\u7528\u4e8e\u672a\u6765\u5927\u90e8\u5206\u6b63\u5e38\u573a\u666f\u3002\u65e2\u7136\u4f7f\u7528\u4e86\u524d\u6587\u7684\u65b0\u540d\u5b57 NORMAL\uff0cSAME_PROTOCOL \u5c31\u663e\u5f97\u5947\u602a\u4e86\uff0c\u5bb9\u6613\u8bef\u89e3\uff0c\u4e0d\u592a\u53ef\u80fd\u7ee7\u7eed\u4f7f\u7528\u3002<\/li>\n\n\n\n<li>WebSocket.MessagePart \u5df2\u88ab\u79fb\u9664\u3002\u8fd9\u4e2a\u679a\u4e3e\u503c\u7528\u4e8e\u63a5\u6536\u7aef\u6807\u8bc6\u6d88\u606f\u662f\u5426\u53d1\u9001\u5b8c\u6bd5\u3002\u53d1\u9001\u7aef\u4f7f\u7528\u4e86\u4e00\u4e2a\u7b80\u5355\u7684 boolean \u6765\u6807\u8bc6\uff0c\u548c\u63a5\u6536\u7aef\u7684\u6807\u8bc6\u65b9\u5f0f\u4e0d\u5bf9\u79f0\u3002\u53ef\u4ee5\u770b\u5230\u4f7f\u7528\u4e00\u4e2a\u7b80\u5355\u7684 boolean \u6765\u5904\u7406\u63a5\u6536\u5230\u7684\u6d88\u606f\uff0c\u6781\u5927\u51cf\u5c11\u4e86\u548c\u7b80\u5316\u4e86\u63a5\u6536\u903b\u8f91\u3002\u5224\u65ad\u6d88\u606f\u662f\u5426\u5df2\u88ab\u4f5c\u4e3a\u4e00\u4e2a\u6574\u4f53\u53d1\u9001\uff0c\u662f\u4e0a\u8ff0 MessagePart \u7684\u597d\u5904\u4e4b\u4e00\u548c\u4e3b\u8981\u76ee\u7684\uff0c\u4f46\u5df2\u88ab\u8bc1\u660e\u662f\u5f97\u4e0d\u507f\u5931\u3002<\/li>\n<\/ol>\n\n\n\n<p>\u5173\u4e8e API \u7684\u66f4\u591a\u5b9a\u4e49\u53ef\u4ee5\u67e5\u770b <a href=\"https:\/\/openjdk.org\/jeps\/110#Description\" data-type=\"link\" data-id=\"https:\/\/openjdk.org\/jeps\/110#Description\">JEP 110<\/a>\u3001\u6700\u65b0\u7684 <a href=\"https:\/\/cr.openjdk.org\/~chegar\/httpclient\/02\/javadoc\/api\/java.net.http\/module-summary.html\" data-type=\"link\" data-id=\"https:\/\/cr.openjdk.org\/~chegar\/httpclient\/02\/javadoc\/api\/java.net.http\/module-summary.html\">API javadoc<\/a>\u3001\u6216\u8005\u7f51\u7edc\u5de5\u4f5c\u5c0f\u7ec4\u7684 <a href=\"https:\/\/openjdk.org\/groups\/net\/httpclient\/\" data-type=\"link\" data-id=\"https:\/\/openjdk.org\/groups\/net\/httpclient\/\">JDK HTTP Client<\/a> \u9875\u9762\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u6d4b\u8bd5<\/h2>\n\n\n\n<p>\u5b58\u91cf\u7684\u6d4b\u8bd5\u7528\u4f8b\u90fd\u662f\u9488\u5bf9\u5b75\u5316\u7248 API \u7684\uff0c\u5c06\u6309\u7167\u65b0\u7684\u6807\u51c6 API \u8fdb\u884c\u66f4\u65b0\u3002\u540c\u65f6\u589e\u52a0\u6d4b\u8bd5\u7528\u4f8b\u4ee5\u8986\u76d6\u6240\u6709\u652f\u6301\u7684\u573a\u666f\uff0c\u7279\u522b\u662f HTTP\/1.1 \u548c HTTP\/2 \u4e4b\u95f4\u7684\u534f\u8bae\u5347\u964d\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u98ce\u9669\u548c\u5047\u8bbe<\/h2>\n\n\n\n<p>\u5f53\u524d\u4f9d\u8d56\u4e86\u5b75\u5316\u7248 HTTP Client API \u7684\u4ee3\u7801\u9700\u8981\u66f4\u65b0\uff0c\u53d8\u66f4\u5f15\u7528\u5305\u7684\u6700\u5c0f\u5316\u4fee\u6539\u3002\u548c\u5b75\u5316\u5176\u4ed6\u7279\u6027\u7684\u5904\u7406\u65b9\u5f0f\u4e00\u6837\u3002\u5982\u679c\u4f9d\u8d56\u4e86\u5b75\u5316\u7248\u6a21\u5757\uff0c\u4f1a\u5728\u7f16\u8bd1\u548c\u8fd0\u884c\u65f6\u6536\u5230\u5408\u9002\u7684\u544a\u8b66\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u539f\u6587\uff1aJEP 321: HTTP Client API \u6458\u8981 \u5728 JDK 10 \u4e2d\u6807\u51c6\u5316\u5728 JDK  [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[17],"tags":[118,143,199],"class_list":["post-12420","post","type-post","status-publish","format-standard","hentry","category-17","tag-http","tag-java","tag-jep"],"_links":{"self":[{"href":"https:\/\/www.chenqing.work\/index.php?rest_route=\/wp\/v2\/posts\/12420","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.chenqing.work\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.chenqing.work\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.chenqing.work\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.chenqing.work\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=12420"}],"version-history":[{"count":55,"href":"https:\/\/www.chenqing.work\/index.php?rest_route=\/wp\/v2\/posts\/12420\/revisions"}],"predecessor-version":[{"id":12557,"href":"https:\/\/www.chenqing.work\/index.php?rest_route=\/wp\/v2\/posts\/12420\/revisions\/12557"}],"wp:attachment":[{"href":"https:\/\/www.chenqing.work\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=12420"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.chenqing.work\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=12420"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.chenqing.work\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=12420"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}