ADF Mobile Configuration Service Usage


ADF Mobile Configuration Service provides a mechanism for ADF Mobile Apps to update the end-points after they have been deployed to devices. This service allows any end-points configured in connections.xml to be updated on the server and have the deployed Apps uptake the changes without having to go through the normal App update process. All the end-points configured in the connections.xml like Web Service WSDL URI, REST Service URI, LoginServer URI, Remote URL etc can be updated using the Configuration Service.  


1. Test to Production : When Apps are built they are configured to use dev/test end-points used by the developers for testing during development. Typically these end points are configured by administrators to point to production instances as part of application provisioning. Using Configuration Service allows mobile application administrators to configure the end-points a part of App provisioning.
2. Updating Configuration for Apps in production : In certain cases one may need to change the end points used by an App after deployment to a production environment due to maintenance or some other reason. Configuration Service  & checkForNewConfiguration() API can be used for the configuration changes to be propagated to the mobile apps in production.

Configuration Uptake Flow

First time App start up:

1. When Configuration Service is enabled in an ADF Mobile App, the user is prompted with a dialog to provide the credentials and URI for the Configuration Service. A default URL is populated for the Config Service URL field based on the seeded URL entry in adf-config.xml. User can change this to any end-point provided by the administrator

Config Service Login

2. After the user enters the credentials and submits the FWK downloads connections.xml from the Configuration Service and restarts the App with the new configuration.

3. During the Application restart the FWK checks for the presence of the downloaded connections.xml and continues with the normal startup flow.

Configuration updates after deployment:  

Developers can use oracle.adfmf.framework.api.AdfmfContainerUtilities.checkForNewConfiguration() API to check if the connections.xml on Configuration Service has changed and if so, download a new version of the connections.xml file from the server. If a new version of the file is downloaded, the application is restarted with the new configuration. Developers can either invoke the API through some UI as shown in the attached sample app or do the check automatically as part of Application or Feature Lifecycle listeners at a certain event point in the App lifecycle.    

Enabling Configuration Service

Configuration Service can be enabled using the  following configuration in adf-config.xml. This file is in <App root>/.adf/META-INF folder 

<adf:adf-properties-child xmlns="">
     <!-- Enable Configuration Service Check at Startup--> 
     <adf-property name="use-configuration-service-at-startup" value="true"/>
     <!-- Seeded Configuration Service URL -->
     <adf-property name="adfmf-configuration-service-seed-url" value=""/>

Server Side Configuration Service Setup

Configuration Service can be implemented as a WebDav service or as a Service that accepts HTTP GET and returns connections.xml. The URL used by the Config Service Client is of the following format : <URL Configured in adf-config.xml>/<application bundle id>/connections.xml. The Config Service end-point can be secured using Basic-Auth or Basic-Auth over SSL.

Sample Details

The provided sample application has :
1. ADF MF App (ConfigServiceTest): This App has two features ; 1. remote URL feature pointing to 2. Config feature with a page to check for config changes on the server. The App is configured to check for configuration during initial start-up. The URL used by the remote URL feature is configured in connections.xml. This URL can be changed in the Configuration Service App to point to say, for ex: and the mobile app can pick up this change using Config feature. 
2. J2EE app(ConfigService) that contains connections.xml at HTML root/<application bundle id> . This App does not have to be a J2EE App. In fact, it can be any endpoint that accepts HTTP GET and returns connections.xml using the specified URL format. 

Steps to try the sample:

1. Deploy the ADF Mobile App to a simulator or device.
2. Deploy the WAR file to a WLS instance(tested with integrated WLS shipped with JDev

3. Start the mobile App. Enter the Config Service URL from step2 in the Config Service dialog displayed during the app startup as shown below. Make sure you change the host and port to point to the WLS instance used in step2.

Config Service Login

4. The App will download the connections.xml from Config Service and restart.

5. When the App restarts Search feature will display google search page 

Config Service Login

6. Change the remote URL in connections.xml in the Config Service App to Make sure the changed end point is visible in the connections.xml by accessing the file from a browser
7. In the mobile app, access the Config feature and click on the "Check For Config Changes" button to detect the config change and download the new connections.xml.

8. The App will restart after downloading the new configuration. This time the search feature will display the bing search page.  

Config Service Login

This approach can be used to change any end points used by the app like WSDL URI, REST Service URI, Login Server URI etc.


Hi Srini,
Is the authentication a must for the configuration service? Can we use simple HTTP GET service without authentication like a public folder in DropBox?


Posted by guest on January 08, 2013 at 11:54 AM PST #

Yes, you can. Authentication is not a must for Configuration service.

Posted by guest on January 10, 2013 at 10:51 PM PST #

I have two questions:
(1)Since Authentication is optional, is there a way to hide the Username and Password fields on the Configuration popup widget? If yes, how can I do this?

(2) Is it possible to write a custom Configuration popup widget? If yes, how can I do this?

Posted by guest on April 30, 2013 at 01:41 PM PDT #

This is the new service came into the mobile this is the nice feature of the mobile.

Posted by guest on June 18, 2013 at 10:41 PM PDT #

is the user credentials passed onto the remote url?

Posted by guest on July 03, 2013 at 11:15 PM PDT #

What is the username, password on startup?

Posted by guest on August 12, 2013 at 03:15 AM PDT #

Hi , now i try to deploy this example in my local
but i can't manage to update the "connection.xml" from remote site,
when mobile application is run pop up come out to keyin user name password and url i don't use basic authentication and i put my local url using "localhost", '' , '' but not successfully got return , just keep pop up screen to enter user name, password, url, after 5 time application auto shutdown,
so anyone help me for that

Posted by guest on August 18, 2013 at 08:55 PM PDT #

Hi Srini -
I ran in to the same issue that others reported - an ADF Mobile app will not retrieve connections.xml from an unsecured ConfigService using the standard Configuration popup. I was having the same issue as the August 18 commenter until I added basic authentication to the ConfigService, at which point I was able to connect. So, to repeat the questions from the commenter on April 30 of last year, is there a way to suppress the username and password fields in the popup or write a custom prompt? I've been searching for a guide to get started on that but haven't found anything.

Posted by guest on May 08, 2014 at 02:29 PM PDT #

There is no mechanism to hide the username & passwd fields from the ConfigService pop-up. It appears that there seems to be regression in recent patches of ADF Mobile that is preventing access to config service end points that are not secured. Please report a bug and we will try to get this addressed in a patch.

Posted by Srini on May 08, 2014 at 02:43 PM PDT #

Entered bug 18733041. Thanks.

Posted by Keath on May 09, 2014 at 07:33 AM PDT #

I Did Everything and its working fine. But i Am not able to Zoom the webpage. Is there any option?

Posted by Bharat G. Vekariya on November 06, 2014 at 01:50 AM PST #

Post a Comment:
  • HTML Syntax: NOT allowed

This blog is is dedicated to announcements,tips and tricks and other items related to developing, integrating, securing, and managing mobile applications using Oracle's Mobile Platform. It is created and maintained by the Oracle Mobile product development team.

Archive of past entries

Even More Mobile Development Blogs

Oracle A-Team Site - Mobile Related Entries

Code samples from the Community

Fusion Middleware Blogs


« June 2016