Why does com.github.librepdf.openpdf 3.0.5 require com.aayushatharva.brotli4j?

[merks]

The 3.0.4 release

• https://repo.maven.apache.org/maven2/com/github/librepdf/openpdf/3.0.4/openpdf-3.0.4.jar

has these OSGi dependencies in the MANIFEST.MF:

Import-Package                          com.ibm.icu.text;resolution:=optional
                                        java.awt
                                        java.awt.color
                                        java.awt.font
                                        java.awt.geom
                                        java.awt.image
                                        java.awt.image.renderable
                                        java.awt.print
                                        java.io
                                        java.lang
                                        java.lang.invoke
                                        java.lang.reflect
                                        java.lang.runtime
                                        java.math
                                        java.net
                                        java.nio
                                        java.nio.channels
                                        java.nio.charset
                                        java.nio.file
                                        java.nio.file.attribute
                                        java.security
                                        java.security.cert
                                        java.security.spec
                                        java.text
                                        java.util
                                        java.util.concurrent
                                        java.util.concurrent.locks
                                        java.util.function
                                        java.util.regex
                                        java.util.stream
                                        java.util.zip
                                        javax.crypto
                                        javax.crypto.spec
                                        javax.imageio
                                        javax.imageio.metadata
                                        javax.imageio.plugins.jpeg
                                        javax.imageio.stream
                                        javax.xml.parsers;resolution:=optional
                                        org.apache.fop.complexscripts.fonts;resolution:=optional
                                        org.apache.fop.complexscripts.util;resolution:=optional
                                        org.apache.fop.fonts.apps;resolution:=optional
                                        org.apache.fop.fonts.truetype;resolution:=optional
                                        org.bouncycastle.asn1.cmp;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.cms;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.ocsp;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.pkcs;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.tsp;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.x500;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.x509;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.cert.jcajce;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.cert.ocsp;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.cert;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.cms.jcajce;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.cms;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.crypto.engines;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.crypto.modes;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.crypto.paddings;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.crypto.params;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.crypto;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.jcajce.provider.asymmetric.x509;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.jce.provider;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.operator.jcajce;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.operator;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.tsp;version="[1.84,2)";resolution:=optional
                                        org.openpdf.bouncycastle
                                        org.openpdf.text
                                        org.openpdf.text.alignment
                                        org.openpdf.text.error_messages
                                        org.openpdf.text.exceptions
                                        org.openpdf.text.factories
                                        org.openpdf.text.html
                                        org.openpdf.text.pdf.codec
                                        org.openpdf.text.pdf.codec.wmf
                                        org.openpdf.text.pdf.collection
                                        org.openpdf.text.pdf.crypto
                                        org.openpdf.text.pdf.draw
                                        org.openpdf.text.pdf.events
                                        org.openpdf.text.pdf.fonts
                                        org.openpdf.text.pdf.fonts.cmaps
                                        org.openpdf.text.pdf.hyphenation
                                        org.openpdf.text.pdf.interfaces
                                        org.openpdf.text.utils
                                        org.openpdf.text.xml
                                        org.openpdf.text.xml.simpleparser
                                        org.openpdf.text.xml.xmp
                                        org.w3c.dom;resolution:=optional
                                        org.xml.sax.helpers;resolution:=optional
                                        org.xml.sax;resolution:=optional

The 3.0.5 release

https://repo.maven.apache.org/maven2/com/github/librepdf/openpdf/3.0.5/openpdf-3.0.5.jar

has these OSGi dependencies in the MANIFEST.MF

Import-Package                          com.aayushatharva.brotli4j
                                        com.aayushatharva.brotli4j.decoder
                                        com.aayushatharva.brotli4j.encoder
                                        com.ibm.icu.text;resolution:=optional
                                        java.awt
                                        java.awt.color
                                        java.awt.font
                                        java.awt.geom
                                        java.awt.image
                                        java.awt.image.renderable
                                        java.awt.print
                                        java.io
                                        java.lang
                                        java.lang.invoke
                                        java.lang.reflect
                                        java.lang.runtime
                                        java.math
                                        java.net
                                        java.nio
                                        java.nio.channels
                                        java.nio.charset
                                        java.nio.file
                                        java.nio.file.attribute
                                        java.security
                                        java.security.cert
                                        java.security.spec
                                        java.text
                                        java.util
                                        java.util.concurrent
                                        java.util.concurrent.locks
                                        java.util.function
                                        java.util.regex
                                        java.util.stream
                                        java.util.zip
                                        javax.crypto
                                        javax.crypto.spec
                                        javax.imageio
                                        javax.imageio.metadata
                                        javax.imageio.plugins.jpeg
                                        javax.imageio.stream
                                        javax.xml.parsers;resolution:=optional
                                        org.apache.fop.complexscripts.fonts;resolution:=optional
                                        org.apache.fop.complexscripts.util;resolution:=optional
                                        org.apache.fop.fonts.apps;resolution:=optional
                                        org.apache.fop.fonts.truetype;resolution:=optional
                                        org.bouncycastle.asn1.cmp;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.cms;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.nist;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.ocsp;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.pkcs;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.tsp;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.x500;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1.x509;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.asn1;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.cert.jcajce;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.cert.ocsp;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.cert;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.cms.jcajce;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.cms;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.crypto.engines;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.crypto.modes;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.crypto.paddings;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.crypto.params;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.crypto;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.jcajce.provider.asymmetric.x509;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.jce.provider;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.operator.jcajce;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.operator;version="[1.84,2)";resolution:=optional
                                        org.bouncycastle.tsp;version="[1.84,2)";resolution:=optional
                                        org.openpdf.bouncycastle
                                        org.openpdf.text
                                        org.openpdf.text.alignment
                                        org.openpdf.text.error_messages
                                        org.openpdf.text.exceptions
                                        org.openpdf.text.factories
                                        org.openpdf.text.html
                                        org.openpdf.text.pdf.codec
                                        org.openpdf.text.pdf.codec.wmf
                                        org.openpdf.text.pdf.collection
                                        org.openpdf.text.pdf.crypto
                                        org.openpdf.text.pdf.draw
                                        org.openpdf.text.pdf.events
                                        org.openpdf.text.pdf.fonts
                                        org.openpdf.text.pdf.fonts.cmaps
                                        org.openpdf.text.pdf.hyphenation
                                        org.openpdf.text.pdf.interfaces
                                        org.openpdf.text.utils
                                        org.openpdf.text.xml
                                        org.openpdf.text.xml.simpleparser
                                        org.openpdf.text.xml.xmp
                                        org.w3c.dom;resolution:=optional
                                        org.xml.sax.helpers;resolution:=optional
                                        org.xml.sax;resolution:=optional

From what I gather from the parent pom's dependencies, the com.aayushatharva.* dependencies are resolved to this version:

https://repo.maven.apache.org/maven2/com/aayushatharva/brotli4j/brotli4j/1.23.0/

But that's not shipped as an OSGi bundle.

Can someone clarify what these new dependencies are for? In particular why are these dependencies non-optional?

This effectively makes the 3.0.5 release useless/dysfunctional as an OSGi bundle because the transitive closure is incomplete. Therefore I cannot consume this new version in Orbit without somehow providing a bundle for com.aayushatharva.brotli4j to resolve the package imports:

https://github.com/eclipse-orbit/orbit-simrel/blob/1d93e28f2cdd2bfb84a6f5639dce27b95ba08307/maven-osgi/tp/Maven.target#L245-L250

[andreasrosdal]

Hello Mr. Merks.

Brotli is a new and better way to compress PDF files, in the latest PDF standard. It's an improvement and modernization.

https://pdfa.org/brotli-compression-coming-to-pdf/

https://pdfa.org/understanding-brotli-pdf-compression/

https://github.com/hyperxpro/Brotli4j

https://itextpdf.com/blog/itext-suite-95-brotli-post-quantum-signatures

Pull requests welcome. Please tell us how to handle this.

[merks]

Oh dear, there's a whole suite of natives as well.

I assume one needs to load the natives library from the matching of those. Bundlizing all that is quite some work. 😢 Then I'd need to test that it actually works without the first clue how to do that such testing.

You will no longer have OSGi consumers for 3.0.5 or any future version until someone does that work...

[andreasrosdal]

Mr. Merks,

Yes, this is the effort to modernize the OpenPDF library. The author of brotli4j is thinking of a native Java library to handle Brotli compression, there is a GitHub issue about it. For now there are native libraries.

I am pretty sure that OpenPDF will function normally if you don't Import brotli4j, maybe some minor modifications needed.

[andreasrosdal]

Mr. Merks, for now maybe treat brotli4j as optional? Still in the future there will be many real PDF files with Brotli compression.

[andreasrosdal]

Mr. Merks, please see: hyperxpro/Brotli4j#255

[merks]

Mr. Merks, for now maybe treat brotli4j as optional? Still in the future there will be many real PDF files with Brotli compression.

I cannot treat it as optional because unlike com.ibm.icu.text;resolution:=optional which is declared optional, the com.aayushatharva.brotli4j dependencies are not declared optional:

So I cannot even build Orbit. Moreover one cannot provision an installation nor start an OSGi runtime with the latest 3.0.5 bundle because no OSGI runtime will be able to wire those package imports to a bundle that exports those packages.

So the OSGi consumer base is effectively dead in the water unless someone bundlizes the non-optional dependencies.

[andreasrosdal]

hyperxpro/Brotli4j#257

[hyperxpro]

@merks - If you don't plan to use Brotli compression then there is no need to import native dependencies. The current dependency used by OpenPDF only has source files (43 KB in size I guess?) , not binaries. And of course, Brotli compression will not work without them.

[merks]

I’ll investigate during the next release cycle in June and share my results. It’s probably similar to what I did for skija recently.

[vk-github18]

There seems to be a Java implementation in https://github.com/google/brotli/tree/master/java

[andreasrosdalw]

https://github.com/google/brotli/blob/master/java/org/brotli/wrapper/enc/BrotliOutputStream.java

The encoder in the Google version also wraps the C++ library in JNI.

[vk-github18]

In the changelog you find the following entries:

https://github.com/google/brotli/blob/master/CHANGELOG.md
[1.2.0] - 2025-10-27
kt: pure Kotlin decoder

[0.6.0] - 2017-04-10
java: pure java decoder