GuardedObject (Java 2 Platform SE v1.4.1_"07")

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

JavaTM 2 Platform
Std. Ed. v1.4.1_"07"

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## java.security
Class GuardedObject

    java.lang.Object
      |
      +--java.security.GuardedObject

All Implemented Interfaces:
  Serializable

public class GuardedObject
extends Object
implements Serializable

A GuardedObject is an object that is used to protect access to another object.

A GuardedObject encapsulates a target object and a Guard object, such that access to the target object is possible only if the Guard object allows it. Once an object is encapsulated by a GuardedObject, access to that object is controlled by the `getObject` method, which invokes the `checkGuard` method on the Guard object that is guarding access. If access is not allowed, an exception is thrown.

See Also:
  `Guard`, `Permission`, Serialized Form

Constructor Summary
`GuardedObject(Object object, Guard guard)` Constructs a GuardedObject using the specified object and guard.

Method Summary
`Object` | `getObject()` Retrieves the guarded object, or throws an exception if access to the guarded object is denied by the guard.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### GuardedObject

    public GuardedObject(Object object,
                         Guard guard)

  Constructs a GuardedObject using the specified object and guard. If the Guard object is null, then no restrictions will be placed on who can access the object.

Parameters:
  `object` - the object to be guarded.
  `guard` - the Guard object that guards access to the object.

Method Detail

### getObject

    public Object getObject()
                     throws SecurityException

  Retrieves the guarded object, or throws an exception if access to the guarded object is denied by the guard.

  Returns:
    the guarded object.
  Throws:
    `SecurityException` - if access to the guarded object is denied.

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

JavaTM 2 Platform
Std. Ed. v1.4.1_"07"

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.