تبدیل CSV به JSON در جاوا

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

مراحل تبدیل CSV به JSON در جاوا

یک نمونه BarcodeApi ایجاد کنید و احراز هویت را پیکربندی کنید - مشتری BarcodeApi را با ClientId و ClientSecret خود مقداردهی اولیه کنید. این کار تمام درخواست‌های بعدی را احراز هویت می‌کند.
```
BarcodeApi apiInstance = new BarcodeApi();
apiInstance.getApiClient().setBasePath("https://api.aspose.cloud");
apiInstance.getApiClient().setClientId("YOUR_CLIENT_ID");
apiInstance.getApiClient().setClientSecret("YOUR_CLIENT_SECRET");
```
فایل CSV منبع را به ذخیره‌سازی Aspose Cloud بارگذاری کنید - از نقطه انتهایی UploadFile برای قرار دادن CSV در ابر استفاده کنید تا منطق تبدیل بتواند بدون محدودیت‌های I/O محلی به آن دسترسی داشته باشد.
```
apiInstance.uploadFile("my-bucket", "input.csv", new File("src/main/resources/input.csv"));
```

محتوای CSV را به صورت جریان دریافت کنید و هر ردیف را به یک شیء JSON تبدیل کنید - فایل را به صورت جریان دریافت کنید، با BufferedReader آن را تجزیه کنید و با استفاده از کتابخانه org.json یک JSONArray بسازید. این روش از بارگذاری کل فایل در حافظه جلوگیری می‌کند.

InputStream csvStream = apiInstance.downloadFile("my-bucket", "input.csv");
BufferedReader reader = new BufferedReader(new InputStreamReader(csvStream));
JSONArray jsonArray = new JSONArray();
String line;
while ((line = reader.readLine()) != null) {
    String[] columns = line.split(",");
    JSONObject obj = new JSONObject();
    obj.put("column1", columns[0]);
    obj.put("column2", columns[1]);
    // add remaining columns as needed
    jsonArray.put(obj);
}

آرایه JSON را در یک فایل خروجی بنویسید - از یک نویسنده با بافر برای ذخیره‌سازی JSON حاصل در ابر یا به صورت محلی استفاده کنید.
```
String jsonString = jsonArray.toString(4); // pretty print with 4‑space indent
apiInstance.uploadFile("my-bucket", "output.json", new ByteArrayInputStream(jsonString.getBytes()));
```
(اختیاری) پردازش چندنخی را برای فایل‌های بزرگ فعال کنید - CSV را به بخش‌های کوچک تقسیم کنید و هر بخش را در یک رشته ExecutorService جداگانه پردازش کنید. این کار زمان تبدیل را برای فایل‌های بزرگ‌تر از ۱۰۰ MB به‌طرز چشمگیری کاهش می‌دهد.

پیاده‌سازی Java CSV به JSON - مثال کامل کد

مثال زیر تمام مراحل را در یک کلاس جاوا قابل اجرا ترکیب می‌کند.

import com.aspose.barcode.api.BarcodeApi;
import com.aspose.barcode.client.ApiException;
import org.json.JSONArray;
import org.json.JSONObject;

import java.io.*;
import java.util.concurrent.*;

public class CsvToJsonConverter {

private static final String CLIENT_ID = "YOUR_CLIENT_ID";
    private static final String CLIENT_SECRET = "YOUR_CLIENT_SECRET";
    private static final String BUCKET = "my-bucket";
    private static final String INPUT_CSV = "input.csv";
    private static final String OUTPUT_JSON = "output.json";

public static void main(String[] args) throws IOException, ApiException, InterruptedException {
        // Initialize API client
        BarcodeApi api = new BarcodeApi();
        api.getApiClient().setBasePath("https://api.aspose.cloud");
        api.getApiClient().setClientId(CLIENT_ID);
        api.getApiClient().setClientSecret(CLIENT_SECRET);

// Upload CSV to cloud storage
        api.uploadFile(BUCKET, INPUT_CSV, new File("src/main/resources/" + INPUT_CSV));

// Download CSV as stream
        InputStream csvStream = api.downloadFile(BUCKET, INPUT_CSV);
        BufferedReader reader = new BufferedReader(new InputStreamReader(csvStream));

// Prepare thread pool for multithreaded processing
        ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());
        CompletionService<JSONArray> completionService = new ExecutorCompletionService<>(executor);

// Submit parsing tasks (each task processes a chunk of lines)
        final int CHUNK_SIZE = 5000; // lines per chunk
        String line;
        int lineCount = 0;
        StringBuilder chunkBuilder = new StringBuilder();

while ((line = reader.readLine()) != null) {
            chunkBuilder.append(line).append("\n");
            lineCount++;
            if (lineCount % CHUNK_SIZE == 0) {
                final String chunk = chunkBuilder.toString();
                completionService.submit(() -> parseChunk(chunk));
                chunkBuilder.setLength(0);
            }
        }
        // Process remaining lines
        if (chunkBuilder.length() > 0) {
            final String chunk = chunkBuilder.toString();
            completionService.submit(() -> parseChunk(chunk));
        }

// Gather results
        JSONArray finalArray = new JSONArray();
        int tasks = (lineCount / CHUNK_SIZE) + (chunkBuilder.length() > 0 ? 1 : 0);
        for (int i = 0; i < tasks; i++) {
            try {
                JSONArray partial = completionService.take().get();
                for (int j = 0; j < partial.length(); j++) {
                    finalArray.put(partial.getJSONObject(j));
                }
            } catch (ExecutionException e) {
                e.printStackTrace();
            }
        }
        executor.shutdown();

// Upload final JSON
        String jsonString = finalArray.toString(4);
        api.uploadFile(BUCKET, OUTPUT_JSON,
                new ByteArrayInputStream(jsonString.getBytes()));

System.out.println("Conversion completed successfully.");
    }

// Helper method to parse a CSV chunk into a JSONArray
    private static JSONArray parseChunk(String csvChunk) {
        JSONArray array = new JSONArray();
        BufferedReader br = new BufferedReader(new StringReader(csvChunk));
        String line;
        try {
            while ((line = br.readLine()) != null) {
                String[] cols = line.split(",");
                JSONObject obj = new JSONObject();
                obj.put("column1", cols.length > 0 ? cols[0] : JSONObject.NULL);
                obj.put("column2", cols.length > 1 ? cols[1] : JSONObject.NULL);
                // Add more columns as needed
                array.put(obj);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
        return array;
    }
}

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل (input.csv، output.json و غیره) را به مکان‌های واقعی خود به‌روزرسانی کنید، اطمینان حاصل کنید تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک با تیم پشتیبانی تماس بگیرید.

پردازش CSV مبتنی بر ابر با استفاده از cURL

API ابری Aspose.BarCode همچنین می‌تواند به‌صورت مستقیم از طریق فراخوانی‌های REST دسترسی پیدا کند. در زیر دستورات cURL مورد نیاز برای انجام همان تبدیل بدون نوشتن کد Java آورده شده است.

دریافت توکن دسترسی - مقادیر جایگزین را با اعتبارهای خود جایگزین کنید.

curl -X POST "https://api.aspose.cloud/v3.0/oauth2/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/v3.0/barcode/storage/file/{bucket}/input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/csv" \
     --data-binary "@path/to/input.csv"

اجرای تبدیل - API نقطه انتهایی مستقیم CSV‑به‑JSON را فراهم نمی‌کند، بنابراین یک تابع سفارشی را فراخوانی می‌کنیم که فایل را می‌خواند، تبدیل می‌کند و نتیجه را ذخیره می‌نماید.

curl -X POST "https://api.aspose.cloud/v3.0/barcode/custom/csvtojson" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"bucket":"my-bucket","inputFile":"input.csv","outputFile":"output.json"}'

فایل JSON تولید شده را دانلود کنید

curl -X GET "https://api.aspose.cloud/v3.0/barcode/storage/file/{bucket}/output.json" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.json

برای جزئیات بیشتر در مورد احراز هویت و مشخصات نقطه انتها، به مستندات رسمی API مراجعه کنید.

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

Add the Maven dependency - Include the following coordinates in your pom.xml file:

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-barcode-cloud</artifactId>
    <version>23.12</version>
</dependency>

Download the latest JAR from the download page if you prefer a manual setup.
Configure authentication - Store your ClientId and ClientSecret securely (environment variables or a protected config file).
Initialize the API client as shown in the code example above.
Review the licensing terms - A temporary license can be obtained from the temporary license page.

درک جریان کار CSV به JSON در جاوا

فرآیند تبدیل شامل سه مرحله منطقی است:

ذخیره‌سازی - فایل CSV به ذخیره‌سازی Aspose Cloud بارگذاری می‌شود که دسترسی سریع و مقیاس‌پذیر برای عملیات بعدی فراهم می‌کند.
پردازش - فایل به صورت جریان‌دار خوانده می‌شود، تجزیه می‌گردد و هر رکورد به یک شیء JSON تبدیل می‌شود. استفاده از روش جریان‌دار از بارگذاری بیش از حد حافظه هنگام کار با فایل‌های بزرگ جلوگیری می‌کند.
خروجی - آرایه JSON حاصل به ذخیره‌سازی بازنویسی می‌شود یا مستقیماً به مشتری دانلود می‌گردد.

با جدا کردن این مراحل، می‌توانید هر بخش از خط لوله را (مثلاً با استفاده از کتابخانه JSON متفاوت) جایگزین یا گسترش دهید بدون اینکه بر سایر بخش‌ها تأثیر بگذارد.

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

ذخیره‌سازی امن ابری - نقاط انتهایی داخلی برای بارگذاری، دانلود و مدیریت فایل‌ها نیاز به سرویس‌های ذخیره‌سازی خارجی را از بین می‌برند.
کلاینت‌های API ایمن در برابر نخ‌ها - اشیاء کلاینت SDK می‌توانند در چندین نخ مجدداً استفاده شوند که برای الگوی تبدیل چندنخی که پیشتر توضیح داده شد، ضروری است.
مستندات جامع - راهنماهای تفصیلی و نمونه‌های کد در مستندات رسمی موجود هستند و به شما کمک می‌کنند به سرعت پیشرفت کنید.

پیکربندی گزینه‌های تبدیل برای CSV به JSON

در حالی که تبدیل اصلی از I/O استاندارد جاوا استفاده می‌کند، SDK به شما امکان تنظیم دقیق چندین پارامتر را می‌دهد:

گزینه	توضیح	مقدار پیشنهادی
`bufferSize`	اندازهٔ بافر خواندن/نوشتن (بایت)	`8192` (پیش‌فرض)
`threadPoolSize`	تعداد رشته‌های کارگر همزمان	`Runtime.getRuntime().availableProcessors()`
`encoding`	کدگذاری کاراکترهای CSV منبع	`UTF-8`
`skipHeader`	آیا خط اول نادیده گرفته شود	`true` اگر CSV شامل نام ستون‌ها باشد

تنظیم این تنظیمات می‌تواند توان پردازش را بهبود بخشد، به‌ویژه هنگام پردازش فایل‌های بزرگ‌تر از ۵۰۰ MB.

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

جریان به‌جای بارگذاری - از BufferedReader استفاده کنید و هر خط را به محض رسیدن پردازش کنید. این کار از بارگذاری کل فایل در حافظه جلوگیری می‌کند.
استفاده از چندنخی - فایل CSV را به بخش‌های منطقی تقسیم کنید (مثلاً 5 خط، 000) و هر بخش را در یک نخ جداگانه با استفاده از ExecutorService پردازش کنید.
استفاده مجدد از کلاینت‌های API - یک شیء BarcodeApi واحد ایجاد کنید و آن را بین نخ‌ها به اشتراک بگذارید تا هزینهٔ برقراری اتصال کاهش یابد.
فشرده‌سازی خروجی - اگر JSON حاصل بزرگ باشد، قبل از بارگذاری یا ارسال به مشتری، آن را با GZIP فشرده کنید.

این تکنیک‌ها با الگوی بهترین‑عمل «CSV to JSON Streaming Conversion in Java» هم‌راستا هستند.

بهترین شیوه‌ها برای تبدیل CSV به JSON در جاوا

اعتبارسنجی داده‌های ورودی - قبل از شروع تبدیل، ردیف‌های خراب، جداکننده‌های غیرمنتظره یا عدم تطابق‌های رمزگذاری را بررسی کنید.
مدیریت استثناها به‌صورت ملایم - عملیات I/O را در بلوک‌های try‑catch بپیچید و خطاها را با زمینه کافی برای کمک به رفع اشکال ثبت کنید.
استفاده از استخر رشته‌ای اختصاصی - از استفاده از ForkJoinPool عمومی برای کارهای وابسته به I/O خودداری کنید؛ یک استخر با اندازه ثابت کنترل بهتری بر مصرف منابع به شما می‌دهد.
آزمون با نمونه‌های واقعی - تست‌های واحدی را شامل کنید که موارد حاشیه‌ای مانند فیلدهای خالی، رشته‌های نقل‌قول‌شده حاوی کاما و خطوط بسیار طولانی را پوشش دهند.
مستندسازی طرح‌واره JSON - قرارداد واضحی برای مصرف‌کنندگان پایین‌دستی فراهم کنید، به‌ویژه زمانی که نام ستون‌ها ممکن است با گذشت زمان تغییر کنند.

پیروی از این راهنماها اطمینان می‌دهد که تبدیل CSV به JSON شما قابل اعتماد، قابل نگهداری و کارآمد باشد.

نتیجه‌گیری

تبدیل CSV به JSON در جاوا با استفاده از Aspose.BarCode Cloud SDK for Java به سادگی انجام می‌شود. با بارگذاری فایل منبع در ذخیره‌سازی Aspose Cloud، پخش داده‌ها و به‌طور اختیاری اعمال پردازش چندنخی، می‌توانید فایل‌های با هر اندازه‌ای را به‌صورت کارآمد مدیریت کنید. API قدرتمند SDK، مستندات جامع و گزینه‌های انعطاف‌پذیر مجوزدهی که از اشتراک‌های پرداختی تا مجوز ارزیابی موقت متغیر است، این ابزار را به انتخابی مطمئن برای پروژه‌های سازمانی و سرگرمی تبدیل می‌کند. شروع به ادغام نمونه‌های کد بالا کنید، با تنظیمات پیکربندی آزمایش کنید و از تبدیل سریع و قابل اعتماد CSV به JSON در برنامه‌های جاوای خود لذت ببرید.

FAQs

چگونه می‌توانم تبدیل CSV به JSON را در جاوا با Aspose.BarCode انجام دهم؟
از SDK برای بارگذاری CSV در ذخیره‌سازی ابری استفاده کنید، فایل را با Java I/O به‌صورت جریان (stream) بخوانید، هر ردیف را به یک JSONObject تبدیل کنید و JSON حاصل را دوباره به ذخیره‌سازی بارگذاری کنید. مثال کامل کد در این مقاله فرآیند را نشان می‌دهد.

آیا می‌توانم فایل‌های CSV بزرگ را به‌صورت کارآمد پردازش کنم؟
بله. SDK از تبدیل چندنخی پشتیبانی می‌کند. با تقسیم CSV به بخش‌های کوچک و پردازش آن‌ها به‌صورت موازی، سرعت‑ups قابل‌توجهی به دست می‌آید، همان‌طور که در بخش «تبدیل چندنخی CSV به JSON در جاوا» توضیح داده شده است.

کجا می‌توانم مرجع API برای عملیات ذخیره‌سازی را پیدا کنم؟
تمام نقاط انتهایی مربوط به ذخیره‌سازی در مرجع رسمی API فهرست شده‌اند. به دنبال متدهایی مانند UploadFile، DownloadFile و DeleteFile بگردید.

چه گزینه‌های مجوزی برای Aspose.BarCode Cloud SDK for Java موجود است؟
شما می‌توانید یک مجوز تجاری را از صفحه قیمت‌گذاری خریداری کنید، و یک مجوز موقت برای ارزیابی در صفحه مجوز موقت موجود است. هر دو گزینه دسترسی کامل به ویژگی‌های SDK را فراهم می‌کنند.

مراحل تبدیل CSV به JSON در جاوا#

پیاده‌سازی Java CSV به JSON - مثال کامل کد#

پردازش CSV مبتنی بر ابر با استفاده از cURL#

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

درک جریان کار CSV به JSON در جاوا#

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

پیکربندی گزینه‌های تبدیل برای CSV به JSON#

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

بهترین شیوه‌ها برای تبدیل CSV به JSON در جاوا#

نتیجه‌گیری#

FAQs#

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