Skip to content

Latest commit

 

History

History
49 lines (35 loc) · 2.68 KB

README.md

File metadata and controls

49 lines (35 loc) · 2.68 KB

ASYNC-API

Requirements (developed and tested on)

steps to prepare and start application:

  1. Vagrant must be used to start virtual machine with callback mock server

        vagrant plugin install vagrant-vbguest
    vagrant up

    NB: be sure to have virtualization enabled in BIOS or otherwise Virtualbox will fail

  2. start application from command line

  3. Unix ./gradlew bootRun

  4. Windows ./gradlew.bat bootRun (not tested)

  5. External service is at http://localhost:8080/service/method url

Intellij IDEA

  • File -> import project
  • choose build.gradle

to unit tests and code coverage from command line (CI server)

  1. run ./gradlew test
  2. check unit tests output from console or "build/reports/test/" folder
  3. test code coverage can be seen after running ./gradlew test jacocoTestReport from "build/reports/jacoco/" directory

Generating a WAR file

To package the application as a (exuctable) WAR, type:

./gradlew bootRepackage

This will generate two files:

  1. "build/libs/asyncapi-0.0.1.war" - This one is an executable WAR file. Instead of deploying on an application server, many people find it easier to just have an exectuable WAR file (which includes Jetty/Tomcat 8, in fact). to run executable war java -jar asyncapi-0.0.1.war
  2. "asyncapi-0.0.1.war.original" - usual WAR without Jetty/Tomcat libs. Use this to deploy on separate application server

p.s. to override properties in production read http://docs.spring.io/spring-boot/docs/current/reference/html/boot-features-external-config.html#boot-features-external-config-application-property-files p.s.s. if you need to change Spring profile start app as java -jar asyncapi-0.0.1.war --spring.profiles.active=node2.

Steps to test cache replication ("horizontal scaling")

  1. vagrant up start virtualmachine with callback api mock
  2. ./gradlew bootRepackage build and package application
  3. ./gradlew.bat bootRun start application first instance (default 8080 port)
  4. java -jar build/libs/asyncapi-0.0.1.war --spring.profiles.active=node2 start second instance of application on 8081 port
  5. query second application extenal api http://localhost:8081/service/method This should make call to backend server (inside virtualmachine) and it will post data back after random delay (1ms to 6s) to first application service http://yourhost:8080/callback.service/method. As callback responses are replicated between application your second instance should show you correct response.