E ADF Mobile Sample Applications

This appendix describes the ADF Mobile sample applications.

E.1 Overview of the ADF Mobile Sample Applications

ADF Mobile ships with a set of a sample applications that provide different development scenarios, such as creating the basic artifacts, accessing such device-native features as SMS and e-mail, or performing CRUD (Create, Read, Update, and Delete) operations on a local SQLite database. These applications are in the PublicSamples.zip file at the following location within the JDeveloper installation directory of your development computer:

jdev_install/jdeveloper/jdev/extensions/oracle.adf.mobile/Samples

To view these applications, extract the PublicSamples.zip file to your JDeveloper working directory (typically, this is User Home Directory/jdeveloper/mywork).

Note:

Sample applications that include a default springboard must be extracted to, and opened from, the Samples directory. The adfmf-application.xml file for these applications must also be updated, as described in Section 5.4.1, "How to Configure Application Navigation," to ensure that the springboard is added to the classpath.

To enable sample applications that use the default springboard run properly:

  1. Open the application from the Samples directory.

  2. In the Applications page of the overview editor for the adfmf-application.xml file, change the springboard option from Default to None.

  3. Choose Default as the springboard option.

  4. Click Save All.

  5. Deploy the application.

These applications, which are described in Table E-1, are complete. Except where noted otherwise, these applications can be deployed to a simulator after you configure the development environment as described in Chapter 3, "Setting Up the ADF Mobile Environment."

Tip:

To get an idea of how to create an ADF Mobile application, review these applications in the order set forth in Table E-1.

Table E-1 ADF Mobile Sample Applications

Recommended Order of Use Application Name Description Additional Resources Required to Run the Sample Application

1

HelloWorld

The "hello world" application for ADF Mobile, which demonstrates the basic structure of the framework. This basic application has a single application feature that is implemented with a local HTML file. Use this application to ascertain that the development environment is set up correctly to compile and deploy an application. See also Section 4.2.2, "What Happens When You Create an ADF Mobile Application."

  

2

CompGallery

This application serves as an introduction to the ADF Mobile AMX UI components by demonstrating all of these components. Using this application, you can change the attributes of these components and see the effects of those changes in real time without recompiling and redeploying the application after each change. See generally Chapter 8, "Creating ADF Mobile AMX User Interface."

  

3

LayoutDemo

This application demonstrates the user interface layout and shows how to create the various list and button styles that are commonly used in mobile applications. It also demonstrates how to create the action sheet style of a popup component and how to use various chart and gauge components. See Section 8.3, "Creating and Using UI Components" and Section 8.5, "Providing Data Visualization."

This application must be opened from the Samples directory. The Default springboard option must be cleared in the Applications page of the adfmf-application.xml overview editor, then selected again.

4

JavaDemo

This application demonstrates how to bind the user interface to Java beans. It also demonstrates how to invoke EL bindings from the Java layer using the supplied utility classes. See also Section 8.10, "Using Event Listeners" and Section 9.2, "Understanding EL Support."

  

5

Navigation

This application demonstrates the various navigation techniques in ADF Mobile, including bounded task flows and routers. It also demonstrates the various page transitions. See also Section 7.2, "Creating Task Flows."

This application must be opened from the Samples directory. The Default springboard option must be cleared in the Applications page of the adfmf-application.xml overview editor, then selected again.

6

LifecycleEvents

This application implements lifecycle event handlers on the ADF Mobile application itself and its embedded application features. This application shows you where to insert code to enable the applications to perform their own logic at certain points in the lifecycle. See also Section 5.6, "About Lifecycle Event Listeners."

For iOS, the LifecycleEvents sample application logs data to the Console application, located at Applications-Utilities-Console application.

7

DeviceDemo

This application shows you how to use the DeviceFeatures data control to expose such device features as geolocation, e-mail, SMS, and contacts, as well as how to query the device for its properties. See also Section 9.5, "Using the DeviceFeatures Data Control."

You must also run this application on an actual device, because SMS and some of the device properties do not function on an iOS simulator or Android emulator.

8

GestureDemo

This application demonstrates how gestures can be implemented and used in ADF Mobile applications. See also Section 8.4, "Enabling Gestures."

  

9

StockTracker

This application demonstrates how data change events use Java to enable data changes to be reflected in the user interface. It also has a variety of layout use cases, gestures and basic mobile patterns. See also Section 9.7, "Data Change Events."

  

10

HR

This human resources application is a CRUD application that demonstrates a variety of real-world application techniques. It uses a local SQLite database to store its data. The application persists the data between each startup and is based on the default HR schema that ships with all Oracle databases. See generally Chapter 11, "Using the Local Database."

By providing layouts for both iPad and iPhone, this application demonstrates how different types of user interfaces can share the same data model. There are a variety of other patterns demonstrated in the application as well.

  

11

Skinning

This application demonstrates how to skin applications and add a unique look and feel by either overriding the supplied style sheets or extending them with their own style sheets. This application also shows how skins control the styling of ADF Mobile AMX UI components based on the type of device. See also Section 5.11, "Skinning ADF Mobile Applications."

  

12

PrefDemo

This application demonstrates application-wide and application feature-specific user setting pages. See generally Chapter 13, "Enabling User Preferences"