This way, its schema will show up in the API docs user interface:

<img src="/img/tutorial/dataclasses/image01.png">

## Dataclasses in Nested Data Structures { #dataclasses-in-nested-data-structures }

You can also combine `dataclasses` with other type annotations to make nested data structures.

            assertArrayEquals(testFileId, Arrays.copyOfRange(buffer, 8, 24));

            // Verify total bytes written (structure + lock data)
            assertEquals(24 + 24, bytesWritten); // 24 for structure, 24 for lock
        }

        @Test
        @DisplayName("Should write request structure correctly with multiple locks")
        void testWriteBytesWireFormatMultipleLocks() {

        @Test
        @DisplayName("Should read valid structure with size 4")
        void testReadBytesWireFormatValid() throws SMBProtocolDecodingException {
            // Given
            byte[] buffer = new byte[10];
            int bufferIndex = 2;
            SMBUtil.writeInt2(4, buffer, bufferIndex); // Write structure size = 4
            SMBUtil.writeInt2(0, buffer, bufferIndex + 2); // Reserved field

        byte[] buffer = new byte[512];
        int offset = 0;

        // Set header start position for the response
        setHeaderStart(response, 64);

        // Write structure header (9 bytes)
        SMBUtil.writeInt2(9, buffer, offset); // Structure size
        SMBUtil.writeInt2(80 - 64, buffer, offset + 2); // Buffer offset (relative to header)
        SMBUtil.writeInt4(50, buffer, offset + 4); // Total length of notification data

        assertEquals(4, bytesWritten);

        // Verify structure size (4) is written at offset
        assertEquals(4, SMBUtil.readInt2(buffer, offset));

        // Verify reserved field (0) is written at offset + 2
        assertEquals(0, SMBUtil.readInt2(buffer, offset + 2));
    }

    @Test
    @DisplayName("Should write exact wire format structure")
    void testWriteBytesWireFormatStructure() {
        // Given

De esta manera, su esquema aparecerá en la interfaz de usuario de la documentación de la API:

<img src="/img/tutorial/dataclasses/image01.png">

## Dataclasses en Estructuras de Datos Anidadas

También puedes combinar `dataclasses` con otras anotaciones de tipos para crear estructuras de datos anidadas.

            try {
                Pac pac = new Pac(pacData, keys);
                assertNotNull(pac.getServerSignature());
                assertNotNull(pac.getKdcSignature());
            } catch (PACDecodingException e) {
                // Expected due to invalid logon info structure
                assertNotNull(e.getMessage());
            }

    @Test
    @DisplayName("Test wire format structure matches SMB2 specification")
    void testWireFormatStructure() {
        byte[] buffer = new byte[256];
        Arrays.fill(buffer, (byte) 0xCC); // Fill with pattern to detect unwritten areas

        int written = request.writeBytesWireFormat(buffer, 0);

        // Verify structure according to SMB2 FLUSH specification
        // Structure Size (2 bytes) - should be 24

 */
package jcifs.internal.smb2.rdma;

import jcifs.internal.util.SMBUtil;

/**
 * SMB2 RDMA Transform structure for READ/WRITE channel info.
 *
 * As per MS-SMB2 2.2.13.1.1 and 2.2.21.1.1
 */
public class Smb2RdmaTransform {

    // SMB_DIRECT_BUFFER_DESCRIPTOR_V1 structure
    private long offset; // 8 bytes: Offset within registered buffer
    private int token; // 4 bytes: RDMA provider token

import jcifs.smb1.dcerpc.ndr.NdrBuffer;
import jcifs.smb1.dcerpc.ndr.NdrException;

/**
 * Comprehensive test suite for SMB1 samr (Security Account Manager Remote) protocol
 * Tests all message types, data structures, and constants
 */
@ExtendWith(MockitoExtension.class)
@DisplayName("SMB1 SAMR Protocol Test Suite")
class samrTest {

    @Mock
    private NdrBuffer mockNdrBuffer;

    @Mock