Introducere

Aspose.Cells FOSS for Java este o bibliotecă open-source Java 17 care permite dezvoltatorilor
să creeze, să încarce, să modifice și să salveze registre de lucru Excel .xlsx în totalitate pe JVM — fără
instalare Microsoft Office, fără biblioteci native și fără dependență comercială de runtime Aspose. API-ul public se află în pachetul com.aspose.cells_foss și este
publicat sub licența MIT, făcându-l potrivit pentru proiecte personale, open-source și
comerciale deopotrivă.

Biblioteca este livrată ca un artefact Maven standard și acoperă modelul de obiecte de bază al foilor de calcul OOXML: registre de lucru, foi de lucru, celule, stiluri și colecții. Este construită cu Maven 3.9+ și vizează Java 17+, integrându-se natural în orice flux de construcție modern Java.

Adăugați dependența la pom.xml și sunteți gata să generați sau să procesați cărți de lucru Excel dintr-un servlet, un job în lot, o funcție Lambda sau orice alt context server-side Java.

Caracteristici principale

Gestionarea registrului de lucru și a foii de lucru

Clasa Workbook este punctul de intrare pentru toate operațiunile cu foi de calcul.
Implementează
AutoCloseable astfel încât să se integreze curat cu modelul try‑with‑resources.
Puteți
crea noi registre de lucru, încărca fișiere .xlsx existente, adăuga și elimina foi de lucru, redenumi
foile cu setName(), seta foaia activă și controla vizibilitatea filelor.

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");
}

Valori de celule și formule

Clasa Cell suportă stocarea de valori tipizate prin putValue() pentru șiruri, întregi, numere double, valori booleene și valori LocalDateTime. Șirurile de formulă sunt stocate cu setFormula() și vor fi recalculate de Excel la deschidere. Tipul valorii este expus prin CellValueType — STRING, NUMBER, BOOLEAN, DATE_TIME sau 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");
}

Formatarea celulelor și stiluri

Formatarea este aplicată prin clasa Style, preluată din cell.getStyle() și scrisă înapoi cu cell.setStyle(). Poți configura îngroșarea și culoarea pe Font, aplica HorizontalAlignment și seta șiruri de format numeric personalizate prin style.setCustom(). Înălțimea rândului și lățimea coloanei sunt controlate prin getRows().get(n).setHeight() și 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");
}

Validarea datelor și formatarea condițională

Regulile de validare a datelor sunt adăugate prin sheet.getValidations().add(). Fiecare obiect Validation conține un ValidationType (de exemplu, WHOLE_NUMBER), un OperatorType (de exemplu, BETWEEN) și șiruri de formule pentru limite. Formatarea condițională este adăugată prin sheet.getConditionalFormattings().add(), care returnează un FormatConditionCollection în care specificați intervalele de celule și condițiile.

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");
}

Filtre automate și Configurare pagină

Filtrele automate sunt configurate prin apelarea ws.getAutoFilter().setRange() cu un șir de interval în notație
A1. Obiectul PageSetup controlează dimensiunea hârtiei, orientarea și setările de potrivire la pagină
pentru ieșirea pregătită pentru tipărire. Protecția foii de lucru se aplică prin protect() cu
un WorksheetProtectionModel.

Start rapid

Adăugați dependența Maven în pom.xml:

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>cells-foss</artifactId>
  <version>1.0.0</version>
</dependency>

Creează un registru de lucru, populează celulele, aplică formatarea și salvează:

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");
        }
    }
}

Formate acceptate

FormatExtensieCitireScriere
Excel Open XML.xlsx✓✓

Salvarea este în prezent limitată la .xlsx. Biblioteca stochează și transferă formulele, dar nu este un motor complet de calcul pentru foi de calcul.

Open Source și Licențiere

Aspose.Cells FOSS pentru Java este lansat sub licența MIT. Sunteți liber să îl utilizați, modificați și distribuiți în proiecte personale, open-source și comerciale fără restricții. Codul sursă este disponibil la github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Java.

Începeți