As programmers, we know how important it is to document our code properly—especially using Javadoc. But let's be honest: writing detailed comments every time we create a new class or method can be tedious and time-consuming.
If you're using IntelliJ IDEA, there's a convenient way to automate this without installing any third-party plugins. This post is a quick reference to help streamline your environment setup across machines and save time during development.
đź§© Auto-Generate Class and Interface Javadoc
To automatically insert Javadoc when creating a new class or interface:
- Navigate to:
File
→Settings
→Editor
→File and Code Templates
→Files
→Class
- Replace the default template with the following content:
/**
* @ClassName ${NAME}
* @Description TODO
* @Author ${USER}
* @Date ${DATE} ${TIME}
* @Version 1.0
*/
public class ${NAME} {
}
Now, every time you create a new class or interface, this Javadoc block will be generated automatically. 🚀
⚙️ Auto-Generate Method Javadoc with Live Templates
To generate Javadoc for methods quickly:
- Go to:
File
→Settings
→Editor
→Live Templates
- Click the
+
icon on the right → SelectTemplate Group...
→ Create a new group (e.g.,JavaDoc
) - Select the new group → Click
+
again → ChooseLive Template
- Set
Abbreviation
to*
(or any shortcut you like) - Add the following to the
Template Text
:
*
* @Author $user$
* @Description //TODO
* @Date $date$ $time$
* @Param $param$
* @return $return$
**/
- Click
Define
at the bottom → SelectJava
to restrict the template to Java files - Click
Edit variables
and configure them as needed (you can refer to the IntelliJ IDEA documentation or use defaults)
Once configured, you can type:
/**
Then press Tab
, and IntelliJ will expand it into a Javadoc template like this:
That’s it! You’ve now got a fast, repeatable way to generate documentation without slowing down your flow.
📝 Final Thoughts
This configuration is a small investment of time that pays off with improved productivity and consistency in your codebase. It’s especially handy when switching environments or setting up a new workspace.
Top comments (0)