Android
लोडर

परिचय

पैरामीटर

टिप्पणियों

बेसिक AsyncTaskLoader

AsyncTaskLoader एक अमूर्त Loader जो काम करने के लिए एक AsyncTask प्रदान करता है।

यहाँ कुछ बुनियादी कार्यान्वयन:

final class BasicLoader extends AsyncTaskLoader<String> {

    public BasicLoader(Context context) {
        super(context);
    }

    @Override
    public String loadInBackground() {
        // Some work, e.g. load something from internet
        return "OK";
    }

    @Override
    public void deliverResult(String data) {
        if (isStarted()) {
            // Deliver result if loader is currently started
            super.deliverResult(data);
        }
    }

    @Override
    protected void onStartLoading() {
        // Start loading
        forceLoad();
    }

    @Override
    protected void onStopLoading() {
        cancelLoad();
    }

    @Override
    protected void onReset() {
        super.onReset();

        // Ensure the loader is stopped
        onStopLoading();
    }
}

आमतौर पर Loader को गतिविधि के onCreate() विधि के भीतर, या टुकड़े के onActivityCreated() के भीतर शुरू किया जाता है। इसके अलावा आमतौर पर गतिविधि या टुकड़ा LoaderManager.LoaderCallbacks इंटरफ़ेस:

public class MainActivity extends Activity implements LoaderManager.LoaderCallbacks<String> {

    // Unique id for loader
    private static final int LDR_BASIC_ID = 1;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // Initialize loader; Some data can be passed as second param instead of Bundle.Empty
        getLoaderManager().initLoader(LDR_BASIC_ID, Bundle.EMPTY, this);
    }

    @Override
    public Loader<String> onCreateLoader(int id, Bundle args) {
        return new BasicLoader(this);
    }

    @Override
    public void onLoadFinished(Loader<String> loader, String data) {
        Toast.makeText(this, data, Toast.LENGTH_LONG).show();
    }

    @Override
    public void onLoaderReset(Loader<String> loader) {
    }
}

इस उदाहरण में, जब लोडर पूरा हो जाता है, तो परिणाम के साथ टोस्ट दिखाया जाएगा।

कैश के साथ AsyncTaskLoader

एक ही डेटा के कई लोडिंग से बचने के लिए लोड किए गए परिणाम को कैश करना एक अच्छा अभ्यास है।
कैश को onContentChanged() अमान्य करने के लिए onContentChanged() को बुलाया जाना चाहिए। यदि लोडर पहले से ही चालू हो गया है, तो forceLoad() को कॉल किया जाएगा, अन्यथा (यदि रोका हुआ राज्य में लोडर) लोडर takeContentChanged() चेक के साथ सामग्री परिवर्तन को समझने में सक्षम होगा।

टिप्पणी: onContentChanged() को प्रक्रिया के मुख्य सूत्र से बुलाया जाना चाहिए।

Javadocs के बारे में कहते हैं

वर्तमान ध्वज को इंगित करें कि क्या लोडर की सामग्री बदल गई थी, जबकि इसे रोक दिया गया था। यदि यह था, तो सच लौटा दिया गया है और झंडा साफ हो गया है।

public abstract class BaseLoader<T> extends AsyncTaskLoader<T> {

    // Cached result saved here
    private final AtomicReference<T> cache = new AtomicReference<>();

    public BaseLoader(@NonNull final Context context) {
        super(context);
    }

    @Override
    public final void deliverResult(final T data) {
        if (!isReset()) {
            // Save loaded result
            cache.set(data);
            if (isStarted()) {
                super.deliverResult(data);
            }
        }
    }

    @Override
    protected final void onStartLoading() {            
        // Register observers
        registerObserver();

        final T cached = cache.get();    
        // Start new loading if content changed in background
        // or if we never loaded any data
        if (takeContentChanged() || cached == null) {
            forceLoad();
        } else {
            deliverResult(cached);
        }
    }

    @Override
    public final void onStopLoading() {
        cancelLoad();
    }

    @Override
    protected final void onReset() {
        super.onReset();
        onStopLoading();
        // Clear cache and remove observers
        cache.set(null);
        unregisterObserver();
    }

    /* virtual */
    protected void registerObserver() {
        // Register observers here, call onContentChanged() to invalidate cache
    }

    /* virtual */
    protected void unregisterObserver() {
        // Remove observers
    }
}

पुन: लोड

अपने पुराने डेटा को अमान्य करने के लिए और मौजूदा लोडर को पुनरारंभ करने के लिए आप पुनः restartLoader() विधि का उपयोग कर सकते हैं:

private void reload() {
    getLoaderManager().reastartLoader(LOADER_ID, Bundle.EMPTY, this);
}

एक बंडल का उपयोग कर मापदंडों को पास करें

आप बंडल करके पैरामीटर पास कर सकते हैं:

Bundle myBundle = new Bundle();
myBundle.putString(MY_KEY, myValue);

OnCreateLoader में मान प्राप्त करें:

@Override
public Loader<String> onCreateLoader(int id, final Bundle args) {
    final String myParam = args.getString(MY_KEY);
    ...
}