*
 * @since 4.0.0
 */
@Experimental
public interface CacheMetadata {

    /**
     * Returns the cache retention that should be applied to the associated data.
     *
     * @return The CacheRetention indicating how long data should be retained, or null if
     *         no specific cache retention is defined
     */
    @Nullable
    CacheRetention getCacheRetention();

    }

    // Test annotation retention policy
    @Test
    public void test_retentionPolicy() {
        final Retention retention = UriType.class.getAnnotation(Retention.class);
        assertNotNull(retention, "Retention annotation should be present");
        assertEquals("Retention should be RUNTIME", RetentionPolicy.RUNTIME, retention.value());
    }

    // Test annotation target elements

        .that(annotationClass.getAnnotation(TesterAnnotation.class))
        .isNotNull();
    Retention retentionPolicy = annotationClass.getAnnotation(Retention.class);
    assertWithMessage(rootLocaleFormat("%s must have a @Retention annotation.", annotationClass))
        .that(retentionPolicy)
        .isNotNull();
    assertEquals(

        assertTrue(Arrays.asList(targetTypes).contains(ElementType.TYPE));

        // Check Retention annotation
        Retention retention = Secured.class.getAnnotation(Retention.class);
        assertNotNull(retention);
        assertEquals(RetentionPolicy.RUNTIME, retention.value());

        // Check Inherited annotation
        assertNotNull(Secured.class.getAnnotation(Inherited.class));

        assertEquals(5, types.length);
    }

    // Test annotation retention policy
    @Test
    public void test_annotationRetention() {
        java.lang.annotation.Retention retention = CronExpression.class.getAnnotation(java.lang.annotation.Retention.class);
        assertNotNull(retention);
        assertEquals(java.lang.annotation.RetentionPolicy.RUNTIME, retention.value());
    }

    // Test annotation is documented
    @Test

 * under the License.
 */
package org.apache.maven.api.annotations;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * The {@code Immutable} annotation indicates that the object is immutable, i.e.

 * under the License.
 */
package org.apache.maven.api.annotations;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * The annotated element must not be null.
 * <p>
 * Annotated fields must not be null after construction has completed.

import com.google.common.collect.testing.features.Feature;
import com.google.common.collect.testing.features.TesterAnnotation;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.util.Set;

/**
 * Optional features of classes derived from {@link Multiset}.
 *
 * @author Louis Wasserman
 */

 * specific language governing permissions and limitations
 * under the License.
 */
package org.apache.maven.api.di;

import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import static java.lang.annotation.ElementType.CONSTRUCTOR;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.METHOD;

 * methods for executing and optionally caching both single requests and batches of requests.
 * <p>
 * The cache behavior is determined by the cache retention specified in the request's metadata.
 * Results can be cached at different policies (forever, session, request, or not at all)
 * based on the {@link CacheRetention} associated with the request.
 *
 * @since 4.0.0