# Validator Exclusion

###### Identifier:

org.eclipse.wst.validation.exclude

###### Since:

WebTools 3.0

###### Description:

A way to add additional exclusion filters to a V2 validator.

###### Configuration Markup:

<!ELEMENT extension (validator+)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #REQUIRED

name CDATA #IMPLIED>

- id - A short id that is unique within the plug-in, so that this set of extra exclusion filters can be identified.
- name - The short user friendly name for the exclusion.

<!ELEMENT validator (exclude)>

<!ATTLIST validator

id IDREF #REQUIRED>

Identifies the validator that is being extended.

- id - The fully qualifed validator id that is being extended.

<!ELEMENT exclude (rules)>

This contains a set of exclusion rules, used in filtering which resources get validated. If any of these rules are matched, then the validator is not called on this resource.

<!ELEMENT fileext EMPTY>

<!ATTLIST fileext

ext CDATA #REQUIRED

caseSensitive (true | false) >

A file extension, for example html.

- ext - The file extension, for example html.
- caseSensitive - If the file extension is case sensitive, then this needs to be set to true.

<!ELEMENT projectNature EMPTY>

<!ATTLIST projectNature

id CDATA #REQUIRED>

Used to filter on project natures.

- id - The fully qualified project nature id, for example "org.eclipse.jdt.core.javanature".

<!ELEMENT file EMPTY>

<!ATTLIST file

name CDATA #REQUIRED

caseSensitive (true | false)

type (folder|file|full) >

- name - The file or folder name. The file name can be fully qualified, that is it starts with a leading slash ("/"), or it can be a relative name. Folder names are separated with the forward slash ("/") character.
- caseSensitive - If the file name is not case senstitive, then this needs to be set to false.
- type - Type of name, there are three choices.
  - folder - specifies a project relative folder name.
  - file - a simple file name (i.e. no path information).
  - full - a fully qualified (project relative) file name.

<!ELEMENT rules (fileext* , file* , projectNature* , facet* , contentType* , pattern*)>

A set of rules for determining if a resource is passed to this validator or not. The rules are OR'ed together.

<!ELEMENT facet EMPTY>

<!ATTLIST facet

id CDATA #REQUIRED>

- id - The facet id.

<!ELEMENT contentType EMPTY>

<!ATTLIST contentType

id CDATA #REQUIRED

exactMatch (true | false) >

Used to filter based on content types.

- id - The content type id.
- exactMatch - Set to true if the content type needs to match exactly. Set to false if sub types are considered matches as well.

<!ELEMENT pattern EMPTY>

<!ATTLIST pattern

regex CDATA #REQUIRED

caseSensitive (true | false) >

Holds a regualr expression, that matches the resource's project relative name.

- regex - Holds a Java regular expression. See the class java.util.regex.Pattern for more details. This regular expression is matched against a resource's project relative path, after that path has been converted into a portable path.

  The path will always start with a forward slash (/) so that folder names can be more easily matched.

- caseSensitive - If the file name is not case senstitive, then this needs to be set to false.

###### Examples:

<exclude> <rules> </rules> </exclude>