إعدادات وكيل موثّقة لـ HTTPBuilder الكلاسيكي في Groovy

بالنسبة لتطبيق يستخدم groovyx.net.http.HTTPBuilder الكلاسيكي، اضبط المسار على الأداة البانية وحساب الوكيل على مزوّد بيانات الاعتماد لعميل Apache HTTP الخاص بها:

import groovyx.net.http.HTTPBuilder
import org.apache.http.auth.AuthScope
import org.apache.http.auth.UsernamePasswordCredentials

def http = new HTTPBuilder('https://api.example.net')
http.setProxy('proxy.example.net', 8080, 'http')

http.client.credentialsProvider.setCredentials(
    new AuthScope('proxy.example.net', 8080),
    new UsernamePasswordCredentials(proxyUser, proxyPassword)
)

تأتي متغيّرات بيانات الاعتماد من التطبيق. يطابق AuthScope اسم مضيف الوكيل ومنفذه المضبوطين مباشرة أعلاه. تستخدم الطلبات اللاحقة التي تمر عبر هذه الأداة البانية ذلك العميل المضبوط.

ينشئ التنفيذ الافتراضي لـ HTTPBuilder الكلاسيكي كائن Apache DefaultHttpClient، وتضبط طريقة setProxy العامة مسار الوكيل الافتراضي لذلك العميل. هذا هو كائن الإعداد ذو الصلة حتى عندما يعمل التطبيق نفسه داخل Grails أو Tomcat.

يستهدف المثال تلك الواجهة البرمجية الكلاسيكية. يمتلك HTTPBuilder-NG نموذج إعداد مختلفاً، وعلى التطبيق الذي يستبدل العميل الأساسي للأداة البانية الكلاسيكية أن يستخدم واجهات يدعمها البديل. أبقِ اسم المضيف والمنفذ الصحيح ومخطط الوكيل قيماً منفصلة عند تحميلها من إعداد التطبيق.