JBoss Tattletale can be downloaded in its binary form for easy installation.
The download location is: http://www.jboss.org/tattletale/downloads
Once downloaded extract the files by executing:
unzip jboss-tattletale-1.1.1.GA.zip
or
tar xzf jboss-tattletale-1.1.1.GA.tar.gz
depending on which archive type you downloaded.
JBoss Tattletale is now located in a folder under the directory you extracted the files into.
The JBoss Tattletale project is published in the JBoss Maven2 repository:
repository.jboss.org
under the group id of: org.jboss.tattletale
The artifacts for the project are
Developer snapshots are published on the JBoss Snapshots Maven2 server:
snapshots.jboss.org
If you want to experiment with the latest developments you may checkout the latest code from SVN. Be aware that the information provided in this manual might then not be accurate.
The anonymous SVN repository is located under:
svn co http://anonsvn.jboss.org/repos/tattletale/trunk/ tattletale-trunk
The developer SVN repository is located under:
svn co https://svn.jboss.org/repos/tattletale/trunk/ tattletale-trunk
The project is compiled using Java Development Kit 1.5 or higher, Apache Ant 1.7 or higher and Apache Ivy 2.1 or higher. Using
ant <target>
where target is one of
dist
Builds the distribution.
release
Builds the release archives.
doc
Builds the documentation for the project.
clean
Cleans the project of temporary files.
See the full list of targets in the main build.xml file.
The configuration of JBoss Tattletale is done through its
jboss-tattletale.properties
file.
The current configuration parameters includes:
Table 3.1. JBoss Tattletale configuration
Key | Value |
---|---|
reports |
A comma separated list of which reports that should be generated.
The following reports are supported:
Default: All reports (reports=*) |
classloader |
Specifies which classloader structure that should be used when scanning the archives.
Can be one of the following:
|
profiles |
Specifies a comma separated list of profiles to resolve against.
The following profiles are supported:
|
excludes |
A comma separated list of directories or files that should be excluded from the scan. F.ex.
**/server/**,myjar.jar |
blacklisted |
A comma separated list of black listed classes or packages. F.ex.
com.mycompany.forinternaluseonly, com.partner.forinternaluseonly |
scan |
A comma separated list of file extensions that should be scanned
Default: .jar |
enableDot |
Should images be generated if the Graphviz DOT application is found
Default: true |
graphvizDot |
The full path to the Graphviz DOT executable. This property is required if you want to generate
PNG files and the Graphviz bin directory is not on your path. F.ex.
graphvizDot=C:\\Graphviz2.26.3\\bin\\dot.exe orgraphvizDot=/opt/graphiz/bin/dot |
The load order for the configuration file is
NOTE: The classloader structure feature is currently based on directory structures and may therefore fail to identify archives that should be included in the reports. If you want to be sure that all archives are included use the NoopClassLoaderStructure plugin.
JBoss Tattletale supports filtering of the warnings and errors that the reports generates.
This functionality allows the user to filter out any warnings or errors that should be ignored and thereby allow the application to successful terminate.
The format of the filter properties file is
An example:
myreport=myfilter
The load order for the filter file is
See the individual reports for filtering support.
Running JBoss Tattletale is very easy
java -Xmx512m -jar tattletale.jar [-exclude=<excludes>] <sourcedir> [<outputdir>]
where the "sourcedir" is the directory that contains your Java archives and the optional "outputdir" parameter is the directory where you would like your reports to be generated. The "-exclude" option let you exclude directories or file on the command line - see the configuration file for syntax.
The main file will be generated under the output directory as index.html.
JBoss Tattletale will scan for Java Archives (.JAR) files.
JBoss Tattletale requires Java Runtime Environment 5 or higher.