WebLogic Server 8.1 API Reference

weblogic.security.service
Class ServerResource

java.lang.Object
  |
  +--weblogic.security.service.ResourceBase
        |
        +--weblogic.security.service.ServerResource

public final class ServerResource

extends ResourceBase

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.

The toString format (which is produced by the ResourceBase class) for a Server resource is:
type=<svr>, application=, server=MyServer, action=shutdown

Author:

Copyright © 2002 BEA Systems, Inc. All Rights Reserved.

See Also:

Serialized Form

Fields inherited from class weblogic.security.service.ResourceBase

id, length, SCOPE_RESOURCE_ACTION, SCOPE_RESOURCE_ACTION_NAME, values

Constructor Summary

ServerResource(java.lang.String application, java.lang.String server, java.lang.String action)
Constructs a new ServerResource with a target name composed from the application, server, and action parameters.

Method Summary

java.lang.String	getActionName() Gets the name of the action being requested on the ServerResource.
java.lang.String	getApplicationName() Gets the name of the application associated with the ServerResource.
java.lang.String[]	getKeys() Gets keys for the ServerResource.
Resource	getParentResource() Gets a Resource object that represents the parent of the current ServerResource.
java.lang.String	getServerName() Gets the name of the ServerResource.
java.lang.String	getType() Gets the type of this resource (ServerResource).
void	initialize(java.lang.String application, java.lang.String server, java.lang.String action) Deprecated. As of 04/01/02, the constructor should be used instead.
java.lang.String	toString() Returns a string representation of the Server resource.

Methods inherited from class weblogic.security.service.ResourceBase

appendArrayValue, appendValue, equals, getFieldType, getID, getRepeatingFieldIndex, getRepeatingFieldTerminatingIndex, getValues, hashCode, init, init, reset

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ServerResource

public ServerResource(java.lang.String application,
                      java.lang.String server,
                      java.lang.String action)

Constructs a new ServerResource with a target name composed from the application, server, and action parameters.

Parameters:

application - a String indicating the name of the application in which the resource is deployed, as it appears in the corresponding <display-name> element. The <display-name> element is associated with an <application> element in the deployment descriptor, in an .ear file. A value of null indicates that the resource is not deployed as part of an application.

server - a String representing the name of the Server resource.

action - a String representing the name of the action being requested on the resource. A value of null indicates that the security policy for the resource pertains to all actions that match the other parameters of the resource specification, without consideration for the action name. Valid values for this parameter are restricted to the following:

• boot
• shutdown
• lock
• unlock

Method Detail

initialize

public void initialize(java.lang.String application,
                       java.lang.String server,
                       java.lang.String action)

Deprecated. As of 04/01/02, the constructor should be used instead.

Replaces application, server, and action parameters of the resource with the specified values.

Parameters:

application - a String indicating the name of the application in which the resource is deployed, as it appears in the corresponding <display-name> element. The <display-name> element is associated with an <application> element in the deployment descriptor, in an .ear file. A value of null indicates that the resource is not deployed as part of an application.

server - a String representing the name of the Server resource.

action - a String representing the name of the action being requested on the resource. A value of null indicates that the security policy for the resource pertains to all actions that match the other parameters of the resource specification, without consideration for the action name. Valid values for this parameter are restricted to the following:

• boot
• shutdown
• lock
• unlock

getType

public java.lang.String getType()

Gets the type of this resource (ServerResource).

Returns:

the type of this resource, represented as a String.

getParentResource

public Resource getParentResource()

Gets a Resource object that represents the parent of the current ServerResource. If the resource does not have a parent, the value of null must be returned.

The parentage hierarchy for the ServerResource is:

type=<svr>, application=, server=MyServer, action=
type=<svr>, application=, server=MyServer
type=<svr>, application=, action=shutdown
type=<svr>


The old deprecated parentage hierarchy for the ServerResource (with -Dweblogic.security.scopeResourceAction) is:

type=<svr>, application=, server=MyServer
type=<svr>

Returns:

the Resource object of the parent resource.

getKeys

public java.lang.String[] getKeys()

Gets keys for the ServerResource.

Returns:

an array of Strings containing the ServerResource's keys.

Overrides:

getKeys in class ResourceBase

getServerName

public java.lang.String getServerName()

Gets the name of the ServerResource.

Returns:

the name of the ServerResource, represented as a String.

getActionName

public java.lang.String getActionName()

Gets the name of the action being requested on the ServerResource.

Returns:

the name of the action being requested on the ServerResource, represented as a String.

getApplicationName

public java.lang.String getApplicationName()

Gets the name of the application associated with the ServerResource.

Returns:

the name of the application associated with the ServerResource, represented as a String.

toString

public java.lang.String toString()

Returns a string representation of the Server resource.

Each type of resource is first printed in angled brackets. Then, each key is printed, in order, along with it's value. The keys are comma-separated. Values that are lists are comma-separated and delineated by open and close curly braces. Each value is printed as is, except that commas (,), open braces ({), close braces (}), and back slashes (\) are each escaped with a backslash.

Note: Because this method produces a result based on the concatenation of strings, it may be expensive in terms of performance.

Returns:

the resource, represented as a String.

Overrides:

toString in class ResourceBase