Java Reference
In-Depth Information
■
$FILE_PATH$
—The portion of the output that corresponds to a source file
$LINE$
—A line number reference
■
$COLUMN$
—A column reference
■
Only the
$FILE_PATH$
parameter is required; the line and column references are
optional, giving you a finer degree of integration if provided by your application.
Depending on your application's output, designing the output filter can be trivial
or impossible. Let's take an easy example:
Error parsing /src/scanner/RadioInterface.xml:103 Missing Closing Tag
One output filter that can match this output is
$FILE_PATH$:$LINE$
However, if colons aren't unique to the error message, you must get more creative.
Many development tools and compilers are designed to produce ma-
chine-readable output, but they often default to a friendly, more verbose
style for human users. If the output from the program you want to inte-
grate with appears too complex to parse, look for a command-line op-
tion that lets you change the output to something more easily digestible
by
IDEA
. Some programs call this
emacs mode
, after the popular
UNIX
editor that uses a similar output parsing scheme.
TIP
Understanding synchronization considerations
Tools like
XD
oclet and Castor can generate Java source code from metadata (in
JavaDoc attributes and
XML
, respectively). Running these tools, or other tools
like them, causes significant changes in your source tree—changes that
IDEA
needs to be aware of. You should select the option
Synchronize files after execu-
tion
on the
Edit Tool
dialog when creating a tool entry if your external tool will
be creating, altering, or deleting any files in your project path. This will ensure
that
IDEA
picks up the changes and updates its internal cache files appropriately.
This update applies to both source files and object files.
13.5 Using IDEA's open APIs
IDEA
provides a set of open
API
s that allow third parties to integrate their solu-
tions and extend existing functionality. JetBrains maintains the online plugin
repository, which holds more than 200 plugins.
IDEA
users can conveniently