مقدمة

Aspose.Cells FOSS for Java is an open-source Java 17 library that enables developers لإنشاء وتحميل وتعديل وحفظ Excel .xlsx كتب العمل بالكامل على JVM مع لا يوجد تثبيت Microsoft Office، ولا مكتبات محلية، و لا وقت تشغيل Aspose التجاري. التبعية. API العامة تعيش تحت إطار com.aspose.cells_foss الحزمة و هو تم إصداره تحت ترخيص MIT، مما يجعله مناسبًا للشخصية والمصدر المفتوح، و المشروعات التجارية على حد سواء.

يتم شحن المكتبة كصنع معياري من Maven وتغطي نموذج الكائنات الأساسية لمخططات البيانات OOXML: كتب العمل وأوراق عمل وخلايا وأنماط وجمعيات. وهي مبنية مع مافين 3.9 + وتهدف إلى Java 17 + ، والتكامل بشكل طبيعي في أي خط أنابيب بناء جاوا الحديثة.

أضف الاعتماد إلى pom.xml و انت جاهز لتوليد او معالجة Excel كتب العمل من servlet، وظيفة مجموعة، لوظيفة Lambda، أو أي جانب خادم Java آخر السياق.

الميزات الرئيسية

ورقة العمل وإدارة ورشة العمل

المجلس الوزاري Workbook الطبقة هي نقطة الدخول لجميع عمليات الجدول. إنها تنفذ AutoCloseable لذا فإنه يتكامل بشكل نظيف مع نمط محاولة الموارد. يمكنك خلق كتب عمل جديدة، تحميل موجودة .xlsx الملفات، إضافة وإزالة ورق العمل، تغيير الاسم ورق مع setName(),، وضعت ورقة النشاط، وتحكم مرئية علامة التبويب.

import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;
import com.aspose.cells_foss.WorksheetCollection;

try (Workbook workbook = new Workbook()) {
    WorksheetCollection sheets = workbook.getWorksheets();
    Worksheet sheet = sheets.get(0);
    sheet.setName("Sales");
    workbook.save("sales.xlsx");
}

قيمة الخلايا والصيغ

المجلس الوزاري Cell الدروس تدعم تخزين القيمة النوعية عبر: putValue() للسلسلات، الأعداد الصحيحة., المضاعفات، والبوليانات، و LocalDateTime يتم تخزين سلسلة الصيغ مع setFormula() وسيتم إعادة حسابها بواسطة Excel على مفتوح. يتم عرض نوع القيمة من خلال CellValueType — STRING, NUMBER, BOOLEAN, DATE_TIME,أو ، FORMULA.

import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;

try (Workbook workbook = new Workbook()) {
    WorksheetCollection sheets = workbook.getWorksheets();
    Worksheet sheet = sheets.get(0);
    Cell a1 = sheet.getCells().get("A1");
    a1.putValue("Revenue");
    Cell b1 = sheet.getCells().get("B1");
    b1.putValue(12500.75);
    Cell c1 = sheet.getCells().get("C1");
    c1.setFormula("=B1*1.2");
    workbook.save("values.xlsx");
}

تصميم الخلايا والأساليب

يتم تطبيق التنسيق من خلال Style الطبقة، استعادة من cell.getStyle() و مكتوب مرة أخرى مع cell.setStyle().يمكنك تهيئة اللون والشكل المميز على الشاشة. Font, تطبيق HorizontalAlignment,، ووضع سلاسل شكل رقم مخصصة عبر style.setCustom(). يتم التحكم في ارتفاع الصف وعرض العمود من خلال getRows().get(n).setHeight() و getColumns().get(n).setWidth().

import com.aspose.cells_foss.Style;
import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;

try (Workbook workbook = new Workbook()) {
    WorksheetCollection sheets = workbook.getWorksheets();
    Worksheet sheet = sheets.get(0);
    Cell cell = sheet.getCells().get("B1");
    cell.putValue(9999.5);
    Style style = cell.getStyle();
    style.getFont().setBold(true);
    style.setCustom("#,##0.00");
    cell.setStyle(style);
    workbook.save("styled.xlsx");
}

التحقق من صحة البيانات وتشكيل المشروط

يتم إضافة قواعد التحقق من صحة البيانات عبر: sheet.getValidations().add().كل واحد منهم Validation الكائن يحمل a ValidationType (مثل،., WHOLE_NUMBER), و OperatorType (مثل،., BETWEEN), وسلسلاً صيغية للحدود. تم إضافة التنسيق المشروط من خلال sheet.getConditionalFormattings().add(),، والذي يعيد a FormatConditionCollection حيث تقوم بتحديد نطاقات الخلايا والظروف.

import com.aspose.cells_foss.CellArea;
import com.aspose.cells_foss.Validation;
import com.aspose.cells_foss.ValidationType;
import com.aspose.cells_foss.OperatorType;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;

try (Workbook workbook = new Workbook()) {
    WorksheetCollection sheets = workbook.getWorksheets();
    Worksheet sheet = sheets.get(0);
    int vi = sheet.getValidations().add(new CellArea(1, 0, 10, 0));
    Validation validation = sheet.getValidations().get(vi);
    validation.setType(ValidationType.WHOLE_NUMBER);
    validation.setOperator(OperatorType.BETWEEN);
    validation.setFormula1("1");
    validation.setFormula2("100");
    workbook.save("validated.xlsx");
}

المرشحات التلقائية وإعداد الصفحة

يتم تكوين AutoFilters عن طريق استدعاء ws.getAutoFilter().setRange() مع علامة A1 سلسلة المدى. PageSetup التحكم في حجم الورق، التوجه، والانتماء إلى الصفحة إعدادات للخروج جاهز للطباعة. يتم تطبيق حماية ورقة العمل من خلال protect() مع أ . WorksheetProtectionModel.

بدء سريع

أضف اعتماد مافين التالي إلى حسابك. pom.xml لتضمين Aspose. الخلايا FOSS لـ Java في مشروعك:

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

إنشاء دفتر عمل، ملء الخلايا، تطبيق التنسيق، وحفظ:

import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.Style;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;

public class QuickStart {
    public static void main(String[] args) {
        try (Workbook workbook = new Workbook()) {
            WorksheetCollection sheets = workbook.getWorksheets();
            Worksheet sheet = sheets.get(0);
            sheet.setName("Report");

            sheet.getCells().get("A1").putValue("Revenue");
            Cell cell = sheet.getCells().get("B1");
            cell.putValue(12500.75);

            Style style = cell.getStyle();
            style.getFont().setBold(true);
            style.setCustom("#,##0.00");
            cell.setStyle(style);

            sheet.getCells().getRows().get(0).setHeight(22.0);
            sheet.getCells().getColumns().get(1).setWidth(14.5);

            workbook.save("report.xlsx");
        }
    }
}

تنسيقات مدعومة

شكلتمديداقرأاكتب
إكسيل افتح XML.xlsx✓✓

الحفاظ على حالياً محدود إلى .xlsx.المكتبات والمتاجر والرحلات الجارية،, لكنه ليس محرك حسابات كاملة.

المصدر المفتوح و الترخيص

Aspose.Cells FOSS for Java is released under the MIT license. You are free to use, تعديل وتوزيعها في المشاريع الشخصية والمفتوحة المصدر والتجارية دون يمكن الاطلاع على الكود المصدر في: github.com/aspose-cells-foss/Aspose.Cells - FOSS-لـJava.

بدءاً من

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