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());

     */
    String getURLPath();

    /**
     * Retrieves the share associated with this SMB resource. In
     * the case of <code>smb://</code>, <code>smb://workgroup/</code>,
     * and <code>smb://server/</code> URLs which do not specify a share,
     * <code>null</code> will be returned.
     *
     * @return The share component or <code>null</code> if there is no share
     */
    String getShare();

    /**

            StringUtil.newStringUnsafeMethod = null;
            char[] chars = new char[0];
            assertThat(StringUtil.newStringUnsafe(chars), is(""));
            chars = new char[] { 'a', 'b', 'c' };
            assertThat(StringUtil.newStringUnsafe(chars), is("abc"));
            StringUtil.newStringUnsafeMethod = newStringUnsafeMethod;
            chars = new char[] { 'a', 'b', 'c', ' ' };

                            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) {

    void testGetSmbResourceWithVariousURLs() throws CIFSException {
        // Test different valid URL formats
        String[] validUrls = { "smb://server/share/", "smb://server/share/file.txt", "smb://user:pass@server/share/file.txt",
                "smb://domain;user:pass@server/share/file.txt" };

        for (String url : validUrls) {
            // When
            SmbResource resource = context.get(url);

            // Then

        // 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");

     * this file is open. This constant may be logically OR'd with other share
     * access flags.
     */
    int FILE_SHARE_READ = 0x01;
    /**
     * When specified as the <code>shareAccess</code> constructor parameter,
     * other SMB clients will be permitted to write to the target file while
     * this file is open. This constant may be logically OR'd with other share
     * access flags.
     */
    int FILE_SHARE_WRITE = 0x02;

    void testToString() {
        // Given
        exception = new SmbOperationException(SmbOperationException.ErrorCode.ACCESS_DENIED, "Cannot access share");
        exception.withContext("share", "\\\\server\\share");
        exception.withContext("user", "john");

        // When
        String str = exception.toString();

        // Then
        assertNotNull(str);

    while (lines.peek() == null) {
      Java8Compatibility.clear(cbuf);
      // The default implementation of Reader#read(CharBuffer) allocates a
      // temporary char[], so we call Reader#read(char[], int, int) instead.
      int read = (reader != null) ? reader.read(buf, 0, buf.length) : readable.read(cbuf);
      if (read == -1) {
        lineBuf.finish();
        break;
      }

    assertThat(expected).hasMessageThat().isEqualTo(msg);
  }

  public void testBadArguments_plusforspace() {
    // space can be a safe char if plusForSpace is false
    PercentEscaper unused = new PercentEscaper(" ", false);

    // space cannot be a safe char is plusForSpace is true
    String msg = "plusForSpace cannot be specified when space is a 'safe' character";
    IllegalArgumentException expected =