Getting started - running a Java sample application

This "Getting Started" document shows you how to build and run any of the samples contained within the samples folder.

Prerequisites

Before you get started, you should:

Prepare your development environment
Setup your IoT Hub
Configure your device in IoT Hub.
See the section "Configure IoT Hub connection" in the document How to use Device Explorer.

If you have successfully prepared your development environment the IoT device SDK and all samples should be built and ready to use.

Start a new instance of the Device Explorer, select or create a new device, obtain and note the connection string for the device, and begin moitoring under the Data tab.
Navigate to the folder containing the executable JAR file for the sample that you wish to run and run the samples as follows:

The executable JAR file for sending event can be found at:
```
{IoT device SDK root}/java/device/samples/send-event/target/send-event-{version}-with-deps.jar
```
Navigate to the directory with the event sample. Run the sample using the following command:
```
java -jar ./send-event-{version}-with-deps.jar "{connection string}" "{number of requests to send}" "{https or amqps}"
```
The executable JAR file for receiving messages can be found at:
```
{IoT device SDK root}/java/device/samples/handle-messages/target/handle-messages-{version}-with-deps.jar
```
Navigate to the directory with the messages sample. Run the sample using the following command:
```
java -jar ./handle-messages-{version}-with-deps.jar "{connection string}" "{https or amqps}"
```
Note that the double quotes around each argument are required, but the braces '{' and '}' should be removed.

To learn how to create a Java application that communicates with an IoT hub from scratch, see How to write an Azure IoT client application from scratch with Java on Windows.

The documentation can be found here.