README.txt

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.