return 0, nil
		}
		return 0, io.EOF
	}
	n = copy(p, b.buf[b.off:])
	b.off += n
	if n > 0 {
		b.lastRead = opRead
	}
	return n, nil
}

// Next returns a slice containing the next n bytes from the buffer,
// advancing the buffer as if the bytes had been returned by [Buffer.Read].
// If there are fewer than n bytes in the buffer, Next returns the entire buffer.

file is unrestricted, regardless of whether it is legally a derivative
work.  (Executables containing this object code plus portions of the
Library will still fall under Section 6.)

  Otherwise, if the work is a derivative of the Library, you may
distribute the object code for the work under the terms of Section 6.
Any executables containing that work also fall under Section 6,
whether or not they are linked directly with the Library itself.

As recommended by the HTTP RFC the max age of a document is defaulted to 10% of the 
document's age at the time it was served based on "Last-Modified". Default expiration dates aren't used for URIs 
containing a query.

 - CallStart
 - **CacheHit**
 - CallEnd
 
### Cache Miss

Under a cache miss the normal request events are seen but an additional event shows the presence of the cache.

     * Pre-processes API requests by checking access authorization before executing the action.
     * If access is not allowed, returns an unauthorized error response.
     *
     * @param runtime the action runtime context containing request information
     * @return ActionResponse with unauthorized error if access denied, otherwise delegates to parent
     */
    @Override
    public ActionResponse godHandPrologue(final ActionRuntime runtime) {

        }
        return sequence;
    }

    /**
     * Creates a Kerberos AP request from an ASN.1 sequence.
     *
     * @param seq the ASN.1 sequence containing the AP-REQ
     * @param keys the Kerberos keys for decryption
     * @throws PACDecodingException if the sequence cannot be decoded
     */

    /** URL key for metadata */
    public static final String URL = "url";

    /** File passwords key for metadata */
    public static final String FILE_PASSWORDS = "file.passwords";

    /** Map containing metadata key-value pairs */
    protected Map<String, String[]> metadata = new HashMap<>();

    /** The extracted content text */
    protected String content;

    /**
     * Constructs a new ExtractData.

import jcifs.DialectVersion;
import jcifs.util.transport.Response;

/**
 * Interface for SMB protocol negotiation response handling.
 * Represents the server's response to a protocol negotiation request, containing negotiated
 * dialect version, security settings, capabilities, and buffer sizes for the SMB connection.
 *
 * @author mbechler
 */
public interface SmbNegotiationResponse extends CommonServerMessageBlock, Response {

 */
public class UUID extends rpc.uuid_t {

    /**
     * Convert hexadecimal characters to binary integer
     *
     * @param arr the character array containing hex digits
     * @param offset the starting position in the array
     * @param length the number of hex digits to convert
     * @return the integer value of the hex digits
     */

You can add code to be run with the `request`,  before any *path operation* receives it.

And also after the `response` is generated, before returning it.

For example, you could add a custom header `X-Process-Time` containing the time in seconds that it took to process the request and generate a response:

{* ../../docs_src/middleware/tutorial001_py39.py hl[10,12:13] *}

/// tip

    private static final int UTF8_BOM_SIZE = 3;

    /** Flag indicating whether content should be pruned */
    public boolean prunedContent = true;

    /** Map containing URL conversion rules (regex patterns to replacement strings) */
    protected Map<String, String> convertUrlMap = new LinkedHashMap<>();

    /** Fess configuration instance */
    protected FessConfig fessConfig;