Introduktion

Aspose.Cells FOSS for Java er et open‑source Java 17‑bibliotek, der gør det muligt for udviklere at oprette, indlæse, ændre og gemme Excel .xlsx arbejdsbøger helt på JVM — uden Microsoft Office‑installation, uden native‑biblioteker og uden kommerciel Aspose‑runtime‑afhængighed. Det offentlige API lever under com.aspose.cells_foss‑pakken og udgives under MIT‑licensen, hvilket gør det egnet til personlige, open‑source og kommercielle projekter.

Biblioteket leveres som en standard Maven-artifact og dækker den grundlæggende OOXML-regnearksobjektmodel: arbejdsbøger, regneark, celler, stilarter og samlinger. Det er bygget med Maven 3.9+ og har som mål Java 17+, hvilket integreres naturligt i enhver moderne Java‑build‑pipeline.

Tilføj afhængigheden til din pom.xml, og du er klar til at generere eller behandle Excel‑arbejdsbøger
fra en servlet, et batch‑job, en Lambda-funktion eller enhver anden Java server‑side
kontekst.

Nøglefunktioner

Projektmappe- og regnearksstyring

Klassen Workbook er indgangspunktet for alle regnearksoperationer. Den implementerer
AutoCloseable, så den integreres problemfrit med try-with-resources-mønsteret. Du kan
oprette nye arbejdsbøger, indlæse eksisterende .xlsx‑filer, tilføje og fjerne regneark, omdøbe
ark med setName(), indstille det aktive ark og kontrollere fanens synlighed.

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

Celleværdier og formler

Klassen Cell understøtter typet værdilagring via putValue() for strenge, heltal, dobbelte, boolske og LocalDateTime-værdier. Formelstrenge gemmes med setFormula() og vil blive genberegnet af Excel ved åbning. Værditypen eksponeres gennem CellValueType — STRING, NUMBER, BOOLEAN, DATE_TIME eller 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");
}

Celleformatering og stilarter

Formatering anvendes gennem Style-klassen, hentet fra cell.getStyle() og skrevet tilbage med cell.setStyle(). Du kan konfigurere fed og farve på Font, anvende HorizontalAlignment og indstille brugerdefinerede talformatstrenge via style.setCustom(). Rækkehøjde og kolonnebredde styres gennem getRows().get(n).setHeight() og 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");
}

Datavalidering og betinget formatering

Data valideringsregler tilføjes gennem sheet.getValidations().add(). Hvert Validation‑objekt indeholder en ValidationType (f.eks. WHOLE_NUMBER), en OperatorType (f.eks. BETWEEN) og formelstrenge for grænserne. Betinget formatering tilføjes gennem sheet.getConditionalFormattings().add(), som returnerer en FormatConditionCollection, hvor du specificerer celleområder og betingelser.

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

Autofiltre og sideopsætning

AutoFilters konfigureres ved at kalde ws.getAutoFilter().setRange() med en A1‑notation område‑streng. PageSetup‑objektet styrer papirstørrelse, orientering og tilpas‑til‑side‑indstillinger for udskriftsklar output. Arkbeskyttelse anvendes gennem protect() med en WorksheetProtectionModel.

Hurtig start

Tilføj Maven‑afhængigheden til din pom.xml:

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

Opret en projektmappe, udfyld celler, anvend formatering og gem:

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

Understøttede formater

FormatUdvidelseLæsSkriv
Excel Open XML.xlsx✓✓

Gemning er i øjeblikket begrænset til .xlsx. Biblioteket gemmer og videresender formler, men det er ikke en fuld regnearksberegningsmotor.

Open Source & Licensering

Aspose.Cells FOSS for Java er udgivet under MIT-licensen. Du er fri til at bruge, ændre og distribuere den i personlige, open-source og kommercielle projekter uden begrænsning. Kildekoden er tilgængelig på github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Java.

Kom i gang