Chapter 3. Getting started

This chapter guides you through the steps to set up your environment and run a simple messaging program.

3.1. Prerequisites

  • You must complete the installation procedure for your environment.
  • You must have an AMQP 1.0 message broker listening for connections on interface localhost and port 5672. It must have anonymous access enabled. For more information, see Starting the broker.
  • You must have a queue named amq.topic. For more information, see Creating a queue.

3.2. Running HelloWorld on Red Hat Enterprise Linux

The Hello World example creates a connection to the broker, sends a message containing a greeting to the amq.topic queue, and receives it back. On success, it prints the received message to the console.

Change to the <install-dir>/examples/netcoreapp3/HelloWorld-simple and use dotnet run to build and execute the program.

$ cd <install-dir>/examples/netcoreapp3/HelloWorld-simple
$ dotnet run
Hello World!

3.3. Running Hello World on Microsoft Windows

The Hello World example creates a connection to the broker, sends a message containing a greeting to the amq.topic queue, and receives it back. On success, it prints the received message to the console.

Procedure

  1. Navigate to <install-dir> and open the amqp.sln solution file in Visual Studio.
  2. Select Build Solution from the Build menu to compile the solution.
  3. Open a command prompt window and execute the following commands to send and receive a message:

    > cd <install-dir>\bin\Debug
    > HelloWorld-simple
    Hello World!