OOScript Class Reference

#include <OOScript.h>

Inheritance diagram for OOScript:

Collaboration diagram for OOScript:

Instance Methods
(NSString *)	- name
(NSString *)	- scriptDescription
(NSString *)	- version
(NSString *)	- displayName
(BOOL)	- requiresTickle
(void)	- runWithTarget:
(NSString *)	- descriptionComponents [implementation]
(BOOL)	- callMethod:inContext:withArguments:count:result:

Class Methods
(NSArray *)	+ worldScriptsAtPath:
(NSArray *)	+ scriptsFromFileNamed:
(NSArray *)	+ scriptsFromList:
(NSArray *)	+ scriptsFromFileAtPath:
(id)	+ jsScriptFromFileNamed:properties:
(id)	+ jsAIScriptFromFileNamed:properties:

Detailed Description

Definition at line 41 of file OOScript.h.

Method Documentation

callMethod:inContext:withArguments:count:result:

- (BOOL) callMethod:		(jsid)	methodID
inContext:		(JSContext *)	context
withArguments:		(jsval *)	argv
count:		(intN)	argc
result:		(jsval *)	outResult

Reimplemented in OOJSScript.

Provided by category OOScript(JavaScriptEvents).

Definition at line 55 of file OOJSScript.m.

                   :(jsid)methodID
          inContext:(JSContext *)context
      withArguments:(jsval *)argv count:(intN)argc
             result:(jsval *)outResult
{
    return NO;
}

descriptionComponents

- (NSString *) descriptionComponents

implementation

Reimplemented in OOJSScript.

Definition at line 40 of file OOScript.m.

{
    return [NSString stringWithFormat:@"\"%@\" version %@", [self name], [self version]];
}

References kOOLogLoadScriptJavaScript, kOOLogLoadScriptNone, kOOLogLoadScriptOK, kOOLogLoadScriptParseError, kOOLogLoadScriptPList, nil, OOArrayFromFile(), OOEnforceStandards(), OOLog, OOLogERR, OOLogIndentIf, OOLogOutdentIf, OOStandardsDeprecated(), scriptsFromList:, OOPListScript::scriptsInPListFile:, and OOJSScript::scriptWithPath:properties:.

Here is the call graph for this function:

displayName

- (NSString *) displayName

Definition at line 40 of file OOScript.m.

{
    NSString *name = [self name];
    NSString *version = [self version];
    
    if (version != nil)  return [NSString stringWithFormat:@"%@ %@", name, version];
    else if (name != nil)  return [NSString stringWithFormat:@"%@", name];
    else  return nil;
}

jsAIScriptFromFileNamed:properties:

+ (id) jsAIScriptFromFileNamed:		(NSString *)	fileName
properties:		(NSDictionary *)	properties

Definition at line 40 of file OOScript.m.

                             :(NSString *)fileName properties:(NSDictionary *)properties
{
    NSString            *extension = nil;
    NSString            *path = nil;
    
    if ([fileName length] == 0)  return nil;
    
    extension = [[fileName pathExtension] lowercaseString];
    if ([extension isEqualToString:@"js"] || [extension isEqualToString:@"es"])
    {
        path = [ResourceManager pathForFileNamed:fileName inFolder:@"AIs"];
        if (path == nil)
        {
            OOLogERR(@"script.load.notFound", @"Could not find script file %@.", fileName);
            return nil;
        }
        return [OOJSScript scriptWithPath:path properties:properties];
    }
    else if ([extension isEqualToString:@"plist"])
    {
        OOLogERR(@"script.load.badName", @"Can't load script named %@ - legacy scripts are not supported in this context.", fileName);
        return nil;
    }
    
    OOLogERR(@"script.load.badName", @"Don't know how to load a script from %@.", fileName);
    return nil;
}

jsScriptFromFileNamed:properties:

+ (id) jsScriptFromFileNamed:		(NSString *)	fileName
properties:		(NSDictionary *)	properties

Definition at line 40 of file OOScript.m.

                           :(NSString *)fileName properties:(NSDictionary *)properties
{
    NSString            *extension = nil;
    NSString            *path = nil;
    
    if ([fileName length] == 0)  return nil;
    
    extension = [[fileName pathExtension] lowercaseString];
    if ([extension isEqualToString:@"js"] || [extension isEqualToString:@"es"])
    {
        path = [ResourceManager pathForFileNamed:fileName inFolder:@"Scripts"];
        if (path == nil)
        {
            OOLogERR(@"script.load.notFound", @"Could not find script file %@.", fileName);
            return nil;
        }
        return [OOJSScript scriptWithPath:path properties:properties];
    }
    else if ([extension isEqualToString:@"plist"])
    {
        OOLogERR(@"script.load.badName", @"Can't load script named %@ - legacy scripts are not supported in this context.", fileName);
        return nil;
    }
    
    OOLogERR(@"script.load.badName", @"Don't know how to load a script from %@.", fileName);
    return nil;
}

name

- (NSString *) name

Reimplemented in OOPListScript.

Definition at line 40 of file OOScript.m.

{
    OOLogERR(kOOLogSubclassResponsibility, @"%@", @"OOScript should not be used directly!");
    return nil;
}

requiresTickle

- (BOOL) requiresTickle

Reimplemented in OOPListScript.

Definition at line 40 of file OOScript.m.

{
    return NO;
}

runWithTarget:

- (void) runWithTarget:

(Entity *)

target

Reimplemented in OOJSScript, and OOPListScript.

Definition at line 40 of file OOScript.m.

                     :(Entity *)target
{
    OOLogERR(kOOLogSubclassResponsibility, @"%@", @"OOScript should not be used directly!");
}

scriptDescription

- (NSString *) scriptDescription

Reimplemented in OOJSScript, and OOPListScript.

Definition at line 40 of file OOScript.m.

{
    OOLogERR(kOOLogSubclassResponsibility, @"%@", @"OOScript should not be used directly!");
    return nil;
}

scriptsFromFileAtPath:

+ (NSArray *) scriptsFromFileAtPath:

(NSString *)

filePath

Definition at line 40 of file OOScript.m.

                                  :(NSString *)filePath
{
    // oo_oxzFile always returns false for directories
    if (![[NSFileManager defaultManager] oo_oxzFileExistsAtPath:filePath]) return nil;
    
    NSString *extension = [[filePath pathExtension] lowercaseString];
    
    if ([extension isEqualToString:@"js"] || [extension isEqualToString:@"es"])
    {
        NSArray     *result = nil;
        OOScript    *script = [OOJSScript scriptWithPath:filePath properties:nil];
        if (script != nil) result = [NSArray arrayWithObject:script];
        return result;
    }
    else if ([extension isEqualToString:@"plist"])
    {
        OOStandardsDeprecated([NSString stringWithFormat:@"Legacy script %@ is deprecated",filePath]);
        if (OOEnforceStandards())
        {
            return nil;
        }
        return [OOPListScript scriptsInPListFile:filePath];
    }
    
    OOLogERR(@"script.load.badName", @"Don't know how to load a script from %@.", filePath);
    return nil;
}

scriptsFromFileNamed:

+ (NSArray *) scriptsFromFileNamed:

(NSString *)

fileName

Definition at line 40 of file OOScript.m.

                                 :(NSString *)fileName
{
    NSArray *result = nil;
    NSString *path = [ResourceManager pathForFileNamed:fileName inFolder:@"Scripts"];
    if (path != nil)
    {
        result = [self scriptsFromFileAtPath:path];
    }
    
    if (result == nil)
    {
        OOLogERR(@"script.load.notFound", @"Could not find script file %@.", fileName);
    }
    
    return result;
}

scriptsFromList:

+ (NSArray *) scriptsFromList:

(NSArray *)

fileNames

Definition at line 40 of file OOScript.m.

                            :(NSArray *)fileNames
{
    NSString            *name = nil;
    NSMutableArray      *result = nil;
    NSArray             *scripts = nil;
    
    result = [NSMutableArray arrayWithCapacity:[fileNames count]];
    
    foreach (name, fileNames)
    {
        scripts = [self scriptsFromFileNamed:name];
        if (scripts != nil)  [result addObjectsFromArray:scripts];
    }
    
    return result;
}

Referenced by descriptionComponents.

Here is the caller graph for this function:

version

- (NSString *) version

Reimplemented in OOPListScript.

Definition at line 40 of file OOScript.m.

{
    OOLogERR(kOOLogSubclassResponsibility, @"%@", @"OOScript should not be used directly!");
    return nil;
}

worldScriptsAtPath:

+ (NSArray *) worldScriptsAtPath:

(NSString *)

path

Definition at line 40 of file OOScript.m.

                               :(NSString *)path
{
    NSFileManager       *fmgr = nil;
    NSString            *filePath = nil;
    NSArray             *names = nil;
    NSArray             *result = nil;
    id                  script = nil;
    BOOL                foundScript = NO;
    
    fmgr = [NSFileManager defaultManager];
    
    // First, look for world-scripts.plist.
    filePath = [path stringByAppendingPathComponent:@"world-scripts.plist"];
    if (filePath != nil)
    {
        names = OOArrayFromFile(filePath);
        if (names != nil)
        {
            foundScript = YES;
            result = [self scriptsFromList:names];
        }
    }
    
    // Second, try to load a JavaScript.
    if (result == nil)
    {
        filePath = [path stringByAppendingPathComponent:@"script.js"];
        if ([fmgr oo_oxzFileExistsAtPath:filePath]) foundScript = YES;
        else
        {
            filePath = [path stringByAppendingPathComponent:@"script.es"];
            if ([fmgr oo_oxzFileExistsAtPath:filePath]) foundScript = YES;
        }
        if (foundScript)
        {
            OOLog(kOOLogLoadScriptJavaScript, @"Trying to load JavaScript script %@", filePath);
            OOLogIndentIf(kOOLogLoadScriptJavaScript);
            
            script = [OOJSScript scriptWithPath:filePath properties:nil];
            if (script != nil)
            {
                result = [NSArray arrayWithObject:script];
                OOLog(kOOLogLoadScriptOK, @"Successfully loaded JavaScript script %@", filePath);
            }
            else  OOLogERR(kOOLogLoadScriptParseError, @"Failed to load JavaScript script %@", filePath);
            
            OOLogOutdentIf(kOOLogLoadScriptJavaScript);
        }
    }
    
    // Third, try to load a plist script.
    if (result == nil)
    {
        filePath = [path stringByAppendingPathComponent:@"script.plist"];
        if ([fmgr oo_oxzFileExistsAtPath:filePath])
        {
            OOStandardsDeprecated([NSString stringWithFormat:@"Legacy script %@ is deprecated",filePath]);
            if (!OOEnforceStandards())
            {
                foundScript = YES;
                OOLog(kOOLogLoadScriptPList, @"Trying to load property list script %@", filePath);
                OOLogIndentIf(kOOLogLoadScriptPList);
                
                result = [OOPListScript scriptsInPListFile:filePath];
                if (result != nil)  OOLog(kOOLogLoadScriptOK, @"Successfully loaded property list script %@", filePath);
                else  OOLogERR(kOOLogLoadScriptParseError, @"Failed to load property list script %@", filePath);
            
                OOLogOutdentIf(kOOLogLoadScriptPList);
            }
        }
    }
    
    if (result == nil && foundScript)
    {
        OOLog(kOOLogLoadScriptNone, @"No script could be loaded from %@", path);
    }
    
    return result;
}

---

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

• src/Core/Scripting/OOScript.h
• src/Core/Scripting/OOScript.m