Corona/Platform

From Eclipsepedia

Jump to: navigation, search

Contents

Corona Platform

Corona's server-side platform is an Eclipse runtime environment. It shares the same architecture used by the Eclipse rich client platform (RCP). The same concepts of bundles, plug-ins, and features are supported across both the client and server environments. The Corona server-side platform also supports the OSGi Application concept to manage the runtime lifecycle of a server component. The Corona server-side platform consists of three categories of components: Corona (core), Equinox/OSGi, Eclipse core runtime, and common 3rd party libraries.

CoronaPlatform medium.jpg

Corona (core)

Corona's core platform plugins provide the functionality to needed to host an Eclipse server-side environment. Corona supports the concept of Server Applications, OSGi Applications that provide server-side functionality.

The items provide by Corona's core are:

Application
An OSGi application used to start/stop the server-side enviornment
Managability
Management interfaces to monitor and control the environment (see COSMOS)
Diagnostics
A diagnostics framework used to collect data from the platform and its components to aid in problem analysis.

Equinox/OSGi

  • org.eclipse.equinox.app
  • org.eclipse.equinox.common
  • org.eclipse.equinox.device
  • org.eclipse.equinox.ds
  • org.eclipse.equinox.event
  • org.eclipse.equinox.http
  • org.eclipse.equinox.http.jetty
  • org.eclipse.equinox.http.registry
  • org.eclipse.equinox.http.servlet
  • org.eclipse.equinox.http.servletbridge
  • org.eclipse.equinox.jsp.jasper
  • org.eclipse.equinox.jsp.jasper.registry
  • org.eclipse.equinox.launcher
  • org.eclipse.equinox.launcher.carbon.macosx
  • org.eclipse.equinox.launcher.gtk.linux.ppc
  • org.eclipse.equinox.launcher.gtk.linux.x86
  • org.eclipse.equinox.launcher.gtk.linux.x86_64
  • org.eclipse.equinox.launcher.gtk.solaris.sparc
  • org.eclipse.equinox.launcher.motif.aix.ppc
  • org.eclipse.equinox.launcher.win32.win32.x86
  • org.eclipse.equinox.launcher.wpf.win32.x86
  • org.eclipse.equinox.log
  • org.eclipse.equinox.metatype
  • org.eclipse.equinox.preferences
  • org.eclipse.equinox.registry
  • org.eclipse.equinox.servletbridge
  • org.eclipse.equinox.useradmin
  • org.eclipse.equinox.util
Note
incubation bundles

Eclipse Core Runtime

  • org.eclipse.core.boot
  • org.eclipse.core.commands
  • org.eclipse.core.contenttype
  • org.eclipse.core.databinding
  • org.eclipse.core.databinding.beans
  • org.eclipse.core.expressions
  • org.eclipse.core.filebuffers
  • org.eclipse.core.filesystem
  • org.eclipse.core.filesystem.linux.ppc
  • org.eclipse.core.filesystem.linux.x86
  • org.eclipse.core.filesystem.linux.x86_64
  • org.eclipse.core.filesystem.macosx
  • org.eclipse.core.filesystem.solaris.sparc
  • org.eclipse.core.filesystem.win32.x86
  • org.eclipse.core.jobs
  • org.eclipse.core.net
  • org.eclipse.core.resources
  • org.eclipse.core.resources.compatibility
  • org.eclipse.core.resources.win32
  • org.eclipse.core.runtime
  • org.eclipse.core.runtime.compatibility
  • org.eclipse.core.runtime.compatibility.auth
  • org.eclipse.core.runtime.compatibility.registry
  • org.eclipse.core.variables
  • org.eclipse.jsch.core
  • org.eclipse.osgi
  • org.eclipse.osgi.services
  • org.eclipse.osgi.util
  • org.eclipse.text
  • org.eclipse.update.configurator
  • org.eclipse.update.core
  • org.eclipse.update.core.linux
  • org.eclipse.update.core.win32

3rd Party Libraries

  • com.ibm.icu
  • com.jcraft.jsch
  • javax.servlet
  • javax.servlet.jsp
  • org.apache.ant
  • org.apache.commons.el
  • org.apache.commons.logging
  • org.apache.jasper
  • org.apache.log4j
  • org.apache.lucene
  • org.apache.lucene.analysis
  • org.apache.xerces
  • org.apache.xml.resolver
  • org.mortbay.jetty

Applications

Beginning with Eclipse v3.3, a new application model was introduced.

The platform runtime provides an application container for controlling and executing applications. The runtime application container implements the Application Admin service specification included in the OSGi R4 specification. The application container is responsible for discovering all available applications and registering an ApplicationDescriptor OSGi service for each application that is available. An ApplicationDescriptor service can be used to launch an application. When an application is launched an ApplicationHandle OSGi service is registered to represent the instance of the running application. An ApplicationHandle service can be used to shutdown an application. See the org.osgi.service.application package and the OSGi R4.1 specification for more information.

Corona's server-side environment supports the execution of multiple applications. The primary application, Corona, runs on the main thread. Additional applications are considered secondary and must be configured to run on any thread. To create an application to run within the Corona server-side environment, create an extension to org.eclipse.core.runtime.application.

Server Application Model

Corona defines IServerApplication, that extends the org.eclipse.equinox.app.IApplication, for the server-side environment. In addition, a component server application should be based upon AbstractServerApplication. This base server application class provides functionality for handling application arguments as well as functionality for managing the applications threds.

Configuration

Corona needs to be configured to start secondary applications. This is accomplished by defining the osgi.applications property. This can be set either as a jvm argument (i.e. -Dosgi.applications=...), or in config.ini. The osgi.applications can be defined to start multiple applications.

Syntax

osgi.applications=<appId>[,arg1][,arg2][,arg3];<appId>[,arg1][,arg2][,arg3]
appId
The id of the osgi application
arg1
The application's 1st argument (optional)
arg2
The application's 2nd argument (optional)
arg3
The application's 3rd argument (optional)

Update Manager

Corona follows the Eclipse feature deployment model via Update Manager. It is possible to invoke the Eclipse Update Manager to install a feature into Corona's server-side environment. The Update Manager is started as a stand-alone OSGi application.

java -jar plugins/org.eclipse.equinox.launcher_"verion".jar -console -application org.eclipse.update.core.standaloneUpdate -command install -from "updateSite" -featureId "featureId" -version "featureVersion"