throw new SmbException("Invalid server name in UNC path");
        }

        // Validate share name
        String share = parts[1];
        if (share.isEmpty() || share.endsWith("$") && share.length() == 1) {
            throw new SmbException("Invalid share name in UNC path");
        }
    }

    /**
     * Validate individual path components
     */

                () -> new SmbFileHandleImpl(cfg, new byte[] { 1, 2 }, null, "//server/share", 0, 0, 0, 0, 0L));
    }

    @Test
    @DisplayName("Constructor with null cfg throws NPE")
    void constructor_nullCfg_throwsNPE() {
        stubValidTree(7L, true, true);
        assertThrows(NullPointerException.class, () -> new SmbFileHandleImpl(null, 42, tree, "//server/share", 0, 0, 0, 0, 0L));
    }

    @Test

        // Setup minimal mocks
        when(request.getRequestURI()).thenReturn("/explorer");
        when(request.getPathInfo()).thenReturn("/share/");
        when(locator.getCanonicalURL()).thenReturn("smb://server/share/");

        // Mock directory listing
        SmbFile file1 = mock(SmbFile.class);
        when(file1.getName()).thenReturn("document.pdf");

        CompletableFuture<WitnessRegistration> future = client.registerForNotifications("\\\\server\\share", serverAddress, listener);

        WitnessRegistration registration = future.get(5, TimeUnit.SECONDS);

        assertNotNull(registration);
        assertEquals(WitnessRegistrationState.REGISTERED, registration.getState());
        assertEquals("\\\\server\\share", registration.getShareName());

    void testCIFSContextInterface() {
        // Verify interface methods exist
        assertDoesNotThrow(() -> {
            mockContext.get("smb://server/share");
            mockContext.getPipe("smb://server/share/pipe", 0);
            mockContext.close();
            mockContext.getConfig();
            mockContext.getNameServiceClient();
            mockContext.getBufferCache();

    }

    @Test
    void testGetReferral_Success() throws IOException, SmbAuthException {
        String domain = "domain.com";
        String root = "share";
        String path = "\\folder";
        String fullPath = "\\" + domain + "\\" + root + path; // Should be "\domain.com\share\folder"

        lenient().when(smbTransport.getDfsReferrals(auth, fullPath, 0)).thenReturn(dfsReferral);

These issues are more complex and might be challenging for first-time contributors.

You can share your interest in fixing the issue by commenting on it.
If somebody shared their interest in the issue, please consider letting them work on it.
However, if there are no changes for more than a week, it's safe to assume that the issue is up for grabs.

    class HappyPath {
        @Test
        void testBasicProperties() throws Exception {
            String url = "smb://server/share/path/file.txt";
            DummySmbResourceLocator loc = new DummySmbResourceLocator(url);
            assertEquals("file.txt", loc.getName());
            assertEquals("smb://server/share/path/", loc.getParent());
            assertEquals(url, loc.getPath());
            // canonicalisation simply removes '.' and '..'

     * @throws CIFSException if an error occurs retrieving the domain name
     */
    String getOEMDomainName() throws CIFSException;

    /**
     * Gets the name of the share this tree is connected to
     * @return the share we are connected to
     */
    String getConnectedShare();

    /**
     * Checks if this tree handle refers to the same tree as another
     * @param th the tree handle to compare with

                            SmbTreeImpl uct = smbSession.getSmbTree(share, null).unwrap(SmbTreeImpl.class);
                            SmbTreeImpl ct = connectTree(loc, host, share, trans, uct, dr)) {

                        if (dr != null) {
                            ct.setTreeReferral(dr);
                            if (dr != start) {