/**
 * 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;
    }

    /**

    /**
     * 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

    /**
     * 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
     */

        bb.putShort((short) 0);

        referral.decode(testBuffer, 0, testBuffer.length);

        assertEquals(3, referral.getVersion());
        assertEquals(100, referral.getSize());
        assertEquals(7, referral.getServerType());
        assertEquals(1, referral.getRFlags());
        assertEquals(20, referral.getProximity());
        assertEquals(3600, referral.getTtl());

        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

             * longest path in the list of stand-alone referrals.
             */
            if (referrals != null && now > referrals.expiration) {
                referrals = null;
            }
            if (referrals == null) {
                referrals = new CacheEntry(0);
            }
            String key = "\\" + domain + "\\" + root;

    /** 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

    // Helper methods for creating test buffers

    private byte[] createValidDfsReferralBuffer() {
        // Create a buffer representing a valid DFS referral response
        // Need to include space for actual string data
        int stringDataStart = 28; // After the referral structure
        String testPath = "\\server\\share";
        byte[] pathBytes = testPath.getBytes(java.nio.charset.StandardCharsets.UTF_16LE);

            final SmbTransportInternal trans = dc.unwrap(SmbTransportInternal.class);
            // the tconHostName is from the DC referral, that referral must be resolved
            // before following deeper ones. Otherwise e.g. samba will return a broken
            // referral.
            synchronized (trans) {
                try {
                    // ensure connected
                    trans.ensureConnected();