TransactionService

Class Overview

The TransactionService of the MMS Client is responsible for handling requests to initiate client-transactions sent from:

• The Proxy-Relay (Through Push messages)
• The composer/viewer activities of the MMS Client (Through intents)

The TransactionService runs locally in the same process as the application. It contains a HandlerThread to which messages are posted from the intent-receivers of this application.

IMPORTANT: This is currently the only instance in the system in which simultaneous connectivity to both the mobile data network and a Wi-Fi network is allowed. This makes the code for handling network connectivity somewhat different than it is in other applications. In particular, we want to be able to send or receive MMS messages when a Wi-Fi connection is active (which implies that there is no connection to the mobile data network). This has two main consequences:

• Testing for current network connectivity (isConnected() is not sufficient. Instead, the correct test is for network availability (isAvailable()).
• If the mobile data network is not in the connected state, but it is available, we must initiate setup of the mobile data connection, and defer handling the MMS transaction until the connection is established.

Summary

Constants
String	ACTION_ONALARM	Action for the Intent which is sent by Alarm service to launch TransactionService.
String	STATE	Used as extra key in notification intents broadcasted by the TransactionService when a Transaction is completed (TRANSACTION_COMPLETED_ACTION intents).
String	STATE_URI	Used as extra key in notification intents broadcasted by the TransactionService when a Transaction is completed (TRANSACTION_COMPLETED_ACTION intents).
String	TRANSACTION_COMPLETED_ACTION	Used to identify notification intents broadcasted by the TransactionService when a Transaction is completed.

[Expand] Inherited Constants
From class android.app.Service int START_CONTINUATION_MASK int START_FLAG_REDELIVERY int START_FLAG_RETRY int START_NOT_STICKY int START_REDELIVER_INTENT int START_STICKY int START_STICKY_COMPATIBILITY
From class android.content.Context String ACCESSIBILITY_SERVICE String ACCOUNT_SERVICE String ACTIVITY_SERVICE String ALARM_SERVICE String AUDIO_SERVICE int BIND_ABOVE_CLIENT int BIND_ADJUST_WITH_ACTIVITY int BIND_ALLOW_OOM_MANAGEMENT int BIND_AUTO_CREATE int BIND_DEBUG_UNBIND int BIND_IMPORTANT int BIND_NOT_FOREGROUND int BIND_WAIVE_PRIORITY String CLIPBOARD_SERVICE String CONNECTIVITY_SERVICE int CONTEXT_IGNORE_SECURITY int CONTEXT_INCLUDE_CODE int CONTEXT_RESTRICTED String DEVICE_POLICY_SERVICE String DOWNLOAD_SERVICE String DROPBOX_SERVICE String INPUT_METHOD_SERVICE String KEYGUARD_SERVICE String LAYOUT_INFLATER_SERVICE String LOCATION_SERVICE int MODE_APPEND int MODE_MULTI_PROCESS int MODE_PRIVATE int MODE_WORLD_READABLE int MODE_WORLD_WRITEABLE String NFC_SERVICE String NOTIFICATION_SERVICE String POWER_SERVICE String SEARCH_SERVICE String SENSOR_SERVICE String STORAGE_SERVICE String TELEPHONY_SERVICE String TEXT_SERVICES_MANAGER_SERVICE String UI_MODE_SERVICE String USB_SERVICE String VIBRATOR_SERVICE String WALLPAPER_SERVICE String WIFI_P2P_SERVICE String WIFI_SERVICE String WINDOW_SERVICE
From interface android.content.ComponentCallbacks2 int TRIM_MEMORY_BACKGROUND int TRIM_MEMORY_COMPLETE int TRIM_MEMORY_MODERATE int TRIM_MEMORY_UI_HIDDEN

Fields
public Handler	mToastHandler

Public Constructors
	TransactionService()

Public Methods
IBinder	onBind(Intent intent)
void	onCreate()
void	onDestroy()
int	onStartCommand(Intent intent, int flags, int startId)
void	update(Observable observable) Handle status change of Transaction (The Observable).

Protected Methods
int	beginMmsConnectivity()
void	endMmsConnectivity()

[Expand] Inherited Methods
From class android.app.Service void dump(FileDescriptor arg0, PrintWriter arg1, String[] arg2) final Application getApplication() abstract IBinder onBind(Intent arg0) void onConfigurationChanged(Configuration arg0) void onCreate() void onDestroy() void onLowMemory() void onRebind(Intent arg0) void onStart(Intent arg0, int arg1) int onStartCommand(Intent arg0, int arg1, int arg2) void onTaskRemoved(Intent arg0) void onTrimMemory(int arg0) boolean onUnbind(Intent arg0) final void startForeground(int arg0, Notification arg1) final void stopForeground(boolean arg0) final void stopSelf() final void stopSelf(int arg0) final boolean stopSelfResult(int arg0)
From class android.content.ContextWrapper void attachBaseContext(Context arg0) boolean bindService(Intent arg0, ServiceConnection arg1, int arg2) int checkCallingOrSelfPermission(String arg0) int checkCallingOrSelfUriPermission(Uri arg0, int arg1) int checkCallingPermission(String arg0) int checkCallingUriPermission(Uri arg0, int arg1) int checkPermission(String arg0, int arg1, int arg2) int checkUriPermission(Uri arg0, int arg1, int arg2, int arg3) int checkUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5) void clearWallpaper() Context createPackageContext(String arg0, int arg1) String[] databaseList() boolean deleteDatabase(String arg0) boolean deleteFile(String arg0) void enforceCallingOrSelfPermission(String arg0, String arg1) void enforceCallingOrSelfUriPermission(Uri arg0, int arg1, String arg2) void enforceCallingPermission(String arg0, String arg1) void enforceCallingUriPermission(Uri arg0, int arg1, String arg2) void enforcePermission(String arg0, int arg1, int arg2, String arg3) void enforceUriPermission(Uri arg0, int arg1, int arg2, int arg3, String arg4) void enforceUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5, String arg6) String[] fileList() Context getApplicationContext() ApplicationInfo getApplicationInfo() AssetManager getAssets() Context getBaseContext() File getCacheDir() ClassLoader getClassLoader() ContentResolver getContentResolver() File getDatabasePath(String arg0) File getDir(String arg0, int arg1) File getExternalCacheDir() File getExternalFilesDir(String arg0) File getFileStreamPath(String arg0) File getFilesDir() Looper getMainLooper() File getObbDir() String getPackageCodePath() PackageManager getPackageManager() String getPackageName() String getPackageResourcePath() Resources getResources() SharedPreferences getSharedPreferences(String arg0, int arg1) Object getSystemService(String arg0) Resources.Theme getTheme() Drawable getWallpaper() int getWallpaperDesiredMinimumHeight() int getWallpaperDesiredMinimumWidth() void grantUriPermission(String arg0, Uri arg1, int arg2) boolean isRestricted() FileInputStream openFileInput(String arg0) FileOutputStream openFileOutput(String arg0, int arg1) SQLiteDatabase openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2) SQLiteDatabase openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2, DatabaseErrorHandler arg3) Drawable peekWallpaper() Intent registerReceiver(BroadcastReceiver arg0, IntentFilter arg1) Intent registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, String arg2, Handler arg3) void removeStickyBroadcast(Intent arg0) void revokeUriPermission(Uri arg0, int arg1) void sendBroadcast(Intent arg0) void sendBroadcast(Intent arg0, String arg1) void sendOrderedBroadcast(Intent arg0, String arg1, BroadcastReceiver arg2, Handler arg3, int arg4, String arg5, Bundle arg6) void sendOrderedBroadcast(Intent arg0, String arg1) void sendStickyBroadcast(Intent arg0) void sendStickyOrderedBroadcast(Intent arg0, BroadcastReceiver arg1, Handler arg2, int arg3, String arg4, Bundle arg5) void setTheme(int arg0) void setWallpaper(Bitmap arg0) void setWallpaper(InputStream arg0) void startActivities(Intent[] arg0) void startActivity(Intent arg0) boolean startInstrumentation(ComponentName arg0, String arg1, Bundle arg2) void startIntentSender(IntentSender arg0, Intent arg1, int arg2, int arg3, int arg4) ComponentName startService(Intent arg0) boolean stopService(Intent arg0) void unbindService(ServiceConnection arg0) void unregisterReceiver(BroadcastReceiver arg0)
From class android.content.Context abstract boolean bindService(Intent arg0, ServiceConnection arg1, int arg2) abstract int checkCallingOrSelfPermission(String arg0) abstract int checkCallingOrSelfUriPermission(Uri arg0, int arg1) abstract int checkCallingPermission(String arg0) abstract int checkCallingUriPermission(Uri arg0, int arg1) abstract int checkPermission(String arg0, int arg1, int arg2) abstract int checkUriPermission(Uri arg0, int arg1, int arg2, int arg3) abstract int checkUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5) abstract void clearWallpaper() abstract Context createPackageContext(String arg0, int arg1) abstract String[] databaseList() abstract boolean deleteDatabase(String arg0) abstract boolean deleteFile(String arg0) abstract void enforceCallingOrSelfPermission(String arg0, String arg1) abstract void enforceCallingOrSelfUriPermission(Uri arg0, int arg1, String arg2) abstract void enforceCallingPermission(String arg0, String arg1) abstract void enforceCallingUriPermission(Uri arg0, int arg1, String arg2) abstract void enforcePermission(String arg0, int arg1, int arg2, String arg3) abstract void enforceUriPermission(Uri arg0, int arg1, int arg2, int arg3, String arg4) abstract void enforceUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5, String arg6) abstract String[] fileList() abstract Context getApplicationContext() abstract ApplicationInfo getApplicationInfo() abstract AssetManager getAssets() abstract File getCacheDir() abstract ClassLoader getClassLoader() abstract ContentResolver getContentResolver() abstract File getDatabasePath(String arg0) abstract File getDir(String arg0, int arg1) abstract File getExternalCacheDir() abstract File getExternalFilesDir(String arg0) abstract File getFileStreamPath(String arg0) abstract File getFilesDir() abstract Looper getMainLooper() abstract File getObbDir() abstract String getPackageCodePath() abstract PackageManager getPackageManager() abstract String getPackageName() abstract String getPackageResourcePath() abstract Resources getResources() abstract SharedPreferences getSharedPreferences(String arg0, int arg1) final String getString(int arg0) final String getString(int arg0, Object... arg1) abstract Object getSystemService(String arg0) final CharSequence getText(int arg0) abstract Resources.Theme getTheme() abstract Drawable getWallpaper() abstract int getWallpaperDesiredMinimumHeight() abstract int getWallpaperDesiredMinimumWidth() abstract void grantUriPermission(String arg0, Uri arg1, int arg2) boolean isRestricted() final TypedArray obtainStyledAttributes(int[] arg0) final TypedArray obtainStyledAttributes(AttributeSet arg0, int[] arg1) final TypedArray obtainStyledAttributes(int arg0, int[] arg1) final TypedArray obtainStyledAttributes(AttributeSet arg0, int[] arg1, int arg2, int arg3) abstract FileInputStream openFileInput(String arg0) abstract FileOutputStream openFileOutput(String arg0, int arg1) abstract SQLiteDatabase openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2) abstract SQLiteDatabase openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2, DatabaseErrorHandler arg3) abstract Drawable peekWallpaper() void registerComponentCallbacks(ComponentCallbacks arg0) abstract Intent registerReceiver(BroadcastReceiver arg0, IntentFilter arg1) abstract Intent registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, String arg2, Handler arg3) abstract void removeStickyBroadcast(Intent arg0) abstract void revokeUriPermission(Uri arg0, int arg1) abstract void sendBroadcast(Intent arg0) abstract void sendBroadcast(Intent arg0, String arg1) abstract void sendOrderedBroadcast(Intent arg0, String arg1, BroadcastReceiver arg2, Handler arg3, int arg4, String arg5, Bundle arg6) abstract void sendOrderedBroadcast(Intent arg0, String arg1) abstract void sendStickyBroadcast(Intent arg0) abstract void sendStickyOrderedBroadcast(Intent arg0, BroadcastReceiver arg1, Handler arg2, int arg3, String arg4, Bundle arg5) abstract void setTheme(int arg0) abstract void setWallpaper(Bitmap arg0) abstract void setWallpaper(InputStream arg0) abstract void startActivities(Intent[] arg0) abstract void startActivity(Intent arg0) abstract boolean startInstrumentation(ComponentName arg0, String arg1, Bundle arg2) abstract void startIntentSender(IntentSender arg0, Intent arg1, int arg2, int arg3, int arg4) abstract ComponentName startService(Intent arg0) abstract boolean stopService(Intent arg0) abstract void unbindService(ServiceConnection arg0) void unregisterComponentCallbacks(ComponentCallbacks arg0) abstract void unregisterReceiver(BroadcastReceiver arg0)
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait() final void wait(long arg0, int arg1) final void wait(long arg0)
From interface android.content.ComponentCallbacks abstract void onConfigurationChanged(Configuration arg0) abstract void onLowMemory()
From interface android.content.ComponentCallbacks2 abstract void onTrimMemory(int arg0)
From interface com.android.mms.transaction.Observer abstract void update(Observable observable) Update the state of the observable.