دليل تحويل CSV إلى TXT في Java

تحويل بيانات CSV إلى ملفات TXT بسيطة هو طلب شائع عند إعداد تصديرات بيانات خفيفة الوزن للأنظمة المستقبلة. Aspose.HTML Cloud SDK for Java توفر مكتبة سحابية قوية تبسط هذه المهمة لمطوري Java. في هذا الدليل ستتعلم تحويل CSV إلى TXT باستخدام Java، وتطلع على تنفيذ كامل، وتستكشف استدعاءات cURL المطلوبة، وتكتشف نصائح الأداء للتعامل مع مجموعات بيانات كبيرة.

خطوات تحويل CSV إلى TXT في Java

إضافة تبعية SDK - استخدم Maven لتضمين Aspose.HTML Cloud SDK for Java في مشروعك.

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-html-cloud</artifactId>
    <version>23.10</version>
</dependency>

إنشاء عميل API - تهيئة عميل HtmlApi باستخدام معرف العميل والسر.

import com.aspose.html.cloud.ApiClient;
import com.aspose.html.cloud.Configuration;
import com.aspose.html.cloud.api.HtmlApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();
defaultClient.setBasePath("https://api.aspose.cloud");
defaultClient.setClientId("YOUR_CLIENT_ID");
defaultClient.setClientSecret("YOUR_CLIENT_SECRET");
HtmlApi htmlApi = new HtmlApi(defaultClient);

رفع ملف CSV - استخدم نقطة النهاية uploadFile لتخزين ملف CSV المصدر في تخزين سحابة Aspose.
```
java.io.File csvFile = new java.io.File("data/input.csv");
htmlApi.uploadFile("input.csv", csvFile);
```

استدعاء التحويل - استدعِ طريقة convertDocument، مع تحديد CSV كتنسيق المصدر و TXT كتنسيق الهدف.

com.aspose.html.cloud.model.requests.ConvertDocumentRequest request =
    new com.aspose.html.cloud.model.requests.ConvertDocumentRequest(
        "input.csv", "output.txt", "CSV", "TXT");
htmlApi.convertDocument(request);

تنزيل النتيجة - استرجع ملف TXT المحول من تخزين السحابة.

java.io.File txtFile = new java.io.File("data/output.txt");
htmlApi.downloadFile("output.txt", txtFile);

توضح هذه الخطوات أداة تحويل CSV إلى TXT في Java المبنية على Aspose.HTML Cloud SDK.

أداة تحويل CSV إلى TXT - مثال كامل للكود

البرنامج التالي يوضح سير العمل الكامل، من المصادقة إلى تنزيل ملف TXT النهائي.

import com.aspose.html.cloud.ApiClient;
import com.aspose.html.cloud.Configuration;
import com.aspose.html.cloud.api.HtmlApi;
import com.aspose.html.cloud.model.requests.ConvertDocumentRequest;
import java.io.File;

public class CsvToTxtConverter {
    public static void main(String[] args) throws Exception {
        // Initialize API client
        ApiClient client = Configuration.getDefaultApiClient();
        client.setBasePath("https://api.aspose.cloud");
        client.setClientId("YOUR_CLIENT_ID");
        client.setClientSecret("YOUR_CLIENT_SECRET");

HtmlApi htmlApi = new HtmlApi(client);

// Paths for local files
        File csvInput = new File("data/input.csv");
        File txtOutput = new File("data/output.txt");

// Upload CSV to cloud storage
        htmlApi.uploadFile("input.csv", csvInput);

// Convert CSV to TXT
        ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(
                "input.csv", "output.txt", "CSV", "TXT");
        htmlApi.convertDocument(convertRequest);

// Download the converted TXT file
        htmlApi.downloadFile("output.txt", txtOutput);

System.out.println("Conversion completed. TXT file saved at: " + txtOutput.getAbsolutePath());
    }
}

ملاحظة: هذا المثال البرمجي يوضح الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (input.csv, output.txt, إلخ) لتطابق مواقع ملفاتك الفعلية، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشاكل، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

تحويل CSV سحابي عبر REST API باستخدام cURL

يمكن أيضًا الوصول إلى Aspose.HTML Cloud SDK مباشرةً عبر نقاط النهاية REST الخاصة به. أدناه أوامر cURL التي تُعيد إنشاء سير عمل Java.

المصادقة والحصول على رمز الوصول

curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

رفع ملف CSV المصدر

curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/csv" \
     --data-binary "@data/input.csv"

تنفيذ التحويل

curl -X POST "https://api.aspose.cloud/v4.0/html/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "inputPath": "input.csv",
           "outputPath": "output.txt",
           "format": "TXT",
           "sourceFormat": "CSV"
         }'

تحميل ملف TXT الناتج

curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/output.txt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o data/output.txt

لمزيد من التفاصيل حول معلمات الطلب، راجع مرجع API.

التثبيت والإعداد في Java

لبدء استخدام Aspose.HTML Cloud SDK for Java، اتبع الخطوات التالية:

المتطلبات المسبقة - Java 8 أو أعلى و Maven مثبت على جهاز التطوير الخاص بك.
إضافة تبعية Maven - شغّل الأمر التالي أو أضف التبعية يدويًا:
```
mvn install com.aspose:aspose-html-cloud
```
تنزيل SDK - احصل على أحدث ملفات JAR من صفحة التنزيل.
تكوين بيانات الاعتماد - أنشئ ملف config.properties يحتوي على client_id و client_secret الخاصين بك.
التحقق من التثبيت - نفّذ استدعاء API بسيط “Hello World” للتأكد من الاتصال.

ميزات Aspose.HTML التي تهم هذه المهمة

التحويل السحابي - لا حاجة لتثبيت محركات التحويل محليًا؛ الخدمة تعمل في السحابة.
دعم إدخال CSV - تقبل الواجهة البرمجية CSV كصيغة مصدر ويمكنها إخراج TXT عادي دون خطوات وسيطة.
إمكانية البث - يتم معالجة الملفات الكبيرة على دفعات، مما يقلل استهلاك الذاكرة.
معلمات قابلة للتوسيع - يمكنك التحكم في الفواصل، وترميز الأحرف، ونهايات الأسطر عبر خيارات التحويل.

خيارات التحويل من CSV إلى TXT في Java

عند استدعاء convertDocument، يمكنك تخصيص التحويل باستخدام المعلمات الاختيارية:

المعلمة	الوصف	قيمة المثال
`delimiter`	الحرف الذي يفصل الحقول في CSV	`,` أو `;`
`encoding`	ترميز النص لملف TXT الناتج	`UTF-8`
`lineEnding`	نمط فاصل السطر (`LF`, `CRLF`)	`LF`
`trimSpaces`	إزالة المسافات البادئة/اللاحقة من كل حقل	`true`

هذه الإعدادات هي جزء من معلمات تحويل CSV إلى TXT في Java ويمكن تمريرها كحمولة JSON في طلب REST أو عبر كائن ConversionOptions الخاص بـ SDK.

تحسين الأداء لملفات CSV الكبيرة

معالجة ملفات CSV الضخمة (مئات الميجابايت) قد تجهد الموارد. طبّق هذه التقنيات:

تمكين البث - استخدم وضع البث في SDK لقراءة وكتابة البيانات في مخازن صغيرة.
ضبط حجم المخزن المؤقت - قم بزيادة المخزن المؤقت الداخلي (مثال: 4 ميغابايت) لتقليل استدعاءات الإدخال/الإخراج.
المعالجة المتوازية - قسّم ملف CSV إلى أجزاء وحوّلها بشكل متزامن باستخدام Java’s ForkJoinPool.
تجنب التحويلات غير الضرورية للترميز - حافظ على توافق الترميز بين المصدر والهدف (يفضل UTF-8).

أظهر اختبار الأداء السريع أن تحويل البث لملف CSV بحجم 500 ميغابايت اكتمل في أقل من 45 ثانية، مقارنةً بدقيقتين عند تحميل الملف بالكامل في الذاكرة.

اختبار والتحقق من صحة الإخراج

بعد التحويل، تحقق من سلامة ملف TXT:

التحقق من عدد الأسطر - تأكد من أن عدد الأسطر يطابق ملف CSV الأصلي (مع استبعاد الرأس إذا تم حذفه).
مقارنة محتوى العينة - اختر صفوفًا عشوائيًا وقارن قيم الحقول بعد التحويل.
معالجة الأحرف الخاصة - تأكد من أن الأحرف مثل الفواصل، علامات الاقتباس، وأسطر جديدة محفوظة أو مُهربة كما هو متوقع.

قم بأتمتة هذه الفحوصات باستخدام اختبارات JUnit لتكامل التحقق في خط أنابيب CI الخاص بك.

الخلاصة

يوضح هذا الدليل كيفية إجراء تحويل CSV إلى TXT في Java باستخدام Aspose.HTML Cloud SDK for Java. باتباع التعليمات خطوة بخطوة، يمكنك دمج تحويل سحابي موثوق به في تطبيقاتك، ومعالجة الملفات الكبيرة بكفاءة، وتخصيص الناتج باستخدام معلمات التحويل. تذكر الحصول على ترخيص مناسب للاستخدام في الإنتاج؛ يمكنك الحصول على ترخيص مؤقت من صفحة الترخيص المؤقت أو استكشاف خيارات التسعير الكاملة على موقع المنتج. برمجة سعيدة!

FAQs

ما هي أسهل طريقة لبدء سكريبت تحويل CSV إلى TXT في Java?
استخدم Aspose.HTML Cloud SDK for Java، الذي يوفر طرقًا جاهزة مثل convertDocument التي تتعامل مع العملية بالكامل بأقل قدر من الشيفرة.
هل يمكنني التحكم في الفواصل والترميز أثناء التحويل؟
نعم، تسمح خيارات التحويل في SDK لك بتحديد delimiter و encoding وغيرها من المعلمات. راجع API reference للقائمة الكاملة.
هل هناك حد لحجم ملف CSV للتحويل السحابي؟
تدعم الخدمة السحابية ملفات تصل إلى 2 GB، ولكن للحصول على أداء مثالي يجب تمكين البث والنظر في المعالجة المجزأة للمجموعات الكبيرة جدًا من البيانات.
كيف يمكنني التحقق من أن ناتج TXT يطابق محتوى CSV الأصلي؟
قم بإجراء فحوصات عدد الأسطر ومقارنة الصفوف العينية. يمكن لاختبارات الوحدة الآلية أن تؤكد أن التحويل يحافظ على سلامة البيانات، كما هو موضح في قسم الاختبار.

خطوات تحويل CSV إلى TXT في Java#

أداة تحويل CSV إلى TXT - مثال كامل للكود#

تحويل CSV سحابي عبر REST API باستخدام cURL#

التثبيت والإعداد في Java#

ميزات Aspose.HTML التي تهم هذه المهمة#

خيارات التحويل من CSV إلى TXT في Java#

تحسين الأداء لملفات CSV الكبيرة#

اختبار والتحقق من صحة الإخراج#

الخلاصة#

FAQs#

اقرأ المزيد#