Johdanto

Aspose.Cells FOSS for Java on avoimen lähdekoodin Java 17 -kirjasto, joka mahdollistaa kehittäjille Excel .xlsx -työkirjojen luomisen, lataamisen, muokkaamisen ja tallentamisen täysin JVM:ssä — ilman Microsoft Office -asennusta, ilman natiivikirjastoja ja ilman kaupallista Aspose‑ajonaikaisia riippuvuutta. Julkinen API sijaitsee com.aspose.cells_foss -paketissa ja se on julkaistu MIT‑lisenssin alla, mikä tekee siitä sopivan henkilökohtaisiin, avoimen lähdekoodin ja kaupallisiin projekteihin.

Kirjasto toimitetaan standardina Maven‑artifactina ja kattaa OOXML‑taulukkolaskennan ydinobjektimallin: työkirjat, taulukot, solut, tyylit ja kokoelmat. Se on rakennettu Maven 3.9+:lla ja kohdistuu Java 17+:een, integroituen luonnollisesti mihin tahansa moderniin Java‑rakennusputkeen.

Lisää riippuvuus pom.xml:si ja olet valmis luomaan tai käsittelemään Excel‑työkirjoja servletistä, eräajosta, Lambda‑funktiosta tai mistä tahansa muusta Java‑palvelinpuolen kontekstista.

Keskeiset ominaisuudet

Työkirjan ja Työarkin Hallinta

Workbook-luokka on sisäänkäynti kaikille taulukkolaskentaoperaatioille. Se toteuttaa
AutoCloseable, joten se integroidaan sujuvasti try-with-resources-malliin. Voit
luoda uusia työkirjoja, ladata olemassa olevia .xlsx‑tiedostoja, lisätä ja poistaa työkirjan taulukoita, nimetä taulukoita uudelleen
setName()‑toiminnolla, asettaa aktiivisen taulukon ja hallita välilehtien näkyvyyttä.

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

Soluarvot ja kaavat

Cell-luokka tukee tyypitettyä arvon tallennusta putValue():n kautta merkkijonoille, kokonaisluvuille, kaksoistarkkuuslukuja, totuusarvoille ja LocalDateTime-arvoille. Kaavamerkkijonot tallennetaan setFormula():lla ja Excel laskee ne uudelleen avattaessa. Arvon tyyppi on näkyvissä CellValueType — STRING, NUMBER, BOOLEAN, DATE_TIME tai 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");
}

Solun muotoilu ja tyylit

Muotoilu toteutetaan Style-luokan kautta, haetaan cell.getStyle():sta ja kirjoitetaan takaisin cell.setStyle():lla. Voit määrittää lihavoinnin ja värin Font:ssä, käyttää HorizontalAlignment:ta ja asettaa mukautetut numeromuotoketjut style.setCustom():n kautta. Rivikorkeus ja sarakeleveys ohjataan getRows().get(n).setHeight():n ja getColumns().get(n).setWidth():n avulla.

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

Tietojen vahvistus ja ehdollinen muotoilu

Data validation -säännöt lisätään sheet.getValidations().add():n kautta. Jokainen Validation-objekti sisältää ValidationType-kohdan (esim. WHOLE_NUMBER), OperatorType-kohdan (esim. BETWEEN) ja kaavarivit rajoille. Ehdollinen muotoilu lisätään sheet.getConditionalFormattings().add():n kautta, joka palauttaa FormatConditionCollection-objektin, jossa määrität soluvälit ja ehdot.

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

Autosuodattimet ja sivun asetukset

Autosuodattimet määritetään kutsumalla ws.getAutoFilter().setRange() A1-notaatiota käyttävällä alueen merkkijonolla. PageSetup‑objekti hallitsee paperikokoa, suuntausta ja sivulle sovittamisen asetuksia tulostusvalmiille tulosteelle. Työkirjan suojaus otetaan käyttöön protect()‑menetelmällä WorksheetProtectionModel avulla.

Pika-aloitus

Lisää Maven‑riippuvuus pom.xml‑tiedostoon:

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

Luo työkirja, täytä solut, sovella muotoilua ja tallenna:

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

Tuetut tiedostomuodot

MuotoTiedostopääteLukuKirjoitus
Excel Open XML.xlsx✓✓

Tallentaminen on tällä hetkellä rajoitettu .xlsx:iin. Kirjasto tallentaa ja siirtää kaavat läpi, mutta se ei ole täysi taulukkolaskenta‑moottori.

Avoin lähdekoodi ja lisensointi

Aspose.Cells FOSS for Java on julkaistu MIT‑lisenssin alla. Voit vapaasti käyttää, muokata ja jakaa sitä henkilökohtaisissa, avoimen lähdekoodin ja kaupallisissa projekteissa ilman rajoituksia. Lähdekoodi on saatavilla osoitteessa github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Java.

Aloittaminen