BEA Systems, Inc.

WebLogic Server 8.1 API Reference

Package weblogic.security.service

This package includes interfaces, classes, and exceptions that support security providers.

See:
          Description

Interface Summary
ContextHandler The ContextHandler interface provides a way for an internal Weblogic container to pass additional information to a WebLogic Security Framework call, so that a security provider can obtain additional context information beyond what is provided by the arguments to a particular method.
SecurityRole The SecurityRole interface represents the abstract notion of a security role.
 

Class Summary
AdminResource The AdminResource class is used by a container to specify the Administrative resource (and method related to the resource) that a caller is attempting to access.
ApplicationResource The ApplicationResource class is used by a container to specify the Application resource (and method related to the resource) for which a security policy is being defined, or that a caller is attempting to access.
COMResource The COMResource class is used by a container to specify a class type that can be exported from the COM runtime.
ContextElement A ContextElement is an object used to represent a named value that is used in a ContextHandler.
EISResource The EISResource class is used by a container to specify the EIS resource (and method related to the resource) that a caller is attempting to access.
EJBResource The EJBResource class is used by a container to specify the EJB resource (and method related to the resource) that a caller is attempting to access.
JDBCResource The JDBCResource class is used by a container to specify the JDBC resource (and method related to the resource) that a caller is attempting to access.
JMSResource The JMSResource class is used by a container to specify the JMS resource (and method related to the resource) that a caller is attempting to access.
JNDIResource The JNDIResource class is used by a container to specify the JMS resource (and method related to the resource) that a caller is attempting to access.
RealmAdapterAclResource Deprecated. This class can be ignored.
RemoteResource  
ResourceBase The ResourceBase class is an abstract base class for all the specific resource types and facilitates the model for the extending resources.
ServerResource The ServerResource class is used by a container to specify the Server resource (and method related to the resource) that a caller is attempting to access.
URLResource The URLResource class is used by a container to specify the URL resource (and method related to the resource) that a caller is attempting to access.
WebResource Deprecated. The WebResource class is used by a container to specify the Web resource (and method related to the resource) that a caller is attempting to access.
WebServiceResource The WebServiceResource class is used by a container to specify the Web Service resource (and method related to the resource) that a caller is attempting to access.
 

Exception Summary
InvalidParameterException The InvalidParameterException exception is thrown if invalid parameters are passed to the WebLogic Security Framework (that is, if a method expects some input parameters and does not receive what it expects).
MBeanException The MBeanException exception is a general exception that is thrown if there are any problems with the MBeans required by the WebLogic Security Framework.
NotYetInitializedException The NotYetInitializedException exception is thrown if an attempt is made to access an uninitialized security service provided by the WebLogic Security Framework.
ProviderDecisionException The ProviderDecisionException exception is thrown by an Access Decision if it encounters a problem during execution.
ProviderException The ProviderException exception is a generic exception that is thrown if the WebLogic Security Framework detects any problem with a security provider.
ResourceCreationException The ResourceCreationException exception is thrown if a security provider encounters a problem while creating a resource.
ResourceNotFoundException The ResourceNotFoundException exception is thrown if a security provider looks for a resource that should exist, but is unable to find that resource.
ResourceRemovalException The ResourceRemovalException exception is thrown if a security provider is unable to remove a resource.
RoleCreationException A RoleCreationException exception is thrown if a Role Mapping provider has a problem creating a role.
RoleNotFoundException The RoleNotFoundException exception is thrown if a Role Mapping provider looks for a particular role that should exist, but is unable to find that role.
RoleRemovalException The RoleRemovalException exception is thrown if a Role Mapping provider is unable to remove a role.
SecurityServiceException The SecurityServiceException exception is the base exception implemented by some of the WebLogic Security Framework exceptions (that is, any exception from the weblogic.security.services package that wrappers an exception with the same name from the weblogic.security.spi package).
SecurityServiceRuntimeException The SecurityServiceRuntimeException exception is the base exception implemented by some of the WebLogic Security Framework exceptions (that is, any exception that is unique to the weblogic.security.services package).
 

Package weblogic.security.service Description

This package includes interfaces, classes, and exceptions that support security providers. These interfaces, classes, and exceptions should be used in conjunction with those in the weblogic.security.spi package.

The *Resource classes are resource descriptions that specify what WebLogic Server resource is being accessed during a security operation. There are different resource classes for different types of resources. For example, there is a URL resource (weblogic.security.service.URLResource) and an EJB resource (weblogic.security.service.EJBResource). Several of the security service provider interfaces (SSPIs), including weblogic.security.spi.RoleMapper and weblogic.security.spi.AccessDecision, require resource descriptions to provide security services.

The exception classes should be used by security providers to signal various errors that may occur. For example, the MBean exception (weblogic.security.service.MBeanException) can be thrown when an error is found in a security provider's associated MBean. Many of these exceptions have equivalents in the weblogic.security.spi package. When exceptions exist in both packages, security providers should use the version in the weblogic.security.spi package.

Author:
Copyright © 2004 BEA Systems, Inc. All Rights Reserved.
See Also:
weblogic.security.spi, Developing Security Providers for WebLogic Server

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