*/
    @Required
    public MultipartFormFile designFile;

    /**
     * The name for the design file being uploaded.
     * Must not contain invalid file system characters like backslash, colon, asterisk, etc.
     */
    @Pattern(regexp = "^[^\\\\|/|:|\\*|?|\"|<|>|\\|]+$", message = "{errors.design_file_name_is_invalid}")
    public String designFileName;

    /**

        verify(tree, times(1)).acquire();
        verify(tree, times(1)).release(); // closed after failure
    }

    @Test
    @DisplayName("open(): invalid UNC without trailing backslash throws SmbException")
    void invalidUncThrows() throws Exception {
        // Override the default setup for this specific test
        when(locator.getUNCPath()).thenReturn("\\\\SERVER\\Share\\dir"); // missing trailing \\

        assertFalse(CharUtil.isUrlChar('<')); // less than
        assertFalse(CharUtil.isUrlChar('>')); // greater than
        assertFalse(CharUtil.isUrlChar('"')); // double quote
        assertFalse(CharUtil.isUrlChar('\\')); // backslash
        assertFalse(CharUtil.isUrlChar('`')); // backtick
    }

    public void test_isUrlChar_controlCharacters() {
        // Test control characters
        assertFalse(CharUtil.isUrlChar('\u0000')); // null

            if (inDfs && !service.equals("IPC") && request.path != null && request.path.length() > 0) {
                /* When DFS is in action all request paths are
                 * full UNC paths minus the first backslash like
                 *   \server\share\path\to\file
                 * as opposed to normally
                 *   \path\to\file
                 */

    @Test
    @DisplayName("handleDFSReferral returns resolved UNC path as stubbed")
    void handleDfsReferralValidInputs() {
        // Edge-like Windows UNC-style: a single backslash in the path
        String reqPath = "\\";
        String resolved = "smb://server/share/path";
        when(locator.handleDFSReferral(referral, reqPath)).thenReturn(resolved);

    }

    /**
     * Escapes specific characters in a query string.
     * Replaces each specified character with its escaped version (prefixed with backslash).
     *
     * @param q the query string to escape
     * @param values the characters to escape
     * @return the escaped query string
     */

                /*
                 * When DFS is in action all request paths are
                 * full UNC paths minus the first backslash like
                 * \server\share\path\to\file
                 * as opposed to normally
                 * \path\to\file
                 */

 * referrals. Nested resources will inherit the information already resolved by the parent resource.
 *
 * Invariant:
 * A directory resource must have a trailing slash/backslash for both URL and UNC path at all times.
 *
 * @author mbechler
 *
 */
class SmbResourceLocatorImpl implements SmbResourceLocatorInternal, Cloneable {

    @Override
    public void setPath(String path) {
        if (path.length() > 0 && path.charAt(0) == '\\') {
            path = path.substring(1);
        }
        // win8.1 returns ACCESS_DENIED if the trailing backslash is included
        if (path.length() > 1 && path.charAt(path.length() - 1) == '\\') {
            path = path.substring(0, path.length() - 1);
        }
        this.name = path;
    }

    /**

    /**
     * Escapes special characters in an LDAP search filter to prevent LDAP injection attacks.
     *
     * <p>This method escapes the following characters as per RFC 4515:
     * <ul>
     * <li>\ (backslash) → \5c</li>
     * <li>* (asterisk) → \2a</li>
     * <li>( (left parenthesis) → \28</li>
     * <li>) (right parenthesis) → \29</li>
     * <li>\0 (null character) → \00</li>
     * </ul>
     *