PathWatcher.Config (Jetty :: Project 9.4.3.v20170317 API)

java.lang.Object
- org.eclipse.jetty.util.PathWatcher.Config

Enclosing class:: PathWatcher

public static class PathWatcher.Config
extends Object

Field Summary

Fields
Modifier and Type	Field and Description
`protected Path`	`dir`
`protected boolean`	`excludeHidden`
`protected List<PathMatcher>`	`excludes`
`protected List<PathMatcher>`	`includes`
`protected int`	`recurseDepth`
`static int`	`UNLIMITED_DEPTH`

Constructor Summary

Constructors
Constructor and Description

Config(Path path)

Constructors
Constructor and Description
`Config(Path path)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addExclude(PathMatcher matcher)` Add an exclude PathMatcher
`void`	`addExclude(String syntaxAndPattern)` Add an exclude PathMatcher.
`void`	`addExcludeGlobRelative(String pattern)` Add a `glob:` syntax pattern exclude reference in a directory relative, os neutral, pattern.
`void`	`addExcludeHidden()` Exclude hidden files and hidden directories
`void`	`addExcludes(List<String> syntaxAndPatterns)` Add multiple exclude PathMatchers
`void`	`addInclude(PathMatcher matcher)` Add an include PathMatcher
`void`	`addInclude(String syntaxAndPattern)` Add an include PathMatcher
`void`	`addIncludeGlobRelative(String pattern)` Add a `glob:` syntax pattern reference in a directory relative, os neutral, pattern.
`void`	`addIncludes(List<String> syntaxAndPatterns)` Add multiple include PathMatchers
`PathWatcher.Config`	`asSubConfig(Path dir)` Build a new config from a this configuration.
`Path`	`getPath()`
`int`	`getRecurseDepth()`
`boolean`	`isExcluded(Path dir)`
`boolean`	`isIncluded(Path dir)`
`boolean`	`isRecurseDepthUnlimited()`
`boolean`	`matches(Path path)`
`void`	`setRecurseDepth(int depth)` Set the recurse depth for the directory scanning.
`boolean`	`shouldRecurseDirectory(Path child)` Determine if the provided child directory should be recursed into based on the configured `setRecurseDepth(int)`
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - UNLIMITED_DEPTH
```
public static final int UNLIMITED_DEPTH
```
    See Also:
    
    Constant Field Values
  - dir
```
protected final Path dir
```
  - recurseDepth
```
protected int recurseDepth
```
  - includes
```
protected List<PathMatcher> includes
```
  - excludes
```
protected List<PathMatcher> excludes
```
  - excludeHidden
```
protected boolean excludeHidden
```
- Constructor Detail
  - Config
```
public Config(Path path)
```
- Method Detail
  - addExclude
```
public void addExclude(PathMatcher matcher)
```
    Add an exclude PathMatcher
    
    Parameters:
    
    matcher - the path matcher for this exclude
  - addExclude
```
public void addExclude(String syntaxAndPattern)
```
    Add an exclude PathMatcher.
    Note: this pattern is FileSystem specific (so use "/" for Linux and OSX, and "\\" for Windows)
    
    Parameters:
    
    syntaxAndPattern - the PathMatcher syntax and pattern to use
    
    See Also:
    
    for detail on syntax and pattern
  - addExcludeGlobRelative
```
public void addExcludeGlobRelative(String pattern)
```
    Add a glob: syntax pattern exclude reference in a directory relative, os neutral, pattern.
```
    On Linux:
    Config config = new Config(Path("/home/user/example"));
    config.addExcludeGlobRelative("*.war") => "glob:/home/user/example/*.war"
 
    On Windows
    Config config = new Config(Path("D:/code/examples"));
    config.addExcludeGlobRelative("*.war") => "glob:D:\\code\\examples\\*.war"

 
```
    Parameters:
    
    pattern - the pattern, in unixy format, relative to config.dir
  - addExcludeHidden
```
public void addExcludeHidden()
```
    Exclude hidden files and hidden directories
  - addExcludes
```
public void addExcludes(List<String> syntaxAndPatterns)
```
    Add multiple exclude PathMatchers
    
    Parameters:
    
    syntaxAndPatterns - the list of PathMatcher syntax and patterns to use
    
    See Also:
    
    for detail on syntax and pattern
  - addInclude
```
public void addInclude(PathMatcher matcher)
```
    Add an include PathMatcher
    
    Parameters:
    
    matcher - the path matcher for this include
  - addInclude
```
public void addInclude(String syntaxAndPattern)
```
    Add an include PathMatcher
    
    Parameters:
    
    syntaxAndPattern - the PathMatcher syntax and pattern to use
    
    See Also:
    
    for detail on syntax and pattern
  - addIncludeGlobRelative
```
public void addIncludeGlobRelative(String pattern)
```
    Add a glob: syntax pattern reference in a directory relative, os neutral, pattern.
```
    On Linux:
    Config config = new Config(Path("/home/user/example"));
    config.addIncludeGlobRelative("*.war") => "glob:/home/user/example/*.war"
 
    On Windows
    Config config = new Config(Path("D:/code/examples"));
    config.addIncludeGlobRelative("*.war") => "glob:D:\\code\\examples\\*.war"

 
```
    Parameters:
    
    pattern - the pattern, in unixy format, relative to config.dir
  - addIncludes
```
public void addIncludes(List<String> syntaxAndPatterns)
```
    Add multiple include PathMatchers
    
    Parameters:
    
    syntaxAndPatterns - the list of PathMatcher syntax and patterns to use
    
    See Also:
    
    for detail on syntax and pattern
  - asSubConfig
```
public PathWatcher.Config asSubConfig(Path dir)
```
    Build a new config from a this configuration.
    Useful for working with sub-directories that also need to be watched.
    
    Parameters:
    
    dir - the directory to build new Config from (using this config as source of includes/excludes)
    
    Returns:
    
    the new Config
  - getRecurseDepth
```
public int getRecurseDepth()
```
  - isRecurseDepthUnlimited
```
public boolean isRecurseDepthUnlimited()
```
  - getPath
```
public Path getPath()
```
  - isExcluded
```
public boolean isExcluded(Path dir)
                   throws IOException
```
    Throws:
    
    IOException
  - isIncluded
```
public boolean isIncluded(Path dir)
```
  - matches
```
public boolean matches(Path path)
```
  - setRecurseDepth
```
public void setRecurseDepth(int depth)
```
    Set the recurse depth for the directory scanning.
    -999 indicates arbitrarily deep recursion, 0 indicates no recursion, 1 is only one directory deep, and so on.
    
    Parameters:
    
    depth - the number of directories deep to recurse
  - shouldRecurseDirectory
```
public boolean shouldRecurseDirectory(Path child)
```
    Determine if the provided child directory should be recursed into based on the configured setRecurseDepth(int)
    
    Parameters:
    
    child - the child directory to test against
    
    Returns:
    
    true if recurse should occur, false otherwise
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class PathWatcher.Config

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

UNLIMITED_DEPTH

dir

recurseDepth

includes

excludes

excludeHidden

Constructor Detail

Config

Method Detail

addExclude

addExclude

addExcludeGlobRelative

addExcludeHidden

addExcludes

addInclude

addInclude

addIncludeGlobRelative

addIncludes

asSubConfig

getRecurseDepth

isRecurseDepthUnlimited

getPath

isExcluded

isIncluded

matches

setRecurseDepth

shouldRecurseDirectory

toString