IntelliJ IDEA 2019.1 Help

Work with Groovy code in the editor

When you work with Groovy code in the editor, IntelliJ IDEA offers you various code completion, refactoring, inspection, and Groovy intention actions that help you write code faster and easier.

Code completion

When you access Basic Completion by pressing Ctrl+Space, you get basic suggestions for variables, types, methods, expressions, for a parameter name you get type suggestions and so on. When you call Basic Completion twice, it shows you more results.

The Smart Completion feature is aware of the expected type and data flow, and offers the options relevant to the context. To call Smart Completion, press Ctrl+Shift+Space. When you call Smart Completion twice, it shows you more results, including chains.

To let IntelliJ IDEA complete a statement for you, press Ctrl+Shift+Enter. Statement Completion will automatically add the missing parentheses, brackets, braces and the necessary formatting.

The Postfix Completion feature lets you transform an already typed expression to another one, based on the postfix you type after a dot.

For more details, refer to Auto-Completing Code.

Refactoring basics

IntelliJ IDEA offers a comprehensive set of automated code refactorings that lead to significant productivity gains when used correctly. Firstly, don't bother selecting anything before you apply a refactoring. IntelliJ IDEA is smart enough to figure out what statement you're going to refactor, and only asks for confirmation if several choices are possible.

Action

Shortcut

Rename

Shift+F6

Extract variable or type

Ctrl+Alt+V

Extract field

Ctrl+Alt+F

Extract a constant

Ctrl+Alt+C

Extract a method

Ctrl+Alt+M

Extract a parameter

Ctrl+Alt+P

Inline

Ctrl+Alt+N

Copy

F5

Move

F6

Refactor this

Ctrl+Shift+Alt+T

For more details, refer to Refactoring code.

Groovy inspections

Inspections are built-in static code analysis tools that help you find probable bugs, locate dead code, detect performance issues, and improve the overall code structure.

To check and configure the available Groovy inspections, in the Settings/Preferences dialog (Ctrl+Alt+S), go to Editor | Inspections.

Groovy inspections settings

Most inspections not only tell you where a problem is, but also provide quick fixes to deal with it right away. Press Alt+Enter to choose a quick-fix.

Inspections that are too complex to be run on-the-fly are available when you perform code analysis for the entire project. You can do this in one of the following two ways: by selecting Analyze | Inspect Code from the main menu, or by selecting Analyze | Run Inspection by Name to run an inspection by its name.

Note that while inspections provide quick-fixes for code that has potential problems, intentions help you apply automatic changes to code that is correct. To get a list of intentions applicable to the code at the caret, press Alt+Enter.

For more details, refer to Code inspections.

Groovy intentions

To read a short description of any Groovy intention action, check its code example, and disable the ones you do not need, access the Groovy intentions settings.

  1. In the Settings/Preferences dialog (Ctrl+Alt+S), go to Editor | Intentions.

  2. In the list of options, click the Groovy node, locate the intention you need and make the adjustments.

    Groovy Intentions settings

  3. Alternatively, while in the editor, when you press Alt+Enter to select an intention action from the context menu, press the arrow key next to it to select an option to edit its settings or disable the intention.

    Groovy edit intentions settings

Strings in Groovy

With the Show intentions (Alt+Enter) action you can select different intentions for strings such as changing single line into a multiline, add concatenation, convert a literal string into a GString, and so on.

  • Convert to multiline: converts a single long line into a multiline. You can break down the line without adding any concatenation. It is helpful for copying and pasting code.

  • Convert into Singleline literal: converts a multiline back into a single long line. In this case, escape sequences /n are added. You can continue and select the Break string on /n action to split the line adding the concatenation.

    Convert a                 multiline to a single line

  • Convert to String and Convert to GString: convert a GString into a regular String and vice versa.

Declare explicit type in Groovy

Among standard declarations, such as creating a field for parameter, or introducing a local variable to a result of expression, IntelliJ IDEA lets you declare an explicit type for the selected variable. Adding explicit declarations, makes code in large projects more readable and sustainable.

  • In the editor, press Alt+Enter on the selected variable and from the list of intentions, select Declare explicit type. To remove it, use the Remove explicit type action.

Convert to @CompileStatic

Since Groovy code is compiled dynamically by default, IntelliJ IDEA lets you use the @CompileStatic annotation to switch to static compilation whenever this annotation is used.

  1. In the editor you can automatically add the @CompileStatic annotation. From the context menu, select Refactor | Convert to @CompileStatic.

    IntelliJ IDEA makes the following adjustments to code:

    • The @CompileDynamic annotation is added to methods that depend on dynamic language features and which could not be automatically converted.

    • An explicit type coercion is added when it’s required.

    • An explicit type is added to fields when they can be inferred from field initializers.

    • An explicit return type is added to methods.

  2. If you added the @CompileStatic annotation manually and want to fix the related red code, invoke the Convert to @CompileStatic intention action.

Change an anonymous class into a dynamic instantiation

You can convert an anonymous class into a closure for better readability.

  1. In the editor, select a class you want to convert and press Alt+Enter.

  2. From the list of options, select Change to dynamic instantiation.

    .

Last modified: 5 June 2019

See Also