Package com.bumptech.glide.request.target

Class SimpleTarget<Z>

  • Type Parameters:
    Z - The type of resource that this target will receive.
    All Implemented Interfaces:
    LifecycleListener, Target<Z>
    @Deprecated
public abstract class SimpleTarget<Z>
extends BaseTarget<Z>
    Deprecated.
    Use CustomViewTarget if loading the content into a view, the download API if in the background (http://bumptech.github.io/glide/doc/getting-started.html#background-threads), or a CustomTarget for any specialized use-cases. Using SimpleTarget or BaseTarget is unsafe if the user does not implement BaseTarget.onLoadCleared(android.graphics.drawable.Drawable), resulting in recycled bitmaps being referenced from the UI and hard to root-cause crashes.
    A simple Target base class with default (usually no-op) implementations of non essential methods that allows the caller to specify an exact width/height. Typically use cases look something like this: 
    
 Target<Bitmap> target =
     Glide.with(fragment)
       .asBitmap()
       .load("http://somefakeurl.com/fakeImage.jpeg")
       .apply(fitCenterTransform())
       .into(new SimpleTarget<Bitmap>(250, 250) {

         {@literal @Override}
         public void onResourceReady(Bitmap resource, Transition<? super Bitmap> transition) {
           // Do something with bitmap here.
         }

       });
 
 // At some later point, clear the Target to release the resources, prevent load queues from
 // blowing out proportion, and to improve load times for future requests:
 Glide.with(fragment).clear(target);
 }

    Warning! this class is extremely prone to mis-use. Use SimpleTarget only as a last resort. ViewTarget or a subclass of ViewTarget is almost always a better choice.

    Don't forget to clear instances of this class!. If you must use this class, keep in mind that unlike ViewTarget it is not safe to load into new instances of this class repeatedly if every instance updates the same underlying View or caller. If you need to load into the same View or caller repeatedly using this class, always retain a reference to the previous instance and either call RequestManager.clear(Target) on the old instance before starting a new load or you must re-use the old instance for the new load. Glide's RequestBuilder.into(Target) method returns the Target instance you provided to make retaining a reference to the Target as easy as possible. That said, you must wait until you're completely finished with the resource before calling RequestManager.clear(Target) and you should always null out references to any loaded resources in Target.onLoadCleared(Drawable).

    Always try to provide a size when using this class. Use SimpleTarget(int, int) whenever possible with values that are not Target.SIZE_ORIGINAL. Using Target.SIZE_ORIGINAL is unsafe if you're loading large images or are running your application on older or memory constrained devices because it can cause Glide to load very large images into memory. In some cases those images may throw OutOfMemoryError and in others they may exceed the texture limit for the device, which will prevent them from being rendered. Providing a valid size allows Glide to downsample large images, which can avoid issues with texture size or memory limitations. You don't have to worry about providing a size in most cases if you use ViewTarget so prefer ViewTarget over this class whenver possible.

    See Also:
    Glide's Target docs page

    • Constructor Detail

      • SimpleTarget

        public SimpleTarget()
        Deprecated.
        Constructor for the target that uses Target.SIZE_ORIGINAL as the target width and height.

      • SimpleTarget

        public SimpleTarget​(int width,
                    int height)
        Deprecated.
        Constructor for the target that takes the desired dimensions of the decoded and/or transformed resource.
        Parameters:
        width - The width in pixels of the desired resource.
        height - The height in pixels of the desired resource.

    • Method Detail

      • getSize

        public final void getSize​(@NonNull
                          SizeReadyCallback cb)
        Deprecated.
        Immediately calls the given callback with the sizes given in the constructor.
        Parameters:
        cb - The callback that must be called when the size of the target has been determined

      • removeCallback

        public void removeCallback​(@NonNull
                           SizeReadyCallback cb)
        Deprecated.
        Description copied from interface: Target
        Removes the given callback from the pending set if it's still retained.
        Parameters:
        cb - The callback to remove.