Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Sisu/LegacyMigration
Upgrade
The latest releases of Sonatype/Sisu are actually runtime wrappers that translate and delegate calls to their Eclipse/Sisu dependencies:
<dependency> <groupId>org.sonatype.sisu</groupId> <artifactId>sisu-inject-plexus</artifactId> <version>2.5.0</version> </dependency>
<dependency> <groupId>org.sonatype.sisu</groupId> <artifactId>sisu-inject-bean</artifactId> <version>2.5.0</version> </dependency>
This enables you to migrate gradually to the new API by mixing new components and libraries with those written against the old API.
Change imports
Once you have upgraded to Sonatype/Sisu 2.5.0 you can start migrating to the new API. In most cases this just involves changing imports:
Old package | New package |
---|---|
org.sonatype.inject | org.eclipse.sisu |
org.sonatype.guice.bean.binders | org.eclipse.sisu.wire org.eclipse.sisu.space |
org.sonatype.guice.bean.containers | org.eclipse.sisu.launch |
org.sonatype.guice.bean.converters | org.eclipse.sisu.wire |
org.sonatype.guice.bean.inject | org.eclipse.sisu.bean |
org.sonatype.guice.bean.locators | org.eclipse.sisu.inject |
org.sonatype.guice.bean.locators.spi | org.eclipse.sisu.inject |
org.sonatype.guice.bean.reflect | org.eclipse.sisu.inject org.eclipse.sisu.bean org.eclipse.sisu.space |
org.sonatype.guice.bean.scanners.index | org.eclipse.sisu.space |
org.sonatype.guice.bean.scanners | org.eclipse.sisu.space |
org.sonatype.guice.plexus.annotations | org.eclipse.sisu.plexus |
org.sonatype.guice.plexus.binders | org.eclipse.sisu.plexus |
org.sonatype.guice.plexus.config | org.eclipse.sisu.plexus |
org.sonatype.guice.plexus.converters | org.eclipse.sisu.plexus |
org.sonatype.guice.plexus.lifecycles | org.eclipse.sisu.plexus |
org.sonatype.guice.plexus.locators | org.eclipse.sisu.plexus |
org.sonatype.guice.plexus.scanners | org.eclipse.sisu.plexus |
org.sonatype.guice.plexus.shim | org.eclipse.sisu.plexus |
All the old types have been marked as deprecated to help identify which components you need to upgrade.