★ wanayoo — archive 1999 http://java.sun.com/products/embeddedjava/spec/1.0/eJavaSpec.htmlNouvelle recherche | Portail wanayoo

EmbeddedJavaTM API Specification

Version 1.0

See also: EmbeddedJava 1.0 Technical Overview


Sun Microsystems, Inc Sun Microsystems, Inc.

Copyright 1998 Sun Microsystems, Inc.
901 San Antonio Road, Palo Alto, CA 94303 USA

All rights reserved.

Sun Microsystems, Inc. (SUN) hereby grants to you at no charge a nonexclusive, nontransferable, worldwide, limited license (without the right to sublicense) under SUN's intellectual property rights that are essential to practice the EmbeddedJava Specification ("Specification") to use the Specification for internal evaluation purposes only. Other than this limited license, you acquire no right, title, or interest in or to the Specification and you shall have no right to use the Specification for productive or commercial use.

RESTRICTED RIGHTS LEGEND

Use, duplication, or disclosure by the U.S. Government is subject to restrictions of FAR 52.227-14(g)(2)(6/87) and FAR 52.227-19(6/87), or DFAR 252.227-7015(b)(6/95) and DFAR 227.7202-1(a).

This software and documentation is the confidential and proprietary information of Sun Microsystems, Inc. ("Confidential Information"). You shall not disclose such Confidential Information and shall use it only in accordance with the terms of the license agreement you entered into with Sun.

TRADEMARKS

Sun, the Sun logo, Sun Microsystems, JavaSoft, JavaBeans, JDK, Java, HotJava, HotJava Views, Visual Java, Solaris, NEO, Joe, Netra, NFS, ONC, ONC+, OpenWindows, PC-NFS, EmbeddedJava, PersonalJava, SNM, SunNet Manager, Solaris sunburst design, Solstice, SunCore, SolarNet, SunWeb, Sun Workstation, The Network Is The Computer, ToolTalk, Ultra, Ultracomputing, Ultraserver, Where The Network Is Going, Sun WorkShop, XView, Java WorkShop, the Java Coffee Cup logo, and Visual Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.


THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THIS DOCUMENT OR ITS DERIVATIVES.

THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THE DOCUMENT. SUN MICROSYSTEMS, INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.


Please submit any comments to the following email address:

embeddedjava-comments@java.sun.com

By submission of comments to Sun, you grant to Sun the right to incorporate such comments in whole or in part into the document royalty-free and without restriction.

Due to the tremendous interest in the EmbeddedJava platform, Sun may not be able to respond to each submission received on the embeddedjava-comments@java.sun.com alias.

For further information on Intellectual Property matters, contact Sun's Legal Department:


Table of Contents

Introduction

The EmbeddedJava TM API is derived from the JDK 1.1 API. The EmbeddedJava platform addresses the software needs of dedicated-purpose embedded devices.

Relation to JDK 1.1 API

This document describes the facilities that the EmbeddedJava platform provides to applications. It is not a standalone specification because it is based on the JDK 1.1 API. Java APIs introduced after JDK 1.1 will not automatically become a part of the EmbeddedJava API. New Java APIs will be reviewed and evaluated for appropriateness before being added to the EmbeddedJava platform.

Definitions

EmbeddedJava Platform Modifications

The EmbeddedJava API is derived from the JDK 1.1 API. The following definitions describe the degree of API support provided by the EmbeddedJava platform.

Configurable
All of the package's methods and fields are available to an EmbeddedJava application. Java Filter determines the list of methods and fields that are required by the EmbeddedJava application. The EmbeddedJava development environment then builds an EmbeddedJava application environment that supports the specific needs of the EmbeddedJava application.

Unsupported
The feature is not supported by the EmbeddedJava platform. None of the classes, methods or fields from the package may be made available to an EmbeddedJava application.

Java Standard Extensions

The EmbeddedJava platform supports Java standard extensions that are based on JDK 1.1. Java standard extensions have package names that begin with javax. Java standard extensions that are supported by the EmbeddedJava platform are configurable.

Additional Reading

EmbeddedJava API

The table below describes the EmbeddedJava API by listing the packages available in the JDK 1.1 API and indicating how the EmbeddedJava platform supports each package.

PackageSupport
java.appletunsupported
java.awtconfigurable
java.awt.datatransferconfigurable
java.awt.eventconfigurable
java.awt.imageconfigurable
java.awt.peerconfigurable
java.beansconfigurable
java.ioconfigurable
java.langconfigurable
java.lang.reflectconfigurable
java.mathconfigurable
java.netconfigurable
java.rmiconfigurable
java.rmi.dgcconfigurable
java.rmi.registryconfigurable
java.rmi.serverconfigurable
java.securityconfigurable
java.security.aclconfigurable
java.security.interfacesconfigurable
java.sqlconfigurable
java.textconfigurable
java.text.resourcesconfigurable
java.utilconfigurable
java.util.zipconfigurable

Implementation Requirements

RTOS Requirements

The EmbeddedJava platform has a few minimum requirements of the underlying RTOS:

Java Native Interface (JNI)

The EmbeddedJava platform uses the Java Native Interface for supporting native methods.