Skip to main content
Jump to: navigation, search

Orion/Documentation/Developer Guide/Core client services

< Orion‎ | Documentation‎ | Developer Guide
Revision as of 13:51, 14 June 2011 by John (Talk | contribs) (orion.core.file)

Overview of core client services

Orion provides a number of basic infrastructure services that can be used by client scripts for performing various tasks. These services have no user interface component and can be used within any page of a client application. This section of the guide outlines what services are available, along with simple examples of how to use them.


The orion.core.favorite service is used to access and store the user's bookmarks or favorites. While a user may opt to use their own browser's bookmark mechanism instead, there are some specific advantages to using Orion's favorite service instead:

  • Favorites are persisted on the server, so the user can switch to another client computer or browser and access their familiar bookmarks
  • Favorites are associated with a specific Orion application and user, so favorites from different users or applications are not all mixed into a single place.

Here is an example usage of the favorites service:

serviceRegistry.getService("orion.core.favorite").then(function(service) {


The orion.core.file service is used to contribute some custom content to the Orion Navigator/Explorer. Content could be in the form of files served from some remote system. The Orion navigator already displays any content created by the application user. These include any folder, file or files within a folder.

  • A developer who creates an Orion plugin will use this service to contribute some custom content to the Navigator.

The code snippet below demonstrates an use of this service:

provider.registerServiceProvider("orion.core.file", service, {Name: 'Test Project'});

The above code will contribute a top level node to the Navigator named "Test Project". The parameter "service" in the API above must provide the functions specified by the Orion file client API. Refer to [/help/topic/org.eclipse.orion.doc.isv/jsdoc/symbols/orion.fileClient.FileClient.html orion.fileClient.FileClient] for more API details. For more information on client-server interaction, see Orion File Server API




Back to the top