oracle.dss.bicontext
Interface Acl

All Known Subinterfaces:

AclObject

public interface Acl

Methods required for an access control list for a BIContext. You use the methods in this interface to find information about the users of the associated BIContext and information about the privileges that those users have. You also use the methods in this interface to add and remove users for accessing the associated BIContext with a specific privilege.

To get access to the Acl for a BIContext, call the getAcl method of the BIContext.

See Also:

User, Privilege

Method Summary

boolean	addEntries(java.util.Vector entries, boolean cascade) Adds a Vector of entries to this Acl.
java.util.Vector	entries() Retrieves the Vector of entries in this Acl.
Privilege	getPrivilege() Retrieves the privilege that the caller has, either as a user or as a member of a group.
boolean	removeEntries(java.util.Vector entries, boolean cascade) Removes a Vector of entries from this Acl.

Method Detail

addEntries

public boolean addEntries(java.util.Vector entries,
                          boolean cascade)
                   throws javax.naming.NamingException

Adds a Vector of entries to this Acl. Invalid entries and entries that have invalid user or privileges are ignored.

Parameters:

entries - The entries to add to this Acl.

cascade - true to have this Acl apply to all of the subfolders of folder from which this Acl was obtained, false to have this Acl apply only to the folder from which it was obtained.

Returns:

true if entries are successfully added to this Acl, false if all of the entries in entries are invalid.

Throws:

javax.naming.NamingException - If there is a naming problem. For example, this method might throw a NamingException if the caller does not have sufficient privilege to add entries to this Acl.

removeEntries

public boolean removeEntries(java.util.Vector entries,
                             boolean cascade)
                      throws javax.naming.NamingException

Removes a Vector of entries from this Acl. Invalid entries and entries that have invalid user or privileges are ignored.

Parameters:

entries - The entries to remove to this Acl.

cascade - true to have this Acl apply to all of the subfolders of folder from which this Acl was obtained, false to have this Acl apply only to the folder from which it was obtained.

Returns:

true if entries are successfully removed from this Acl, false if all of the entries in entries are invalid.

Throws:

javax.naming.NamingException - If there is a naming problem. For example, this method might throw a NamingException if the caller does not have sufficient privilege to remove entries from this Acl.

entries

public java.util.Vector entries()
                         throws javax.naming.NamingException

Retrieves the Vector of entries in this Acl.

Returns:

A Vector of entries in this Acl.

Throws:

javax.naming.NamingException - If there is a naming problem. For example, this method might throw a NamingException if the caller does not have sufficient privilege to list entries of this Acl.

getPrivilege

public Privilege getPrivilege()
                       throws javax.naming.NamingException

Retrieves the privilege that the caller has, either as a user or as a member of a group. For example, you might have only read access assigned in your entry as an individual user. But, as a member of a DBA group, you might have full control. This method returns that you have full control.

Returns:

The highest privilege of the caller, either as a user or as a member of a group.