com.j256.ormlite.android.apptools.OrmLiteBaseService Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of ormlite-android Show documentation
Show all versions of ormlite-android Show documentation
Lightweight Object Relational Model (ORM) Android classes
package com.j256.ormlite.android.apptools;
import android.app.Service;
import android.content.Context;
import com.j256.ormlite.support.ConnectionSource;
/**
* Base class to use for services in Android.
*
* For more information, see {@link OrmLiteBaseActivity}.
*
* @author graywatson, kevingalligan
*/
public abstract class OrmLiteBaseService extends Service {
private volatile H helper;
private volatile boolean created = false;
private volatile boolean destroyed = false;
/**
* Get a helper for this action.
*/
public H getHelper() {
if (helper == null) {
if (!created) {
throw new IllegalStateException("A call has not been made to onCreate() yet so the helper is null");
} else if (destroyed) {
throw new IllegalStateException(
"A call to onDestroy has already been made and the helper cannot be used after that point");
} else {
throw new IllegalStateException("Helper is null for some unknown reason");
}
} else {
return helper;
}
}
/**
* Get a connection source for this action.
*/
public ConnectionSource getConnectionSource() {
return getHelper().getConnectionSource();
}
@Override
public void onCreate() {
if (helper == null) {
helper = getHelperInternal(this);
created = true;
}
super.onCreate();
}
@Override
public void onDestroy() {
super.onDestroy();
releaseHelper(helper);
destroyed = true;
}
/**
* This is called internally by the class to populate the helper object instance. This should not be called directly
* by client code unless you know what you are doing. Use {@link #getHelper()} to get a helper instance. If you are
* managing your own helper creation, override this method to supply this activity with a helper instance.
*
*
* NOTE: If you override this method, you most likely will need to override the
* {@link #releaseHelper(OrmLiteSqliteOpenHelper)} method as well.
*
*/
protected H getHelperInternal(Context context) {
@SuppressWarnings({ "unchecked", "deprecation" })
H newHelper = (H) OpenHelperManager.getHelper(context);
return newHelper;
}
/**
* Release the helper instance created in {@link #getHelperInternal(Context)}. You most likely will not need to call
* this directly since {@link #onDestroy()} does it for you.
*
*
* NOTE: If you override this method, you most likely will need to override the
* {@link #getHelperInternal(Context)} method as well.
*
*/
protected void releaseHelper(H helper) {
OpenHelperManager.releaseHelper();
this.helper = null;
}
}