استخدم عميل HTTP المدرك للوكيل في Jenkins داخل إضافة

يمكن لإضافة في Jenkins تُجري طلب HTTP صادرًا أن تستخدم مساعد العميل العام المدرك للوكيل:

HttpClient client = ProxyConfiguration.newHttpClient();
HttpRequest request = ProxyConfiguration.newHttpRequestBuilder(
        URI.create("https://service.example/status"))
    .GET()
    .build();
HttpResponse<Void> response = client.send(
    request, HttpResponse.BodyHandlers.discarding());

يستخدم هذا المقطع أنواع hudson.ProxyConfiguration وjava.net.URI وjava.net.http. ويتولى المستدعي الإدخال والإخراج والمقاطعة عبر مسار الإضافة المعتاد، بينما يستهلك معالج النص جسم الاستجابة ويتجاهله.

يتوفر newHttpClient وواجهة المنشئ الخاصة به منذ Jenkins 2.379. وفي الجهاز الافتراضي لجافا الخاص بالمتحكم تطبّق هذه الواجهات إعداد الوكيل المدعوم في Jenkins. أعد استخدام العميل بدل إنشاء عميل جديد لكل طلب.

يمنع ذلك نسخ اسم الوكيل وكلمة المرور المخزنين في المتحكم إلى ناقل مُعدَّ بشكل مستقل. فالعميل الذي يُنشأ منفصلًا في جافا لا يصبح مدركًا للوكيل لمجرد وجود إدخال وكيل في واجهة المتحكم.

بالنسبة للطلبات التي ترسل ترويسة Authorization إلى الوجهة، راجع قيد الوكيل الموثّق على Java 17 وما بعده. فالتوثيق يشير إلى هذا التركيب تحديدًا، واختيار هذا المساعد لا يزيل ذلك القيد.