Sun Logo


Optional APIs Porting Guide

Sun Javatrademark Wireless Client Software 2.0

Java Platform, Micro Edition

05-2007



Contents

Preface

1. Overview

2. Porting the Personal Information Management and File Connection Optional Package

Package Design

Porting Notes

Building JSR 75

Testing JSR 75

JavaCall Porting Layer

FileConnection

Personal Information Management

JavaCall API Implementation Notes

Memory Allocation

Special Storage Locations

Localized Storage Directory Names

Platform-specific Constants

Callback functions

JavaCall API Porting Steps

File Connection Implementation

PIM Implementation

3. Porting the Bluetooth Optional Package

Bluetooth Overview

Bluetooth Profiles

Bluetooth Functionality

Bluetooth Control Center

BluetoothStack Interface and the Bluetooth Control Center

Porting the BluetoothStack Interface

Assumptions About the Implementation

Implementation Requirements

procedure iconsmall spacePorting the Bluetooth Stack

Porting the BCC Interface

L2CAP Protocol and BTSPP Profile

BlueZ Library

Making Connections in L2CAP and BTSPP

procedure iconsmall spacePorting L2CAP and BTSPP

Porting the OBEX Interface

JavaCall Porting Layer

JavaCall API Bluetooth Variable Types and Values

Definition of JavaCall API Bluetooth Variable Types, Values and Functions

JavaCall API Bluetooth Function Groups

Memory Allocation

Porting steps

4. Location API

Introduction

Implementation Description

LandmarkStore Implementation

LocationProvider implementation

Atan2 Implementation

Location API Code Structure

Porting layer functionality

Native Porting Layer

Accessing Landmarks

Getting the Current Location

Acquisition of Terminal Orientation

Implementation Notes

Asynchronous Operation

Buffer Allocation

Mandatory LandmarkStore Functions

Optional LandmarkStore Functions

Mandatory LocationProvider Functions

Optional LocationProvider Functions

Optional Atan2 Function

Callback functions

Porting JSR 179

Implementing LocationProvider

Implementing LandmarkStore

Implementing atan2

JavaCall Porting Layer

Accessing Landmarks

Getting the Current Location

Acquisition of Terminal Orientation

Implementation Notes

Asynchronous Operation

Buffer Allocation

Mandatory LandmarkStore Functions

Optional LandmarkStore Functions

Mandatory LocationProvider Functions

Optional LocationProvider functions

Optional Atan2 Function

Callback Functions

Porting JSR 179

Implementing LocationProvider

Implementing LandmarkStore

Implementing atan2

5. Integrating the Scalable 2D Vector Graphics Optional Package

6. Mobile Internationalization API

Porting java_global

Porting with the JavaCall API

Glossary

Index