Ievads

Aspose.Cells FOSS for Java ir atvērtā koda Java 17 bibliotēka, kas ļauj izstrādātājiem
izveidot, ielādēt, modificēt un saglabāt Excel .xlsx darba grāmatas pilnīgi uz JVM — ar
nekādām Microsoft Office instalācijām, bez vietējām bibliotēkām un bez komerciālas Aspose izpildlaika
atkarību. Publiskā API atrodas com.aspose.cells_foss paketē un ir
izlaista zem MIT licences, padarot to piemērotu personīgām, atvērtā koda, un
komerciāliem projektiem.

Bibliotēka tiek piegādāta kā standarta Maven artefakts un aptver galveno OOXML izklājlapu objektu modeli: darba grāmatas, darba lapas, šūnas, stili un kolekcijas. Tā ir izveidota ar Maven 3.9+ un mērķē uz Java 17+, integrējoties dabiski jebkurā mūsdienīgā Java būvēšanas caurulē.

Pievienojiet atkarību savam pom.xml un jūs esat gatavs ģenerēt vai apstrādāt Excel darblapas no servlet, batch darba, Lambda funkcijas vai jebkura cita Java servera puses konteksta.

Galvenās funkcijas

Darblapas un darblapas lapas pārvaldība

Workbook klase ir ieejas punkts visām izklājlapu operācijām. Tā īsteno AutoCloseable, tāpēc tā tīri integrējas ar try‑with‑resources modeli. Jūs varat izveidot jaunas darba grāmatas, ielādēt esošus .xlsx failus, pievienot un noņemt darblapas, pārdēvēt lapas ar setName(), iestatīt aktīvo lapu un kontrolēt cilnes redzamību.

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

Šūnu vērtības un formulas

Cell klase atbalsta tipizētu vērtību glabāšanu, izmantojot putValue(), lai saglabātu virknes, veselos skaitļus, dubultus, loģiskās vērtības un LocalDateTime vērtības. Formulas virknes tiek saglabātas ar setFormula() un tiks pārrēķinātas, atverot Excel. Vērtības tips tiek atklāts caur CellValueType — STRING, NUMBER, BOOLEAN, DATE_TIME vai 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");
}

Šūnu formatēšana un stili

Formatēšana tiek piemērota, izmantojot klasi Style, izgūta no cell.getStyle() un atgriezta ar cell.setStyle(). Jūs varat konfigurēt treknrakstu un krāsu uz Font, piemērot HorizontalAlignment un iestatīt pielāgotas skaitļu formāta virknes, izmantojot style.setCustom(). Rindas augstums un kolonnas platums tiek kontrolēti, izmantojot getRows().get(n).setHeight() un getColumns().get(n).setWidth().

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

Datu validācija un nosacītā formatēšana

Datu validācijas noteikumi tiek pievienoti caur sheet.getValidations().add(). Katrs Validation objekts satur ValidationType (piemēram, WHOLE_NUMBER), OperatorType (piemēram, BETWEEN) un formulas virknes robežām. Nosacītā formatēšana tiek pievienota caur sheet.getConditionalFormattings().add(), kas atgriež FormatConditionCollection, kur norādāt šūnu diapazonus un nosacījumus.

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

Autofiltri un Lapas iestatījumi

AutoFiltri tiek konfigurēti, izsaucot ws.getAutoFilter().setRange() ar A1‑notācijas diapazona virkni. PageSetup objekts kontrolē papīra izmēru, orientāciju un lapas pielāgošanas iestatījumus izvadam, kas gatavs drukāšanai. Darblapas aizsardzība tiek piemērota, izmantojot protect() ar WorksheetProtectionModel.

Ātrais sākums

Pievienojiet Maven atkarību savam pom.xml:

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

Izveidojiet darba grāmatu, aizpildiet šūnas, piemērojiet formatēšanu un saglabājiet:

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

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 tā nav pilna izklājlapas aprēķinu dzinējs.

Atvērtā pirmkods & licencēšana

Aspose.Cells FOSS for Java ir izlaists zem MIT licences. Jūs varat brīvi izmantot, modificēt un izplatīt to personīgos, atvērtā koda un komerciālos projektos bez ierobežojumu. Avota kods ir pieejams github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Java.

Sākšana