if (!allowUncPaths) {
                throw new SmbException("UNC paths are not allowed");
            }
            validateUncPath(normalized);
        }

        // Check individual components
        validateComponents(normalized);

        return normalized;
    }

    /**
     * Validate an SMB URL
     *
     * @param smbUrl the SMB URL to validate

```

### Key Components

#### Core Engine
- **Crawler**: Main orchestrator managing crawl execution
- **CrawlerContext**: Execution context and configuration
- **CrawlerThread**: Individual crawler thread implementation

#### Client Architecture
- **HcHttpClient**: HTTP/HTTPS client using Apache HttpComponents
- **FileSystemClient**: File system access
- **FtpClient**: FTP protocol support

            log.warn("Path contains traversal sequences: {}", sanitizeForLog(path));
            throw new SmbException("Path contains directory traversal");
        }

        // Check individual components
        String[] components = path.split("[/\\\\]");
        for (String component : components) {
            if (component.length() > MAX_PATH_COMPONENT_SIZE) {

            }
        });
        nonPooledConnections.clear();

        activeConnections.set(0);
        log.info("Transport pool closed");
    }

    /**
     * Connection metrics for monitoring individual connections
     */
    private static class ConnectionMetrics {
        private final AtomicLong connectionsCreated = new AtomicLong(0);
        private final AtomicLong successCount = new AtomicLong(0);

     * <code>smb://server/</code>,
     * <li>or <code>null</code> if the resource cannot be resolved.
     * </ul>
     *
     * If strict resource lifecycle is used, make sure you close the individual files after use.
     *
     * @return An array of <code>SmbResource</code> objects representing file
     *         and directories, workgroups, servers, or shares depending on the context

            // 3.2.5.1.9 Handling Compounded Responses
            // The final response in the compounded response chain will have NextCommand equal to 0,
            // and it MUST be processed as an individual message of a size equal to the number of bytes
            // remaining in this receive.
            final int rem = this.readSize - this.length;
            len += rem;
        }

}

// CompleteMultipartUpload - completes an ongoing multipart
// transaction after receiving all the parts indicated by the client.
// Returns an md5sum calculated by concatenating all the individual
// md5sums of all the parts.
//
// Implements S3 compatible Complete multipart API.

	return bytealg.Compare(a, b)
}

// explode splits s into a slice of UTF-8 sequences, one per Unicode code point (still slices of bytes),
// up to a maximum of n byte slices. Invalid UTF-8 sequences are chopped into individual bytes.
func explode(s []byte, n int) [][]byte {
	if n <= 0 || n > len(s) {
		n = len(s)
	}
	a := make([][]byte, n)
	var size int
	na := 0
	for len(s) > 0 {
		if na+1 >= n {
			a[na] = s
			na++

    public interface EntityCreator<T, R, H> {
        /**
         * Creates an entity from a search response and hit.
         *
         * @param response the search response
         * @param hit      the individual search hit
         * @return the created entity
         */
        T build(R response, H hit);
    }

    /**
     * Sets the name of the search engine cluster.
     *

/// tip

Having `dependencies` in the `APIRouter` can be used, for example, to require authentication for a whole group of *path operations*. Even if the dependencies are not added individually to each one of them.

///

/// check

The `prefix`, `tags`, `responses`, and `dependencies` parameters are (as in many other cases) just a feature from **FastAPI** to help you avoid code duplication.