Migration from 13 to version 14

A migration to RapidClipse 14 consists of multiple steps. These mostly focus on the migration to Hibernate ORM 6.

Step 1 - Preparation:

  1. Download the latest RapidClipse IDE and extract it to a folder of your choice.

  2. Create a new workspace.

  3. Import your project into this workspace and create a new branch to perform the migration.

  4. Check all basic configurations within the new IDE, some examples below:

    1. JDK versions of your IDE

    2. Export/import your database connections from your old IDE to the new one.

    3. Copy your code formatter settings

    4. Install all of your previous plugins such as JRebel.

    5. Install a suitable application server such as Tomcat 10.1.

  5. Make sure there are no compiler errors in your project.

Step 2 - Automatic migration:

  1. There are two different steps that has to be done for the automatic part of the migration. Both popups should appear after importing an old project or when you bind an old workspace.

    1. Update workspace

    2. Update RapidClipse Framework

  2. You should first run the "Update Workspace" without closing the "Update RapidClipse Framework"

  3. After the workspace has been updated you can directly start "Update RapidClipse Framework"

  4. In case you missed the two popups you can start both procedures as follows:

    1. Right click Projekt → RapidClipse → Update Project

    2. Menubar - Help → Check for Framework Updates

  5. You will see following changes after migration

    1. POM.xml should be updated

      1. rap-server-core updated to version 14.0.0 or 14.0.0-SNAPSHOT

      2. vaadin-maven-plugin updated to version 24.4.7

  6. It is also possible that some compiler errors may occur after migration. See "Manual migration" for further details.

Step 3 - Manual migration :

  1. You’ll need to switch Hibernate imports from javax.persistence.* to jakarta.persistence.*

  2. Disable the JPA validation, via Right click Project → Properties - "Validation" → Remove both ticks next to "JPA Validator"

    1. After this step, execute a Maven update.

  3. Add JPA modelgen into your project

    1. +

			<build>
				<plugins>
					...
					<plugin>
						<groupId>org.apache.maven.plugins</groupId>
						<artifactId>maven-compiler-plugin</artifactId>
						<version>3.13.0</version>
						<configuration>
							<annotationProcessorPaths>
								<path>
									<groupId>org.hibernate.orm</groupId>
									<artifactId>
										hibernate-jpamodelgen
									</artifactId>
									<version>6.4.0.Final</version>
								</path>
							</annotationProcessorPaths>
						</configuration>
					</plugin>
				</plugins>
			</build>

  1. Update Persistence.xml

    1. All properties need to be switched from javax to jakarta

    2. Perform an dialect update

Step 4 - Additional hints and informations :

  1. If there are some bigger issues during migration contact us here

    1. https://github.com/orgs/RapidClipse/discussions