IntelliJ IDEA 2024.3 Help

Source code hierarchy

With IntelliJ IDEA, you can examine the hierarchy of classes, methods, and calls and explore the structure of source files.

Analyzing Code Hierarchies

  • Type hierarchies show parent and child classes of a class.

  • Method hierarchies show subclasses where the method overrides the selected one as well as superclasses or interfaces where the selected method gets overridden.

    In the hierarchy tree, IntelliJ IDEA displays the method should be defined icon to indicate subclasses that are not abstract but don't have the method defined in them. When a method is not defined in a class, but is defined in the superclass, IntelliJ IDEA displays the method not defined icon.

  • Call hierarchies show callers (supertypes) or callees (subtypes) of a method.

    If you invoke the call hierarchy on a field, it will show you the list of the methods where the selected field is used.

When built, a hierarchy can be immediately viewed and examined in the Hierarchy tool window. By default, every new built hierarchy overwrites the contents of the current tab. You can retain the current tab and have the next hierarchy built in a new one.

Build a type hierarchy

  1. Select the desired class in the Project tool window or open it in the editor.

  2. In the main menu, go to Navigate | Type Hierarchy or just press Ctrl+H.

    Class hierarchy shown in the Hierarchy Tool Window

Different colors of elements stand for different scopes to which these files belong. For example, green by default is used for tests. For more information, refer to Associate scopes with colors.

Build a method hierarchy

  1. Open the file in the editor and place the caret at the declaration of the desired method.

    Alternatively, select the desired method in the Project tool window.

  2. Go to Navigate | Method Hierarchy or press Ctrl+Shift+H.

Build a call hierarchy

  1. Open a file in the editor and place the caret at the declaration or usage of the desired method or a field.

    Alternatively, select the desired method or the field in the Project tool window.

  2. In the main menu, go to Navigate | Call Hierarchy or press Ctrl+Alt+H.

Retain a hierarchy tab

  • In the Hierarchy tool window, click the Pin Tab button Pin button on the toolbar.

View hierarchies

Open the Hierarchy tool window

  1. Make sure, you have already built hierarchies to show, see Building hierarchies above.

  2. Select View | Tool Windows | Hierarchy from the main menu.

Navigate between the tabs

  • Click the currently displayed tab and select the next one to display from the list.

Toggle between views

  • With IntelliJ IDEA, you can build and explore ascending or descending hierarchies, that is, callee or caller methods, parent or children classes, and so on.

    Click the Caller Hierarchy toolbar button or the Callee Hierarchy button to show caller methods or callee methods respectively.

Hierarchy tool window buttons

Item

Description

Available In

the Class Hierarchy button

Shows both the parent and child classes of the selected class, which is marked with an arrow in the tree of results.

Class hierarchies

the Caller Hierarchy toolbar button

Depending on the hierarchy type:

  • Class hierarchies: shows the hierarchy of each supertype of the current class.

  • Call hierarchies: shows the callers of the selected method.

Class hierarchies

Call hierarchies

the Callee Hierarchy button

Depending on the hierarchy type:

  • Class hierarchies: shows all classes that extend the selected class.

  • Call hierarchies: shows the callees of the selected method.

Class hierarchies

Call hierarchies

the Sort Alphabetically button

Sorts all elements within a tree alphabetically.

All hierarchies

Scope

Use this list to limit the scope of the current hierarchy:

  • Project: traces usages of the method across the project.

  • Test: traces usages of the method across the test classes.

  • All: traces usages of the method across the project and the libraries.

  • This class: limits the scope to the current class.

In addition to the preconfigured scopes, you can define your own one. To define a scope, select Configure from the list and define the required scope in the Scopes dialog.

Call hierarchies

In a method hierarchy, the tree views of the following classes are available:

  • the Plus icon: the method is defined.

  • the Minus icon: the method is defined only in the superclass.

  • the Exclamation mark icon: the method must be defined because the class is not abstract.

the Refresh button

Shows all updated classes or class structures.

All hierarchies

the Navigate with Single Click button

Moves to a file and a section in a source code that corresponds to the selected node in the hierarchy tree.

All hierarchies

the Expand All button

Expands all nodes.

All hierarchies

the Pin button

Locks the current tab from closing and reusing. Results of the next command are displayed in a new tab.

All hierarchies

the Export to Text File

Exports a hierarchy into a text file. You can specify a location for this file.

All hierarchies

the Close button

Closes the tool window.

All hierarchies

Last modified: 14 October 2024