- **MS-SMB2 Section 3.3.5.9.11**: Directory Leasing and Caching

## 3. Directory Lease Types

### 3.1 Directory-Specific Lease States
```java
public class DirectoryLeaseState extends Smb2LeaseState {
    // Standard lease states apply, plus directory-specific semantics:
    
    // READ_CACHING for directories means:
    // - Can cache directory enumeration results
    // - Can cache file existence queries

     * of the project.
     *
     * @return the path of the pom
     * @see #getBasedir()
     */
    @Nonnull
    Path getPomPath();

    /**
     * Returns the project base directory, i.e. the directory containing the project.
     * A project is usually read from the file system and this will point to
     * the directory containing the POM file.
     *

public interface SourceRoot {
    /**
     * {@return the root directory where the sources are stored}
     * The path is relative to the <abbr>POM</abbr> file.
     *
     * <h4>Default implementation</h4>
     * The default value depends on whether a {@linkplain #module() module name} is specified in this source root:
     * <ul>
     *   <li>
     *     If no module name, then the default directory is

     * @return the Path object pointing to the site directory
     */
    public static Path getSitePath(final String... names) {
        return getPath("WEB-INF/", "site", names);
    }

    /**
     * Gets the path to plugin files directory.
     *
     * @param names the path components to append to the plugin directory
     * @return the Path object pointing to the plugin directory
     */

            lock.writeLock().unlock();
        }
    }

    /**
     * Gets the directory path for this cache entry
     * @return the directory path
     */
    public String getDirectoryPath() {
        return directoryPath;
    }

    /**
     * Gets the lease key associated with this directory cache
     * @return the lease key
     */
    public Smb2LeaseKey getLeaseKey() {

    /**
     * Directory change types
     */
    public enum DirectoryChangeType {
        /**
         * File was added to the directory
         */
        FILE_ADDED,
        /**
         * File was removed from the directory
         */
        FILE_REMOVED,
        /**
         * File was modified in the directory
         */
        FILE_MODIFIED,
        /**

            // Execute with target model 4.0.0 (should create .mvn directory)
            upgradeGoal.testExecuteWithTargetModel(context, "4.0.0");

            Path mvnDir = projectDir.resolve(".mvn");
            assertTrue(Files.exists(mvnDir), ".mvn directory should be created");
            assertTrue(Files.isDirectory(mvnDir), ".mvn should be a directory");
        }

        @Test

        // Create test directory structure
        File baseDir = new File(tempDir.toFile(), "images");
        baseDir.mkdirs();
        File validFile = new File(baseDir, "test.png");

        Boolean result = invokeIsValidUploadPath(validFile, baseDir);
        assertTrue("Valid path within base directory should be allowed", result);
    }

    @Test

     * Returns a {@link Traverser} that handles a collection of classes or resources based on the specified directory.
     *
     * @param rootDir
     *            The root directory. Must not be {@literal null} or an empty string.
     * @return A {@link Traverser} that handles a collection of classes or resources based on the specified directory.
     */
    public static Traverser getTraverser(final String rootDir) {

    /**
     * Sets the root directory of the project.
     *
     * @since 4.0.0
     */
    MavenExecutionRequest setRootDirectory(Path rootDirectory);

    /**
     * Gets the root directory of the top project, which is the parent directory containing the {@code .mvn}
     * directory or a {@code pom.xml} file with the {@code root="true"} attribute.