*
     * @return a new access context arranger
     */
    @Override
    protected AccessContextArranger newAccessContextArranger() { // for framework
        // fess does not use DBFlute, and this is unneeded so dummy
        return resource -> {
            final AccessContext context = new AccessContext();
            context.setAccessLocalDateTimeProvider(() -> timeManager.currentDateTime());

 * It writes data to a temporary file once the data size exceeds a specified threshold.
 *
 * <p>This class ensures that the temporary file is deleted if it is not needed.
 * It uses a logger to log warnings if there are issues deleting the temporary file.</p>
 *
 * <p>Fields:</p>
 * <ul>
 *   <li>{@code logger} - Logger instance for logging warnings.</li>

- [ ] Java conventions followed
- [ ] JavaDoc for public APIs
- [ ] Tests pass (`mvn test`)
- [ ] No compiler warnings
- [ ] Proper exception handling
- [ ] Resource cleanup (AutoCloseable)
- [ ] Thread-safe if needed
- [ ] Code formatted (`mvn formatter:format`)
- [ ] License headers (`mvn license:format`)

---

## Quick Reference

### Key File Locations

    ├── stemmer_override.txt
    └── protwords.txt
```

## Important Notes

### No Database Changes Required

- Language configuration is entirely file-based
- No database or OpenSearch index updates needed
- Settings are loaded at application startup and cached

### Fallback Mechanism

                || url.startsWith("s3:") || url.startsWith("gcs:");
    }

    /**
     * Checks if the given URL represents a file system path for content serving.
     * Used to determine if special handling is needed for file system URLs.
     *
     * @param url the URL to check
     * @return true if the URL is a file system path (file, smb, smb1, ftp, storage, s3, gcs)
     */

- **Admin Login**: `admin/admin`

## Log Message Guidelines

- Format parameters as `key=value` (e.g., `sessionId={}`, `url={}`)
- Prefix with `[name]` when context identification is needed
- Use full words, not abbreviations (e.g., "documents" not "docs")

            synchronized (lastTime) {
                final long lastValue = lastTime.get();
                if (lastValue == 0) {
                    // First access to this host - no delay needed
                    // Set current time to allow proper delay for next access
                    lastTime.set(SystemUtil.currentTimeMillis());
                    return;
                }

            "filetype": doc.get("filetype", "html"),
            "created": doc.get("@timestamp", ""),
            "timestamp": doc.get("@timestamp", ""),
            # Add custom fields as needed
        }

        outfile.write(json.dumps(fess_doc) + '\n')
```

**Step 3: Import to Fess**

Option A: Via Admin UI
1. Go to **System > Backup**
2. Upload `fess-documents.json` (bulk format)

}
```

### Testing Best Practices

- Minimize `Thread.sleep()` - use only when absolutely necessary
- For timestamp tests: use minimal delays (50-100ms)
- Clean only test-specific indices (not `_all` unless needed)
- Use `runner.refresh()` after index operations
- Test with realistic multilingual content

### Key Test Classes

- `SuggesterRefactoringTest` - Index lifecycle, alias management

        }
        return url.toString();
    }

    /**
     * Builds a URL from protocol, hostname string, port, and path.
     * Properly handles IPv6 addresses by wrapping them in brackets if needed.
     *
     * @param protocol the protocol (e.g., "http", "https")
     * @param host the hostname or IP address string
     * @param port the port number
     * @param path the path (should start with "/" or be empty)