Server-side API changes in V8.0.0

For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.

Server-side API changes in V8.0.0

To migrate the server side of your MobileFirst application, take into account the changes to the APIs.

The following tables list the discontinued server-side API elements in V8.0.0, deprecated server-side API elements in V8.0.0, and suggested migration paths. For more information about migrating the server side of your application, see Migrating existing adapters to work under MobileFirst Server V8.0.0 and Migrating to push notifications from event source-based notifications.
Table 1. JavaScript API elements discontinued in V8.0.0
Category API Element Replacement path
Security WL.Server.getActiveUser Use MFP.Server.getAuthenticatedUser instead.
WL.Server.getCurrentUserIdentity
WL.Server.getCurrentDeviceIdentity
WL.Server.setActiveUser
WL.Server.getClientId
WL.Server.getClientDeviceContext
WL.Server.setApplicationContext
Event source WL.Server.createEventSource To migrate from Event source-based notifications to tag-based notifications, see Migrating to push notifications from event source-based notifications.
WL.Server.setEventHandlers
WL.Server.createEventHandler
WL.Server.createSMSEventHandler To send SMS messages, use the push service REST API. For more information, see Sending SMS notifications.
WL.Server.createUSSDEventHandler Integrate USSD by using third-party services.
Push WL.Server.getUserNotificationSubscription To migrate from Event source-based notifications to tag-based notifications, see Migrating to push notifications from event source-based notifications.
WL.Server.notifyAllDevices
WL.Server.sendMessage
WL.Server.notifyDevice
WL.Server.notifyDeviceSubscription
WL.Server.notifyAll
WL.Server.createDefaultNotification
WL.Server.submitNotification
WL.Server.subscribeSMS Use the REST API Push Device Registration (POST) to register the device. To send and receive SMS notifications, provide the phoneNumber in the payload while invoking the API.
WL.Server.unsubscribeSMS Use the REST API Push Device Registration (DELETE) to unregister the device.
WL.Server.getSMSSubscription Use the REST API Push Device Registration GET) to get the device registrations.
Location services WL.Geo.* Integrate Location services by using third-party services.
WS-Security WL.Server.signSoapMessage Use the WS-Security capabilities of WebSphere® Application Server.

Table 2. Java API elements discontinued in V8.0.0
Category API Element Replacement path
Security SecurityAPI.getSecurityContext Use AdapterSecurityContext instead.
Push PushAPI.sendMessage(INotification notification, String applicationId) To migrate from Event source-based notifications to tag-based notifications, see Migrating to push notifications from event source-based notifications.
INotification PushAPI.buildNotification(); To migrate from Event source-based notifications to tag-based notifications, see Migrating to push notifications from event source-based notifications.
UserSubscription PushAPI.getUserSubscription(String eventSource, String userId) To migrate from Event source-based notifications to tag-based notifications, see Migrating to push notifications from event source-based notifications.

Table 3. Java API elements deprecated in V8.0.0
Category Deprecation Replacement path
Java AdaptersAPI interface in the com.worklight.adapters.rest.api package Use the AdaptersAPI interface in the com.ibm.mfp.adapter.api package instead.
AnalyticsAPI interface in the com.worklight.adapters.rest.api package Use the AnalyticsAPI interface in the com.ibm.mfp.adapter.api package instead.
ConfigurationAPI interface in the com.worklight.adapters.rest.api package Use the ConfigurationAPI interface in the com.ibm.mfp.adapter.api package instead.
OAuthSecurity annotation in the com.worklight.core.auth package Use the OAuthSecurity annotation in the com.ibm.mfp.adapter.api package instead.
MFPJAXRSApplication class in the com.worklight.wink.extensions package Use the MFPJAXRSApplication class in the com.ibm.mfp.adapter.api package instead.
WLServerAPI interface in the com.worklight.adapters.rest.api package Use the JAX-RS Context annotation to access the MobileFirst API interfaces directly.
WLServerAPIProvider class in the com.worklight.adapters.rest.api package Use the JAX-RS Context annotation to access the MobileFirst API interfaces directly.

Parent topic: Migrating apps from earlier releases


Category	API Element	Replacement path
Security	WL.Server.getActiveUser	Use MFP.Server.getAuthenticatedUser instead.
WL.Server.getCurrentUserIdentity
WL.Server.getCurrentDeviceIdentity
WL.Server.setActiveUser
WL.Server.getClientId
WL.Server.getClientDeviceContext
WL.Server.setApplicationContext
Event source	WL.Server.createEventSource	To migrate from Event source-based notifications to tag-based notifications, see Migrating to push notifications from event source-based notifications.
WL.Server.setEventHandlers
WL.Server.createEventHandler
WL.Server.createSMSEventHandler	To send SMS messages, use the push service REST API. For more information, see Sending SMS notifications.
WL.Server.createUSSDEventHandler	Integrate USSD by using third-party services.
Push	WL.Server.getUserNotificationSubscription	To migrate from Event source-based notifications to tag-based notifications, see Migrating to push notifications from event source-based notifications.
WL.Server.notifyAllDevices
WL.Server.sendMessage
WL.Server.notifyDevice
WL.Server.notifyDeviceSubscription
WL.Server.notifyAll
WL.Server.createDefaultNotification
WL.Server.submitNotification
WL.Server.subscribeSMS	Use the REST API Push Device Registration (POST) to register the device. To send and receive SMS notifications, provide the phoneNumber in the payload while invoking the API.
WL.Server.unsubscribeSMS	Use the REST API Push Device Registration (DELETE) to unregister the device.
WL.Server.getSMSSubscription	Use the REST API Push Device Registration GET) to get the device registrations.
Location services	WL.Geo.*	Integrate Location services by using third-party services.
WS-Security	WL.Server.signSoapMessage	Use the WS-Security capabilities of WebSphere® Application Server.


Category	Deprecation	Replacement path
Java	AdaptersAPI interface in the com.worklight.adapters.rest.api package	Use the AdaptersAPI interface in the com.ibm.mfp.adapter.api package instead.
AnalyticsAPI interface in the com.worklight.adapters.rest.api package	Use the AnalyticsAPI interface in the com.ibm.mfp.adapter.api package instead.
ConfigurationAPI interface in the com.worklight.adapters.rest.api package	Use the ConfigurationAPI interface in the com.ibm.mfp.adapter.api package instead.
OAuthSecurity annotation in the com.worklight.core.auth package	Use the OAuthSecurity annotation in the com.ibm.mfp.adapter.api package instead.
MFPJAXRSApplication class in the com.worklight.wink.extensions package	Use the MFPJAXRSApplication class in the com.ibm.mfp.adapter.api package instead.
WLServerAPI interface in the com.worklight.adapters.rest.api package	Use the JAX-RS Context annotation to access the MobileFirst API interfaces directly.
WLServerAPIProvider class in the com.worklight.adapters.rest.api package	Use the JAX-RS Context annotation to access the MobileFirst API interfaces directly.