The Oracle Mobile A-TEAM is happy to announce a new (and slightly renamed) version of the A-Team Mobile Persistence Accelerator (AMPA). AMPA is a lightweight persistence and data synchronization framework that works on top of Oracle Mobile Application Framework (MAF). It eases the consumption of RESTful services, and provides a complete persistence layer that allows you to use the mobile application in offline mode. You can read and write data while not connected to the internet, and synchronize any pending data changes later when you are online again. The design-time wizards that are integrated with JDeveloper enable you to build a fully functional mobile application within minutes.
This new version is hosted on GitHub and is available as an open source framework. This article explains how to install the accelerator and how to get up and running.
These instructions assume you already installed JDeveloper 12.1.3 with the Oracle MAF 2.1 extension.
While the screen shots show older AMPA build numbers for MAF 2.0, these instructions have been updated for AMPA release 188.8.131.52.x that is compliant with MAF 2.1.
Go to the AMPA GitHub Home Page and click on the Download ZIP button to download the source code to your computer.
Unzip the zip file to a directory of your choice and start JDeveloper 12.1.3.
In JDeveloper choose File -> Open and select file MobilePersistenceAccelerator.jws, located under \mobile-persistence-master\Projects\Framework.
Click on the Runtime project node in the application navigator. In the JDeveloper menu bar, choose Build -> Run Ant on Runtime.jpr.
Click on the DesignTime project node in the application navigator. In the JDeveloper menu bar, choose Build -> Run Ant on DesignTime.jpr.
In about 10-20 seconds the installation zip file ateam-mobile-persistence.184.108.40.206.xx-install.zip is created in directory \mobile-persistence-master\Projects\Framework\stage.
We are now ready to install the accelerator as JDeveloper extension.
In the JDeveloper menu bar, choose Help -> Check for Updates. In the Check for Updates dialog that appears, select the radio button Install from Local File.
Use the Browse.. button to select the install zip file ateam-mobile-persistence.220.127.116.11.xx-install.zip you just created. Click Next and then Finish and click Yes in the Confirm Exit dialog to restart JDeveloper.
After JDeveloper has restarted the A-Team Mobile Accelerator read-me file should appear and you are ready to go!
If the Read Me file does not display, then try to restart JDeveloper again. You can also check the version you installed by going to the Help -> About menu and then click on Extensions.
The best way to get started is to do the tutorial, read the articles we published earlier, and to study and run the sample application, and to view the presentation and videos that show the overall development process. In the near future, we will add comprehensive documentation to the GitHub wiki pages.
The tutorial Consuming REST web services with A-Team Mobile Persistence Accelerator for Oracle MAF takes you through all the basic steps. It teaches you how to install the extension, how to build a JSON-REST service, and how to build a MAF application using AMPA that consumes this REST service.
The videos below are still based on the previous version that worked with ADF Mobile, but the overall development process is pretty much the same.
You can also take a look at this presentation which includes some more screenshots to illustrate the development process.
We have created a simple CRUD demo application based on the tables from HR schema.For employees and departments we consume Restful services and for regions, cpountries and locations we use a SOAP-based service. The demo MAF application is generated with the User Interface Generator that comes with AMPA and has not been modified afterwards. In other words, the demo is meant to showcase the functionality of AMPA, the user interface is not very fancy. Here are the demo files:
First, we need to make clear that AMPA is an open source framework, so its not covered under Oracle Support Policy. Based on that the code is provided as is and allows you to extend and use it under the Open Source License Agreement.
You can raise your issues or ask questions at the Oracle MAF discussion forum, A-Team is closely following this forum.