https://github.com/panga/lite-beans
LiteBeans is implementation of the java.beans package based on the Apache Harmony project
https://github.com/panga/lite-beans
java jdk9 jigsaw jpms
Last synced: 23 days ago
JSON representation
LiteBeans is implementation of the java.beans package based on the Apache Harmony project
- Host: GitHub
- URL: https://github.com/panga/lite-beans
- Owner: panga
- License: apache-2.0
- Created: 2018-06-08T03:16:31.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-06-08T03:56:38.000Z (almost 7 years ago)
- Last Synced: 2024-04-14T15:19:38.585Z (about 1 year ago)
- Topics: java, jdk9, jigsaw, jpms
- Language: Java
- Homepage:
- Size: 107 KB
- Stars: 10
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# LiteBeans Project
**LiteBeans** is implementation of the `java.beans` package based on the [Apache Harmony](https://github.com/apache/harmony) project.
## Problem
The [java.desktop](https://docs.oracle.com/javase/9/docs/api/java.desktop-summary.html) module introduced in JDK 9 encapsulates all AWT, Swing, Image and Sound packages from Java standard libraries.
In addition to that, it contains the `java.beans` package with helper classes to interact with *Java Beans*, specifically bean introspection and property change listeners.
Due to its tight dependency with AWT and Swing, it cannot be easily removed from `java.desktop` module, causing any thirdparty library that uses `java.beans` package to be dependent of all `java.desktop` classes.
The extra overhead of `java.desktop` module adds `12mb` of size into the JVM installation and increases memory usage.
## Solution
Implemented `java.beans` package with only `java.base` module dependency based on [Apache Harmony](https://github.com/apache/harmony) project source code.
The implementation is a subset of official JDK `java.beans` classes, it does not implement the full interface.
However, it adds enough classes to be used by Object Mapping (xml, json) libraries and Dependency Injection (Spring, CDI) frameworks in a transparent way.
The total size of **LiteBeans** library is less than `150kb`.
## Usage
### Using as a `java.beans` alternative
1. Add Maven Dependency
```xml
com.github.panga
lite-beans
1.0.0
```
2. Find all ocurrencies of `import java.beans` and replace with `import lite.beans`.
### Using as a module patch (hacking JPMS)
1. Add Maven Dependency or download the JAR (notice the classifier)
```xml
com.github.panga
lite-beans
1.0.0
patch
```
2. Run your application in a minimal JRE without `java.desktop` module:
```bash
java \
--patch-module java.base=lite-beans-1.0.0-patch.jar \
--add-exports java.base/java.beans=acme.myapp \
--module-path target/modules --module acme.myapp \
```
*Note: See usage in https://github.com/panga/hammock-jpms example.*
## Contributors
* Leonardo Zanivan
## License
[Apache License 2.0](LICENSE.txt)