• see Running Static Analysis 1 for information on pointing to the data location). You can use multiple -resource switches to specify multiple resources.

  Code Block
  -resource [pattern]

• Configure the jtest.resource property in the .properties file. Separate multiple resources with a comma:

  Code Block
  jtest.resource=pattern1,pattern2

Ant and Maven Pattern

If you use Ant or Maven, you can use the following pattern:

<resource>pattern</resource>

You can use the <resources> element to define multiple resources

<resources>
    <resource>pattern1</resource>
    <resource>pattern2</resource>
</resources>

Resource Pattern Syntax

Resource patterns are matched to generated paths according to the following convention: 

ProjectName/resource/inside/of/project/directory.extension
ProjectName/EXT/resource/inside/of/external/source/directories.extension

The ProjectName value is generated according to following rules:

• The Ant project name is taken from name property of project tag
• The Maven project name takes formofgroupId:artifactId
• The Gradle project name is takenfromgradle.settings file
• Project names configured in IDEs are fully maintained

You can customize the Maven and Gradle project names with theprojectNameTemplateparameter. For details, see the build system plug-in manuals: [INSTALL]/manuals/ plugins-manual.html. 

Generated paths include the EXT string if the specified scope includes external resources. For example, an analyzed project may include sourcefilesformanotherlocationthatarelinkedto the project. In the following example the Simple.java file is located within the Demo project, whereas the Money.java file has been added by linking and itslocationsisoutsideof the project: 

Demo/src/main/java/examples/eval/Simple.java
Demo/EXT/examples/bank/Money.java

You can use Ant-style wildcards and other parameters to refine patterns. The following table describes supported usage:

If the -resource argument only contains one value, the value is matched against the project name and a wildcard (*) will be used. The following table shows examples of -resource switch usage.

Fine-tuning the Scope

Use the -include and -exclude switches to apply additional filters to the scope.

• -include instructs Static Analysis Engine to test only the files that match the file system path; all other files are skipped.
• -exclude instructs Static Analysis Engine to test all files except for those that match the file system path.

If both switches are specified, then all files that match -include, but not those that match -exclude patterns are tested.

-include pattern
-exclude pattern

Alternatively, you can specify the pattern in the .properties file with the following options:

jtest.include=pattern
jtest.exclude=pattern

Ant and Maven Pattern

If you use Ant or Maven, you can use the following pattern:

<include>pattern</include>
<exclude>pattern</exclude>

Use Ant-style wildcards and other parameters to with the -include and -exclude filters. The following table describes their usage:  

You can specify a file system path to a list file (*.lst) to include or exclude files in bulk. Each item in the *.lst file is treated as a separate entry.  

Examples

Creating

Custom .json Data Files

In typical scenarions, Jtest runs on jtest.data.json data files that are automatically generated by build system plugins. Alternatively, you can manually create a .json file and provide Jtest with the path to that file using the -data command line option (see Running Static Analysis 1).

To manually create a data file Jtest will use for analysis, run jtestcli with the -project options. The available options are listed in the table below.

The example.data.json file is created in the root of the project configured with the -project.location option.

Example

-project.location C:/ExampleProject
-project.name ExampleProject
-project.encoding UTF-8
-project.sourcepath C:/ExampleProject/src
-project.sourcelevel C:/ExampleProject/src-test
-project.classpath C:/ExampleProject/lib/test.jar;C:/ExampleProject/lib/test2.jar
-project.javahome C:/Program Files/Java/jdk1.7