Ievads

Aspose.Cells FOSS for Java nodrošina plašu izklājlapu iespēju komplektu Java 17 lietojumprogrammām. Izlaists zem MIT licences un izplatīts kā standarta Maven artefakts, bibliotēka aptver visu no pamata darba grāmatas izveides līdz tipizētām šūnu vērtībām, bagātīgai formatēšanai, datu validācijai un AutoFilter — viss bez Microsoft Office atkarības.

Šis ieraksts iziet cauri galvenajām funkciju jomām ar koncentrētiem koda piemēriem, kas ņemti no
pārbaudītās API virsmas. Visi zemāk parādītie klašu un metožu nosaukumi pastāv bibliotēkā
un ir pieejami versijā 1.0.0.

Galvenās funkcijas

Darblapas un darblapas pārvaldība

Workbook klase īsteno AutoCloseable, tāpēc tā tīri integrējas ar
Java try-with-resources modeli. Jūs varat izveidot tukšu darblapu, ielādēt esošu
.xlsx failu, pārdēvēt darblapas, pievienot vai noņemt lapas, iestatīt aktīvo lapu, un
kontrolēt cilnes redzamību.

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

Ierakstītās šūnas vērtības un formulas

Cell klase pieņem tipizētas vērtības caur putValue() priekš String, int, double, boolean, un LocalDateTime. getType() metode atgriež CellValueType enum vērtību — STRING, NUMBER, BOOLEAN, DATE_TIME, vai FORMULA — ļaujot viegli izvēlēties uz vērtības tipu, nepārbaudot virknes. Formulas virknes tiek saglabātas ar setFormula() un tiks pārrēķinātas ar Excel, atverot.

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

Šūnas formatēšana un stili

Formatēšana tiek piemērota, izmantojot Style objektu, kas iegūts no cell.getStyle(), un atgriezta ar cell.setStyle(). Font apakšobjekts atklāj setBold() un setColor(). HorizontalAlignment kontrolē teksta izlīdzinājumu — LEFT, CENTER vai RIGHT. Pielāgoti skaitļu formāti izmanto Excel formāta virknes, izmantojot style.setCustom(). Rindas augstums un kolonnas platums tiek pielāgoti, izmantojot getRows().get(n).setHeight() un 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");
}

Datu validācija

Datu validācijas noteikumi tiek pievienoti, izmantojot sheet.getValidations().add(). Katrs Validation objekts pieņem ValidationType (piemēram, WHOLE_NUMBER, DECIMAL, LIST) un OperatorType (piemēram, BETWEEN, GREATER_THAN). Formulas robežas tiek saglabātas kā virknes, izmantojot setFormula1() un 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");
}

AutoFiltrs

AutoFilters ļauj galalietotājiem interaktīvi filtrēt datus programmā Excel bez papildu konfigurācijas. Izsauciet ws.getAutoFilter().setRange() ar A1‑notation diapazonu, lai aktivizētu filtra galvenes rindu. Papildu filtra kolonnas un pielāgoti kritēriji var tikt definēti, izmantojot FilterColumn un 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");
}

Lapas iestatījumi un darblapas aizsardzība

PageSetup klase kontrolē papīra izmēru, lapas orientāciju un “pielāgot lapai” iestatījumus drukas gatavai izvadē. Darblapas aizsardzība tiek piemērota caur protect() ar WorksheetProtectionModel, ļaujot konkrētām šūnām palikt rediģējāmām, kamēr pārējās tiek bloķētas. Hiperlinki tiek pārvaldīti caur HyperlinkCollection.

Ātrais sākums

Pievienojiet atkarību savam pom.xml:

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

Izveidojiet darba grāmatu ar visām galvenajām funkcijām mazāk nekā 20 rindās:

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

Atbalstītie formāti

FormātsPaplašinājumsLasītRakstīt
Excel Open XML.xlsx✓✓

Saglabāšana pašlaik ir ierobežota līdz .xlsx. Bibliotēka saglabā un pārvieto formulas, bet nefunkcionē kā pilna izklājlapas aprēķinu dzinējs.

Atvērtā pirmkods un licencēšana

Aspose.Cells FOSS for Java ir izlaists zem MIT licences. Jums ir brīva iespēja izmantot, modificēt un izplatīt to personīgajos, atvērtā koda un komerciālajos projektos bez ierobežojumiem. Avota kods ir pieejams vietnē github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Java.

Sākšana