تنفيذ أمر Curl في جافا باستخدام Apache HttpClient

في هذا السياق، يهدف البرنامج الذي ترغب في كتابته بلغة جافا إلى تنفيذ أمر Curl من خلال إرسال طلب إلى خدمة RESTful. للقيام بذلك، يمكنك استخدام مكتبة Apache HttpClient في جافا لإرسال طلب HTTP POST بشكل برمجي. سأوفر لك مثالًا توضيحيًا يمكنك من خلاله البدء في كتابة الكود.

للبداية، يجب عليك تضمين مكتبة Apache HttpClient في مشروعك. يمكنك فعل ذلك عبر إضافة التبعيات اللازمة إلى ملف مشروعك.

xmlCopy code
<dependencies>
    <dependency>
        <groupId>org.apache.httpcomponentsgroupId>
        <artifactId>httpclientartifactId>
        <version>4.5.13version> 
    dependency>
dependencies>

ثم يمكنك استخدام الكود التالي كنقطة انطلاق:

javaCopy code
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.entity.EntityBuilder;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.impl.client.HttpClients;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;

public class CurlCommandInJava {
    public static void main(String[] args) {
        // Replace these values with your actual file path and API key
        String filePath = "path/to/your/image/7_018011.gif";
        String apiKey = "helloworld";

        // API endpoint
        String apiUrl = "https://api.ocr.space/Parse/Image";

        // Create HTTP client
        HttpClient httpClient = HttpClients.createDefault();

        // Create HTTP POST request
        HttpPost httpPost = new HttpPost(apiUrl);

        // Build multipart form data
        HttpEntity multipartEntity = MultipartEntityBuilder.create()
                .addBinaryBody("file", new File(filePath), ContentType.create("image/gif"), "7_018011.gif")
                .addTextBody("apikey", apiKey)
                .addTextBody("language", "por")
                .build();

        // Set the request entity
        httpPost.setEntity(multipartEntity);

        try {
            // Execute the request
            HttpResponse response = httpClient.execute(httpPost);

            // Handle the response
            if (response.getStatusLine().getStatusCode() == 200) {
                // Successful response
                HttpEntity responseEntity = response.getEntity();
                if (responseEntity != null) {
                    // Save the response to a file (m.txt in this case)
                    try (InputStream inputStream = responseEntity.getContent();
                         FileOutputStream fileOutputStream = new FileOutputStream("m.txt")) {
                        byte[] buffer = new byte[1024];
                        int bytesRead;
                        while ((bytesRead = inputStream.read(buffer)) != -1) {
                            fileOutputStream.write(buffer, 0, bytesRead);
                        }
                    }
                    System.out.println("Response saved to m.txt");
                }
            } else {
                // Handle unsuccessful response
                System.err.println("Error: " + response.getStatusLine().getReasonPhrase());
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

يرجى ملاحظة أنه يجب استبدال قيم المتغيرات مثل filePath و apiKey بالقيم الفعلية التي تنطبق على مشروعك. يتيح لك هذا الكود إرسال طلب إلى الخدمة المستهدفة باستخدام الطريقة POST ورفع الملف كجزء من الجسم المتعدد الأجزاء (Multipart).

هذا مجرد مثال أولي، يمكنك تعديله وتكييفه حسب احتياجاتك الخاصة.

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

1. معلومات عن Apache HttpClient:

Apache HttpClient هو مكتبة قوية في جافا لإجراء طلبات HTTP. يوفر واجهة مستخدم رائعة لإرسال طلبات HTTP مثل GET و POST وتحليل الاستجابات.

2. الطلب HTTP POST:

javaCopy code
HttpPost httpPost = new HttpPost(apiUrl);

هنا يتم إنشاء كائن HttpPost لتمثيل طلب HTTP POST. يتم تحديد عنوان الطلب (API URL) في هذا الجزء.

3. بناء الجسم المتعدد الأجزاء (Multipart):

javaCopy code
HttpEntity multipartEntity = MultipartEntityBuilder.create()
        .addBinaryBody("file", new File(filePath), ContentType.create("image/gif"), "7_018011.gif")
        .addTextBody("apikey", apiKey)
        .addTextBody("language", "por")
        .build();

httpPost.setEntity(multipartEntity);

تستخدم مكتبة Apache HttpClient MultipartEntityBuilder لبناء هيكل الجسم المتعدد الأجزاء، حيث يتم إضافة ملف الصورة والمعلومات الإضافية كنصوص.

4. تنفيذ الطلب ومعالجة الاستجابة:

javaCopy code
HttpResponse response = httpClient.execute(httpPost);

هنا يتم تنفيذ الطلب باستخدام execute ويتم استرجاع الاستجابة.

5. معالجة الاستجابة الناجحة والغير ناجحة:

javaCopy code
if (response.getStatusLine().getStatusCode() == 200) {
    // معالجة الاستجابة الناجحة هنا
} else {
    // معالجة الاستجابة الغير ناجحة هنا
}

يتم فحص حالة الاستجابة، وإذا كانت ناجحة (200 OK)، يمكنك معالجة الاستجابة بشكل مناسب، في حين يتم معالجة الحالات الأخرى بشكل منفصل.

6. حفظ الاستجابة إلى ملف:

javaCopy code
try (InputStream inputStream = responseEntity.getContent();
     FileOutputStream fileOutputStream = new FileOutputStream("m.txt")) {
    // قراءة البيانات من الاستجابة وحفظها في ملف
}

هنا يتم قراءة البيانات من الاستجابة وحفظها في ملف “m.txt”.

تذكير: تأكد من التعامل بحذر مع الأمور الأمانية، على سبيل المثال، تخزين المفاتيح السرية بشكل آمن وعدم تضمينها في الكود المصدر. قم بتكوين الكود وفقًا لأفضل ممارسات الأمان والأداء.