Introduksjon

Aspose.Cells FOSS for Java tilbyr et omfattende sett med regnearkfunksjoner
for Java 17-applikasjoner. Utgitt under MIT‑lisensen og distribuert som en
standard Maven‑artifakt, dekker biblioteket alt fra grunnleggende opprettelse av arbeidsbok
gjennom typede celleverdier, rik formatering, datavalidering og AutoFilter — alt
uten en Microsoft Office‑avhengighet.

Dette innlegget går gjennom hovedfunksjonsområdene med fokuserte kodeeksempler hentet fra
den verifiserte API‑overflaten. Alle klasse‑ og metodenavn som vises nedenfor finnes i biblioteket
og er tilgjengelige i versjon 1.0.0.

Nøkkelfunksjoner

Arbeidsbok- og regnearkadministrasjon

Workbook-klassen implementerer AutoCloseable slik at den integreres sømløst med
Java try-with-resources-mønsteret.
Du kan opprette en tom arbeidsbok, laste inn en eksisterende
.xlsx-fil, gi regneark nye navn, legge til eller fjerne ark, angi det aktive arket, og
kontrollere fanens synlighet.

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

try (Workbook workbook = new Workbook()) {
    Worksheet sheet = workbook.getWorksheets().get(0);
    sheet.setName("Q1 Report");
    workbook.getWorksheets().addSheet("Summary");
    workbook.save("report.xlsx");
}

Skrivne celleverdier og formler

Cell‑klassen godtar typede verdier via putValue() for String, int, double, boolean og LocalDateTime. getType()‑metoden returnerer en CellValueType‑enumverdi — STRING, NUMBER, BOOLEAN, DATE_TIME eller FORMULA — noe som gjør det enkelt å forgreine seg på verditypen uten å parse strenger. Formelstrenger lagres med setFormula() og vil bli rekalkulert av Excel ved åpning.

import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.CellValueType;
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(42500.00);
    Cell c1 = sheet.getCells().get("C1");
    c1.setFormula("=B1*1.2");
    // Check type
    assert b1.getType() == CellValueType.NUMBER;
    assert c1.getType() == CellValueType.FORMULA;
    workbook.save("values.xlsx");
}

Celleformatering og stiler

Formatering brukes gjennom Style‑objektet som hentes fra cell.getStyle() og skrives tilbake med cell.setStyle(). Font‑underobjektet eksponerer setBold() og setColor(). HorizontalAlignment styrer tekstjustering — LEFT, CENTER eller RIGHT. Tilpassede tallformater bruker Excel‑formatstrenger via style.setCustom(). Radhøyde og kolonnebredde justeres gjennom getRows().get(n).setHeight() og getColumns().get(n).setWidth().

import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.Style;
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.50);
    Style style = cell.getStyle();
    style.getFont().setBold(true);
    style.setCustom("#,##0.00");
    cell.setStyle(style);
    sheet.getCells().getRows().get(0).setHeight(24.0);
    sheet.getCells().getColumns().get(1).setWidth(16.0);
    workbook.save("styled.xlsx");
}

Datavalidering

Datavalideringsregler legges til gjennom sheet.getValidations().add(). Hvert Validation‑objekt tar en ValidationType (f.eks. WHOLE_NUMBER, DECIMAL, LIST) og en OperatorType (f.eks. BETWEEN, GREATER_THAN). Formelgrenser lagres som strenger via setFormula1() og setFormula2().

import com.aspose.cells_foss.CellArea;
import com.aspose.cells_foss.OperatorType;
import com.aspose.cells_foss.Validation;
import com.aspose.cells_foss.ValidationType;
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");
}

AutoFilter

AutoFilters lar sluttbrukere filtrere data i Excel interaktivt uten ekstra
konfigurasjon. Kall ws.getAutoFilter().setRange() med et A1-notasjonsområde for å
aktivere filterets overskriftsrad. Ytterligere filterkolonner og egendefinerte kriterier kan
defineres gjennom FilterColumn og AutoFilterCustomFilter.

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

try (Workbook workbook = new Workbook()) {
    Worksheet sheet = workbook.getWorksheets().get(0);
    sheet.getCells().get("A1").putValue("Product");
    sheet.getCells().get("B1").putValue("Qty");
    sheet.getAutoFilter().setRange("A1:B1");
    workbook.save("filtered.xlsx");
}

Sideoppsett og regnearkbeskyttelse

PageSetup-klassen styrer papirstørrelse, sideorientering og innstillinger for tilpasning til siden for utskriftsklar output. Arbeidsarkbeskyttelse brukes via protect() med en WorksheetProtectionModel, som gjør at spesifikke celler kan forbli redigerbare mens resten låses. Hyperkoblinger håndteres via HyperlinkCollection.

Rask start

Legg til avhengigheten i din pom.xml:

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

Lag en arbeidsbok med alle hovedfunksjonene på under 20 linjer:

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("Sales");
            sheet.getCells().get("A1").putValue("Revenue");
            Cell b1 = sheet.getCells().get("B1");
            b1.putValue(42500.00);
            Style style = b1.getStyle();
            style.getFont().setBold(true);
            style.setCustom("#,##0.00");
            b1.setStyle(style);
            sheet.getAutoFilter().setRange("A1:B1");
            workbook.save("sales.xlsx");
        }
    }
}

Støttede formater

FormatFiltypeLeseSkrive
Excel Open XML.xlsx✓✓

Lagring er for øyeblikket begrenset til .xlsx. Biblioteket lagrer og overfører formler, men fungerer ikke som en full regnearkberegningsmotor.

Open Source og lisensiering

Aspose.Cells FOSS for Java er utgitt under MIT‑lisensen. Du er fri til å bruke, endre og distribuere den i personlige, åpen kildekode‑ og kommersielle prosjekter uten restriksjoner. Kildekoden er tilgjengelig på github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Java.

Kom i gang