Bevezetés

Aspose.Cells FOSS for Java egy nyílt forráskódú Java 17 könyvtár, amely lehetővé teszi a fejlesztők számára, hogy teljesen a JVM-en hozzanak létre, töltsenek be, módosítsanak és mentsenek Excel .xlsx munkafüzeteket — Microsoft Office telepítés nélkül, natív könyvtárak nélkül, és kereskedelmi Aspose futtatókörnyezet függőség nélkül. A nyilvános API a com.aspose.cells_foss csomag alatt található, és MIT licenc alatt kerül kiadásra, így alkalmas személyes, nyílt forráskódú és kereskedelmi projektekhez egyaránt.

A könyvtár standard Maven artefaktumként érkezik, és lefedi az OOXML táblázatkezelő alapvető objektummodelljét: munkafüzetek, munkalapok, cellák, stílusok és gyűjtemények. Maven 3.9+ segítségével épült, és a Java 17+ célplatformra van szabva, természetesen integrálódik bármely modern Java build pipeline‑ba.

Adja hozzá a függőséget a pom.xml-hez, és készen áll arra, hogy Excel
munkafüzeteket egy servletből, egy kötegelt feladatból, egy Lambda függvényből vagy bármilyen más Java szerveroldali
környezetből.

Főbb jellemzők

Munkafüzet és munkalap kezelése

A Workbook osztály a táblázatkezelő műveletek belépési pontja. Implementálja
AutoCloseable így tisztán integrálódik a try-with-resources mintával. Létrehozhat
új munkafüzeteket, betöltheti a meglévő .xlsx fájlokat, hozzáadhat és eltávolíthat munkalapokat, átnevezheti
a lapokat a setName() segítségével, beállíthatja az aktív lapot, és vezérelheti a fül láthatóságát.

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

Cellák értékei és képletei

A Cell osztály típusos értéktárolást támogat a putValue() segítségével karakterláncok, egész számok, duplák, logikai értékek és LocalDateTime értékek számára. A képlet karakterláncok a setFormula()-val tárolódnak, és az Excel megnyitáskor újraszámolja őket. Az értéktípus a CellValueType-on keresztül érhető el — STRING, NUMBER, BOOLEAN, DATE_TIME vagy 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");
}

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

Formázást a Style osztályon keresztül alkalmazzák, amelyet a cell.getStyle()‑ből nyernek ki és
írják vissza a cell.setStyle()‑vel. A Font‑n beállítható a félkövér és a szín,
alkalmazható a HorizontalAlignment, és egyéni számformátum-karakterláncok állíthatók be a style.setCustom()‑n keresztül.
A sormagasságot és az oszlopszélességet a getRows().get(n).setHeight() és
getColumns().get(n).setWidth() szabályozza.

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

Adatérvényesítés és Feltételes formázás

Az adatellenőrzési szabályok a sheet.getValidations().add() segítségével adhatók hozzá. Minden Validation objektum egy ValidationType‑t (például WHOLE_NUMBER), egy OperatorType‑t (például BETWEEN) és képletkarakterláncokat tartalmaz a határokhoz. A feltételes formázás a sheet.getConditionalFormattings().add() segítségével adható hozzá, amely egy FormatConditionCollection‑t ad vissza, ahol megadhatja a cellatartományokat és a feltételeket.

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

AutoFilters és Oldalbeállítás

Az AutoFilterek a ws.getAutoFilter().setRange() hívásával, egy A1-notációs tartománykarakterlánccal konfigurálhatók. A PageSetup objektum szabályozza a papírméretet, tájolást és a laphoz igazítás beállításait a nyomtatásra kész kimenethez. A munkalap védelme a protect() segítségével, egy WorksheetProtectionModel-vel alkalmazható.

Gyors kezdés

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

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

Hozzon létre egy munkafüzetet, töltse fel a cellákat, alkalmazzon formázást, és mentse el:

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

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 továbbadja a képleteket, de nem egy teljes táblázatkezelő számítási motor.

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