blob: 4145e542fdc1ae707fd59ea76e97214557d3bf71 [file] [log] [blame]
Documentation for the Qpid components can be accessed on our website at:
http://qpid.apache.org/documentation.html
Some initial helper info can be found below.
==== Building the code and running the tests ====
Here are some example Maven build commands that you may find useful.
Clean previous builds output and install all modules to local repository without
running any of the unit or system tests.
mvn clean install -DskipTests
Perform a subset of the tests
mvn verify -Dtest=TestNamePattern* -DfailIfNoTests=false
Execute system tests against Broker-J using Java 8 or above
mvn verify -Pbroker-j
Execute system tests with AMQP 0-9-1 against Broker-J using Java 8 and above
mvn verify -Pbroker-j -Dqpid.amqp.version=0-9-1
Execute system tests against Broker-J using Java 7 and specifying a path to Java 8 executable to run the broker
mvn verify -Pbroker-j -Dqpid.systest.java8.executable=/usr/java/jdk1.8.0_121/bin/java
Execute system tests against cpp broker available on PATH
mvn verify -Pcpp
Execute system tests against cpp broker by providing path to broker executable explicitly
mvn verify -Pcpp -Dqpid.systest.broker.executable=/home/alex/qpid/qpidd
Execute the unit tests and then produce the code coverage report
mvn test jacoco:report
For more details on how to build see:
https://cwiki.apache.org/confluence/display/qpid/Qpid+Java+Build+How+To
==== Running client examples =====
Use maven to build the modules, and additionally copy the dependencies alongside their output:
mvn clean package dependency:copy-dependencies -DskipTests
Now you can then run the examples as follows:
java -cp "client/example/target/classes/:client/example/target/dependency/*" org.apache.qpid.example.Hello
The examples assume that a Broker is running on port 5672.