/**
 * Represents a DFS (Distributed File System) referral entry containing server redirection information.
 * This class handles DFS referral responses that redirect clients to alternate servers for accessing
 * distributed file system resources, supporting multiple DFS versions and referral types.
 */
public class Referral implements Decodable {

    /**
     * Default constructor for Referral.
     */
    public Referral() {

        bufferIndex += 2;
        this.tflags = SMBUtil.readInt2(buffer, bufferIndex);
        bufferIndex += 4;

        this.referrals = new Referral[this.numReferrals];
        for (int ri = 0; ri < this.numReferrals; ri++) {
            this.referrals[ri] = new Referral();
            bufferIndex += this.referrals[ri].decode(buffer, bufferIndex, len);
        }

        return bufferIndex - start;
    }

    /**

    /** The underlying DFS referral data */
    private final DfsReferralData data;

    /**
     * Constructs a DfsReferral with the specified referral data
     *
     * @param data the DFS referral data
     */
    public DfsReferral(final DfsReferralData data) {
        this.data = data;
    }

    /**
     * Get the DFS referral data associated with this referral
     *
     * @return the DFS referral data

    /**
     * Check if this referral needs to be resolved further
     *
     * @return whether this refrral needs to be resolved further
     */
    boolean isIntermediate();

    /**
     * Combine this referral with another to form a chain
     *
     * @param next the referral to combine with
     * @return new referral, combining a chain of referrals
     */

    /**
     * Get the server this referral points to
     *
     * @return the server this referral points to
     */
    String getServer();

    /**
     * Get the domain this referral is for
     *
     * @return the domain this referral is for
     */
    String getDomain();

    /**
     * Get the share this referral points to
     *
     * @return the share this referral points to

    void testToString() {
        // Given
        DfsReferral referral = new DfsReferral();
        referral.pathConsumed = 20;
        referral.server = "testServer";
        referral.share = "testShare";
        referral.link = "testLink";
        referral.path = "/test/path";
        referral.ttl = 300;
        referral.expiration = 1234567890L;
        referral.resolveHashes = true;

        // When

        bufferIndex += 2;
        flags = readInt2(buffer, bufferIndex);
        bufferIndex += 4;

        referrals = new Referral[numReferrals];
        for (int ri = 0; ri < numReferrals; ri++) {
            referrals[ri] = new Referral();
            bufferIndex += referrals[ri].readWireFormat(buffer, bufferIndex, len);
        }

        return bufferIndex - start;
    }

    @Override

        String resolved = "smb://server/share/path";
        when(locator.handleDFSReferral(referral, reqPath)).thenReturn(resolved);

        String out = locator.handleDFSReferral(referral, reqPath);
        assertEquals(resolved, out);

        // Verify exact argument interaction
        verify(locator, times(1)).handleDFSReferral(referral, reqPath);
        verifyNoMoreInteractions(locator);
    }

    /** Target share for this referral */
    public String share; // Share
    /** The complete UNC path link */
    public String link;
    /** Path relative to tree from which this referral was thrown */
    public String path; // Path relative to tree from which this referral was thrown
    /** Whether to resolve hashes in the path */
    public boolean resolveHashes;
    /** Expiration time for this referral entry */

            // Second Referral v1
            bb.putShort((short) 1); // version
            bb.putShort((short) 16); // size
            bb.putShort((short) 1); // serverType
            bb.putShort((short) 3); // rflags
            bb.put("\\srv2\0".getBytes(StandardCharsets.UTF_16LE));

            // Position for third referral
            bb.position(40); // 8 header + 16 + 16

            // Third Referral v1