Sonatype Insight plug-in for Eclipse

Skip to end of metadata
Go to start of metadata

What is the Sonatype Insight plug-in for Eclipse?

The Sonatype Insight plug-in for Eclipse helps you gain insight into the Java libraries used by a project. It helps answer three questions:

  • Is this the most recent version a library?
  • Is this library used consistently across a project?
  • Why is this library being used? 

The answer to these questions is primarily found in the "Dependency Hub" view that is provided by this plugin. The "Dependency Hub" view shows  all the Java libraries used in the workspace, present available new versions, allow to search for references and update a particular library.

Plug-in feature list

  • Show the Java libraries used by Java projects including Maven, PDE, JDT.
  • Show the versions available for a given library.
  • Search for references to a Java library in the workspace.
  • Update Maven projects to use a new version of a library.

User Guide

Overview of the dependency hub view

The picture below shows the "Dependency hub" view. It is divided into two sections, an overview on the left, and a details section on the right. The overview presents a list of all the libraries used by the projects contained in the workspace, whereas the details provides a list of the available versions. Libraries that are brought in transitively are shown in a light grey. 

Having shown with a "red X" overlay means that the artifact could not be identified. For Maven projects, the identification process will query the repositories associated with the Maven project, whereas for other projects, it will only query Maven Central.

 

Icon legends

In the details section:

 Show major updates (e.g. from 3.0 to 4.0).
 Show minor updates (e.g. from 3.1 to 3.2).
 Show micro updates (e.g. from 3.0.1 to 3.0.2).
 Show snapshot versions.
 Show older versions than current one.

In the overview section:
 Indicates that an major update and a micro update is available. Other combinations of this icon exist.
 Indicates that a released version of the library is available.
 Indicates that the library has not yet been processed.

Upgrading a library to a new version

For Maven projects only, the dependency plug-in allows to easily update a library to a new version. To perform this operation, select the desired version in the details section and hit the "Mark for upgrade" button. Repeat this operation for all the desired libraries, then hit the "commit changes" button. Hitting the "commit changes" button will bring up the Eclipse refactoring wizard which will present the edits made to the files.

The upgrade facility supports usage of properties, introduction of management section, and changes to the version section of the dependency. Note that when the operation is complete, the view will only be updated one the build is complete.

Finding references to a library

In order to help locate why a library is used, it suffices to right click on a dependency in the overview section of the view and select "locate declarations" or use the button in the view toolbar. This will cause the results to be revealed in the Eclipse Search view (see picture below). For Maven projects, the user will have the possibility to directly jump to the relevant declaration in the pom.xml. For Java projects the Java Build path dialog is shown, and for PDE the Manifest.mf will be opened.

Install instructions

Sonatype Insight plug-in for Eclipse runs on Eclipse 3.6 (aka Helios) and Eclipse 3.7 (aka Indigo).

Feedback and bugs

Feedback and bugs can be reported at: https://issues.sonatype.org/browse/SIPE

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Aug 20, 2011

    Anonymous says:

    Cannot complete the install because of a conflicting dependency.   Software...

    Cannot complete the install because of a conflicting dependency.
      Software being installed: Sonatype Insight plug-in for Eclipse - beta 1.0.0.v20110617 (com.sonatype.dependencies.eclipse.feature.feature.group 1.0.0.v20110617)
      Software currently installed: Maven Integration for Eclipse (Required) 0.12.1.20110112-1712 (org.maven.ide.eclipse.feature.feature.group 0.12.1.20110112-1712)
      Only one of the following can be installed at once: 
        Maven Integration for Eclipse 0.12.1.20110112-1712 (org.maven.ide.eclipse 0.12.1.20110112-1712)
        Maven Integration for Eclipse 0.12.0.20101115-1102 (org.maven.ide.eclipse 0.12.0.20101115-1102)
        This version of m2eclipse cannot be installed on top of the already installed m2eclipse. Uninstall the previous version of m2eclipse and try the install again. 1.0.0.20110607-2117 (org.maven.ide.eclipse 1.0.0.20110607-2117)
      Cannot satisfy dependency:
        From: Sonatype Insight plug-in for Eclipse - beta 1.0.0.v20110617 (com.sonatype.dependencies.eclipse.feature.feature.group 1.0.0.v20110617)
        To: org.eclipse.m2e.feature.feature.group [1.0.0,2.0.0)
      Cannot satisfy dependency:
        From: m2e - Maven Integration for Eclipse 1.0.0.20110607-2117 (org.eclipse.m2e.feature.feature.group 1.0.0.20110607-2117)
        To: bundle org.maven.ide.eclipse [1.0.0.20110607-2117]
      Cannot satisfy dependency:
        From: Maven Integration for Eclipse (Required) 0.12.1.20110112-1712 (org.maven.ide.eclipse.feature.feature.group 0.12.1.20110112-1712)
        To: org.maven.ide.eclipse [0.12.1.20110112-1712]
    Cannot complete the install because of a conflicting dependency.

      Software being installed: Sonatype Insight plug-in for Eclipse - beta 1.0.0.v20110617 (com.sonatype.dependencies.eclipse.feature.feature.group 1.0.0.v20110617)

      Software currently installed: Maven Integration for Eclipse (Required) 0.12.1.20110112-1712 (org.maven.ide.eclipse.feature.feature.group 0.12.1.20110112-1712)

      Only one of the following can be installed at once: 

        Maven Integration for Eclipse 0.12.1.20110112-1712 (org.maven.ide.eclipse 0.12.1.20110112-1712)

        Maven Integration for Eclipse 0.12.0.20101115-1102 (org.maven.ide.eclipse 0.12.0.20101115-1102)

        This version of m2eclipse cannot be installed on top of the already installed m2eclipse. Uninstall the previous version of m2eclipse and try the install again. 1.0.0.20110607-2117 (org.maven.ide.eclipse 1.0.0.20110607-2117)

      Cannot satisfy dependency:

        From: Sonatype Insight plug-in for Eclipse - beta 1.0.0.v20110617 (com.sonatype.dependencies.eclipse.feature.feature.group 1.0.0.v20110617)

        To: org.eclipse.m2e.feature.feature.group [1.0.0,2.0.0)

      Cannot satisfy dependency:

        From: m2e - Maven Integration for Eclipse 1.0.0.20110607-2117 (org.eclipse.m2e.feature.feature.group 1.0.0.20110607-2117)

        To: bundle org.maven.ide.eclipse [1.0.0.20110607-2117]

      Cannot satisfy dependency:

        From: Maven Integration for Eclipse (Required) 0.12.1.20110112-1712 (org.maven.ide.eclipse.feature.feature.group 0.12.1.20110112-1712)

        To: org.maven.ide.eclipse [0.12.1.20110112-1712]

    1. Sep 13, 2011

      Anonymous says:

      This happens because you have m2e 0.12 installed and this plugin depends on m2e ...

      This happens because you have m2e 0.12 installed and this plugin depends on m2e 1.0 available from the eclipse servers.

Add Comment