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.
Difference between revisions of "Sisu/LegacyMigration"
< Sisu
m |
|||
| Line 1: | Line 1: | ||
<h1>Upgrade</h1> | <h1>Upgrade</h1> | ||
| + | |||
| + | The latest releases of Sonatype/Sisu are actually runtime wrappers that translate and delegate calls to their Eclipse/Sisu dependencies: | ||
<syntaxhighlight lang="xml"> | <syntaxhighlight lang="xml"> | ||
| Line 8: | Line 10: | ||
</dependency> | </dependency> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | <p> | |
| − | + | ||
| − | + | ||
<syntaxhighlight lang="xml"> | <syntaxhighlight lang="xml"> | ||
<dependency> | <dependency> | ||
| Line 18: | Line 18: | ||
</dependency> | </dependency> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| + | |||
| + | This enables you to migrate gradually to the new API by letting you mix components and libraries with those written against the old API. | ||
<h1>Change imports</h1> | <h1>Change imports</h1> | ||
| + | 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: | ||
| + | |||
| + | {| width="50%" border="1" style="border-collapse:collapse;padding:5px 10px;color:black;" cellspacing="0" cellpadding="5" | ||
| + | ! scope="col" | Old package | ||
| + | ! scope="col" | New package | ||
| + | |- | ||
| + | | org.sonatype.inject || org.eclipse.sisu | ||
| + | |- | ||
| + | | org.sonatype.guice.bean.binders || org.eclipse.sisu.wire | ||
| + | |- | ||
| + | | org.sonatype.guice.bean.containers || org.eclipse.sisu.launch | ||
| + | |- | ||
| + | | org.sonatype.guice.bean.converters || org.eclipse.sisu.wire | ||
| + | |- | ||
| + | | org.sonatype.guice.bean.locators || org.eclipse.sisu.inject | ||
| + | |- | ||
| + | | org.sonatype.guice.bean.reflect || org.eclipse.sisu.inject | ||
| + | |- | ||
| + | | 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.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. | ||
| − | <h1> | + | <h1>Check bindings</h1> |
Revision as of 12:30, 14 November 2013
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 letting you mix 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.sonatype.guice.bean.containers | org.eclipse.sisu.launch |
| org.sonatype.guice.bean.converters | org.eclipse.sisu.wire |
| org.sonatype.guice.bean.locators | org.eclipse.sisu.inject |
| org.sonatype.guice.bean.reflect | org.eclipse.sisu.inject |
| 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.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.