dagger.releasablereferences

Interface TypedReleasableReferenceManager<M extends java.lang.annotation.Annotation>

Type Parameters:

M - the type of the metadata annotation

All Superinterfaces:

ReleasableReferenceManager

Deprecated.

The releasable references feature is deprecated and scheduled for removal in July 2018. If you use it or are planning to add usages, please comment on this bug.

@Beta
 @Deprecated
public interface TypedReleasableReferenceManager<M extends java.lang.annotation.Annotation>
extends ReleasableReferenceManager

A ReleasableReferenceManager for a scope that is annotated with an annotation that itself is annotated with CanReleaseReferences. That annotation is available as metadata() and may be useful at runtime to decide when to release references held by the scope.

For example:

    @CanReleaseReferences
   public  @interface SomeAnnotation {
     int value();
   }

    @Documented
    @Retention(RUNTIME)
    @SomeAnnotation(15)
    @Scope
   public  @interface MyScope {}

   // In a component that is (or has a subcomponent) annotated with  @MyScope:
    @Inject
   void manager(
        @ForReferenceReleasingScope(MyScope.class)
        TypedReferenceReleasingScope<SomeAnnotation> manager) {
     manager.metadata().value(); // returns 15
   }

This interface is implemented by Dagger.

Method Summary

Modifier and Type	Method and Description
M	metadata() Deprecated. Returns the annotation on ReleasableReferenceManager.scope() that is annotated with CanReleaseReferences.

Methods inherited from interface dagger.releasablereferences.ReleasableReferenceManager

releaseStrongReferences, restoreStrongReferences, scope

Method Detail

metadata

M metadata()

Deprecated.

Returns the annotation on ReleasableReferenceManager.scope() that is annotated with CanReleaseReferences.