مقدمة

Aspose.Cells FOSS for Java is a pure-Java 17, MIT-licensed library for creating و التلاعب بـ Excel .xlsx كتيبات العمل بدون أي اعتماد على Microsoft Office. هذا المقال يمر عبر العمليات الأكثر شيوعا لإدارة جداول البيانات: إنشاء كتب العمل، تحميل الملفات، العمل مع الخلايا، وحفظ النتائج.

بدء سريع

أضف إعتماد (مافين) إلى حسابك. pom.xml للبدء:

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-cells-foss</artifactId>
  <version>26.5.0</version>
</dependency>

لا حاجة إلى ملف ترخيص أو مفتاح API. المكتبة مفتوحة المصدر بالكامل تحت MIT .

إنشاء دفتر عمل

المجلس الوزاري Workbook() يقوم constructor بإنشاء دفتر عمل جديد فارغ مع ورقة افتراضية واحدة:

import com.aspose.cells.foss.Workbook;
import com.aspose.cells.foss.Worksheet;

Workbook workbook = new Workbook();
WorksheetCollection sheets = workbook.getWorksheets();
Worksheet sheet = sheets.get(0);
System.out.println(sheet.getName()); // Sheet1

استخدام WorksheetCollection.add(sheetName) لإضافة الصفحات المسمية و removeAt(sheetName) لإزالتها:

int idx = workbook.getWorksheets().add("Report");
workbook.getWorksheets().get(idx).setName("Report");
workbook.getWorksheets().removeAt("Sheet1");

تحميل ملف موجود

إعطاء مسار ملف إلى … Workbook(fileName) لفتح شركة موجودة .xlsx دفتر العمل:

Workbook workbook = new Workbook("data/report.xlsx");
System.out.println("Sheets: " + workbook.getWorksheets().getCount());

بالنسبة لبرامج الإدخال (مثل من قاعدة بيانات أو استجابة HTTP) ، استخدم: Workbook(stream):

try (java.io.InputStream is = new java.io.FileInputStream("data/report.xlsx")) {
    Workbook workbook = new Workbook(is);
}

قراءة و كتابة الخلايا

Worksheet.getCells() يعيد المعلومات Cells الوصول إلى الخلايا الفردية عن طريق: اسم أو عن طريق مؤشر الصفوف/الصفوف المستند إلى صفر:

import com.aspose.cells.foss.Cells;
import com.aspose.cells.foss.Cell;

WorksheetCollection sheets = workbook.getWorksheets();
Cells cells = sheets.get(0).getCells();

// Write by cell name
cells.get("A1").putValue("Product");
cells.get("B1").putValue("Revenue");

// Write by row/column index
cells.get(1, 0).putValue("Widget A");   // A2
cells.get(1, 1).putValue(45000);        // B2

// Read back
String name = cells.get("A2").getStringValue();
Object rev  = cells.get("B2").getValue();
System.out.println(name + ": " + rev);

وضع الصيغ

استخدام Cell.setFormula() لتخزين سلسلة صيغ في خلية. يتم تقييم الصيغة عند حفظ وكتاب العمل وإعادة تحميله:

cells.get("B3").setFormula("=SUM(B2:B2)");
System.out.println(cells.get("B3").getFormula()); // =SUM(B2:B2)

يتم حل نتائج الصيغة عند حفظ وكتاب العمل وإعادة تحميله.

حفظ دفتر العمل

Workbook.save(fileName) يكتب دفتر العمل، يتم تحديد الشكل بواسطة الملف. تمديد الملف (.xlsx ينتج ملف Excel 2007+):

workbook.save("output/result.xlsx");

دائماً لف الكتب في محاولة مع الموارد لإطلاق الملفات على الفور:

try (Workbook workbook = new Workbook("data/input.xlsx")) {
    workbook.getWorksheets().get(0).getCells().get("A1").putValue("Updated");
    workbook.save("data/output.xlsx");
}

ما الذي ستكتشفه بعد ذلك؟

Aspose.Cells FOSS for Java includes APIs for worksheet-level operations beyond cell manipulation:

  • حماية ورقة العمل: protect() / unprotect() في Worksheet
  • AutoFilter: Worksheet.getAutoFilter() للفلترات البرمجة للبيانات
  • أنماط الخلية: Cell.getStyle() / setStyle() مع Style الممتلكات
  • الخلايا المدمجة: Cells.merge(firstRow, firstColumn, totalRows, totalColumns)

لمعرفة كامل API، انظر المقالة التالية: دليل المطورين و المادة الثانية: مرجع API.

بدءاً من

تغطي الأمثلة أعلاه أكثر مهام إدارة جداول البيانات شيوعًا في Aspose. الخلايا FOSS لـ Java. للحصول على نموذج API كامل بما في ذلك التحقق من صحة ، والرسوم البيانيّة، وتشكيل الملفات، انظر: دليل المطورين.

الموارد ذات الصلة