Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Orion/Documentation/Developer Guide/Core client services"

m
Line 16: Line 16:
 
= orion.core.file =
 
= orion.core.file =
  
The <tt>orion.core.file</tt> service can be 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.
+
The <tt>orion.core.file</tt> 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.
 
* A developer who creates an Orion plugin will use this service to contribute some custom content to the Navigator.
  

Revision as of 15:33, 12 June 2011

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.

orion.core.favorite

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) {
  service.makeFavorites(item);
});

orion.core.file

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 could be an implementation of FileService. Also see FileClientAPI for more details on the method summary. For more information on client-server interaction, see Orion File Server API

orion.core.marker

orion.core.preference

orion.core.user

Back to the top