For internal purposes, we use binary formats for their brevity.
We use the `Serializer` abstraction to separate the actual implementation of serialization from its uses.

When sharing data with external tools, we use JSON.

## Consequences

* The configuration cache serialization infrastructure should be used for all serialization.

     * opened if it is not and should be closed with {@link #close()} when no longer
     * needed.
     *
     * Closing the context should cancel a pending notify request, but that does not seem to work reliable in all
     * implementations.
     *
     * Changes in between these calls (as long as the file is open) are buffered by the server, so iteratively calling

        // Act + Assert
        assertTrue(it.hasNext());
        assertEquals("a", it.next().getName(), "First element should be initial from open()");
        assertTrue(it.hasNext());
        assertEquals("b", it.next().getName(), "Next element should skip '.' and '..'");
        assertFalse(it.hasNext(), "Iterator exhausted after valid entries");
        verify(tree, times(1)).release(); // closed after exhaustion
    }

        byte[] dst = new byte[1024];
        int result = setupAndX.writeParameterWordsWireFormat(dst, 0);

        // Verify that data was written (should write 22 bytes based on implementation)
        assertEquals(22, result, "writeParameterWordsWireFormat should write 22 bytes");
    }

    @Test
    void testWriteBytesWireFormat() {
        byte[] dst = new byte[1024];

        // Cache should be invalidated
        assertFalse(cacheEntry.isComplete());

        // Step 10: Test lease release
        directoryLeaseManager.releaseDirectoryLease(directoryPath);

        // Cache entry should be removed
        assertNull(directoryLeaseManager.getCacheEntry(directoryPath));

        urlQueueService.insert(urlQueue);

        // Poll should return the item
        final OpenSearchUrlQueue polled = urlQueueService.poll(sessionId);
        assertNotNull(polled);
        assertEquals("http://www.example.com/page1", polled.getUrl());
        assertEquals(sessionId, polled.getSessionId());

        // Second poll should return null (queue is empty)

// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

package dsync

import "context"

// NetLocker is dsync compatible locker interface.
type NetLocker interface {
	// Do read lock for given LockArgs.  It should return
	// * a boolean to indicate success/failure of the operation

        // Check if fields were added (they should be added by the store method)
        assertNotNull(dataMap.get("id"), "ID should be set");
        assertNotNull(dataMap.get("doc_id"), "Doc ID should be set");
        assertNotNull(dataMap.get("click_count"), "Click count should be set");
        assertNotNull(dataMap.get("favorite_count"), "Favorite count should be set");
        assertEquals(1, indexUpdateCallback.docList.size());

        // Then
        assertNotNull(request, "The request object should not be null.");
        assertEquals(mockDomainHandle, request.domain_handle, "The domain handle should be set correctly.");
        assertEquals(acctFlags, request.acct_flags, "The account flags should be set correctly.");
        assertEquals(mockSamArray, request.sam, "The sam array should be set correctly.");

        InputStream in = new ByteArrayInputStream(concat(messageHeader(5), data));
        SocketInputStream sis = new SocketInputStream(in);

        // Skip should return 0 for negative or zero values
        assertEquals(0, sis.skip(skipBytes));

        // All data should still be available
        assertEquals(10, sis.read());
    }

    @Test
    @DisplayName("Skip correctly advances position in stream")