- JavaDoc required for public APIs
- License headers required

### Testing

**Structure**: `src/test/java/org/codelibs/fess/crawler/`
**Frameworks**: JUnit 4, UTFlute, Mockito, Testcontainers
**Test Resources**: `src/test/resources/`

**Pattern**:
```java
public class MyTest extends UTFlute {
    @Override
    protected void setUp() throws Exception {
        super.setUp();
        // Setup
    }

     */
    boolean shouldForceSigning();

    /**
     * Determines whether this resource path overlaps with another resource path by sharing a common root.
     *
     * @param other the other resource locator to compare with
     * @return whether the paths share a common root
     * @throws CIFSException if an error occurs during comparison
     */
    boolean overlaps(SmbResourceLocator other) throws CIFSException;

├── helper/                    # Cross-cutting utilities
├── crawler/                   # Crawling engine
├── sso/                       # SSO implementations
└── ds/                        # Data store connectors

src/main/resources/
├── fess_config.properties     # Main config
├── app.xml                    # DI configuration
├── fess_label_*.properties    # UI labels (i18n)
├── fess_message_*.properties  # Validation messages (i18n)

package org.codelibs.core.io;

import java.io.InputStream;

/**
 * Interface for handlers that process resources.
 *
 * @author taedium
 */
public interface ResourceHandler {

    /**
     * Processes a resource.
     *
     * @param path the path
     * @param is the {@link InputStream} to read the resource
     */
    void processResource(String path, InputStream is);

mc cat myminio-newuser/my-bucketname/my-objectname
```

### Policy Variables

You can use policy variables in the *Resource* element and in string comparisons in the *Condition* element.

        // This test verifies that once a handler is cached, subsequent calls reuse it.
        setupMockProtocolHandlers();
        URL url1 = new URL("http://example.com/resource1");
        URL url2 = new URL("http://example.com/resource2");

        URLConnection connection1 = handler.openConnection(url1);
        URLConnection connection2 = handler.openConnection(url2);

type LockArgs struct {
	// Unique ID of lock/unlock request.
	UID string

	// Resources contains single or multiple entries to be locked/unlocked.
	Resources []string

	// Owner represents unique ID for this instance, an owner who originally requested
	// the locked resource, useful primarily in figuring out stale locks.
	Owner string

 * dependencies - resources - configuration - extension points of plugins
 *
 * For a particular application plugin there will be a declarative descriptor for that plugin type.
 *
 * - nexus - the plugin class - UI to contribute - what JS to hook into the UI - what resources to
 * load into the UI - having packed or unpacked plugins, and positioning resources if necessary -

import org.codelibs.core.zip.ZipInputStreamUtil;

/**
 * Utility for traversing collections of classes and resources on the file system or inside JAR files.
 * <p>
 * Target directories on the file system or JAR files are provided as {@link URL}. The appropriate {@link Traverser} is returned depending on the protocol of the URL, and you can traverse classes and resources by calling its methods.
 * </p>
 * <p>
 * Supported protocols:
 * </p>
 * <ul>

- Enabled in-place resizing of pod-level resources.  
  - Added `Resources` in `PodStatus` to capture resources set in the pod-level cgroup.