com.inkapplications.android.standard.BaseApplication Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of android-standard Show documentation
A base class framework for android projects
The newest version!
package com.inkapplications.android.standard;

import android.app.Application;

import javax.inject.Inject;

import com.inkapplications.android.standard.dependencyinjection.module.StandardApplicationModule;
import com.inkapplications.android.eventdispatcher.event.application.OnCreateEvent;
import com.inkapplications.android.eventdispatcher.event.application.OnLowMemoryEvent;
import com.inkapplications.android.eventdispatcher.event.application.OnTerminateEvent;
import com.squareup.otto.Bus;
import dagger.ObjectGraph;

import java.util.ArrayList;
import java.util.List;

/**
 * Base Application
 *
 * Sets up an Application with Dependency Injection and registers events
 * with the application event dispatcher / bus.
 *
 * @author Maxwell Vandervelde 
 */
public class BaseApplication extends Application
{
    /**
     * Application-wide Event Bus.
     */
    @Inject Bus applicationBus;

    /**
     * Dagger Object Graph
     */
    private ObjectGraph objectGraph;

    @Override
    public void onCreate()
    {
        super.onCreate();

        this.inject(this);
        this.applicationBus.post(new OnCreateEvent(this));
    }

    @Override
    public void onTerminate()
    {
        super.onTerminate();
        this.applicationBus.post(new OnTerminateEvent(this));
    }

    @Override
    public void onLowMemory()
    {
        super.onLowMemory();
        this.applicationBus.post(new OnLowMemoryEvent(this));
    }

    /**
     * Inject
     *
     * Injects an object with dagger's Application activity graph
     *
     * @param object object that needs dependencies injected
     */
    public void inject(Object object)
    {
        this.getObjectGraph().inject(object);
    }

    /**
     * Get Object Graph
     *
     * @return The application object graph
     */
    final public ObjectGraph getObjectGraph()
    {
        if (null == this.objectGraph) {
            this.objectGraph = this.buildObjectGraph();
        }

        return this.objectGraph;
    }

    /**
     * Build Object Graph
     * 
     * @return A new dagger object graph
     */
    protected ObjectGraph buildObjectGraph()
    {
        ObjectGraph graph = ObjectGraph.create(this.getModules().toArray());

        return graph;
    }

    /**
     * Get Modules
     *
     * Gets all of the dagger modules to load into the application object graph.
     * These modules are loaded for the application only.
     * Method may be overridden to include additional modules.
     *
     * @return The modules to include in the object graph
     */
    public List