import org.apache.maven.api.annotations.Experimental;
import org.apache.maven.api.annotations.Nullable;

/**
 * Interface defining metadata for cache behavior and lifecycle management.
 * Implementations can specify how long cached data should be retained.
 *
 * @since 4.0.0
 */
@Experimental
public interface CacheMetadata {

    /**
     * Returns the cache retention that should be applied to the associated data.
     *

                 * be cached and cause other types to fail even though they may
                 * not be the authority for the name. For example, if a WINS lookup
                 * for FOO fails and caches unknownAddress for FOO, a subsequent
                 * lookup for FOO using BCAST should not fail because of that
                 * name cached from WINS.
                 *

        }
    }

    /**
     * Continues an MD4 message digest using the input byte.
     */
    @Override
    public void engineUpdate(final byte b) {
        // compute number of bytes still unhashed; ie. present in buffer
        final int i = (int) (count % BLOCK_LENGTH);
        count++; // update number of bytes
        buffer[i] = b;
        if (i == BLOCK_LENGTH - 1) {
            transform(buffer, 0);

                        "Reusing cached resolved plugin version for {}:{} to {} from POM {}",
                        request.getGroupId(),
                        request.getArtifactId(),
                        result.getVersion(),
                        request.getPom());
            }
        } else {
            logger.debug(
                    "Reusing cached resolved plugin version for {}:{} to {} from POM {}",

import okhttp3.Response
import okhttp3.internal.http.RealInterceptorChain

/**
 * Opens a connection to the target server and proceeds to the next interceptor. The network might
 * be used for the returned response, or to validate a cached response with a conditional GET.
 */
object ConnectInterceptor : Interceptor {
  @Throws(IOException::class)
  override fun intercept(chain: Interceptor.Chain): Response {
    val realChain = chain as RealInterceptorChain

        if (entry != null) {
            entry.breaking = true;
            entry.updateState(newState);
            // Flush any cached data if losing write cache
            if (!entry.hasWriteCache()) {
                flushCachedWrites(entry.path);
            }
            // Invalidate cached data if losing read cache
            if (!entry.hasReadCache()) {
                invalidateReadCache(entry.path);
            }

import org.codehaus.plexus.classworlds.realm.NoSuchRealmException;
import org.codehaus.plexus.personality.plexus.lifecycle.phase.Disposable;

/**
 * Default extension realm cache implementation. Assumes cached data does not change.
 */
@Named
@Singleton
public class DefaultExtensionRealmCache implements ExtensionRealmCache, Disposable {
    /**
     * CacheKey
     */
    protected static class CacheKey implements Key {

        this.cacheScope = cacheScope;
    }

    /**
     * Gets the maximum age for cached directory data before requiring refresh
     * @return the maximum cache age in milliseconds
     */
    public long getMaxCacheAge() {
        return maxCacheAge;
    }

    /**
     * Sets the maximum age for cached directory data
     * @param maxCacheAge the maximum cache age in milliseconds
     */

    /**
     *
     *
     *             The location of the POM from which this POM was
     * imported from or {@code null} if unknown.
     */
    private InputLocation importedFrom;

    /**
     * Cached hashCode for performance.
     */
    private volatile int hashCode = 0;

    // ----------------/
    // - Constructors -/
    // ----------------/

    /**
     * Default constructor for InputSource.

In an advanced scenario where you know you need the dependency to be called at every step (possibly multiple times) in the same request instead of using the "cached" value, you can set the parameter `use_cache=False` when using `Depends`:

//// tab | Python 3.9+

```Python hl_lines="1"
async def needy_dependency(fresh_value: Annotated[str, Depends(get_value, use_cache=False)]):