OSGi™ Service Platform
Compendium Specification

Release 4 Version 4.3

org.osgi.service.prefs
Interface PreferencesService


public interface PreferencesService

The Preferences Service.

Each bundle using this service has its own set of preference trees: one for system preferences, and one for each user.

A PreferencesService object is specific to the bundle which obtained it from the service registry. If a bundle wishes to allow another bundle to access its preferences, it should pass its PreferencesService object to that bundle.

Consumers of this API must not implement this interface

Method Summary
 Preferences getSystemPreferences()
          Returns the root system node for the calling bundle.
 Preferences getUserPreferences(java.lang.String name)
          Returns the root node for the specified user and the calling bundle.
 java.lang.String[] getUsers()
          Returns the names of users for which node trees exist.
 

Method Detail

getSystemPreferences

Preferences getSystemPreferences()
Returns the root system node for the calling bundle.

Returns:
The root system node for the calling bundle.

getUserPreferences

Preferences getUserPreferences(java.lang.String name)
Returns the root node for the specified user and the calling bundle.

Parameters:
name - The user for which to return the preference root node.
Returns:
The root node for the specified user and the calling bundle.

getUsers

java.lang.String[] getUsers()
Returns the names of users for which node trees exist.

Returns:
The names of users for which node trees exist.

OSGi™ Service Platform
Compendium Specification

Release 4 Version 4.3

Copyright © OSGi Alliance (2000, 2012). All Rights Reserved. Licensed under the OSGi Specification License, Version 2.0