JAlgoArena Queue

JAlgoArena Queue is microservice dedicated for publishing incoming submissions to Apache Kafka cluster.

• Introduction
• API
• Running Locally
• Notes

Introduction

• JAlgoArena Queue allows user to publish solution for chosen problem so it may be queued within Apache Kafka and processed later on via JAlgoArena Judge agent.

API

Publish new submission

Submit new submission for chosen problem

URL	Method
/problems/:problemId/publish	POST

• Data Params

  Submission json for given problem id e.g. fib

  POST /problems/fib/publish

  {
    "sourceCode": "<source code>",
    "userId": "1"
  }

  Note: you have to submit token via header - 'X-Authorization': Bearer <token>

• Success Response:

  You will get confirmation that your solution was submitted

  • Code: 200
    Content: {"sourceCode":"<source code>","userId":"1","submissionId":"db01a2ee-fb3b-48a3-b727-47d63b6b6e10","problemId":"fib","token":"Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ1c2VyMSIsInNjb3BlcyI6WyJST0xFX1VTRVIiXSwiaXNzIjoiamFsZ29hcmVuYS5jb20iLCJpYXQiOjE1MzI2ODUyMDUsImV4cCI6MTUzNTI3NzIwNX0.45Ilu0GnQyBVYprAcgtvPHmq5tdvbwiUZucSRAFDDPU2RYY-N8cDoM8k3gl1i2r4FPV7ECZaHgcc20fZwqj_CQ","statusCode":"WAITING","elapsedTime":-1.0,"submissionTime":"2018-07-27T12:06:23.253"}

• Error Response:

  In case of wrong credentials access will be forbidden.

  • Code: 401 UNAUTHORIZED
    

• Sample Call:

  curl --header "Content-Type: application/json" \
       --header "X-Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ1c2VyMSIsInNjb3BlcyI6WyJST0xFX1VTRVIiXSwiaXNzIjoiamFsZ29hcmVuYS5jb20iLCJpYXQiOjE1MzI2ODUyMDUsImV4cCI6MTUzNTI3NzIwNX0.45Ilu0GnQyBVYprAcgtvPHmq5tdvbwiUZucSRAFDDPU2RYY-N8cDoM8k3gl1i2r4FPV7ECZaHgcc20fZwqj_CQ" \
       --data '{"sourceCode":"<source code>","userId":"1"}' \
       http://localhost:5007/problems/fib/publish

Running locally

There are two ways to run it - from sources or from binaries.

Running from binaries

• go to releases page and download last app package (JAlgoArena-Queue-[version_number].zip)
• after unpacking it, go to folder and run ./run.sh (to make it runnable, invoke command chmod +x run.sh)
• you can modify port in run.sh script, depending on your infrastructure settings. The script itself can be found in here: run.sh

Running from sources

• run git clone https://github.com/spolnik/JAlgoArena-Queue to clone locally the sources
• now, you can build project with command ./gradlew clean stage which will create runnable jar package with app sources. Next, run java -Dserver.port=8989 -jar build\libs\jalgoarena-queue-*.jar which will start application
• there is second way to run app with gradle. Instead of running above, you can just run ./gradlew clean bootRun

Notes

• Running locally
• Travis Builds