A script enabled browser is required for this page to function properly.
Exit Print View

Oracle® Java Micro Edition Embedded Client Reference Guide, Version 1.0

Get PDF Book Print View
 

Document Information

Preface

Part I  Developer Guide

1.  Introduction

2.  Execution

2.1 Components

2.2 Execution and Supported Runtime Parameters

2.3 Mouse Restrictions

2.3.1 Input Mechanisms

2.3.1.1 Standard Keyboard Support

2.3.2 Mouse Support

3.  Developing Applications

Part II  Java Virtual Machine Reference

4.  Java Virtual Machine Capabilities

5.  Internal Memory Allocator

6.  Threading

7.  Internationalization

8.  External PBP Porting Layer Plugin

Part III  Working Without An IDE

A.  Legacy Tools

Index

Chapter 2

Execution

Oracle Java Micro Edition Embedded Client is the foundation for software product development for many embedded client platforms. The client stack can be ported to other platforms on request. The client software can be modified or extended to provide the appropriate platform for Java applications or middleware. Applications and middleware can be designed and implemented by partners or third parties catering to end-user needs.

2.1 Components

This section identifies the typical binary components of the Oracle Java ME Embedded Client. This reflects how the stack has been installed in various devices.

The Linux/x86 bundle (software development kit) contains prebuilt virtual machine binaries and classes for target devices as follows:

/docs
  /cdc-1_1_2-mrel-spec-jdoc
  /fp-1_1_2-mrel-spec-jdoc
  /j2me_rmiop-1_0-fr-spec
  /j2me_web_services-1_0-fr-spec-jdoc
  /jdbc_cdc-1_0-fr-doc
  /pbp-1_1_2-mrel-spec-jdoc
/emulator-platform
  /bin
    emulator
  btclasses.zip
  /lib 
    /profiler
      /lib 
    /security
    /ext
    /fonts
      /zi
        /America
        /Asia
/legal 

2.2 Execution and Supported Runtime Parameters

The supported runtime parameters can be considered separately for the virtual machine and CDC and the supported profile.

To print the version, use the -version command option. The output is similar to the following:

Product: Oracle Java Micro Edition Embedded Client-1.0 
(built on Profile: CDC 1.1.2 (JSR218)
- FP 1.1.2 (JSR219) (SecOp 1.0)
- PBP 1.1.2 (JSR217)
- (RMI JSR66)
- (JDBC JSR169)
- (WebServices JSR172)- (Specification 1.1.2)
- Toolkit: DirectFB (1.2)
JVM:     CVM rev (mixed mode)

2.3 Mouse Restrictions

A Personal Basis Profile implementation can also optionally provide partial support for a pointing device. The Personal Basis Profile specification states:

“If the property java.awt.MouseEvent.isRestricted is true, then the property java.awt.event.MouseEvent.supportLevel reports the level of mouse events generated by the implementation.” The following table describes the mouse events generated by the implementation based on the support level.

Level of Mouse Events Generated by the Implementation
Support Level
Mouse Events Generated
0
No mouse events generated
1
MOUSE_CLICKED, MOUSE_PRESSED, MOUSE_RELEASED, MOUSE_ENTERED, MOUSE_EXITED
2
All the events of level 1, plus MOUSE_MOVED

2.3.1 Input Mechanisms

The following sections describe the various input mechanisms: standard keyboard, events outside the PBP specification, and mouse support.

2.3.1.1 Standard Keyboard Support

Developers can query the particular key events supported, by querying the following runtime properties:

java.awt.event.KeyEvent.isRestricted

and

java.awt.event.KeyEvent.supportMask

Typical values are:

java.awt.event.KeyEvent.isRestricted =true
java.awt.event.KeyEvent.supportMask=0x07

Hence the Oracle Java ME Embedded Client supports the following subset of key events that match typical remote control input capabilities:

VK_LEFT and VK_RIGHT
VK_UP and VK_DOWN
VK_0 through VK_9
VK_ENTER

2.3.2 Mouse Support

Developers can determine the particular mouse events supported, by querying the following runtime properties:

java.awt.MouseEvent.isRestricted

and

java.awt.event.MouseEvent.supportLevel

Typical values are:

java.awt.MouseEvent.isRestricted=true
java.awt.event.MouseEvent.supportLevel=0

The last value indicates that Oracle Java ME Embedded Client supports no mouse events.

ing HTML r