OSGi™ Service Platform
Release 4 Version 4.1

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.


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

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

Returns:
The root system node for the calling bundle.

getUserPreferences

public 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

public 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
Release 4 Version 4.1

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