מבוא

Aspose.Cells FOSS for Java הוא ספרייה קוד פתוח Java 17 המאפשרת למפתחים
ליצור, לטעון, לשנות ולשמור חוברות Excel .xlsx במלואן על ה‑JVM — ללא
התקנת Microsoft Office, ללא ספריות מקומיות, וללא תלות בזמן ריצה מסחרי של Aspose
. ה‑API הציבורי נמצא תחת החבילה com.aspose.cells_foss והוא
משוחרר תחת רישיון MIT, מה שהופך אותו מתאים לפרויקטים אישיים, קוד פתוח,
ופרויקטים מסחריים כאחד.

הספרייה נשלחת כארטיפקט Maven סטנדרטי ומכסה את מודל האובייקטים הליבה של גיליון האלקטרוני OOXML: חוברות עבודה, גיליונות עבודה, תאים, סגנונות ואוספים. היא נבנית עם Maven 3.9+ ומיועדת ל‑Java 17+, ומשתלבת באופן טבעי בכל צינור בנייה מודרני של Java.

הוסף את התלות לpom.xml ואתה מוכן ליצור או לעבד חוברות Excel מ‑servlet, משימת batch, פונקציית Lambda, או כל הקשר צד‑שרת של Java.

תכונות מרכזיות

ניהול חוברת עבודה וגליון עבודה

המחלקה Workbook היא נקודת הכניסה לכל פעולות הגיליון האלקטרוני. היא מממשת
AutoCloseable ולכן משתלבת בצורה נקייה עם תבנית try-with-resources. אתה יכול
ליצור חוברות עבודה חדשות, לטעון קבצי .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()) {
    Worksheet sheet = workbook.getWorksheets().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()) {
    Worksheet sheet = workbook.getWorksheets().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 אובייקט מכיל ValidationType (למשל, WHOLE_NUMBER), OperatorType
(למשל, BETWEEN), ומחרוזות נוסחה עבור הגבולות. עיצוב מותנה מתווסף
דרך sheet.getConditionalFormattings().add(), שמחזיר 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()) {
    Worksheet sheet = workbook.getWorksheets().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 והגדרת עמוד

AutoFilters מוגדרים על ידי קריאה לws.getAutoFilter().setRange() עם מחרוזת טווח בתצורת A1. העצם PageSetup שולט בגודל הנייר, בכיוון ובהגדרות התאמה לעמוד עבור פלט מוכן להדפסה. הגנת הגיליון מוחלת דרך protect() עם WorksheetProtectionModel.

התחלה מהירה

הוסף את תלות Maven ל-pom.xml:

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>cells-foss</artifactId>
  <version>1.0.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()) {
            Worksheet sheet = workbook.getWorksheets().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");
        }
    }
}

פורמטים נתמכים

פורמטהרחבהקריאהכתיבה
Excel Open XML.xlsx✓✓

השמירה מוגבלת כרגע ל.xlsx. הספרייה מאחסנת ומעבירה נוסחאות, אך היא איננה מנוע חישוב גיליון אלקטרוני מלא.

קוד פתוח ורישוי

Aspose.Cells FOSS for Java משוחרר תחת רישיון MIT. אתה חופשי להשתמש, לשנות ולהפיץ אותו בפרויקטים אישיים, קוד פתוח ומסחריים ללא הגבלה. קוד המקור זמין ב github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Java.

התחלה