- **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

            return lastModified;
        }

        /**
         * Checks if this cached item represents a directory
         * @return true if this is a directory
         */
        public boolean isDirectory() {
            return isDirectory;
        }

        /**
         * Gets the SMB file attributes for this cached item
         * @return the file attributes
         */

        // List empty directory
        String[] files = checkDir.list();
        assertNotNull(files, "List should not be null");
        assertEquals(0, files.length, "Empty directory should have no files");

        // Get directory size (should be 0 for directories)
        assertEquals(0, checkDir.length(), "Directory length should be 0");
        checkDir.close();

    /**
     * Enhanced listFiles method that uses directory leasing for caching when available
     *
     * @param smbFile the SmbFile directory to list
     * @return array of SmbFile objects representing the directory contents
     * @throws SmbException if an error occurs
     */
    public static SmbFile[] listFilesWithLeasing(SmbFile smbFile) throws SmbException {
        if (!smbFile.isDirectory()) {

						<!-- logs (empty) -->
						<mapping>
							<directory>${packaging.fess.log.dir}</directory>
						</mapping>
						<!-- temp (empty) -->
						<mapping>
							<directory>${packaging.fess.temp.dir}</directory>
						</mapping>
						<!-- dictionary (empty) -->
						<mapping>
							<directory>${packaging.fess.dictionary.dir}</directory>
							<filemode>755</filemode>
							<username>opensearch</username>

    Path getTopDirectory();

    /**
     * Gets the root directory of the session, which is the root directory for the top directory project.
     *
     * @return the root directory, never {@code null}
     * @throws IllegalStateException if the root directory could not be found
     * @see #getTopDirectory()
     * @see Project#getRootDirectory()
     * @see Project#isRootProject()
     */
    @Nonnull
    Path getRootDirectory();

    /**
     * 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,
        /**

     * @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
     */

    // filter flags

    /**
     * Any file name change in the watched directory or subtree causes a change notification wait operation to return.
     * Changes include renaming, creating, or deleting a file.
     */
    int FILE_NOTIFY_CHANGE_FILE_NAME = 0x00000001;

    /**
     * Any directory-name change in the watched directory or subtree causes a change notification wait operation to

        assertFalse(cacheEntry.isComplete());

        // Step 3: Verify can cache directory listing
        assertTrue(directoryLeaseManager.canCacheDirectoryListing(directoryPath));

        // Step 4: Initially no cached listing
        assertNull(directoryLeaseManager.getCachedDirectoryListing(directoryPath));

        // Step 5: Simulate directory enumeration and update cache