cli-java

cli-java is a collection of commandline messaging clients suitable for interacting with Message Oriented Middleware.

Requirements

• Java 11+
• Maven 3
• for tcnative dynamic library, outdated openssl 1.0 is required
  • on Fedora 37, execute sudo dnf install -y apr https://kojipkgs.fedoraproject.org//packages/compat-openssl10/1.0.2o/11.fc33/x86_64/compat-openssl10-1.0.2o-11.fc33.x86_64.rpm
  • or, enable use of BoringSSL static library instead of the dynamic one, with -P tcnative-boringssl-static profile to maven

Getting started

mvn clean package  # compile without executing external tests (tests that require broker)
java -jar cli-qpid-jms/target/cli-qpid-jms-*.jar sender -b amqp://127.0.0.1:5672 -a myQ --log-msgs dict

IntelliJ notes

Open an existing Maven project.

Common issues

• OSGi problems (don't remember what those actually were)

When using IntelliJ IDEA Ultimate Edition, select "Open" (not "Import Project") option to open project and delete OSGi facets in File >> Project Structure >> Project Settings >> Facets.

• Unresolved reference: DaggerFakeClient, or anything else with Dagger in it

The class is generated by the Dagger annotation processor. Run mvn compile on the command line so that Maven generates what is needed.

The IDE action on the Maven tab to generate sources does not actually generate what is needed for Kotlin tests, because of a missing feature.

• Error: Unable to access jarfile [...]/target/cli-qpid-jms-1.2.2-SNAPSHOT-2.2.0.jar

IntelliJ is happy to run failsafe tests without doing the (equivalent of) mvn package first. This means that the jars used in the *ITCase tests may be nonexistent (or out of date). Run mvn package -DskipTests yourself to fix this.

Run tests

mvn test -Ptests

mvn test -Pcoverage,tests  # collect coverage using JaCoCo

mvn clean test -Dmaven.test.failure.ignore
find -wholename "*/surefire-reports/TEST-*.xml" | zip -j@ test_results.zip

Update dependencies

 mvn versions:display-dependency-updates
 mvn versions:display-plugin-updates

Update versions

mvn versions:set -DgenerateBackupPoms=false -DnewVersion=2017.07

Build docker

Uses podman. Needs sudo to hook qemu.

mvn clean
bash build_java.sh
bash build_docker.sh

Date-based versioning of image tags, use

bash build_docker.sh $(date '+%Y-%m-%d')

List of Java clis

Additional maven modules

Directories

Related projects

• https://github.com/rh-messaging/cli-netlite
• https://github.com/rh-messaging/cli-rhea
• https://github.com/rh-messaging/cli-proton-python
• https://github.com/rh-messaging/cli-proton-ruby