OOCache Class Reference

#include <OOCache.h>

Inheritance diagram for OOCache:

Collaboration diagram for OOCache:

Instance Methods
(id)	- init
(id)	- initWithPList:
(id)	- pListRepresentation
(id)	- objectForKey:
(void)	- setObject:forKey:
(void)	- removeObjectForKey:
(void)	- setPruneThreshold:
(unsigned)	- pruneThreshold
(void)	- setAutoPrune:
(BOOL)	- autoPrune
(void)	- prune
(BOOL)	- dirty
(void)	- markClean
(NSString *)	- name
(void)	- setName:
(NSArray *)	- objectsByAge
(void)	- dealloc [implementation]
(NSString *)	- description [implementation]
(void)	- loadFromArray: [implementation]

Private Attributes
struct OOCacheImpl *	cache
unsigned	pruneThreshold
BOOL	autoPrune
BOOL	dirty

Detailed Description

Definition at line 57 of file OOCache.h.

Method Documentation

autoPrune

- (BOOL) autoPrune

dealloc

- (void) dealloc

implementation

Definition at line 917 of file OOCache.m.

{
    CHECK_INTEGRITY(@"dealloc");
    CacheFree(cache);
    
    [super dealloc];
}

description

- (NSString *) description

implementation

Definition at line 917 of file OOCache.m.

{
    return [NSString stringWithFormat:@"<%@ %p>{\"%@\", %u elements, prune threshold=%u, auto-prune=%s dirty=%s}", [self class], self, [self name], CacheGetCount(cache), pruneThreshold, autoPrune ? "yes" : "no", dirty ? "yes" : "no"];
}

dirty

- (BOOL) dirty

init

- (id) init

Definition at line 917 of file OOCache.m.

{
    return [self initWithPList:nil];
}

initWithPList:

- (id) initWithPList:

(id)

pList

Definition at line 917 of file OOCache.m.

                   :(id)pList
{
    BOOL                    OK = YES;
    
    self = [super init];
    OK = self != nil;
    
    if (OK)
    {
        cache = CacheAllocate();
        if (cache == NULL) OK = NO;
    }
    
    if (pList != nil)
    {
        if (OK) OK = [pList isKindOfClass:[NSArray class]];
        if (OK) [self loadFromArray:pList];
    }
    if (OK)
    {
        pruneThreshold = kOOCacheDefaultPruneThreshold;
        autoPrune = YES;
    }
    
    if (!OK)
    {
        [self release];
        self = nil;
    }
    
    return self;
}

loadFromArray:

- (void) loadFromArray: (NSArray *) inArray

implementation

Provided by category OOCache(Private).

Definition at line 917 of file OOCache.m.

                     :(NSArray *)array
{
    NSEnumerator            *entryEnum = nil;
    NSDictionary            *entry = nil;
    NSString                *key = nil;
    id                      value = nil;
    
    if (array == nil) return;
    
    for (entryEnum = [array objectEnumerator]; (entry = [entryEnum nextObject]); )
    {
        if ([entry isKindOfClass:[NSDictionary class]])
        {
            key = [entry objectForKey:kSerializedEntryKeyKey];
            value = [entry objectForKey:kSerializedEntryKeyValue];
            if ([key isKindOfClass:[NSString class]] && value != nil)
            {
                [self setObject:value forKey:key];
            }
        }
    }
}

markClean

- (void) markClean

Definition at line 917 of file OOCache.m.

{
    dirty = NO;
}

name

- (NSString *) name

Definition at line 917 of file OOCache.m.

{
    return CacheGetName(cache);
}

objectForKey:

- (id) objectForKey:

(id)

key

Definition at line 917 of file OOCache.m.

                  :(id)key
{
    id                      result = nil;
    
    CHECK_INTEGRITY(@"objectForKey: before");
    
    result = CacheRetrieve(cache, key);
    // Note: while reordering the age list technically makes the cache dirty, it's not worth rewriting it just for that, so we don't flag it.
    
    CHECK_INTEGRITY(@"objectForKey: after");
    
    return [[result retain] autorelease];
}

objectsByAge

- (NSArray *) objectsByAge

Definition at line 917 of file OOCache.m.

{
    return CacheArrayOfContentsByAge(cache);
}

pListRepresentation

- (id) pListRepresentation

Definition at line 917 of file OOCache.m.

{
    return CacheArrayOfNodesByAge(cache);
    
    return nil;
}

prune

- (void) prune

Definition at line 917 of file OOCache.m.

{
    unsigned                pruneCount;
    unsigned                desiredCount;
    unsigned                count;
    
    // Order of operations is to ensure rounding down.
    if (autoPrune)  desiredCount = (pruneThreshold * 4) / 5;
    else  desiredCount = pruneThreshold;
    
    if (pruneThreshold == kOOCacheNoPrune || (count = CacheGetCount(cache)) <= pruneThreshold)  return;
    
    pruneCount = count - desiredCount;
    
    NSString *logKey = [NSString stringWithFormat:@"dataCache.prune.%@", CacheGetName(cache)];
    OOLog(logKey, @"Pruning cache \"%@\" - removing %u entries", CacheGetName(cache), pruneCount);
    OOLogIndentIf(logKey);
    
    while (pruneCount--)  CacheRemoveOldest(cache, logKey);
    
    OOLogOutdentIf(logKey);
}

pruneThreshold

- (unsigned) pruneThreshold

removeObjectForKey:

- (void) removeObjectForKey:

(id)

key

Definition at line 917 of file OOCache.m.

                          :(id)key
{
    CHECK_INTEGRITY(@"removeObjectForKey: before");
    
    if (CacheRemove(cache, key)) dirty = YES;
    
    CHECK_INTEGRITY(@"removeObjectForKey: after");
}

setAutoPrune:

- (void) setAutoPrune:

(BOOL)

flag

Definition at line 917 of file OOCache.m.

                    :(BOOL)flag
{
    BOOL prune = (flag != NO);
    if (prune != autoPrune)
    {
        autoPrune = prune;
        [self prune];
    }
}

setName:

- (void) setName:

(NSString *)

name

Definition at line 917 of file OOCache.m.

               :(NSString *)name
{
    CacheSetName(cache, name);
}

setObject:forKey:

- (void) setObject:		(id)	value
forKey:		(id)	key

Definition at line 917 of file OOCache.m.

                 :inObject forKey:(id)key
{
    CHECK_INTEGRITY(@"setObject:forKey: before");
    
    if (CacheInsert(cache, key, inObject))
    {
        dirty = YES;
        if (autoPrune)  [self prune];
    }
    
    CHECK_INTEGRITY(@"setObject:forKey: after");
}

setPruneThreshold:

- (void) setPruneThreshold:

(unsigned)

threshold

Definition at line 917 of file OOCache.m.

                         :(unsigned)threshold
{
    threshold = MAX(threshold, (unsigned)kOOCacheMinimumPruneThreshold);
    if (threshold != pruneThreshold)
    {
        pruneThreshold = threshold;
        if (autoPrune)  [self prune];
    }
}

Member Data Documentation

autoPrune

- (BOOL) autoPrune

private

Definition at line 62 of file OOCache.h.

cache

- (struct OOCacheImpl*) cache

private

Definition at line 60 of file OOCache.h.

dirty

- (BOOL) dirty

private

Definition at line 63 of file OOCache.h.

pruneThreshold

- (unsigned) pruneThreshold

private

Definition at line 61 of file OOCache.h.

---

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

• src/Core/OOCache.h
• src/Core/OOCache.m