Service Management Framework
Release 3.1

com.ibm.osg.smf.platform
Interface PermissionStorage


public interface PermissionStorage

Permission Storage interface for managing a persistent storage of bundle permissions.

This class is used to provide methods to manage persistent storage of bundle permissions. The PermissionStorage object is returned by the Platform object and is called by SMF to persistently store bundle permissions.

The permission data will typically take the form of encoded PermissionInfo Strings. See org.osgi.service.permissionadmin.PermissionInfo.

For example

      PermissionStorage storage = platform.getPermissionStorage();
      try {
          storage.setPermissionData(location, permissions);
      } catch (IOException e) {
          // Take some error action.
      }
 


Method Summary
 java.lang.String[] getLocations()
          Returns the locations that have permission data assigned to them, that is, locations for which permission data exists in persistent storage.
 java.lang.String[] getPermissionData(java.lang.String location)
          Gets the permission data assigned to the specified location.
 void setPermissionData(java.lang.String location, java.lang.String[] data)
          Assigns the specified permission data to the specified location.
 

Method Detail

getLocations

public java.lang.String[] getLocations()
                                throws java.io.IOException
Returns the locations that have permission data assigned to them, that is, locations for which permission data exists in persistent storage.
Returns:
The locations that have permission data in persistent storage, or null if there is no permission data in persistent storage.
Throws:
java.io.IOException - If a failure occurs accessing peristent storage.

getPermissionData

public java.lang.String[] getPermissionData(java.lang.String location)
                                     throws java.io.IOException
Gets the permission data assigned to the specified location.
Parameters:
location - The location whose permission data is to be returned. The location can be null for the default permission data.
Returns:
The permission data assigned to the specified location, or null if that location has not been assigned any permission data.
Throws:
java.io.IOException - If a failure occurs accessing peristent storage.

setPermissionData

public void setPermissionData(java.lang.String location,
                              java.lang.String[] data)
                       throws java.io.IOException
Assigns the specified permission data to the specified location.
Parameters:
location - The location that will be assigned the permissions. The location can be null for the default permission data.
data - The permission data to be assigned, or null if the specified location is to be removed from persistent storaqe.
Throws:
java.io.IOException - If a failure occurs modifying peristent storage.

Service Management Framework
Release 3.1

Licensed Materials - Property of IBM. (C) Copyright IBM Corp. 2000, 2002 All Rights Reserved. IBM is a registered trademark of IBM Corp.