دمج جداول PDF مع مصادر البيانات في Java

مثال Java يبني جداول PDF من بيانات CSV دون الاعتماد على مكتبات إطارات البيانات الخارجية.

إنشاء جدول من صفوف CSV

استخدم هذا المثال عندما يجب تحويل أعمدة CSV المختارة إلى جدول PDF منسق.

1. أنشئ كائنًا من الفئة Table واضبط حدوده.
2. اكتشف فهارس الأعمدة المطلوبة من صف رأس ملف CSV.
3. أضف صف الرأس وعدد الصفوف المطلوبة من البيانات، ثم أرجع الجدول.

public static Table createTableFromCsv(List<String[]> rows, int maxRows) {
    Table table = new Table();
    table.setBorder(new BorderInfo(BorderSide.All, 1, Color.getLightGray()));
    table.setDefaultCellBorder(new BorderInfo(BorderSide.Bottom, 1, Color.getLightGray()));

    String[] header = rows.get(0);
    int[] selectedColumns = findColumns(header, "city", "country", "population", "iso3");

    Row headerRow = table.getRows().add();
    headerRow.setRowBroken(false);
    for (int columnIndex : selectedColumns) {
        Cell cell = headerRow.getCells().add(header[columnIndex]);
        cell.setBackgroundColor(Color.getLightGray());
    }

    int limit = Math.min(maxRows, rows.size() - 1);
    for (int rowIndex = 1; rowIndex <= limit; rowIndex++) {
        Row row = table.getRows().add();
        String[] rowData = rows.get(rowIndex);
        for (int columnIndex : selectedColumns) {
            row.getCells().add(columnIndex < rowData.length ? rowData[columnIndex] : "");
        }
    }

    return table;
}

إنشاء ملف PDF من بيانات CSV

استخدم هذا المثال عندما يجب عرض مدخلات CSV كوثيقة جدول PDF.

1. اقرأ صفوف CSV من ملف الإدخال.
2. معاينة مجموعة فرعية من الصفوف التي تم تحليلها في وحدة التحكم.
3. أنشئ ملف PDF Document، أضف الجدول المُنشأ، واحفظ ملف الإخراج.

public static void createPdfFromCsv(Path inputFile, Path outputFile, int maxRows) throws Exception {
    List<String[]> rows = readCsv(inputFile);
    for (int i = 0; i < Math.min(20, rows.size()); i++) {
        System.out.println(String.join(" | ", rows.get(i)));
    }

    try (Document document = new Document()) {
        Page page = document.getPages().add();
        page.getParagraphs().add(createTableFromCsv(rows, maxRows));
        document.save(outputFile.toString());
    }
}

ابحث عن فهارس أعمدة CSV بالاسم

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

1. مرّ على أسماء الأعمدة المطلوبة.
2. ابحث في صف الرأس عن الفهارس المطابقة.
3. أرجع مواضع الأعمدة المجموعة.

private static int[] findColumns(String[] header, String... names) {
    int[] indexes = new int[names.length];
    for (int i = 0; i < names.length; i++) {
        indexes[i] = 0;
        for (int j = 0; j < header.length; j++) {
            if (names[i].equals(header[j])) {
                indexes[i] = j;
                break;
            }
        }
    }
    return indexes;
}

قراءة صفوف CSV من ملف

استخدم هذا المُساعد عندما يجب تحميل مصدر CSV في الذاكرة قبل إنشاء الجدول.

1. اقرأ جميع السطور من ملف الإدخال.
2. قسّم كل سطر باستخدام أداة مساعد محلل CSV..
3. أرجع القيم المجمعة للصفوف.

private static List<String[]> readCsv(Path inputFile) throws Exception {
    List<String[]> rows = new ArrayList<>();
    for (String line : Files.readAllLines(inputFile)) {
        rows.add(splitCsvLine(line));
    }
    return rows;
}

قسّم سطر CSV واحد إلى القيم

استخدم هذه الدالة المساعدة عندما قد يحتوي صف CSV على قيم محاطة بعلامات اقتباس وحروف اقتباس مهربة.

1. تكرّر عبر الأحرف في السطر.
2. تتبّع ما إذا كان المُحلِّل حالياً داخل نص محاط بعلامات اقتباس.
3. أنشئ قائمة القيم النهائية وأعدها كمصفوفة.

private static String[] splitCsvLine(String line) {
    List<String> values = new ArrayList<>();
    StringBuilder current = new StringBuilder();
    boolean inQuotes = false;
    for (int i = 0; i < line.length(); i++) {
        char ch = line.charAt(i);
        if (ch == '"') {
            if (inQuotes && i + 1 < line.length() && line.charAt(i + 1) == '"') {
                current.append('"');
                i++;
            } else {
                inQuotes = !inQuotes;
            }
        } else if (ch == ',' && !inQuotes) {
            values.add(current.toString());
            current.setLength(0);
        } else {
            current.append(ch);
        }
    }
    values.add(current.toString());
    return values.toArray(String[]::new);
}