Bevezetés

Az Aspose.Cells FOSS for Java átfogó táblázatkezelő képességeket biztosít Java 17 alkalmazások számára. MIT license alatt kiadva és standard Maven artifactként terjesztve, a könyvtár mindent lefed az alapvető munkafüzet létrehozástól a típusos cellaértékeken, gazdag formázáson, adatellenőrzésen és AutoFilteren keresztül – mindezt Microsoft Office függőség nélkül.

Ez a bejegyzés végigvezet a fő funkcióterületeken, fókuszált kódrészletekkel, amelyek a hitelesített API felületről.
Az alább bemutatott összes osztály- és metódusnév megtalálható a könyvtárban
és elérhető a 1.0.0 verzióban.

Főbb jellemzők

Munkafüzet és munkalap kezelése

A Workbook osztály megvalósítja a AutoCloseable‑t, így tisztán integrálódik a
Java try-with-resources mintával. Létrehozhat egy üres munkafüzetet, betölthet egy meglévő
.xlsx fájlt, átnevezheti a munkalapokat, hozzáadhat vagy eltávolíthat lapokat, beállíthatja az aktív lapot, és
vezérelheti a fülek láthatóságát.

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

Típusos cellaértékek és képletek

A Cell osztály típusos értékeket fogad el a putValue() segítségével a String, int, double, boolean, és LocalDateTime számára. A getType() metódus egy CellValueType enum értéket ad vissza — STRING, NUMBER, BOOLEAN, DATE_TIME vagy FORMULA — így könnyű az értéktípus alapján elágazni anélkül, hogy karakterláncokat kellene elemezni. A képlet karakterláncok a setFormula() segítségével tárolódnak, és az Excel újraszámolja őket megnyitáskor.

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

Cellák formázása és stílusai

A formázást a Style objektumon keresztül alkalmazzák, amelyet a cell.getStyle()‑ből nyernek ki, és a cell.setStyle()‑vel írják vissza. A Font alobjektum a setBold()‑t és a setColor()‑t teszi elérhetővé. A HorizontalAlignment szabályozza a szöveg igazítását — LEFT, CENTER vagy RIGHT. Az egyéni számformátumok az Excel formátumkarakterláncokat használják a style.setCustom()‑n keresztül. A sormagasságot és az oszlopszélességet a getRows().get(n).setHeight() és a getColumns().get(n).setWidth() segítségével állítják be.

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

Adatellenőrzés

Az adatellenőrzési szabályok a sheet.getValidations().add() segítségével adhatók hozzá. Minden Validation objektum egy ValidationType-t (pl. WHOLE_NUMBER, DECIMAL, LIST) és egy OperatorType-t (pl. BETWEEN, GREATER_THAN) kap. A képlet határait a setFormula1() és setFormula2() segítségével karakterláncként tárolják.

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

Az AutoFilters lehetővé teszi a végfelhasználók számára, hogy interaktívan szűrjék az adatokat az Excelben anélkül, hogy további
konfigurációra lenne szükség. Hívja meg a ws.getAutoFilter().setRange()-t egy A1-jelölésű tartománnyal a
szűrőfejléc sor engedélyezéséhez. További szűrőoszlopok és egyéni feltételek
definiálhatók a FilterColumn és a AutoFilterCustomFilter segítségével.

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

Oldalbeállítás és munkalapvédelem

A PageSetup osztály szabályozza a papírméretet, az oldal tájolását és a laphoz igazítás beállításait a nyomtatásra kész kimenethez. A munkalap védelmét a protect() és egy WorksheetProtectionModel segítségével alkalmazzák, lehetővé téve, hogy bizonyos cellák szerkeszthetőek maradjanak, míg a többit zárolják. A hiperhivatkozásokat a HyperlinkCollection kezeli.

Gyors kezdés

Adja hozzá a függőséget a pom.xml-hoz:

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

Készíts egy munkafüzetet az összes fő funkcióval 20 sor alatt:

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

Támogatott formátumok

FormátumKiterjesztésOlvasásÍrás
Excel Open XML.xlsx✓✓

A mentés jelenleg korlátozva van a .xlsx-ra. A könyvtár tárolja és körbeviszi a képleteket, de nem működik teljes táblázat‑kalkulációs motorként.

Nyílt forráskód és licencelés

Aspose.Cells FOSS for Java az MIT licenc alatt kerül kiadásra. Szabadon használhatja, módosíthatja, és terjesztheti személyes, nyílt forráskódú és kereskedelmi projektekben korlátozás nélkül A forráskód elérhető itt github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Java.

Első lépések