BEA Systems, Inc.

WebLogic Server 8.1 API Reference

weblogic.security.acl
Interface BasicRealm

All Known Subinterfaces:
DynamicUserAcl, ListableRealm, ManageableRealm

Deprecated. Deprecated in WebLogic Server 7.0. Replaced by Pluggable Security Infrastructure.

public interface BasicRealm

BasicRealm provides a minimal interface for realms. Different implementations of the security-related interfaces User, Group, Permission, and Acl are organized into Realms. BasicRealm is extended by ListableRealm and ManageableRealm, which add the ability to list all instances managed by the realm and the ability to create and destroy instances.

Author:
Copyright © 2004 BEA Systems, Inc. All Rights Reserved.
See Also:
User, GroupImpl, PermissionImpl, AclImpl

Method Summary
 java.security.acl.Acl getAcl(java.lang.String name)
          Deprecated. Retrieves an Access Control List (Acl) of that name, or null.
 java.security.acl.Acl getAcl(java.lang.String name, char separator)
          Deprecated. Retrieves an Access Control List (Acl) with the best matching name, or null.
 java.security.Principal getAclOwner(java.lang.Object credential)
          Deprecated. Retrieves the owner of all ACLs in a BasicRealm, or null, depending on the validity of the passed credential.
 java.security.acl.Group getGroup(java.lang.String name)
          Deprecated. Retrieves a group of that name or null.
 java.lang.String getName()
          Deprecated. Gets the name of a BasicRealm.
 java.security.acl.Permission getPermission(java.lang.String name)
          Deprecated. Retrieves a permission object of that name or, if null is passed in, returns null.
 User getUser(java.lang.String name)
          Deprecated. Retrieves a User by the specified name, or null.
 User getUser(UserInfo userInfo)
          Deprecated. Checks whether some User matches the presented UserInfo and accepts its credentials.
 void init(java.lang.String name, java.lang.Object ownerCredential)
          Deprecated. Initializes a realm implementation.
 void load(java.lang.String name, java.lang.Object credential)
          Deprecated. Loads a BasicRealm from some persistent state identified in the name.
 void save(java.lang.String name)
          Deprecated. Saves the realm to some persistent state identified in the name.
 

Method Detail

init

public void init(java.lang.String name,
                 java.lang.Object ownerCredential)
          throws java.security.acl.NotOwnerException
Deprecated. 
Initializes a realm implementation. Throws NotOwnerException on reinitialization if the owner credential is invalid.

Parameters:
name - Name of Realm
ownerCredential - Credentialed owner of a BasicRealm
Throws:
java.security.acl.NotOwnerException - if the owner credential is invalid

getName

public java.lang.String getName()
Deprecated. 
Gets the name of a BasicRealm.

Returns:
Name

getUser

public User getUser(java.lang.String name)
Deprecated. 
Retrieves a User by the specified name, or null.

Parameters:
User - name
Returns:
User object

getUser

public User getUser(UserInfo userInfo)
Deprecated. 
Checks whether some User matches the presented UserInfo and accepts its credentials. Typically, the UserInfo must be created from a RealmProxy for this realm.

Parameters:
userInfo - Credentials to check against
Returns:
Authenticated User or null

getAclOwner

public java.security.Principal getAclOwner(java.lang.Object credential)
Deprecated. 
Retrieves the owner of all ACLs in a BasicRealm, or null, depending on the validity of the passed credential.

Parameters:
credential - Credentials of an owner
Returns:
Principal that is a BasicRealm owner

getGroup

public java.security.acl.Group getGroup(java.lang.String name)
Deprecated. 
Retrieves a group of that name or null.

Parameters:
name - Name of group
Returns:
Group that matches name

getAcl

public java.security.acl.Acl getAcl(java.lang.String name)
Deprecated. 
Retrieves an Access Control List (Acl) of that name, or null.

Parameters:
name - Name of ACL associated with a BasicRealm
Returns:
Acl object

getAcl

public java.security.acl.Acl getAcl(java.lang.String name,
                                    char separator)
Deprecated. 
Retrieves an Access Control List (Acl) with the best matching name, or null. A name matches if it is a prefix. The longer the prefix, the better the match. The only prefixes considered are up to, but excluding the separator character. For example: getAcl("/files/personal/bill", '.') looks for Acls named files.personal.bill, files.personal, and files and returns the one with the longest name.

Parameters:
name - Name of the Acl to retrieve
separator - Character separator
Returns:
Acl object

getPermission

public java.security.acl.Permission getPermission(java.lang.String name)
Deprecated. 
Retrieves a permission object of that name or, if null is passed in, returns null. If the named permission does not exist, then it will be created and put in the list of permissions. If you pass in null, null will be returned.

Parameters:
name - Name of permission to retrieve
Returns:
Permission object

load

public void load(java.lang.String name,
                 java.lang.Object credential)
          throws java.lang.ClassNotFoundException,
                 java.io.IOException,
                 java.security.acl.NotOwnerException
Deprecated. 
Loads a BasicRealm from some persistent state identified in the name. Different implementations differ in how they are stored persistently and how they interpret the name.

Parameters:
name - Name of BasicRealm to load
credential - Credentialed owner of a BasicRealm
Throws:
java.lang.ClassNotFoundException - if the BasicRealm cannot be found
java.io.IOException - if there is an I/O error
java.security.acl.NotOwnerException - if the credential does not match an owner

save

public void save(java.lang.String name)
          throws java.io.IOException
Deprecated. 
Saves the realm to some persistent state identified in the name. Different implementations differ in how they are stored persistently and how they interpret the name.

Parameters:
name - Name to save under
Throws:
java.io.IOException - if there is an I/O error

Documentation is available at
http://download.oracle.com/docs/cd/E13222_01/wls/docs81