ReleaseLockProxy Class Reference

#include <ReleaseLockProxy.h>

Inheritance diagram for ReleaseLockProxy:

Collaboration diagram for ReleaseLockProxy:

Instance Methods
(id)	- initWithObject:name:
(id)	- initWithRetainedObject:name:
(void)	- rlpAllowRelease
(NSString *)	- rlpObjectDescription
(void)	- dealloc [implementation]
(void)	- release [implementation]
(id)	- autorelease [implementation]
(void)	- forwardInvocation: [implementation]
(NSMethodSignature *)	- methodSignatureForSelector: [implementation]
(BOOL)	- respondsToSelector: [implementation]

Class Methods
(id)	+ proxyWithObject:name:
(id)	+ proxyWithRetainedObject:name:
(BOOL)	+ instancesRespondToSelector: [implementation]

Private Attributes
id< NSObject >	_object
NSString *	_name
BOOL	_locked

Detailed Description

Definition at line 15 of file ReleaseLockProxy.h.

Method Documentation

autorelease

- (id) autorelease

implementation

Definition at line 1 of file ReleaseLockProxy.m.

{
    VerboseLog(@"-- ReleaseLockProxy (%@): autoreleased while %slocked and retain count at %u.", [self rlpObjectDescription], _locked ? "" : "not ", [self retainCount]);
    return [super autorelease];
}

dealloc

- (void) dealloc

implementation

Definition at line 1 of file ReleaseLockProxy.m.

{
    if (_locked)
    {
        NSLog(@"** ReleaseLockProxy (%@): deallocated while locked. This shouldn't happen, unless -dealloc is being called directly.", [self rlpObjectDescription]);
    }
    else
    {
        VerboseLog(@"-- ReleaseLockProxy (%@): deallocated while not locked.", [self rlpObjectDescription]);
    }
    
    [_object release];
    [_name release];
    
    [super dealloc];
}

forwardInvocation:

- (void) forwardInvocation: (NSInvocation *) invocation

implementation

Definition at line 1 of file ReleaseLockProxy.m.

                         :(NSInvocation *)invocation
{
    [invocation invokeWithTarget:_object];
}

initWithObject:name:

- (id) initWithObject:		(id<NSObject>)	object
name:		(NSString *)	name

Definition at line 1 of file ReleaseLockProxy.m.

                    :(id<NSObject>)object name:(NSString *)name
{
    return [self initWithRetainedObject:[object retain] name:name];
}

initWithRetainedObject:name:

- (id) initWithRetainedObject:		(id<NSObject>)	object
name:		(NSString *)	name

Definition at line 1 of file ReleaseLockProxy.m.

                            :(id<NSObject>)object name:(NSString *)name
{
    if (object == nil)
    {
        NSLog(@"** ReleaseLockProxy: passed nil object, returning nil proxy.");
        [self release];
        return nil;
    }
    
    // No super init for proxies.
    
    _object = object;
    _name = [name copy];
    _locked = YES;
    
    return self;
}

instancesRespondToSelector:

+ (BOOL) instancesRespondToSelector: (SEL) selector

implementation

Definition at line 1 of file ReleaseLockProxy.m.

                                  :(SEL)selector
{
    if (selector == @selector(initWithObject:name:) ||
        selector == @selector(initWithRetainedObject:name:) || 
        selector == @selector(rlpAllowRelease) ||
        selector == @selector(rlpObjectDescription))
    {
        return YES;
    }
    else
    {
        return NO;
    }
}

methodSignatureForSelector:

- (NSMethodSignature *) methodSignatureForSelector: (SEL) selector

implementation

Definition at line 1 of file ReleaseLockProxy.m.

                                                 :(SEL)selector
{
    NSMethodSignature       *result = nil;
    
    if (selector == @selector(initWithObject:name:) ||
        selector == @selector(initWithRetainedObject:name:) || 
        selector == @selector(rlpAllowRelease) ||
        selector == @selector(rlpObjectDescription))
    {
        result = [ReleaseLockProxy_SignatureTemplateClass methodSignatureForSelector:selector];
    }
    else
    {
        result = [(id)_object methodSignatureForSelector:selector];
    }
    
    return result;
}

proxyWithObject:name:

+ (id) proxyWithObject:		(id<NSObject>)	object
name:		(NSString *)	name

Definition at line 1 of file ReleaseLockProxy.m.

                     :(id<NSObject>)object name:(NSString *)name
{
    return [[[self alloc] initWithObject:object name:name] autorelease];
}

proxyWithRetainedObject:name:

+ (id) proxyWithRetainedObject:		(id<NSObject>)	object
name:		(NSString *)	name

Definition at line 1 of file ReleaseLockProxy.m.

                             :(id<NSObject>)object name:(NSString *)name
{
    return [[[self alloc] initWithRetainedObject:object name:name] autorelease];
}

release

- (void) release

implementation

Definition at line 1 of file ReleaseLockProxy.m.

{
    unsigned retainCount = [self retainCount];
    
    if (_locked && retainCount == 1)
    {
        // Breakpoint here to catch what would otherwise be the last release before crashing.
        NSLog(@"** ReleaseLockProxy (%@): released while locked and retain count is one - intercepting retain. Something is broken.", [self rlpObjectDescription]);
        return;
    }
    
    if (_locked)
    {
        VerboseLog(@"-- ReleaseLockProxy (%@): released while locked, but retain count > 1; retain count going from %u to %u.", [self rlpObjectDescription], retainCount, retainCount - 1);
    }
    else
    {
        VerboseLog(@"-- ReleaseLockProxy (%@): released while not locked; retain count going from %u to %u.", [self rlpObjectDescription], retainCount, retainCount - 1);
    }
    
    [super release];
}

respondsToSelector:

- (BOOL) respondsToSelector: (SEL) selector

implementation

Definition at line 1 of file ReleaseLockProxy.m.

                          :(SEL)selector
{
    return [ReleaseLockProxy instancesRespondToSelector:selector];
}

rlpAllowRelease

- (void) rlpAllowRelease

Definition at line 1 of file ReleaseLockProxy.m.

{
    _locked = NO;
}

rlpObjectDescription

- (NSString *) rlpObjectDescription

Definition at line 1 of file ReleaseLockProxy.m.

{
    return _name ? _name : [_object description];
}

Member Data Documentation

_locked

- (BOOL) _locked

private

Definition at line 20 of file ReleaseLockProxy.h.

_name

- (NSString*) _name

private

Definition at line 19 of file ReleaseLockProxy.h.

_object

- (id<NSObject>) _object

private

Definition at line 18 of file ReleaseLockProxy.h.

---

The documentation for this class was generated from the following files:

• src/Core/ReleaseLockProxy.h
• src/Core/ReleaseLockProxy.m