تحويل curl إلى Java

Q: ما هو HttpClient في Java؟

يعد HttpClient في Java (الذي تم تقديمه في Java 11) عميل HTTP حديثاً ومدمجاً يحل محل HttpURLConnection القديم. يدعم HTTP/2، والطلبات غير المتزامنة، و WebSocket، وواجهة builder سلسة. لا حاجة لتبعيات خارجية. يدعم curl2code أيضاً OkHttp، و Jsoup، و HttpURLConnection كبدائل.

Q: مقارنة بين HttpClient و OkHttp و HttpURLConnection — أيهما أستخدم؟

HttpClient (Java 11+) هو المعيار الحديث — استخدمه للمشاريع الجديدة. OkHttp ناضج ومستخدم على نطاق واسع في Android، مع معترضات وتجميع اتصالات. HttpURLConnection يعمل على جميع إصدارات Java ولكنه مطول. لـ Android/Kotlin، راجع محول curl إلى Kotlin. لنهج حديث مماثل، جرب curl إلى C#.

Q: كيفية التعامل مع المصادقة في Java؟

اضبط ترويسة Authorization: request.header("Authorization", "Bearer " + token). لمصادقة Basic، قم بالتشفير باستخدام Base64.getEncoder().encodeToString((user + ":" + pass).getBytes()). يدعم HttpClient أيضاً Authenticator للتعامل التلقائي مع بيانات الاعتماد.

Q: كيفية التعامل مع أخطاء HTTP في Java؟

مع HttpClient، تحقق من response.statusCode() بعد كل طلب — فهو لا يلقي استثناءات عند أخطاء HTTP. قم بتغليف الاستدعاءات في try/catch لـ IOException (شبكة) و InterruptedException (غير متزامن). تلقي OkHttp استثناء IOException عند الفشل وتوفر response.isSuccessful() لفحص الحالة.

Q: كيفية إجراء طلبات HTTP غير متزامنة في Java؟

يوفر HttpClient دالة sendAsync() التي تعيد CompletableFuture: client.sendAsync(request, BodyHandlers.ofString()).thenApply(HttpResponse::body). قم بالتسلسل باستخدام thenAccept()، أو thenCompose()، أو استخدم CompletableFuture.allOf() للطلبات المتوازية. تستخدم OkHttp enqueue() مع واجهة Callback.

Q: كيفية ضبط المهلات في HttpClient في Java؟

اضبطها على العميل: HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(10)).build(). لكل طلب: request.timeout(Duration.ofSeconds(30)). تستخدم OkHttp OkHttpClient.Builder().connectTimeout(10, TimeUnit.SECONDS).readTimeout(30, TimeUnit.SECONDS).

Q: كيفية تكوين بروكسي في Java؟

مع HttpClient: HttpClient.newBuilder().proxy(ProxySelector.of(new InetSocketAddress("proxy", 8080))).build(). تستخدم OkHttp فئة Proxy: new OkHttpClient.Builder().proxy(new Proxy(Proxy.Type.HTTP, address)). تحترم Java أيضاً أعلام JVM مثل -Dhttp.proxyHost. يحول curl2code أعلام -x تلقائياً.

Q: كيف يمكن إرسال طلب POST مع جسم JSON في Java؟

قم بتحويل أمر curl POST مثل curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL إلى Java باستخدام curl2code. يستخدم الكود الناتج HttpRequest.newBuilder().POST(BodyPublishers.ofString(jsonString)).build(). يقوم curl2code تلقائيًا باكتشاف وسوم -d/--data التي تحتوي على محتوى JSON ويضبط ترويسة Content-Type المناسبة في كود HttpClient.

Q: كيف يمكن إضافة مصادقة Bearer token في Java؟

قم بتمرير curl -H "Authorization: Bearer YOUR_TOKEN" URL إلى curl2code وسيقوم بإنشاء كود HttpClient مع ترويسة المصادقة: .header("Authorization", "Bearer YOUR_TOKEN"). يكتشف curl2code رموز Bearer من كل من وسوم -H "Authorization: Bearer ..." و --oauth2-bearer. بالنسبة لـ Basic auth، استخدم -u user:pass.

قم بتحويل أوامر curl إلى كود Java باستخدام HttpClient API الحديث. يعمل curl2code بالكامل في متصفحك عبر WebAssembly — لا تغادر أي بيانات جهازك. لتطوير Kotlin، جرب محول curl إلى Kotlin. لـ C# (.NET)، راجع curl إلى C#. أدناه أمثلة Java جاهزة للاستخدام.

كيفية نسخ curl من متصفحك

1
افتح أدوات المطور (DevTools)
اضغط على F12 أو Ctrl+Shift+I لفتح أدوات مطور المتصفح.
2
انتقل إلى علامة تبويب الشبكة (Network)
انقر فوق علامة التبويب Network وقم بالإجراء الذي يؤدي إلى إرسال طلب HTTP.
3
نسخ كـ cURL
انقر بزر الماوس الأيمن على الطلب ← Copy ← Copy as cURL. ثم قم بلصقه أعلاه.

أمثلة كود Java

1طلب GET بسيط

أمر curl

curl https://api.example.com/users

Java · HttpClient

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.example.com/users"))
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

2POST مع جسم JSON

أمر curl

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

Java · HttpClient

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.example.com/users"))
    .POST(BodyPublishers.ofString("{\"name\":\"John\",\"email\":\"john@example.com\"}"))
    .setHeader("Content-Type", "application/json")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

3طلب مع Bearer Token

أمر curl

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

Java · HttpClient

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.example.com/me"))
    .GET()
    .setHeader("Authorization", "Bearer token123")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

4رفع نموذج متعدد الأجزاء (Multipart Form)

أمر curl

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

Java · HttpClient

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.example.com/upload"))
    .POST(HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

5رؤوس مخصصة (Custom Headers)

أمر curl

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

Java · HttpClient

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.example.com/data"))
    .GET()
    .setHeader("X-API-Key", "abc123")
    .setHeader("Accept", "application/json")
    .setHeader("X-Request-ID", "req-456")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

الأسئلة الشائعة

ما هو HttpClient في Java؟

يعد HttpClient في Java (الذي تم تقديمه في Java 11) عميل HTTP حديثاً ومدمجاً يحل محل HttpURLConnection القديم. يدعم HTTP/2، والطلبات غير المتزامنة، و WebSocket، وواجهة builder سلسة. لا حاجة لتبعيات خارجية. يدعم curl2code أيضاً OkHttp، و Jsoup، و HttpURLConnection كبدائل.

مقارنة بين HttpClient و OkHttp و HttpURLConnection — أيهما أستخدم؟

HttpClient (Java 11+) هو المعيار الحديث — استخدمه للمشاريع الجديدة. OkHttp ناضج ومستخدم على نطاق واسع في Android، مع معترضات وتجميع اتصالات. HttpURLConnection يعمل على جميع إصدارات Java ولكنه مطول. لـ Android/Kotlin، راجع محول curl إلى Kotlin. لنهج حديث مماثل، جرب curl إلى C#.

كيفية التعامل مع المصادقة في Java؟

اضبط ترويسة Authorization: request.header("Authorization", "Bearer " + token). لمصادقة Basic، قم بالتشفير باستخدام Base64.getEncoder().encodeToString((user + ":" + pass).getBytes()). يدعم HttpClient أيضاً Authenticator للتعامل التلقائي مع بيانات الاعتماد.

كيفية إرسال بيانات نموذج متعدد الأجزاء في Java؟

يتطلب HttpClient في Java 11+ بناء جسم متعدد الأجزاء يدوياً مع سلاسل الحدود (boundary). استخدم HttpRequest.BodyPublishers.ofString() مع أجزاء منسقة يدوياً. تبسط OkHttp ذلك باستخدام MultipartBody.Builder. ينتج curl2code كود الأجزاء المتعددة المناسب لمكتبة Java المختارة.

كيفية التعامل مع أخطاء HTTP في Java؟

مع HttpClient، تحقق من response.statusCode() بعد كل طلب — فهو لا يلقي استثناءات عند أخطاء HTTP. قم بتغليف الاستدعاءات في try/catch لـ IOException (شبكة) و InterruptedException (غير متزامن). تلقي OkHttp استثناء IOException عند الفشل وتوفر response.isSuccessful() لفحص الحالة.

كيفية إجراء طلبات HTTP غير متزامنة في Java؟

يوفر HttpClient دالة sendAsync() التي تعيد CompletableFuture: client.sendAsync(request, BodyHandlers.ofString()).thenApply(HttpResponse::body). قم بالتسلسل باستخدام thenAccept()، أو thenCompose()، أو استخدم CompletableFuture.allOf() للطلبات المتوازية. تستخدم OkHttp enqueue() مع واجهة Callback.

كيفية ضبط المهلات في HttpClient في Java؟

اضبطها على العميل: HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(10)).build(). لكل طلب: request.timeout(Duration.ofSeconds(30)). تستخدم OkHttp OkHttpClient.Builder().connectTimeout(10, TimeUnit.SECONDS).readTimeout(30, TimeUnit.SECONDS).

كيفية تكوين بروكسي في Java؟

مع HttpClient: HttpClient.newBuilder().proxy(ProxySelector.of(new InetSocketAddress("proxy", 8080))).build(). تستخدم OkHttp فئة Proxy: new OkHttpClient.Builder().proxy(new Proxy(Proxy.Type.HTTP, address)). تحترم Java أيضاً أعلام JVM مثل -Dhttp.proxyHost. يحول curl2code أعلام -x تلقائياً.

كيف يمكن إرسال طلب POST مع جسم JSON في Java؟

قم بتحويل أمر curl POST مثل curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL إلى Java باستخدام curl2code. يستخدم الكود الناتج HttpRequest.newBuilder().POST(BodyPublishers.ofString(jsonString)).build(). يقوم curl2code تلقائيًا باكتشاف وسوم -d/--data التي تحتوي على محتوى JSON ويضبط ترويسة Content-Type المناسبة في كود HttpClient.

كيف يمكن إضافة مصادقة Bearer token في Java؟

قم بتمرير curl -H "Authorization: Bearer YOUR_TOKEN" URL إلى curl2code وسيقوم بإنشاء كود HttpClient مع ترويسة المصادقة: .header("Authorization", "Bearer YOUR_TOKEN"). يكتشف curl2code رموز Bearer من كل من وسوم -H "Authorization: Bearer ..." و --oauth2-bearer. بالنسبة لـ Basic auth، استخدم -u user:pass.

كيف يمكن ضبط ترويسة Content-Type في Java؟

يقوم curl2code بتحويل curl -H "Content-Type: application/json" URL إلى كود HttpClient مع الترويسة المناسبة: .header("Content-Type", "application/json"). بالنسبة لبيانات -d، يستخدم curl افتراضيًا application/x-www-form-urlencoded؛ أما بالنسبة لرفع النماذج باستخدام -F، فإنه يستخدم multipart/form-data. يقوم curl2code بربط كل منها بـ API الصحيح في HttpClient.

روابط مفيدة

توثيق HttpClient

docs.oracle.com

مرجع المكتبة القياسية

square.github.io

صفحة دليل curl

curl.se

أدلة curl

رموز أخطاء curl

ابحث عن أي رمز خروج لـ curl — الأسباب والحلول ونصائح التشخيص.

تنزيل الملفات باستخدام curl

احفظ الملفات باستخدام -o و -O، تتبّع عمليات إعادة التوجيه، استأنف التنزيلات والمزيد.

SSL و TLS والوكيل

إعداد الشهادات وإصدارات TLS ووكلاء HTTP/SOCKS و DNS المخصص.

كيفية نسخ curl من متصفحك

أمثلة كود Java

1طلب GET بسيط

2POST مع جسم JSON

3طلب مع Bearer Token

4رفع نموذج متعدد الأجزاء (Multipart Form)

5رؤوس مخصصة (Custom Headers)

الأسئلة الشائعة

روابط مفيدة

أدلة curl

تحويل curl إلى لغات أخرى

أمثلة كود Java

1طلب GET بسيط

2POST مع جسم JSON

3طلب مع Bearer Token

4رفع نموذج متعدد الأجزاء (Multipart Form)

5رؤوس مخصصة (Custom Headers)