public interface IAccessRule
On a given includepath entry, the access rules are considered in the order given
when the entry was created. When a source matches an access
rule's pattern, the access rule's kind define whether the file is considered
accessible, non accessible, or its access is discouraged. If the source
file doesn't match any accessible rule, it is considered accessible. A source
file that is not accessible or discouraged can still be refered to but it is tagged as being not
accessible - the JavaScript validator will create a problem marker for example.
The severity of the marker created from a non accessible rule is controled through
the JavaScriptCore.COMPILER_PB_FORBIDDEN_REFERENCE
compiler option.
The severity of the marker created from a discouraged rule is controled through
the JavaScriptCore.COMPILER_PB_DISCOURAGED_REFERENCE
compiler option.
Note this is different from inclusion and exclusion patterns on source includepath entries,
where a source file that is excluded is not even validated.
Files patterns look like relative file paths with wildcards and are interpreted relative
to each entry's path.
File patterns are case-sensitive and they can contain '**', '*' or '?' wildcards (see
IIncludePathEntry.getExclusionPatterns()
for the full description
of their syntax and semantics).
Note that file patterns must not include the file extension.
com/xyz/tests/MyClass
is a valid file pattern, whereas
com/xyz/tests/MyClass.class
is not valid.
Modifier and Type | Field and Description |
---|---|
static int |
IGNORE_IF_BETTER
Flag indicating that whether a type matching this rule should be ignored iff a type with
the same qualified name can be found on a later includepath entry with a better
accessibility.
|
static int |
K_ACCESSIBLE
Constant indicating that files matching the rule's pattern are accessible.
|
static int |
K_DISCOURAGED
Constant indicating that access to the files matching the rule's pattern is discouraged.
|
static int |
K_NON_ACCESSIBLE
Constant indicating that files matching the rule's pattern are non accessible.
|
Modifier and Type | Method and Description |
---|---|
int |
getKind()
|
IPath |
getPattern()
Returns the file pattern for this access rule.
|
boolean |
ignoreIfBetter()
Returns whether a type matching this rule should be ignored iff a type with
the same qualified name can be found on a later includepath entry with a better
accessibility.
|
static final int K_ACCESSIBLE
static final int K_NON_ACCESSIBLE
static final int K_DISCOURAGED
static final int IGNORE_IF_BETTER
Flag indicating that whether a type matching this rule should be ignored iff a type with the same qualified name can be found on a later includepath entry with a better accessibility.
E.g. if a type p.X matches a rule K_NON_ACCESSIBLE | IGNORE_IF_BETTER on a library entry 'lib1' and another type p.X also matches a rule K_DISCOURAGED on library entry 'lib2' ('lib2' being after 'lib1' on the includepath), then p.X from 'lib2' will be used and reported as discouraged.
IPath getPattern()
int getKind()
boolean ignoreIfBetter()
Returns whether a type matching this rule should be ignored iff a type with the same qualified name can be found on a later includepath entry with a better accessibility.
E.g. if a type p.X matches a rule K_NON_ACCESSIBLE | IGNORE_IF_BETTER on a library entry 'lib1' and another type p.X also matches a rule K_DISCOURAGED on library entry 'lib2' ('lib2' being after 'lib1' on the includepath), then p.X from 'lib2' will be used and reported as discouraged.
Copyright (c) IBM Corp. and others 2000, 2016. All Rights Reserved.