Akka hands-on preparation procedure from Java

This is the preparation procedure for Hands-on to touch Akka from Java.

Flow of preparation

1. Installation of required software (JDK / Maven / IntelliJ IDEA / HTTPie)

• Get source code
• Run test
• Start the server
• API operation check
• Import source code into IntelliJ IDEA

1. 1. Installation of required software

• JDK8
• I think that it will work with JDK 8 or higher, but only 8 environments have been confirmed to work (Oracle JDK)
• (Optional) Maven
• Download / [Install (https://maven.apache.org/install.html)
• • Since Maven Wrapper is included, you can do "./mvnw" and "mvn".
• (Optional) IntelliJ IDEA or another IDE
• For IntelliJ IDEA, Community version is OK
• (Optional) HTTP request sending tool something
  • CLI： HTTPie
  • GUI： Advanced REST client
• ...Such

2. Get source code

git clone [email protected]:yugolf/akka-in-action-java.git

3. 3. Run the test

• Execute in the ʻakka-in-action-java / chapter-up-and-running` directory of the obtained source code

Run the test

mvn test

Execution result

[INFO] Scanning for projects...
[INFO]
[INFO] --------------------------< com:goticks-java >--------------------------
[INFO] Building goticks-java 1.0
[INFO] --------------------------------[ jar ]---------------------------------

(abridgement)

Results :

Tests run: 14, Failures: 0, Errors: 0, Skipped: 0

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 12.740 s
[INFO] Finished at: 2018-12-08T23:19:20+09:00
[INFO] ------------------------------------------------------------------------

4. Start the server

• Execute in the ʻakka-in-action-java / chapter-up-and-running` directory of the obtained source code --After checking the operation, press Enter to finish.

Start the server

mvn compile exec:exec

5. API operation check

• If you send two HTTP requests and get the following response, it's OK (example when using HTTPie)

(1) Creating an event

HTTP request

http POST localhost:5000/events/JJUG/ tickets:=5

HTTP response

HTTP/1.1 201 Created
Content-Length: 27
Content-Type: application/json
Date: Sat, 08 Dec 2018 14:36:29 GMT
Server: GoTicks.com REST API

{
    "name": "JJUG",
    "tickets": 5
}

(2) Acquisition of event list

HTTP request (event list)

http GET localhost:5000/events/

Execution result

HTTP/1.1 200 OK
Content-Length: 40
Content-Type: application/json
Date: Sat, 08 Dec 2018 14:37:24 GMT
Server: GoTicks.com REST API

{
    "events": [
        {
            "name": "JJUG",
            "tickets": 5
        }
    ]
}

6. Import source code into IntelliJ IDEA

• Specify the directory cloned from GitHub (ʻakka-in-action-java / chapter-up-and-running) from Project from Existing Sources ...`
• ʻImport project from external model` specifies Maven
• Follow the flow and click Finish to start importing the project
• If you can see it like this, the capture is successful! !!

That's all for preparation. Thank you for your support.

Postscript

Hands-on was done on the "hands on" branch.

Switch branches

git checkout handson