Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rabanti-github/picoxlsx4j
PicoXLSX4j is a small Java library to create XLSX files (Microsoft Excel 2007 or newer) in an easy and native way. It is a direct port of PicoXLSX for C#
https://github.com/rabanti-github/picoxlsx4j
excel excelwriter java microsoft-office ooxml spreadsheet xlsx
Last synced: 29 days ago
JSON representation
PicoXLSX4j is a small Java library to create XLSX files (Microsoft Excel 2007 or newer) in an easy and native way. It is a direct port of PicoXLSX for C#
- Host: GitHub
- URL: https://github.com/rabanti-github/picoxlsx4j
- Owner: rabanti-github
- License: mit
- Created: 2015-10-12T22:55:19.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2022-11-11T21:08:02.000Z (about 2 years ago)
- Last Synced: 2024-04-15T04:39:26.168Z (8 months ago)
- Topics: excel, excelwriter, java, microsoft-office, ooxml, spreadsheet, xlsx
- Language: Java
- Homepage:
- Size: 7.19 MB
- Stars: 2
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog.md
- License: LICENSE
Awesome Lists containing this project
README
# PicoXLSX4j ![PicoXLSX](https://rabanti-github.github.io/PicoXLSX/icons/PicoXLSX.png)
## Important: This project is (currently) deprecated.
Please have a look at [NanoXLSX4j](https://github.com/rabanti-github/NanoXLSX4j) that is actively maintained.![Maven Central](https://img.shields.io/maven-central/v/ch.rabanti/picoxlsx4j.svg?maxAge=86400)
![license](https://img.shields.io/github/license/rabanti-github/picoXlsx.svg)
[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Frabanti-github%2FPicoXLSX4j.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Frabanti-github%2FPicoXLSX4j?ref=badge_shield)PicoXLSX4j is a small Java library to create XLSX files (Microsoft Excel 2007 or newer) in an easy and native way. It is a direct port of [PicoXLSX for C#](https://github.com/rabanti-github/PicoXLSX)
* No need for an installation of Microsoft Office
* No need for Office interop/DCOM or other bridging libraries
* No need for 3rd party libraries
* Pure usage of standard JRE**Please have a look at the successor library [NanoXLSX4j](https://github.com/rabanti-github/NanoXLSX4j) for reader support.**
Project website: [https://picoxlsx.rabanti.ch](https://picoxlsx.rabanti.ch)
See the **[Change Log](https://github.com/rabanti-github/PicoXLSX4j/blob/master/Changelog.md)** for recent updates.
## What's new in version 2.x
* Changed package structure to ch.rabanti.picoxlsx4j
* Added Maven support (available in Maven Central under ch.rabanti.picoxlsx4j)
* Complete replacement of the old style handling
* Added appending of styles for an easier composition of complex styles
* Added more options to assign styles to cells
* Added Shortener (property WS) to reduce the code overhead
* Added static methods for the most important formulas (round, floor, ceil, min, max, average, median, sum, vlookup)
* Added Save option to save the XLSX file as stream
* Added an option for sanitizing of worksheet names
* Replaced specific exception classes with general exceptions (e.g. StyleException, FormatException or WorksheetException)
* Added functions to retrieve stored data and the current cell address
* Many internal optimizations and additional documentation## Requirements
PicoXLSX4j was initially created with Java 8 and currently build with OpenJDK 11
The only requirement for development is an up-to-date Java environment (OpenJDK 11 or higher recommended)## Installation
### As JAR
Simply place the PicoXLSX4j jar file (e.g. **picoxlsx4j-2.6.0.jar**) into the lib folder of your project and create a library reference to it in your IDE.
### As source files
Place all .java files from the PicoXLSX4j source folder into your project. The folder structure defines the packages. Please use refactoring if you want to relocate the files.
### Maven
Add the following information to your POM file within the `````` tag:
```xml
ch.rabanti
picoxlsx4j
2.6.0```
**Important:** The version number may change.
Please see the version number of Maven Central at the top of the README (maven-central badge) or check the [Change Log](https://github.com/rabanti-github/PicoXLSX4j/blob/master/Changelog.md) for the most recent version. The keywords ```LATEST``` and ```RELEASE``` are only valid in Maven 2, not 3 and newer.## Usage
### Quick Start (shortened syntax)
```java
Workbook workbook = new Workbook("myWorkbook.xlsx", "Sheet1"); // Create new workbook with a worksheet called Sheet1
workbook.WS.value("Some Data"); // Add cell A1
workbook.WS.formula("=A1"); // Add formula to cell B1
workbook.WS.down(); // Go to row 2
workbook.WS.value(new Date(), BasicStyles.Bold()); // Add formatted value to cell A2
try{
workbook.save(); // Save the workbook as myWorkbook.xlsx
} catch (Exception ex) {}
```### Quick Start (regular syntax)
```java
Workbook workbook = new Workbook("myWorkbook.xlsx", "Sheet1"); // Create new workbook with a worksheet called Sheet1
workbook.getCurrentWorksheet().addNextCell("Some Data"); // Add cell A1
workbook.getCurrentWorksheet().addNextCell(42); // Add cell B1
workbook.getCurrentWorksheet().goToNextRow(); // Go to row 2
workbook.getCurrentWorksheet().addNextCell(new Date()); // Add cell A2
try {
workbook.Save(); // Save the workbook as myWorkbook.xlsx
} catch (Exception ex) {}
```## Further References
See the full **API-Documentation at: [https://rabanti-github.github.io/PicoXLSX4j/](https://rabanti-github.github.io/PicoXLSX4j/).
The [Demo class](https://github.com/rabanti-github/PicoXLSX4j/blob/master/src/main/java/ch/rabanti/picoxlsx4j/demo/PicoXLSX4j.java) contains 13 simple use cases. You can also look at the full API documentation or the Javadoc annotations in the particular .java files.## License
[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Frabanti-github%2FPicoXLSX4j.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Frabanti-github%2FPicoXLSX4j?ref=badge_large)