Introdução

Aspose.Cells FOSS for Java is a pure-Java 17, MIT-licensed library for creating e manipulação do Excel. .xlsx Livros de trabalho sem qualquer dependência do Microsoft Office. Este post apresenta as operações de gestão das planilhas mais comuns: criar e utilizar um sistema de cálculo com base em dados. Livros de trabalho, carregamento de ficheiros, trabalhos com células e salvamento dos resultados.

Começo rápido

Adicione a dependência de Maven ao seu pom.xml Para começar:

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-cells-foss</artifactId>
  <version>26.5.0</version>
</dependency>

Não é necessário nenhum arquivo de licença ou chave API. A biblioteca é totalmente open-source sob MIT .


Criar um livro de trabalho

A Comissão Workbook() constructor cria uma nova pasta de trabalho em branco com uma folha padrão:

import com.aspose.cells.foss.Workbook;
import com.aspose.cells.foss.Worksheet;

Workbook workbook = new Workbook();
WorksheetCollection sheets = workbook.getWorksheets();
Worksheet sheet = sheets.get(0);
System.out.println(sheet.getName()); // Sheet1

Utilização: WorksheetCollection.add(sheetName) para adicionar folhas com nomes e removeAt(sheetName) para as remover:

int idx = workbook.getWorksheets().add("Report");
workbook.getWorksheets().get(idx).setName("Report");
workbook.getWorksheets().removeAt("Sheet1");

Carregamento de um ficheiro existente

Passe um caminho de arquivo para: Workbook(fileName) A Comissão Europeia .xlsx Livro de trabalho:

Workbook workbook = new Workbook("data/report.xlsx");
System.out.println("Sheets: " + workbook.getWorksheets().getCount());

Para fluxos de entrada (por exemplo, a partir de uma base de dados ou resposta HTTP), utilizar Workbook(stream):

try (java.io.InputStream is = new java.io.FileInputStream("data/report.xlsx")) {
    Workbook workbook = new Workbook(is);
}

Celas de leitura e escrita

Worksheet.getCells() Retorna o valor de: Cells Acesse as células individuais através do código de identificação. nome ou por índice de linha/coluna baseado em zero:

import com.aspose.cells.foss.Cells;
import com.aspose.cells.foss.Cell;

WorksheetCollection sheets = workbook.getWorksheets();
Cells cells = sheets.get(0).getCells();

// Write by cell name
cells.get("A1").putValue("Product");
cells.get("B1").putValue("Revenue");

// Write by row/column index
cells.get(1, 0).putValue("Widget A");   // A2
cells.get(1, 1).putValue(45000);        // B2

// Read back
String name = cells.get("A2").getStringValue();
Object rev  = cells.get("B2").getValue();
System.out.println(name + ": " + rev);

Configuração de fórmulas

Utilização: Cell.setFormula() para armazenar uma sequência de fórmulas numa célula. A fórmula é avaliada quando a pasta de trabalho é salva e recarregada:

cells.get("B3").setFormula("=SUM(B2:B2)");
System.out.println(cells.get("B3").getFormula()); // =SUM(B2:B2)

Os resultados da fórmula são resolvidos quando a pasta de trabalho é salva e recarregada.


Salvar o livro de trabalho

Workbook.save(fileName) escreve o livro de trabalho; o formato é determinado pelo sistema de cálculo. Extensão de ficheiro (.xlsx produz um arquivo Excel 2007+):

workbook.save("output/result.xlsx");

Sempre envolva folhetos de trabalho grandes em recursos para liberar os manobros dos arquivos prontamente:

try (Workbook workbook = new Workbook("data/input.xlsx")) {
    workbook.getWorksheets().get(0).getCells().get("A1").putValue("Updated");
    workbook.save("data/output.xlsx");
}

O que seguir a ser explorado

Aspose.Cells FOSS for Java includes APIs for worksheet-level operations beyond cell manipulation:

  • Proteção da folha de cálculo: protect() / unprotect() em 1 de Setembro de Worksheet
  • AutoFilter: Worksheet.getAutoFilter() para filtragem de dados programáticos
  • Estilo de célula: Cell.getStyle() / setStyle() com: Style propriedades
  • Células fundidas: Cells.merge(firstRow, firstColumn, totalRows, totalColumns)

Para uma API completa, veja o Guia de desenvolvedores e o Referência API.

Começar a Fazer

Os exemplos acima cobrem as tarefas de gerenciamento de planilha mais comuns em Aspose.Celas FOSS para Java. Para um guia completo da API, incluindo validação, gráficos e formatação , veja o Guia de desenvolvedores.

Recursos relacionados