Eclipse Equinox 3.6.0

Release Date
Deliverables

The release deliverables have the same form as previous releases, namely:

  • Source code release for all Equinox Project deliverables, available as versions tagged "R3_6" in the Equinox Project CVS repository.
  • Framework:
    • An OSGi R4.2 Core Framework implementation
    • Native launcher and splash screen support
  • Compendium Services:
    • Application Container - An implementation of the OSGi R4.2 MEG Application Container service.
    • Config Admin - An implementation of the OSGi R4.2 Configuration Admin service.
    • Device Access Service - An implementation of the OSGi R4.2 Device Access service.
    • Declarative Services - An implementation of the OSGi R4.2 Declarative Services specification.
    • Event Admin Service - An implementation of the OSGi R4.2 Event Admin Service.
    • HTTP Service - An implementation of the OSGi R4.2 HTTP service.
    • HTTP Servlet - Generic support for exposing another servlet facility (e.g., an underlying application server) as an OSGi HTTP service.
    • IO Connector Service - An implementation of the OSGi R4.2 IO Connector Service.
    • Initial Provisioning - An implementation of the OSGi R4.2 Initial Provisioning.
    • Log Service - An implementation of the OSGi R4.2 Log service.
    • Metatype Service - An implementation of the OSGi R4.2 Metatype service.
    • Preferences Service - The Eclipse preference service is an extension of the standard OSGi preference service that adds listeners and the notion of preference scopes.
    • User Admin Service - An implementation of the OSGi R4.2 User Admin Service.
    • Wire Admin Service - An implementation of the OSGi R4.2 Wire Admin Service.
  • p2
    • Command line application to mirror repositories.
    • Command line application to manage (install / uninstall / update) an eclipse install.
    • UI to manage an eclipse installation from within eclipse.
    • API to programmatically interact with p2.
  • Component model
    • Eclipse Extension Registry - The Eclipse extension registry allows bundles to communicate and cooperate using declarative markup and lazy instantiation.
    • Equinox Transforms - A framework to provide transformations of bundle resources.
  • Security
    • Equinox Secure Storage
    • Certificate Trust Engine - API for to managing trusted certificates
  • Server Side
    • HTTP Registry - Support for registering servlets, resources and JSPs via the Eclipse extension registry rather than using the code based OSGi registration mechanisms.
    • JSP Registry - Provides a JSP Factory that allows JSP usage with the HTTP Registry.
    • Servlet Bridge - Low level hook servlet installed in an existing traditional application server. This servlet launches an embedded Equinox and enables it to handle incoming HTTP requests originally sent to the underlying server.
    • HTTP Jetty - A thin layer that exposes an embedded Jetty server as a compliant OSGi HTTP service.
  • Weaving
    • Equinox Weaving - Support for weaving aspects at runtime.
Compatibility

Compatibility of Release 3.6 with 3.5

Equinox 3.6 will be compatible with Equinox 3.5 (and all earlier 3.x versions).

API Contract Compatibility: Equinox 3.6 will be upwards contract-compatible with Equinox 3.5 except in those areas noted in the Eclipse 3.6 Plug-in Migration Guide. Programs that use affected APIs and extension points will need to be ported to Equinox 3.6 APIs. Downward contract compatibility is not supported. There is no guarantee that compliance with Equinox 3.6 APIs would ensure compliance with Equinox 3.5 APIs. Refer to Evolving Java-based APIs for a discussion of the kinds of API changes that maintain contract compatibility.

Binary (plug-in) Compatibility: Equinox 3.6 will be upwards binary-compatible with Equinox 3.5 except in those areas noted in the Eclipse 3.6 Plug-in Migration Guide. Downward plug-in compatibility is not supported. Plug-ins for Equinox 3.6 will not be usable in Equinox 3.5. Refer to Evolving Java-based APIs for a discussion of the kinds of API changes that maintain binary compatibility.

Source Compatibility: Equinox 3.6 will be upwards source-compatible with Equinox 3.5 except in the areas noted in the Eclipse 3.6 Plug-in Migration Guide. This means that source files written to use Equinox 3.5 APIs might successfully compile and run against Equinox 3.6 APIs, although this is not guaranteed. Downward source compatibility is not supported. If source files use new Equinox APIs, they will not be usable with an earlier version of Equinox.

Workspace Compatibility: Equinox 3.6 will be upwards workspace-compatible with earlier 3.x versions of the Equinox unless noted. This means that workspaces created with Equinox 3.5 .. 3.0 can be successfully opened by Equinox 3.6 and upgraded to a 3.6 workspace. This includes both hidden metadata, which is localized to a particular workspace, as well as metadata files found within a workspace project (e.g., the .project file), which may propagate between workspaces via file copying or team repositories. Individual plug-ins developed for Eclipse SDK 3.6 should provide similar upwards compatibility for their hidden and visible workspace metadata created by earlier versions; 3.6 plug-in developers are responsible for ensuring that their plug-ins recognize metadata from earlier versions and process it appropriately. User interface session state may be discarded when a workspace is upgraded. Downward workspace compatibility is not supported. A workspace created (or opened) by a product based on Eclipse 3.6 will be unusable with a product based on an earlier version of Eclipse. Visible metadata files created (or overwritten) by Eclipse 3.6 will generally be unusable with earlier versions of Eclipse.

Non-compliant usage of API's: All non-API methods and classes, and certainly everything in a package with "internal" in its name or exported with the x-internal directive, are considered implementation details which may vary between operating environment and are subject to change without notice. Client plug-ins that directly depend on anything other than what is specified in the Equinox API are inherently unsupportable and receive no guarantees about compatibility within a single release much less with earlier releases. Refer to How to Use the Eclipse API for information about how to write compliant plug-ins.

Internationalization

The Equinox SDK is designed as the basis for internationalized products. The user interface elements provided by the Equinox components, including dialogs and error messages, are externalized. The English strings are provided as the default resource bundles.

Latin-1 and DBCS locales are supported by the Equinox on all reference platforms; BIDI locales are supported by the Equinox everywhere but on Motif.

The Equinox supports GB 18030 (level 1), the Chinese code page standard, on Windows XP and 2000, Linux/GTK and the Macintosh.

German and Japanese locales are tested.

Target Environments

In order to remain current, each Equinox Project release targets reasonably current operating environments.

Most of Equinox is "pure" Java code and has no direct dependence on the underlying operating system. The chief dependence is therefore on the Java Platform itself. Portions are targeted to specific classes of operating environments, requiring their source code to only reference facilities available in particular class libraries (e.g. J2ME Foundation 1.0, J2SE 1.3 and 1.4, etc.).

In general, the 3.6 release of the Equinox Project is developed on a mix of Java 1.4, Java 5 and Java 6 VMs. As such, the Equinox SDK as a whole is targeted at all modern, desktop Java VMs. Full functionality is available for 1.4 level development everywhere, and extended development capabilities are made available on the VMs that support them.

Appendix 1 contains a table that indicates the class library level required for each bundle.

There are many different implementations of the Java Platform running atop a variety of operating systems. We focus our testing on a handful of popular combinations of operating system and Java Platform; these are our reference platforms. Equinox undoubtedly runs fine in many operating environments beyond the reference platforms we test. However, since we do not systematically test them we cannot vouch for them. Problems encountered when running Equinox on a non-reference platform that cannot be recreated on any reference platform will be given lower priority than problems with running Equinox on a reference platform.

Equinox 3.6 is tested and validated on the following reference platforms (this list is updated over the course of the release cycle):

table.platforms { border-width: 1px; border-spacing: 0px; border-style: solid; border-collapse: separate; } table.platforms th { border-width: 1px; padding: 3px; border-style: inset; border-color: black; background-color: #B9A9FF; } table.platforms td { border-width: 1px 1px 1px 1px; padding: 3px 3px 3px 3px; border-style: inset inset inset inset; border-color: gray gray gray gray; } table.platforms tr.c0 td { background-color: #FDFDFD; } table.platforms tr.c1 td { background-color: #F4EEFF; } Operating SystemVersionHardwareJREWindowing SystemWindows 7x86 32-bitSun Java 5 Update 14

IBM Java 5 SR6b Win32x86 64-bitVistax86 32-bitSun Java 5 Update 14

IBM Java 5 SR6b

BEA JRockit 27.4.0 x86 64-bitSun Java 5 Update 14

IBM Java 5 SR6b XPx86 32-bitSun Java 6 Update 3

Sun Java 5 Update 14

Sun Java 1.4.2 Update 16

IBM Java 5 SR6b

IBM Java 1.4.2 SR10

BEA JRockit 27.4.0 x86 64-bitSun Java 5 Update 14

IBM Java 5 SR6b Red Hat Enterprise Linux5.0x86 32-bitSun Java 6 Update 3

Sun Java 5 Update 14

Sun Java 1.4.2 Update 16

IBM Java 5 SR6b

IBM Java 1.4.2 SR10

BEA JRockit 27.4.0 GTK Power 64-bitIBM Java 5 SR6b4.0x86 64-bitSun Java 5 Update 14

IBM Java 5 SR6b SUSE Linux Enterprise Server 11x86 32-bitSun Java 5 Update 14

IBM Java 5 SR6b GTKx86 64-bit Power 64-bitIBM Java 5 SR6b Ubuntu Long Term Support9.04x86 32-bitSun Java 5 Update 14

IBM Java 5 SR6b GTKx86 64-bitSun Solaris10x86 32-bitSun Java 5 Update 14GTKSPARCHP-UX11i v2ia64HP-UX Java 5 Update 7Motif 2.1IBM AIX5.3PowerIBM Java 5 SR6bMotif 2.1Apple Mac OS X10.5UniversalApple Java 10.5 Update 1CarbonUniversal 32-bitCocoaUniversal 64-bit

As stated above, we expect that Equinox works fine on other current Java VM and OS versions but we cannot flag these as reference platforms without significant community support for testing them.

Themes

Scalability and Performance

New usage scenarios for Equinox require it to be faster, smaller, bigger, ... The technology needs to scale up or down to allow Equinox to scale down to small embedded environments as well as scaling up to large server environments. Monitor overall performance and memory consumption which includes the addition of new performance tests for new features.

Robustness

As the basis for the entire Eclipse eco-system, Equinox must be robust, flexible and secure. This work will address those issues by providing API for missing or currently internal functionality, and focusing on the issues that affect the stability of the platform.

Consumability

This work will make it easier for users to get Equinox, install it on their systems, and configure it for their use. It also covers work related to error handling and reporting mechanisms.

Future

Eclipse is evolving quickly. New features in the next OSGi specification and e4 will drive numerous changes throughout the Equinox project. Considerable effort will be put into updating Equinox to accomodate and exploit these new scenarios.