تبدیل داده‌های CSV به فایل‌های سادهٔ TXT یک نیاز مکرر هنگام آماده‌سازی خروجی‌های داده‌ای سبک برای سیستم‌های پایین‌دست است. Aspose.HTML Cloud SDK for Java کتابخانهٔ قدرتمند مبتنی بر ابر را فراهم می‌کند که این کار را برای توسعه‌دهندگان جاوا ساده می‌سازد. در این راهنما شما یاد خواهید گرفت که چگونه CSV را به TXT در جاوا تبدیل کنید، یک پیاده‌سازی کامل را ببینید، تماس‌های cURL مورد نیاز را بررسی کنید و نکات عملکردی برای پردازش مجموعه‌های داده بزرگ را کشف کنید.

مراحل تبدیل CSV به TXT در Java

  1. Add the SDK Dependency - Use Maven to include the Aspose.HTML Cloud SDK for Java in your project. 
    <dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-html-cloud</artifactId>
    <version>23.10</version>
</dependency>
  2. Create an API Client - Initialize the HtmlApi client with your client ID and secret. 
    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);
  3. Upload the CSV File - Use the uploadFile endpoint to store the source CSV in Aspose cloud storage. 
    java.io.File csvFile = new java.io.File("data/input.csv");
htmlApi.uploadFile("input.csv", csvFile);
  4. Invoke the Conversion - Call the convertDocument method, specifying CSV as the source format and TXT as the target format. 
    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);
  5. Download the Result - Retrieve the converted TXT file from cloud storage. 
    java.io.File txtFile = new java.io.File("data/output.txt");
htmlApi.downloadFile("output.txt", txtFile);

این مراحل یک ابزار تبدیل CSV به TXT در جاوا را که بر پایه 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 را بازتولید می‌کنند.

  1. احراز هویت و دریافت توکن دسترسی

    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"

  2. بارگذاری فایل 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"

  3. اجرای تبدیل

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"
         }'
  1. دانلود فایل 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 مراجعه کنید.

نصب و راه‌اندازی در جاوا

برای شروع استفاده از Aspose.HTML Cloud SDK for Java، مراحل زیر را دنبال کنید:

  1. پیش‌نیازها - Java 8 یا بالاتر و Maven نصب شده بر روی ماشین توسعه شما.
  2. افزودن وابستگی Maven - دستور زیر را اجرا کنید یا وابستگی را به صورت دستی اضافه کنید: 
    mvn install com.aspose:aspose-html-cloud
  3. دانلود SDK - آخرین JARها را از صفحه دانلود دریافت کنید.
  4. پیکربندی اعتبارها - یک فایل config.properties با client_id و client_secret خود ایجاد کنید.
  5. تأیید نصب - یک فراخوانی ساده API «Hello World» را اجرا کنید تا اتصال را تأیید کنید.

Aspose.HTML ویژگی‌هایی که برای این کار مهم هستند

  • تبدیل مبتنی بر ابر - نیازی به نصب محلی موتورهای تبدیل نیست؛ سرویس در ابر اجرا می‌شود.
  • پشتیبانی از ورودی CSV - API فرمت CSV را به عنوان منبع می‌پذیرد و می‌تواند بدون مراحل میانی، متن ساده TXT را خروجی دهد.
  • قابلیت استریمینگ - فایل‌های بزرگ به صورت تکه‌تکه پردازش می‌شوند که مصرف حافظه را کاهش می‌دهد.
  • پارامترهای قابل گسترش - می‌توانید با استفاده از گزینه‌های تبدیل، جداکننده‌ها، رمزگذاری کاراکترها و انتهای خطوط را کنترل کنید.

گزینه‌های تبدیل CSV به TXT در Java

هنگام فراخوانی convertDocument، می‌توانید تبدیل را با پارامترهای اختیاری سفارشی کنید:

پارامتر توضیح مقدار مثال
delimiter کاراکتری که فیلدها را در CSV جدا می‌کند , or ;
encoding کدگذاری متن برای فایل خروجی TXT UTF-8
lineEnding سبک شکست خط (LF، CRLF) LF
trimSpaces حذف فضاهای پیشرو/پس‌رو از هر فیلد true

این تنظیمات بخشی از پارامترهای تبدیل CSV به TXT در جاوا هستند و می‌توانند به عنوان یک بارگذاری JSON در درخواست REST یا از طریق شی ConversionOptions SDK ارسال شوند.

بهینه‌سازی عملکرد برای فایل‌های CSV بزرگ

پردازش فایل‌های CSV بزرگ (صدها مگابایت) می‌تواند بر منابع فشار آورد. این تکنیک‌ها را اعمال کنید:

  • فعال‌سازی استریمینگ - از حالت استریمینگ SDK برای خواندن و نوشتن داده‌ها در بافرهای کوچک استفاده کنید.
  • تنظیم اندازه بافر - حجم بافر داخلی را افزایش دهید (به عنوان مثال، ۴ مگابایت) تا تعداد فراخوانی‌های I/O کاهش یابد.
  • پردازش موازی - فایل CSV را به بخش‌های کوچک تقسیم کنید و به‌صورت همزمان با استفاده از Java’s ForkJoinPool تبدیل کنید.
  • از تبدیل‌های غیرضروری رمزگذاری جلوگیری کنید - رمزگذاری منبع و مقصد را یکسان نگه دارید (ترجیحاً UTF-8).

یک بنچمارک سریع نشان داد که تبدیل جریان‌دار یک CSV با حجم ۵۰۰ MB در کمتر از ۴۵ ثانیه تکمیل شد، در حالی که بارگذاری کل فایل در حافظه ۲ دقیقه زمان می‌برد.

آزمون و اعتبارسنجی خروجی

پس از تبدیل، یکپارچگی فایل TXT را تأیید کنید:

  1. بررسی تعداد خطوط - اطمینان حاصل کنید که تعداد خطوط با CSV اصلی مطابقت دارد (در صورتی که سرصفحه حذف شده باشد).
  2. مقایسه محتوای نمونه - به‌صورت تصادفی ردیف‌ها را انتخاب کنید و مقادیر فیلدها را پس از تبدیل مقایسه کنید.
  3. مدیریت کاراکترهای ویژه - تأیید کنید که کاراکترهایی مانند کاما، نقل‌قول و خطوط جدید به‌صورت مورد انتظار حفظ یا Escape شده‌اند.

این بررسی‌ها را با تست‌های JUnit خودکار کنید تا اعتبارسنجی را در خط لوله CI خود یکپارچه کنید.

نتیجه‌گیری

این راهنما نشان داد که چگونه می‌توانید تبدیل CSV به TXT را در جاوا با استفاده از Aspose.HTML Cloud SDK for Java انجام دهید. با دنبال کردن دستورالعمل‌های گام‌به‌گام، می‌توانید تبدیل مبتنی بر ابر قابل اعتماد را در برنامه‌های خود یکپارچه کنید، فایل‌های بزرگ را به‌صورت کارآمد مدیریت کنید و خروجی را با پارامترهای تبدیل سفارشی کنید. به‌خاطر داشته باشید که برای استفاده در محیط تولید، باید یک لایسنس مناسب تهیه کنید؛ می‌توانید یک لایسنس موقت را از صفحه لایسنس موقت دریافت کنید یا گزینه‌های کامل قیمت‌گذاری را در سایت محصول بررسی کنید. کدنویسی خوش!

FAQs

  • آسان‌ترین راه برای شروع یک اسکریپت تبدیل CSV به TXT در جاوا چیست؟
    از Aspose.HTML Cloud SDK for Java استفاده کنید که روش‌های آماده‌ای مانند convertDocument ارائه می‌دهد که کل فرآیند را با حداقل کد مدیریت می‌کند.
  • آیا می‌توانم در طول تبدیل، جداکننده‌ها و رمزگذاری را کنترل کنم؟
    بله، گزینه‌های تبدیل SDK به شما امکان می‌دهند delimiter، encoding و سایر پارامترها را مشخص کنید. برای لیست کامل به API reference مراجعه کنید.
  • آیا محدودیتی برای اندازه فایل CSV در تبدیل ابری وجود دارد؟
    سرویس ابری فایل‌ها را تا ۲ GB پشتیبانی می‌کند، اما برای عملکرد بهینه باید استریمینگ را فعال کنید و برای مجموعه داده‌های بسیار بزرگ پردازش قطعه‑قطعه را در نظر بگیرید.
  • چگونه می‌توانم اطمینان حاصل کنم که خروجی TXT با محتوای اصلی CSV مطابقت دارد؟
    چک‌های شمارش خطوط را انجام دهید و ردیف‌های نمونه را مقایسه کنید. تست‌های واحد خودکار می‌توانند تأیید کنند که تبدیل یکپارچگی داده‌ها را حفظ می‌کند، همان‌طور که در بخش تست توضیح داده شده است.

بیشتر بخوانید