jadex.android

Class JadexAndroidActivity

java.lang.Object

android.content.Context

android.content.ContextWrapper

android.view.ContextThemeWrapper

android.app.Activity

jadex.android.JadexAndroidActivity

All Implemented Interfaces:

android.content.ComponentCallbacks, android.content.ComponentCallbacks2, android.content.ServiceConnection, android.view.KeyEvent.Callback, android.view.LayoutInflater.Factory, android.view.LayoutInflater.Factory2, android.view.View.OnCreateContextMenuListener, android.view.Window.Callback, IJadexPlatformInterface

public class JadexAndroidActivity
extends android.app.Activity
implements android.content.ServiceConnection, IJadexPlatformInterface

This is an Android Activity Class which provides needed Functionality and comfort Features for Jadex Android Activities. It uses the JadexPlatformService internally, but takes care about service binding.
IMPORTANT: When creating real applications, you need to use your own Service (extend JadexPlatformService)!
Don't use this Activity for real applications as the service will be killed when it's destroyed.

Field Summary

Fields

Modifier and Type	Field and Description
protected IComponentIdentifier	platformId

Fields inherited from class android.app.Activity

DEFAULT_KEYS_DIALER, DEFAULT_KEYS_DISABLE, DEFAULT_KEYS_SEARCH_GLOBAL, DEFAULT_KEYS_SEARCH_LOCAL, DEFAULT_KEYS_SHORTCUT, FOCUSED_STATE_SET, RESULT_CANCELED, RESULT_FIRST_USER, RESULT_OK

Fields inherited from class android.content.Context

ACCESSIBILITY_SERVICE, ACCOUNT_SERVICE, ACTIVITY_SERVICE, ALARM_SERVICE, APP_OPS_SERVICE, APPWIDGET_SERVICE, AUDIO_SERVICE, BATTERY_SERVICE, BIND_ABOVE_CLIENT, BIND_ADJUST_WITH_ACTIVITY, BIND_ALLOW_OOM_MANAGEMENT, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, BIND_IMPORTANT, BIND_NOT_FOREGROUND, BIND_WAIVE_PRIORITY, BLUETOOTH_SERVICE, CAMERA_SERVICE, CAPTIONING_SERVICE, CARRIER_CONFIG_SERVICE, CLIPBOARD_SERVICE, CONNECTIVITY_SERVICE, CONSUMER_IR_SERVICE, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESTRICTED, DEVICE_POLICY_SERVICE, DISPLAY_SERVICE, DOWNLOAD_SERVICE, DROPBOX_SERVICE, FINGERPRINT_SERVICE, INPUT_METHOD_SERVICE, INPUT_SERVICE, JOB_SCHEDULER_SERVICE, KEYGUARD_SERVICE, LAUNCHER_APPS_SERVICE, LAYOUT_INFLATER_SERVICE, LOCATION_SERVICE, MEDIA_PROJECTION_SERVICE, MEDIA_ROUTER_SERVICE, MEDIA_SESSION_SERVICE, MIDI_SERVICE, MODE_APPEND, MODE_ENABLE_WRITE_AHEAD_LOGGING, MODE_MULTI_PROCESS, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NETWORK_STATS_SERVICE, NFC_SERVICE, NOTIFICATION_SERVICE, NSD_SERVICE, POWER_SERVICE, PRINT_SERVICE, RESTRICTIONS_SERVICE, SEARCH_SERVICE, SENSOR_SERVICE, STORAGE_SERVICE, TELECOM_SERVICE, TELEPHONY_SERVICE, TELEPHONY_SUBSCRIPTION_SERVICE, TEXT_SERVICES_MANAGER_SERVICE, TV_INPUT_SERVICE, UI_MODE_SERVICE, USAGE_STATS_SERVICE, USB_SERVICE, USER_SERVICE, VIBRATOR_SERVICE, WALLPAPER_SERVICE, WIFI_P2P_SERVICE, WIFI_SERVICE, WINDOW_SERVICE

Fields inherited from interface android.content.ComponentCallbacks2

TRIM_MEMORY_BACKGROUND, TRIM_MEMORY_COMPLETE, TRIM_MEMORY_MODERATE, TRIM_MEMORY_RUNNING_CRITICAL, TRIM_MEMORY_RUNNING_LOW, TRIM_MEMORY_RUNNING_MODERATE, TRIM_MEMORY_UI_HIDDEN

Constructor Summary

Constructors

Constructor and Description
JadexAndroidActivity() Constructor

Method Summary

Modifier and Type	Method and Description
boolean	dispatchEvent(IJadexAndroidEvent event) Dispatch an event.
protected <any>	getCMS() Deprecated. use getPlatformService().getSservice() instead.
IExternalAccess	getExternalPlatformAccess() Returns the Jadex External Platform Access object.
protected <any>	getMS() Deprecated. use getPlatformService().getSservice() instead.
IExternalAccess	getPlatformAccess() Returns the Jadex External Platform Access object.
protected PlatformConfiguration	getPlatformConfiguration() Get the platform configuration
IComponentIdentifier	getPlatformId() Retrieves the platformId of the last started Platform, if any.
protected IJadexPlatformBinder	getPlatformService() Gets the platform service.
<S> <any>	getService(java.lang.Class<S> serviceClazz) Looks up a service.
<S> <any>	getService(java.lang.Class<S> serviceClazz, java.lang.String scope) Looks up a service.
<S> S	getsService(java.lang.Class<S> serviceClazz) Looks up a service and returns it synchronously.
boolean	isPlatformRunning() Returns true if given jadex platform is running.
protected boolean	isPlatformRunning(IComponentIdentifier platformId)
protected void	onCreate(android.os.Bundle savedInstanceState)
protected void	onDestroy()
protected void	onPlatformStarted(IExternalAccess result) Called right after the platform is started.
protected void	onPlatformStarting() Called right before the platform startup.
void	onServiceConnected(android.content.ComponentName name, android.os.IBinder service)
void	onServiceDisconnected(android.content.ComponentName name)
void	registerEventReceiver(IEventReceiver<?> rec) Register an event receiver.
protected <any>	sendMessage(java.util.Map<java.lang.String,java.lang.Object> message, IComponentIdentifier receiver) Sends a FIPA Message to the specified receiver.
protected <any>	sendMessage(java.util.Map<java.lang.String,java.lang.Object> message, MessageType type, IComponentIdentifier receiver) Sends a Message to a Component on the Jadex Platform.
protected void	setPlatformAutostart(boolean autostart) Sets the autostart parameter for this jadex platform.
protected void	setPlatformConfiguration(PlatformConfiguration config) Sets platform configuration.
protected void	setPlatformKernels(java.lang.String... kernels) Deprecated. use getPlatformConfiguration().getRootConfig().setKernels() instead.
protected void	setPlatformName(java.lang.String name) Deprecated. use getPlatformConfiguration().setPlatformName() instead.
protected void	setPlatformOptions(java.lang.String options) Deprecated. use setPlatformConfiguration
void	shutdownJadexPlatform() Terminates the running jadex platform with the given ID.
void	shutdownJadexPlatform(IComponentIdentifier platformID)
protected <any>	startBDIAgent(java.lang.String name, java.lang.String modelPath) Deprecated. Use startComponent for all Component types instead.
protected <any>	startBPMNAgent(java.lang.String name, java.lang.String modelPath) Deprecated. Use startComponent for all Component types instead.
<any>	startComponent(java.lang.String name, java.lang.Class<?> clazz) Start a new Component on a given platform with default CreationInfo.
<any>	startComponent(java.lang.String name, java.lang.Class<?> clazz, CreationInfo creationInfo) Start a new Component on a given platform.
<any>	startComponent(java.lang.String name, java.lang.String modelPath) Start a new Component on a given platform.
<any>	startComponent(java.lang.String name, java.lang.String modelPath, CreationInfo creationInfo) Start a new Component.
<any>	startMicroAgent(java.lang.String name, java.lang.Class<?> clazz) Starts a Micro Agent.
protected void	startPlatform() Starts the Jadex Platform.
protected void	stopPlatforms() Deprecated. use shutdownJadexPlatforms() instead.
boolean	unregisterEventReceiver(IEventReceiver<?> rec) Unregister an event receiver.

Methods inherited from class android.app.Activity

addContentView, closeContextMenu, closeOptionsMenu, createPendingResult, dismissDialog, dispatchGenericMotionEvent, dispatchKeyEvent, dispatchKeyShortcutEvent, dispatchPopulateAccessibilityEvent, dispatchTouchEvent, dispatchTrackballEvent, dump, findViewById, finish, finishActivity, finishActivityFromChild, finishAffinity, finishAfterTransition, finishAndRemoveTask, finishFromChild, getActionBar, getApplication, getCallingActivity, getCallingPackage, getChangingConfigurations, getComponentName, getContentScene, getContentTransitionManager, getCurrentFocus, getFragmentManager, getIntent, getLastNonConfigurationInstance, getLayoutInflater, getLoaderManager, getLocalClassName, getMediaController, getMenuInflater, getParent, getParentActivityIntent, getPreferences, getReferrer, getRequestedOrientation, getSearchEvent, getSystemService, getTaskId, getTitle, getTitleColor, getVoiceInteractor, getVolumeControlStream, getWindow, getWindowManager, hasWindowFocus, invalidateOptionsMenu, isChangingConfigurations, isChild, isDestroyed, isFinishing, isImmersive, isTaskRoot, isVoiceInteraction, isVoiceInteractionRoot, managedQuery, moveTaskToBack, navigateUpTo, navigateUpToFromChild, onActionModeFinished, onActionModeStarted, onActivityReenter, onActivityResult, onApplyThemeResource, onAttachedToWindow, onAttachFragment, onBackPressed, onChildTitleChanged, onConfigurationChanged, onContentChanged, onContextItemSelected, onContextMenuClosed, onCreate, onCreateContextMenu, onCreateDescription, onCreateDialog, onCreateDialog, onCreateNavigateUpTaskStack, onCreateOptionsMenu, onCreatePanelMenu, onCreatePanelView, onCreateThumbnail, onCreateView, onCreateView, onDetachedFromWindow, onEnterAnimationComplete, onGenericMotionEvent, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyShortcut, onKeyUp, onLowMemory, onMenuItemSelected, onMenuOpened, onNavigateUp, onNavigateUpFromChild, onNewIntent, onOptionsItemSelected, onOptionsMenuClosed, onPanelClosed, onPause, onPostCreate, onPostCreate, onPostResume, onPrepareDialog, onPrepareDialog, onPrepareNavigateUpTaskStack, onPrepareOptionsMenu, onPreparePanel, onProvideAssistContent, onProvideAssistData, onProvideReferrer, onRequestPermissionsResult, onRestart, onRestoreInstanceState, onRestoreInstanceState, onResume, onRetainNonConfigurationInstance, onSaveInstanceState, onSaveInstanceState, onSearchRequested, onSearchRequested, onStart, onStateNotSaved, onStop, onTitleChanged, onTouchEvent, onTrackballEvent, onTrimMemory, onUserInteraction, onUserLeaveHint, onVisibleBehindCanceled, onWindowAttributesChanged, onWindowFocusChanged, onWindowStartingActionMode, onWindowStartingActionMode, openContextMenu, openOptionsMenu, overridePendingTransition, postponeEnterTransition, recreate, registerForContextMenu, releaseInstance, removeDialog, reportFullyDrawn, requestPermissions, requestVisibleBehind, requestWindowFeature, runOnUiThread, setActionBar, setContentTransitionManager, setContentView, setContentView, setContentView, setDefaultKeyMode, setEnterSharedElementCallback, setExitSharedElementCallback, setFeatureDrawable, setFeatureDrawableAlpha, setFeatureDrawableResource, setFeatureDrawableUri, setFinishOnTouchOutside, setImmersive, setIntent, setMediaController, setProgress, setProgressBarIndeterminate, setProgressBarIndeterminateVisibility, setProgressBarVisibility, setRequestedOrientation, setResult, setResult, setSecondaryProgress, setTaskDescription, setTitle, setTitle, setTitleColor, setVisible, setVolumeControlStream, shouldShowRequestPermissionRationale, shouldUpRecreateTask, showAssist, showDialog, showDialog, showLockTaskEscapeMessage, startActionMode, startActionMode, startActivities, startActivities, startActivity, startActivity, startActivityForResult, startActivityForResult, startActivityFromChild, startActivityFromChild, startActivityFromFragment, startActivityFromFragment, startActivityIfNeeded, startActivityIfNeeded, startIntentSender, startIntentSender, startIntentSenderForResult, startIntentSenderForResult, startIntentSenderFromChild, startIntentSenderFromChild, startLockTask, startManagingCursor, startNextMatchingActivity, startNextMatchingActivity, startPostponedEnterTransition, startSearch, stopLockTask, stopManagingCursor, takeKeyEvents, triggerSearch, unregisterForContextMenu

Methods inherited from class android.view.ContextThemeWrapper

applyOverrideConfiguration, attachBaseContext, getResources, getTheme, setTheme

Methods inherited from class android.content.ContextWrapper

bindService, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingPermission, checkCallingUriPermission, checkPermission, checkSelfPermission, checkUriPermission, checkUriPermission, clearWallpaper, createConfigurationContext, createDisplayContext, createPackageContext, databaseList, deleteDatabase, deleteFile, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getApplicationInfo, getAssets, getBaseContext, getCacheDir, getClassLoader, getCodeCacheDir, getContentResolver, getDatabasePath, getDir, getExternalCacheDir, getExternalCacheDirs, getExternalFilesDir, getExternalFilesDirs, getExternalMediaDirs, getFilesDir, getFileStreamPath, getMainLooper, getNoBackupFilesDir, getObbDir, getObbDirs, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getSharedPreferences, getSystemServiceName, getWallpaper, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, grantUriPermission, isRestricted, openFileInput, openFileOutput, openOrCreateDatabase, openOrCreateDatabase, peekWallpaper, registerReceiver, registerReceiver, removeStickyBroadcast, removeStickyBroadcastAsUser, revokeUriPermission, sendBroadcast, sendBroadcast, sendBroadcastAsUser, sendBroadcastAsUser, sendOrderedBroadcast, sendOrderedBroadcast, sendOrderedBroadcastAsUser, sendStickyBroadcast, sendStickyBroadcastAsUser, sendStickyOrderedBroadcast, sendStickyOrderedBroadcastAsUser, setWallpaper, setWallpaper, startInstrumentation, startService, stopService, unbindService, unregisterReceiver

Methods inherited from class android.content.Context

getColor, getColorStateList, getDrawable, getString, getString, getSystemService, getText, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, registerComponentCallbacks, unregisterComponentCallbacks

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

platformId

protected IComponentIdentifier platformId

Constructor Detail

JadexAndroidActivity

public JadexAndroidActivity()

Constructor

Method Detail

onCreate

protected void onCreate(android.os.Bundle savedInstanceState)

Overrides:

onCreate in class android.app.Activity

onDestroy

protected void onDestroy()

Overrides:

onDestroy in class android.app.Activity

setPlatformAutostart

protected void setPlatformAutostart(boolean autostart)

Sets the autostart parameter for this jadex platform. If true, the platform will be started during onCreate.

Parameters:

autostart -

setPlatformConfiguration

protected void setPlatformConfiguration(PlatformConfiguration config)

Sets platform configuration.

Parameters:

config -

getPlatformConfiguration

protected PlatformConfiguration getPlatformConfiguration()

Get the platform configuration

Returns:

setPlatformKernels

protected void setPlatformKernels(java.lang.String... kernels)

Deprecated. use getPlatformConfiguration().getRootConfig().setKernels() instead.

Sets the Kernels. See jadex.base.RootComponentConfiguration.KERNEL Constants for available Kernels.

Parameters:

kernels -

setPlatformOptions

protected void setPlatformOptions(java.lang.String options)

Deprecated. use setPlatformConfiguration

Sets platform options.

Parameters:

options -

setPlatformName

protected void setPlatformName(java.lang.String name)

Deprecated. use getPlatformConfiguration().setPlatformName() instead.

Sets the name of the platform that is started by this activity.

Parameters:

name -

isPlatformRunning

public boolean isPlatformRunning()

Description copied from interface: IJadexPlatformInterface

Returns true if given jadex platform is running.

Specified by:

isPlatformRunning in interface IJadexPlatformInterface

getPlatformId

public IComponentIdentifier getPlatformId()

Description copied from interface: IJadexPlatformInterface

Retrieves the platformId of the last started Platform, if any.

Specified by:

getPlatformId in interface IJadexPlatformInterface

Returns:

IComponentIdentifier platformId or null.

getPlatformAccess

public IExternalAccess getPlatformAccess()

Description copied from interface: IJadexPlatformInterface

Returns the Jadex External Platform Access object.

Specified by:

getPlatformAccess in interface IJadexPlatformInterface

Returns:

IExternalAccess

getExternalPlatformAccess

public IExternalAccess getExternalPlatformAccess()

Description copied from interface: IJadexPlatformInterface

Returns the Jadex External Platform Access object.

Specified by:

getExternalPlatformAccess in interface IJadexPlatformInterface

Returns:

IExternalAccess

getPlatformService

protected IJadexPlatformBinder getPlatformService()

Gets the platform service.

Returns:

PlatformService binder

getsService

public <S> S getsService(java.lang.Class<S> serviceClazz)

Description copied from interface: IJadexPlatformInterface

Looks up a service and returns it synchronously.

Specified by:

getsService in interface IJadexPlatformInterface

Parameters:

serviceClazz - Class of the service (interface) to find

Returns:

the service

getService

public <S> <any> getService(java.lang.Class<S> serviceClazz)

Description copied from interface: IJadexPlatformInterface

Looks up a service.

Specified by:

getService in interface IJadexPlatformInterface

Parameters:

serviceClazz - Class of the service (interface) to find

Returns:

Future of the service.

See Also:

getsService

getService

public <S> <any> getService(java.lang.Class<S> serviceClazz,
                            java.lang.String scope)

Description copied from interface: IJadexPlatformInterface

Looks up a service.

Specified by:

getService in interface IJadexPlatformInterface

Parameters:

serviceClazz - Class of the service (interface) to find

scope - Search scope. See RequiredServiceInfo constants.

Returns:

Future of the service.

See Also:

getsService

isPlatformRunning

protected boolean isPlatformRunning(IComponentIdentifier platformId)

startMicroAgent

public <any> startMicroAgent(java.lang.String name,
                             java.lang.Class<?> clazz)

Starts a Micro Agent.

Specified by:

startMicroAgent in interface IJadexPlatformInterface

Parameters:

name - Name of the Micro Agent created

clazz - Class which defines the Micro Agent

Returns:

IFuture

startBDIAgent

protected <any> startBDIAgent(java.lang.String name,
                              java.lang.String modelPath)

Deprecated. Use startComponent for all Component types instead.

Starts a Component.

Parameters:

name - Name of the Component created

modelPath - Path to the Component XML definition file

Returns:

IFuture

startBPMNAgent

protected <any> startBPMNAgent(java.lang.String name,
                               java.lang.String modelPath)

Deprecated. Use startComponent for all Component types instead.

Starts a Component.

Parameters:

name - Name of the Component created

modelPath - Path to the Component XML definition file

Returns:

IFuture

startComponent

public <any> startComponent(java.lang.String name,
                            java.lang.String modelPath)

Description copied from interface: IJadexPlatformInterface

Start a new Component on a given platform.

Specified by:

startComponent in interface IJadexPlatformInterface

Parameters:

name - name of the newly created component

modelPath - Path to the model file of the new component

Returns:

ComponentIdentifier of the created component.

startComponent

public <any> startComponent(java.lang.String name,
                            java.lang.String modelPath,
                            CreationInfo creationInfo)

Description copied from interface: IJadexPlatformInterface

Start a new Component.

Specified by:

startComponent in interface IJadexPlatformInterface

Parameters:

name - name of the newly created component

modelPath - Path to the model file of the new component

creationInfo - CreationInfo to pass to the started Component.

Returns:

ComponentIdentifier of the created component.

startComponent

public <any> startComponent(java.lang.String name,
                            java.lang.Class<?> clazz,
                            CreationInfo creationInfo)

Description copied from interface: IJadexPlatformInterface

Start a new Component on a given platform.

Specified by:

startComponent in interface IJadexPlatformInterface

Parameters:

name - name of the newly created component

clazz - Class of the new component

creationInfo - CreationInfo to pass to the started Component.

Returns:

ComponentIdentifier of the created component.

startComponent

public <any> startComponent(java.lang.String name,
                            java.lang.Class<?> clazz)

Description copied from interface: IJadexPlatformInterface

Start a new Component on a given platform with default CreationInfo.

Specified by:

startComponent in interface IJadexPlatformInterface

Parameters:

name - name of the newly created component

Returns:

ComponentIdentifier of the created component.

registerEventReceiver

public void registerEventReceiver(IEventReceiver<?> rec)

Description copied from interface: IJadexPlatformInterface

Register an event receiver.

Specified by:

registerEventReceiver in interface IJadexPlatformInterface

unregisterEventReceiver

public boolean unregisterEventReceiver(IEventReceiver<?> rec)

Description copied from interface: IJadexPlatformInterface

Unregister an event receiver.

Specified by:

unregisterEventReceiver in interface IJadexPlatformInterface

Returns:

true if, the given receiver was registered before removal.

dispatchEvent

public boolean dispatchEvent(IJadexAndroidEvent event)
                      throws WrongEventClassError

Description copied from interface: IJadexPlatformInterface

Dispatch an event.

Specified by:

dispatchEvent in interface IJadexPlatformInterface

Returns:

true, if an receiver was found for this event.

Throws:

WrongEventClassError

sendMessage

protected <any> sendMessage(java.util.Map<java.lang.String,java.lang.Object> message,
                            IComponentIdentifier receiver)

Sends a FIPA Message to the specified receiver. The Sender is automatically set to the Platform.

Parameters:

message -

receiver -

Returns:

Future

sendMessage

protected <any> sendMessage(java.util.Map<java.lang.String,java.lang.Object> message,
                            MessageType type,
                            IComponentIdentifier receiver)

Sends a Message to a Component on the Jadex Platform.

Parameters:

message -

type -

Returns:

Future

getMS

protected <any> getMS()

Deprecated. use getPlatformService().getSservice() instead.

Returns:

getCMS

protected <any> getCMS()

Deprecated. use getPlatformService().getSservice() instead.

Returns:

onServiceConnected

public void onServiceConnected(android.content.ComponentName name,
                               android.os.IBinder service)

Specified by:

onServiceConnected in interface android.content.ServiceConnection

onServiceDisconnected

public void onServiceDisconnected(android.content.ComponentName name)

Specified by:

onServiceDisconnected in interface android.content.ServiceConnection

onPlatformStarting

protected void onPlatformStarting()

Called right before the platform startup.

onPlatformStarted

protected void onPlatformStarted(IExternalAccess result)

Called right after the platform is started.

Parameters:

result - The external access to the platform

startPlatform

protected final void startPlatform()

Starts the Jadex Platform. To set Parameters, use setPlatformKernels(), setPlatformOptions() or setPlatformName() before calling this Method. Will be automatically called when setPlatformAutostart(true) was called in the Constructor. The Lifecycle methods onPlatformStarting() and onPlatformStarted() will be executed during Startup.

stopPlatforms

protected void stopPlatforms()

Deprecated. use shutdownJadexPlatforms() instead.

Stops all running jadex platforms.

shutdownJadexPlatform

public void shutdownJadexPlatform()

Description copied from interface: IJadexPlatformInterface

Terminates the running jadex platform with the given ID.

Specified by:

shutdownJadexPlatform in interface IJadexPlatformInterface

shutdownJadexPlatform

public void shutdownJadexPlatform(IComponentIdentifier platformID)