(this is a draft)
| Table of Contents |
|---|
This documentation provides some help for backend developers to get started. It is most likely incomplete, so please don't hesitate to ask and add information here as needed.
See also: Overview for a new developer and Newcomer's first steps
Running in IDEA
Installation
- Install Java JDK 11
Install IDEA as IDE : https://www.jetbrains.com/idea/
- Install last version of Vagrant : https://www.vagrantup.com/
- Install VirtualBox : https://www.virtualbox.org/
- Install Postman: https://www.postman.com/
- Clone from git modules and add all of them in one IDEA project
- ThunderJet back-end modules : mod-orders, mod-orders-storage, mod-invoice, mod-invoice-storage, mod-finance, mod-finance-storage, mod-organizations, mod-organizations-storage, mod-gobi, edge-orders, edge-common, mod-ebsconet, acq-models
- Modules with integration tests: folio-integration-tests(Karate), folio-api-tests(Postman)
- Up FOLIO platform by using one of the box :
- Back-end + UI : https://app.vagrantup.com/folio/boxes/testing
- Only Back-End : https://app.vagrantup.com/folio/boxes/testing-backend
- See build times at https://dev.folio.org/guides/automation/#reference-environments
- Configure VitualBox and IDEA for running FOLIO microservice from IDEA : How to run folio backend modules with IntelliJ Idea and interact with Vagrant box environment
...
If a module was already deployed and a new version needs to be tested for integration tests, it is not necessary to remove the old version: simply add .xxx to the id in the descriptor, with a number higher than the currently deployed one, and the karate tests will automatically use the latest version.
Debugging
TODOModules can be executed in debug mode in IDEA, they just need to be deployed as described above.. Unit tests can also be debugged in the same way.
change log level for mod-invoice-storage:
http://localhost:8097/admin/loglevel?level=INFO&java_package=org.folio.rest.persist.PostgresClient
...