[FINERACT-918] Document how to run Fineract in IDEs like Eclipse & IntelliJ - great for easy debugging!

• Type: New Feature
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 1.4.0
• Component/s: Build
• Labels: technical
• Assignee: Petri Tuomola
• Reporter: Michael Vorburger
• Created: 02/May/20 23:04
• Updated: 02/Jun/20 03:17
• Resolved: 01/Jun/20 09:48

Description

The goal of this issue is to be able to easily run (something like) org.apache.fineract.ServerApplication directly within the IDE.

While Spring Boot itself will launch just fine in-IDE, the main issue in Fineract is that it fails due to (missing) OpenJPA Enhancement. (Caused by: org.apache.openjpa.util.MetaDataException: The type "class org.apache.fineract.infrastructure.core.domain.AbstractPersistableCustom" has not been enhanced.)

One solution would be that I  resurrect my (very!!) old OPENJPA-1412 (with OPENJPA-1879 and OPENJPA-1887, see [https://openjpa.apache.org/enhancement-with-eclipse.html|https://openjpa.apache.org/enhancement-with-eclipse.html)] ... I'm JOKING!

Another much easier and perhaps more feasible approach could be to make the IDE use the same classes produced by and already enhanced during the Gradle build on the CLI?

PS: Once we have FINERACT-764, it would also be great of all ITs (first the SpringBootLoginTest and then others) could be run directly within the IDE, instead of only via Gradle on the CLI. That should, in theory, "just work" - when we resolve this.

Issue Links

• is blocked by: FINERACT-730 Fix failing gradle task bootRun & can't run simple Spring Boot java -jar (without Tomcat)
• is blocked by: FINERACT-724 Upgrade Spring Boot, Spring and Spring Security to their latest stable version
• is duplicated by: FINERACT-831 Running the App from my IntelliJ IDE does not give any error but building a war file and running the war file gives error
• links to: GitHub Pull Request #945