11 About Java ME Demo Applications

The Oracle Java ME SDK 8 includes demo applications that introduce you to the emulator's API features and the Oracle Java ME SDK 8 features, tools, and utilities that support the various APIs.

Note:

Before using the Oracle Java ME SDK 8 demo applications, carefully read Appendix B. Some demonstrations use network access and open ports, and do not include protection against malicious intrusion. If you run the demo projects, ensure that your environment is secure.

Demo applications are installed with the Java ME SDK plug-ins for NetBeans IDE and Eclipse IDE. Additional demo applications may become available through the update center. For more information about installing the plug-ins and the update center, see Chapter 2.

The following demos are available by default:

Calculator Sample: Calculates several arithmetic expressions concurrently. Demonstrates the following functionality: Multithreading, Service Loader.
Data Collection Demo: Reads data from peripheral devices using Device Access API (DAAPI) and processes it. Demonstrates the following functionality: MVM, Inter-IMlet communication using local datagrams, Device I/O pulse counter, Device I/O SPI, Logging API.
Data Forwarder Sample: Forwards text data received from a connected TCP client to a set of applications. Demonstrates the following functionality: MEEP IMC, MEEP Events, GCF Server Socket.
Directory Files Tree Sample: Prints the tree of files and directories. Demonstrates a part of CLDC NIO files functionality.
GPIO Demo: Changes the values of GPIO buttons. Demonstrates the General Purpose Input Output (GPIO) part of DAAPI.
I2C Demo: Acquires a slave device named I2C_Joystick, writes data to it, and retrieves it. Demonstrates the usage of interfaces and classes for Inter-Integrated Circuit Bus (I2C) part of DAAPI.
Light Track Demo: Flashes corresponding LEDs depending on the current value of the Analog-to-Digital (ADC) channel.
NetworkDemo: Demonstrates data exchange using socket connections.
Network Info Sample: Displays information about available network interfaces, access points, IP address and host reachability (ping). Demonstrates the following functionality: GCF Network Interfaces, GCF Access Points, GCF NetworkUtilities.
PDAPDemo: Demonstrates the usage of JSR 75: File Connection API.
System Controller Sample: Displays the state of other applications, enables you to run and stop them using a simple command-line interface, and does other application management tasks. Demonstrates the following functionality: MEEP Software Management (SWM), CLDC Logging, CLDC Timers, GCF Server Sockets, DIO GPIO Pins, DIO Watchdog, MEEP Power, Application autostart.
System Info Sample: Reads system properties and information about the amount of memory used by the JVM, displays details about installed and running applications. Demonstrates part of MEEP SWM functionality.
Temperature Collector Sample: Measures temperature periodically and stores results. When a remote client connects, it sends the average temperature to the client. Demonstrates the following functionality: MEEP PushRegistry Alarm, MEEP PushRegistry Push Notifications, MEEP Record Store Management (RMS), GCF Server Socket, CLDC system time.

Running Demo Applications

You can run the default demo applications from NetBeans IDE or Eclipse IDE by creating the corresponding project. Then you run the project to try out the features that the demo was created for.

To create a Java ME demo application project in NetBeans IDE:

Open the File menu and select New Project.
In the Categories list, expand Samples and select Java ME SDK 8.1.
Select the demo application from the Projects list and click Next.
Enter a name for the project or leave the default, change other settings as necessary, and click Finish.

To create a Java ME demo application project in Eclipse IDE:

Open the File menu, select New, and then Example.
In the New Example wizard, select Java ME Sample Applications and click Next.
Select the demo application from the list and click Finish.

Configuring the Web Browser and Proxy Settings

If you are behind a firewall, you can configure the demo applications to use proxy server settings that you define.

The demo application proxy server settings typically match the proxy server settings used in your web browser. To manually set the proxy server settings for your demo applications, do the following:

Open the Device Selector.
Select the platform name to view its properties.
Specify the HTTP Proxy Settings, HTTP Proxy Host, and HTTP Proxy Port fields to match your network and browser settings.

Troubleshooting

Sometimes a demo application does not run successfully. Often, the problem is your environment.

Some demonstrations require specific setup and instructions. For example, see "Configuring the Web Browser and Proxy Settings."
Because sample programs can be started remotely, virus checking software can sometimes prevent them from running. In the console, you see warnings that the emulator cannot connect.

Consider configuring your antivirus software to allow access to sample application directories and components.