Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
devel:documentation:quickstart:dev:ide:idea [2023/11/09 09:36]
kolombom [Configure test runner] 		devel:documentation:quickstart:dev:ide:idea [2023/12/05 08:51] (current)
kolombom [Importing a Module]
Line 7: Line 7:
 ====== Import project ====== ====== Import project ======
  
-  - Open Idea and choose to //Import project (File -> New -> Project from Existing Sources)// +  - Open Idea and choose to //Import project (File → New → Project from Existing Sources)// 
-  - Import the ''/--path--/CzechIdM/Realization/backend/aggregator''  project, where ''--path--''  is wherever you pulled your sources, click //Next//+  - Import the ''/–path–/CzechIdM/Realization/backend/aggregator''  project, where ''–path–''  is wherever you pulled your sources, click //Next//
   - {{  .:importmaven.png?nolink&460x581  }}The aggregator project should import all dependencies automatically, give it some time.   - {{  .:importmaven.png?nolink&460x581  }}The aggregator project should import all dependencies automatically, give it some time.
   - Next. Next… Project should be imported.   - Next. Next… Project should be imported.
Line 62: Line 62:
  
 Save the configuration and test it by running. Tests from all modules should be executed. Save the configuration and test it by running. Tests from all modules should be executed.
- 
  
 ====== Launch on Tomcat ====== ====== Launch on Tomcat ======
Line 68: Line 67:
 First of all make sure that you have Tomcat 9.0 installed. Then chose Tomcat server in Run/Debug Configurations in IDEA. Set URL to "http://localhost:8080/idm-backend/". On a "Deployment" tab set Application context to ''idm-backend/''. Apply and try to launch the project on server. At this point I had an error that said something like "name or service not known", there is the link that helped me solving this error: "https://stackoverflow.com/questions/19068977/intellij-cant-start-simple-web-application-unable-to-ping-server-at-localhost". First of all make sure that you have Tomcat 9.0 installed. Then chose Tomcat server in Run/Debug Configurations in IDEA. Set URL to "http://localhost:8080/idm-backend/". On a "Deployment" tab set Application context to ''idm-backend/''. Apply and try to launch the project on server. At this point I had an error that said something like "name or service not known", there is the link that helped me solving this error: "https://stackoverflow.com/questions/19068977/intellij-cant-start-simple-web-application-unable-to-ping-server-at-localhost".
  
-{{  .:backend-path.png?nolink&780x182  }}​​​​​​​+{{  .:backend-path.png?nolink&780x182  }}
  
 TIP 01: Deploy exploded artefact instead of compressed one. TIP 01: Deploy exploded artefact instead of compressed one.
  
 TIP 02: If there is nothing deployed to the server check File → Project Structure → Artefacts tab. Add all modules you want to deploy to the artefact you deploy. This should happen automatically by Maven but sometimes it doesn't. TIP 02: If there is nothing deployed to the server check File → Project Structure → Artefacts tab. Add all modules you want to deploy to the artefact you deploy. This should happen automatically by Maven but sometimes it doesn't.
 +
 +====== Importing a Module ======
 +
 +To develop a module alongside main CzechIdm, import the module from Project Structure > Project Settings > Modules > Right click in the list of modules > Add > Import Module
 +
 +{{.:screenshot2023-12-04153509.png?nolink&1035x921}}
 +
 +When the module is imported, go to Artifacts tab and drag the module artifact over idm-backend.war.
 +
 +{{.:idm-war.png?nolink&855x579}}
 +
 +Then rebuild the project.
 +
 +<note important>When you reload Maven configuration, this change will disappear and you have to re-add the module to war again</note>
 +
 +
 +===== Troubleshooting =====
 +
 +If you see errors with missing dependencies, try to reload Maven profiles (double-shift > reload Maven).
 +
 +If that doesn't help, try to rebuild project from command line ''mvn clean install -DskipTests''
  
  
  • by kolombom