A Java library for generating event hashes for EPCIS documents/events in XML/JSON-LD format. EPCIS, a GS1 standard recognized by ISO, IEC, and GS1, enhances cooperation between trading partners by exchanging data on products. The OpenEPCIS Event Hash Generator helps avoid duplicate event storage due to issues like hardware malfunctions or human error, ensuring data uniqueness and integrity.
- Features
- Running with Docker and Podman
- Running Native Binaries
- Usage Examples
- Releases
- Related Projects
- References
- Reactive Streams: Offers efficient processing of millions of events through non-blocking back pressure.
- Hash Algorithms: Supports a wide range of algorithms including SHA, RSA, and MD5, catering to various security needs.
- CBV Versions: Ensures compatibility with both CBV 2.0 and 2.1 versions, enhancing flexibility.
- Quarkus GraalVM Native Builds: Dramatically reduces startup times and memory usage, ideal for cloud-native, microservices, and serverless architectures. Enables AOT compilation for creating lightweight, high-performance native executables.
Offers robust performance and portability across different platforms, harnessing the versatility of the Java Virtual Machine.
Package URL: Event Hash Generator Service - JVM
docker pull ghcr.io/openepcis/event-hash-generator-service:latest
docker run --rm -p 9000:9000 --name event-hash-generator-jvm ghcr.io/openepcis/event-hash-generator-service:latestpodman pull ghcr.io/openepcis/event-hash-generator-service:latest
podman run --rm -p 9000:9000 --name event-hash-generator-jvm ghcr.io/openepcis/event-hash-generator-service:latestProvides lightning-fast startup and reduced memory footprint, thanks to ahead-of-time compilation with GraalVM, perfect for high-performance and resource-constrained environments.
Package URL: Event Hash Generator Service - Native
docker pull ghcr.io/openepcis/event-hash-generator-service-native:latest
docker run --rm -p 9000:9000 --name event-hash-generator-native ghcr.io/openepcis/event-hash-generator-service-native:latestpodman pull ghcr.io/openepcis/event-hash-generator-service-native:latest
podman run --rm -p 9000:9000 --name event-hash-generator-native ghcr.io/openepcis/event-hash-generator-service-native:latestNative binaries are platform-specific compiled versions of software, optimized for enhanced performance on the designated operating system and architecture. The OpenEPCIS Event Hash Generator offers native binaries for various platforms, eliminating the need for a Java runtime environment.
Find the latest versions of these binaries at: Latest Release.
- CLI (Command Line Interface): Ideal for batch processing. It provides a range of command-line options for customized operation.
- Service Runner: Functions as a REST service on port 9000, with a Swagger UI accessible at
http://localhost:9000/q/swagger-ui/index.html.
Replace [platform] and [version] with the appropriate platform (mac, windows, linux-amd64, linux-arm64) and version number:
# Usage example
./openepcis-event-hash-generator-cli-[version]-[platform]CLI Options:
usage: OpenEPCIS Event Hash Generator Utility: [options] file.. url.., -
-a,--algorithm <arg> Hash Algorithm (e.g., sha-256).
-b,--batch Output hashes to a .hashes file.
-e,--enforce-format <arg> Parse files as JSON or XML.
-h,--help Show options.
-j,--join <arg> String to join the prehash string.
-p,--prehash Output the prehash string.Replace [platform] and [version] with the appropriate platform (mac, windows, linux-amd64, linux-arm64) and version number:
# Usage example
./openepcis-event-hash-generator-service-runner-[version]-[platform]
The Swagger UI will be accessible at http://localhost:9000/q/swagger-ui/index.html.
Below are examples demonstrating how to integrate the OpenEPCIS Event Hash Generator into your Java application. These snippets illustrate the basic setup and usage for both XML and JSON/JSON-LD documents.
// Initialize EventHashGenerator with the desired CBV version
EventHashGenerator eventHashGenerator = new EventHashGenerator(); // Defaults to CBV 2.0
EventHashGenerator eventHashGenerator2_1 = new EventHashGenerator(CBVVersion.VERSION_2_1_0); // For CBV 2.1
// Generate Hash-Ids from an XML document stream
InputStream xmlStream = getClass().getResourceAsStream("/XmlEpcisDocument.xml");
List<String> xmlHashIds = eventHashGenerator.fromXml(xmlStream, "sha-256").subscribe().asStream().toList();// Initialize EventHashGenerator with the desired CBV version
EventHashGenerator eventHashGenerator = new EventHashGenerator(); // Defaults to CBV 2.0
EventHashGenerator eventHashGenerator2_1 = new EventHashGenerator(CBVVersion.VERSION_2_1_0); // For CBV 2.1
// Generate Hash-Ids from a JSON document stream
InputStream jsonStream = getClass().getResourceAsStream("/JsonEpcisDocument.json");
List<String> jsonHashIds = eventHashGenerator.fromJson(jsonStream, "sha-256").subscribe().asStream().toList();This example shows how to utilize Reactive Streams for efficient and immediate processing of generated HashIds.
// Use EventHashGenerator with Reactive Streams for on-the-fly processing of HashIds
EventHashGenerator eventHashGenerator = new EventHashGenerator();
Multi<Map<String, String>> xmlEventHash = eventHashGenerator.fromXml(xmlStream, "prehash", "sha-256");
// Subscribe to the stream to process each HashId as it's generated
xmlEventHash.subscribe().with(xmlHash -> System.out.println(xmlHash.get("sha-256") + "\n" + xmlHash.get("prehash") + "\n\n"), failure -> System.out.println("XML HashId Generation Failed with " + failure));Stay updated with the newest features and improvements by downloading the latest version of the OpenEPCIS Event Hash Generator:
Download the Latest Release: Click Here
- Core Library: openepcis-event-hash-generator
- Command-Line Utility: openepcis-event-hash-generator-cli
- RESTful Service Bindings: openepcis-event-hash-generator-rest-api
- Quarkus REST Application: openepcis-event-hash-generator-quarkus-app
For detailed documentation on event hash generation and canonicalization, visit the GitHub Repository.