OOJSScript Class Reference

#include <OOJSScript.h>

Inheritance diagram for OOJSScript:

Collaboration diagram for OOJSScript:

Instance Methods
(id)	- initWithPath:properties:
(BOOL)	- callMethod:inContext:withArguments:count:result:
(id)	- propertyWithID:inContext:
(BOOL)	- setProperty:withID:inContext:
(BOOL)	- defineProperty:withID:inContext:
(id)	- propertyNamed:
(BOOL)	- setProperty:named:
(BOOL)	- defineProperty:named:
(void)	- dealloc [implementation]
(NSString *)	- oo_jsClassName [implementation]
(NSString *)	- descriptionComponents [implementation]
(void)	- javaScriptEngineWillReset: [implementation]
(id)	- weakRetain [implementation]
(void)	- weakRefDied: [implementation]
(NSString *)	- scriptDescription [implementation]
(void)	- runWithTarget: [implementation]
(jsval)	- oo_jsValueInContext: [implementation]
(NSString *)	- scriptNameFromPath: [implementation]
(NSDictionary *)	- defaultPropertiesFromPath: [implementation]
Instance Methods inherited from OOScript
(NSString *)	- name
(NSString *)	- version
(NSString *)	- displayName
(BOOL)	- requiresTickle
Instance Methods inherited from <OOWeakReferenceSupport>
(id)	- OO_RETURNS_RETAINED

Class Methods
(id)	+ scriptWithPath:properties:
(OOJSScript *)	+ currentlyRunningScript
(NSArray *)	+ scriptStack
(void)	+ pushScript:
(void)	+ popScript:
Class Methods inherited from OOScript
(NSArray *)	+ worldScriptsAtPath:
(NSArray *)	+ scriptsFromFileNamed:
(NSArray *)	+ scriptsFromList:
(NSArray *)	+ scriptsFromFileAtPath:
(id)	+ jsScriptFromFileNamed:properties:
(id)	+ jsAIScriptFromFileNamed:properties:

Private Attributes
JSObject *	_jsSelf
NSString *	name
NSString *	description
NSString *	version
NSString *	filePath
OOWeakReference *	weakSelf

Detailed Description

Definition at line 31 of file OOJSScript.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 from OOScript.

Definition at line 395 of file OOJSScript.m.

                   :(jsid)methodID
          inContext:(JSContext *)context
      withArguments:(jsval *)argv count:(intN)argc
             result:(jsval *)outResult
{
    NSParameterAssert(name != NULL && (argv != NULL || argc == 0) && context != NULL && JS_IsInRequest(context));
    if (_jsSelf == NULL)  return NO;
    
    JSObject                *root = NULL;
    BOOL                    OK = NO;
    jsval                   method;
    jsval                   ignoredResult = JSVAL_VOID;
    
    if (outResult == NULL)  outResult = &ignoredResult;
    OOJSAddGCObjectRoot(context, &root, "OOJSScript method root");
    
    if (EXPECT(JS_GetMethodById(context, _jsSelf, methodID, &root, &method) && !JSVAL_IS_VOID(method)))
    {
#ifndef NDEBUG
        if (JS_IsExceptionPending(context))
        {
            OOLog(@"script.internalBug", @"Exception pending on context before calling method in %s, clearing. This is an internal error, please report it.", __PRETTY_FUNCTION__);
            JS_ClearPendingException(context);
        }
        
        OOLog(@"script.javaScript.call", @"Calling [%@].%@()", [self name], OOStringFromJSID(methodID));
        OOLogIndentIf(@"script.javaScript.call");
#endif
        
        // Push self on stack of running scripts.
        RunningStack stackElement =
        {
            .back = sRunningStack,
            .current = self
        };
        sRunningStack = &stackElement;
        
        // Call the method.
        OOJSStartTimeLimiter();
        OK = JS_CallFunctionValue(context, _jsSelf, method, argc, argv, outResult);
        OOJSStopTimeLimiter();
        
        if (JS_IsExceptionPending(context))
        {
            JS_ReportPendingException(context);
            OK = NO;
        }
        
        // Pop running scripts stack
        sRunningStack = stackElement.back;
        
#ifndef NDEBUG
        OOLogOutdentIf(@"script.javaScript.call");
#endif
    }
    
    JS_RemoveObjectRoot(context, &root);
    
    return OK;
}

References _jsSelf, RunningStack::back, EXPECT, JS_IsInRequest, name, OOJSAddGCObjectRoot, OOJSStartTimeLimiter, OOJSStopTimeLimiter, OOLog, OOLogIndentIf, OOLogOutdentIf, OOStringFromJSID(), and sRunningStack.

Referenced by StationEntity::acceptDockingClearanceRequestFrom:, PlayerEntity::activatePrimableEquipment:withMode:, PlayerEntity::adjustPriceByScriptForEqKey:withCurrent:, DockEntity::allowsLaunchingOf:, ShipEntity::behaviour_scripted_ai:, DockEntity::canAcceptShipForDocking:, Universe::canInstantiateShip:, StationEntity::dockingInstructionsForShip:, OOCharacter::doScriptEvent:, OOVisualEffectEntity::doScriptEvent:, ShipEntity::doScriptEvent:inContext:withArguments:count:, ShipEntity::equipmentValidToAdd:whileLoading:inContext:, OOShipRegistry(OODataLoader)::loadDemoShips, OODebugMonitor::performJSConsoleCommand:, and Universe::shipsForSaleForSystem:withTL:atTime:.

Here is the call graph for this function:

Here is the caller graph for this function:

currentlyRunningScript

+ (OOJSScript *) currentlyRunningScript

Definition at line 339 of file OOJSScript.m.

{
    if (sRunningStack == NULL)  return NULL;
    return sRunningStack->current;
}

References currentlyRunningScript, and sRunningStack.

Referenced by currentlyRunningScript, OOJSGuiScreenKeyDefinition::init, OOJSInterfaceDefinition::init, OOJSPopulatorDefinition::init, OOJSTimer(Private)::initWithDelay:interval:context:function:this:, OODebugMonitor(Private)::jsEngine:context:error:stackSkip:showingLocation:withMessage:, MissionRunScreen(), MissionSetInstructionsInternal(), ReportJSError(), OOSystemInfo::setValue:forKey:, SystemInfoSetPropertyMethod(), SystemInfoStaticSetInterstellarProperty(), and SystemSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

dealloc

- (void) dealloc

implementation

Definition at line 286 of file OOJSScript.m.

{
    [[NSNotificationCenter defaultCenter] removeObserver:self
                                                    name:kOOJavaScriptEngineWillResetNotification
                                                  object:[OOJavaScriptEngine sharedEngine]];
    
    DESTROY(name);
    DESTROY(description);
    DESTROY(version);
    DESTROY(filePath);
    
    if (_jsSelf != NULL)
    {
        JSContext *context = OOJSAcquireContext();
        
        OOJSObjectWrapperFinalize(context, _jsSelf);    // Release weakref to self
        JS_RemoveObjectRoot(context, &_jsSelf);          // Unroot jsSelf
        
        OOJSRelinquishContext(context);
    }
    
    [weakSelf weakRefDrop];
    
    [super dealloc];
}

References _jsSelf, dealloc, description, DESTROY, filePath, name, OOJSAcquireContext(), OOJSObjectWrapperFinalize(), OOJSRelinquishContext(), OOJavaScriptEngine::sharedEngine, version, and OOWeakReference::weakRefDrop.

Referenced by dealloc.

Here is the call graph for this function:

Here is the caller graph for this function:

defaultPropertiesFromPath:

- (NSDictionary *) defaultPropertiesFromPath: (NSString *) path

implementation

Provided by category OOJSScript(OOPrivate).

Definition at line 616 of file OOJSScript.m.

                                            :(NSString *)path
{
    // remove file name, remove OXP subfolder, add manifest.plist
    NSString *manifestPath = [[[path stringByDeletingLastPathComponent] stringByDeletingLastPathComponent] stringByAppendingPathComponent:@"manifest.plist"];
    NSDictionary *manifest = OODictionaryFromFile(manifestPath);
    NSMutableDictionary *properties = [NSMutableDictionary dictionaryWithCapacity:3];
    /* __oolite.tmp.* is allocated for OXPs without manifests. Its
     * values are meaningless and shouldn't be used here */
    if (manifest != nil && ![[manifest oo_stringForKey:kOOManifestIdentifier] hasPrefix:@"__oolite.tmp."])
    {
        if ([manifest objectForKey:kOOManifestVersion] != nil)
        {
            [properties setObject:[manifest oo_stringForKey:kOOManifestVersion] forKey:@"version"];
        }
        if ([manifest objectForKey:kOOManifestIdentifier] != nil)
        {
            // used for system info
            [properties setObject:[manifest oo_stringForKey:kOOManifestIdentifier] forKey:kLocalManifestProperty];
        }
        if ([manifest objectForKey:kOOManifestAuthor] != nil)
        {
            [properties setObject:[manifest oo_stringForKey:kOOManifestAuthor] forKey:@"author"];
        }
        if ([manifest objectForKey:kOOManifestLicense] != nil)
        {
            [properties setObject:[manifest oo_stringForKey:kOOManifestLicense] forKey:@"license"];
        }
    }
    return properties;
}

Referenced by initWithPath:properties:.

Here is the caller graph for this function:

defineProperty:named:

- (BOOL) defineProperty:		(id)	value
named:		(NSString *)	name

Definition at line 517 of file OOJSScript.m.

                       :(id)value named:(NSString *)propName
{
    if (value == nil || propName == nil)  return NO;
    if (_jsSelf == NULL)  return NO;
    
    JSContext *context = OOJSAcquireContext();
    BOOL result = [self defineProperty:value withID:OOJSIDFromString(propName) inContext:context];
    OOJSRelinquishContext(context);
    
    return result;
}

References _jsSelf, defineProperty:withID:inContext:, nil, OOJSAcquireContext(), and OOJSRelinquishContext().

Referenced by initWithPath:properties:.

Here is the call graph for this function:

Here is the caller graph for this function:

defineProperty:withID:inContext:

- (BOOL) defineProperty:		(id)	value
withID:		(jsid)	propID
inContext:		(JSContext *)	context

Definition at line 481 of file OOJSScript.m.

                       :(id)value withID:(jsid)propID inContext:(JSContext *)context
{
    NSParameterAssert(context != NULL && JS_IsInRequest(context));
    if (_jsSelf == NULL)  return NO;
    
    jsval jsValue = OOJSValueFromNativeObject(context, value);
    return JS_DefinePropertyById(context, _jsSelf, propID, jsValue, NULL, NULL, OOJS_PROP_READONLY);
}

References _jsSelf, JS_IsInRequest, OOJS_PROP_READONLY, and OOJSValueFromNativeObject().

Referenced by defineProperty:named:.

Here is the call graph for this function:

Here is the caller graph for this function:

descriptionComponents

- (NSString *) descriptionComponents

implementation

Reimplemented from OOScript.

Definition at line 319 of file OOJSScript.m.

{
    if (_jsSelf != NULL)  return [super descriptionComponents];
    else  return @"invalid script";
}

References _jsSelf, descriptionComponents, and OOScript::descriptionComponents.

Referenced by descriptionComponents.

Here is the call graph for this function:

Here is the caller graph for this function:

initWithPath:properties:

- (id) initWithPath:		(NSString *)	path
properties:		(NSDictionary *)	properties

Definition at line 118 of file OOJSScript.m.

                   :(NSString *)path properties:(NSDictionary *)properties
{
    JSContext               *context = NULL;
    NSString                *problem = nil;      // Acts as error flag.
    JSScript                *script = NULL;
    JSObject                *scriptObject = NULL;
    jsval                   returnValue = JSVAL_VOID;
    NSEnumerator            *keyEnum = nil;
    NSString                *key = nil;
    id                      property = nil;
    
    self = [super init];
    if (self == nil) problem = @"allocation failure";
    else
    {
        context = OOJSAcquireContext();
        
        if (JS_IsExceptionPending(context))
        {
            JS_ClearPendingException(context);
            OOLogERR(@"script.javaScript.load.waitingException", @"Prior to loading script %@, there was a pending JavaScript exception, which has been cleared. This is an internal error, please report it.", path);
        }
        
        // Set up JS object
        if (!problem)
        {
            _jsSelf = JS_NewObject(context, &sScriptClass, sScriptPrototype, NULL);
            if (_jsSelf == NULL) problem = @"allocation failure";
        }
        
        if (!problem && !OOJSAddGCObjectRoot(context, &_jsSelf, "Script object"))
        {
            problem = @"could not add JavaScript root object";
        }
        
        if (!problem && !OOJSAddGCObjectRoot(context, &scriptObject, "Script GC holder"))
        {
            problem = @"could not add JavaScript root object";
        }
        
        if (!problem)
        {
            if (!JS_SetPrivate(context, _jsSelf, OOConsumeReference([self weakRetain])))
            {
                problem = @"could not set private backreference";
            }
        }
        
        // Push self on stack of running scripts.
        RunningStack stackElement =
        {
            .back = sRunningStack,
            .current = self
        };
        sRunningStack = &stackElement;
        
        filePath = [path retain];
        
        if (!problem)
        {
            OOLog(@"script.javaScript.willLoad", @"About to load JavaScript %@", path);
            script = LoadScriptWithName(context, path, _jsSelf, &scriptObject, &problem);
        }
        OOLogIndentIf(@"script.javaScript.willLoad");
        
        // Set default properties from manifest.plist
        NSDictionary *defaultProperties = [self defaultPropertiesFromPath:path];
        for (keyEnum = [defaultProperties keyEnumerator]; (key = [keyEnum nextObject]); )
        {
            if ([key isKindOfClass:[NSString class]])
            {
                property = [defaultProperties objectForKey:key];
                if ([key isEqualToString:kLocalManifestProperty])
                {
                    // this must not be editable
                    [self defineProperty:property named:key];
                }
                else
                {
                    // can be overwritten by script itself
                    [self setProperty:property named:key];
                }
            }
        }
 
        // Set properties. (read-only)
        if (!problem && properties != nil)
        {
            for (keyEnum = [properties keyEnumerator]; (key = [keyEnum nextObject]); )
            {
                if ([key isKindOfClass:[NSString class]])
                {
                    property = [properties objectForKey:key];
                    [self defineProperty:property named:key];
                }
            }
        }
        
        /*  Set initial name (in case of script error during initial run).
            The "name" ivar is not set here, so the property can be fetched from JS
            if we fail during setup. However, the "name" ivar is set later so that
            the script object can't be renamed after the initial run. This could
            probably also be achieved by fiddling with JS property attributes.
        */
        jsid nameID = OOJSID("name");
        [self setProperty:[self scriptNameFromPath:path] withID:nameID inContext:context];
        
        // Run the script (allowing it to set up the properties we need, as well as setting up those event handlers)
        if (!problem)
        {
            OOJSStartTimeLimiterWithTimeLimit(kOOJSLongTimeLimit);
            if (!JS_ExecuteScript(context, _jsSelf, script, &returnValue))
            {
                problem = @"could not run script";
            }
            OOJSStopTimeLimiter();
            
            // We don't need the script any more - the event handlers hang around as long as the JS object exists.
            JS_DestroyScript(context, script);
        }
        
        JS_RemoveObjectRoot(context, &scriptObject);
        
        sRunningStack = stackElement.back;
        
        if (!problem)
        {
            // Get display attributes from script
            DESTROY(name);
            name = [StrippedName([[self propertyWithID:nameID inContext:context] description]) copy];
            if (name == nil)
            {
                name = [[self scriptNameFromPath:path] retain];
                [self setProperty:name withID:nameID inContext:context];
            }
            
            version = [[[self propertyWithID:OOJSID("version") inContext:context] description] copy];
            description = [[[self propertyWithID:OOJSID("description") inContext:context] description] copy];
            
            OOLog(@"script.javaScript.load.success", @"Loaded JavaScript: %@ -- %@", [self displayName], description ? description : (NSString *)@"(no description)");
        }
        
        OOLogOutdentIf(@"script.javaScript.willLoad");
        
        DESTROY(filePath);   // Only used for error reporting during startup.
    }
    
    if (problem)
    {
        OOLog(@"script.javaScript.load.failed", @"***** Error loading JavaScript script %@ -- %@", path, problem);
        JS_ReportPendingException(context);
        DESTROY(self);
    }
    
    OOJSRelinquishContext(context);
    
    if (self != nil)
    {
        [[NSNotificationCenter defaultCenter] addObserver:self
                                                 selector:@selector(javaScriptEngineWillReset:)
                                                     name:kOOJavaScriptEngineWillResetNotification
                                                   object:[OOJavaScriptEngine sharedEngine]];
    }
    
    return self;
}

References _jsSelf, RunningStack::back, defaultPropertiesFromPath:, defineProperty:named:, description, DESTROY, OOScript::displayName, filePath, kLocalManifestProperty, kOOJSLongTimeLimit, LoadScriptWithName(), name, nil, OOConsumeReference(), OOJSAcquireContext(), OOJSAddGCObjectRoot, OOJSID, OOJSRelinquishContext(), OOJSStartTimeLimiterWithTimeLimit, OOJSStopTimeLimiter, OOLog, OOLogERR, OOLogIndentIf, OOLogOutdentIf, propertyWithID:inContext:, scriptNameFromPath:, setProperty:named:, setProperty:withID:inContext:, OOJavaScriptEngine::sharedEngine, sRunningStack, sScriptClass, sScriptPrototype, version, and weakRetain.

Here is the call graph for this function:

javaScriptEngineWillReset:

- (void) javaScriptEngineWillReset: (NSNotification *) notification

implementation

Definition at line 326 of file OOJSScript.m.

                                  :(NSNotification *)notification
{
    // All scripts become invalid when the JS engine resets.
    if (_jsSelf != NULL)
    {
        _jsSelf = NULL;
        JSContext *context = OOJSAcquireContext();
        JS_RemoveObjectRoot(context, &_jsSelf);
        OOJSRelinquishContext(context);
    }
}

References _jsSelf, OOJSAcquireContext(), and OOJSRelinquishContext().

Here is the call graph for this function:

oo_jsClassName

- (NSString *) oo_jsClassName

implementation

Definition at line 313 of file OOJSScript.m.

{
    return @"Script";
}

References oo_jsClassName.

Referenced by oo_jsClassName.

Here is the call graph for this function:

Here is the caller graph for this function:

oo_jsValueInContext:

- (jsval) oo_jsValueInContext: (JSContext *) context

implementation

Definition at line 530 of file OOJSScript.m.

                            :(JSContext *)context
{
    if (_jsSelf == NULL)  return JSVAL_VOID;
    return OBJECT_TO_JSVAL(_jsSelf);
}

References _jsSelf.

popScript:

+ (void) popScript:

(OOJSScript *)

script

Definition at line 550 of file OOJSScript.m.

                 :(OOJSScript *)script
{
    RunningStack            *element = NULL;
    
    assert(sRunningStack->current == script);
    
    element = sRunningStack;
    sRunningStack = sRunningStack->back;
    free(element);
}

References sRunningStack.

Referenced by OOJSFunction::evaluateWithContext:scope:argc:argv:result:, MissionRunCallback(), OOJSGuiScreenKeyDefinition::runCallback:, OOJSInterfaceDefinition::runCallback:, OOJSPopulatorDefinition::runCallback:, and OOJSTimer::timerFired.

Here is the caller graph for this function:

propertyNamed:

- (id) propertyNamed:

(NSString *)

name

Definition at line 491 of file OOJSScript.m.

                    :(NSString *)propName
{
    if (propName == nil)  return nil;
    if (_jsSelf == NULL)  return nil;
    
    JSContext *context = OOJSAcquireContext();
    id result = [self propertyWithID:OOJSIDFromString(propName) inContext:context];
    OOJSRelinquishContext(context);
    
    return result;
}

References _jsSelf, nil, OOJSAcquireContext(), OOJSRelinquishContext(), and propertyWithID:inContext:.

Referenced by OOSystemInfo::setValue:forKey:, SystemInfoSetPropertyMethod(), SystemInfoStaticSetInterstellarProperty(), and SystemSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

propertyWithID:inContext:

- (id) propertyWithID:		(jsid)	propID
inContext:		(JSContext *)	context

Definition at line 457 of file OOJSScript.m.

                     :(jsid)propID inContext:(JSContext *)context
{
    NSParameterAssert(context != NULL && JS_IsInRequest(context));
    if (_jsSelf == NULL)  return nil;
    
    jsval jsValue = JSVAL_VOID;
    if (JS_GetPropertyById(context, _jsSelf, propID, &jsValue))
    {
        return OOJSNativeObjectFromJSValue(context, jsValue);
    }
    return nil;
}

References _jsSelf, JS_IsInRequest, nil, and OOJSNativeObjectFromJSValue().

Referenced by initWithPath:properties:, and propertyNamed:.

Here is the call graph for this function:

Here is the caller graph for this function:

pushScript:

+ (void) pushScript:

(OOJSScript *)

script

Definition at line 537 of file OOJSScript.m.

                  :(OOJSScript *)script
{
    RunningStack            *element = NULL;
    
    element = malloc(sizeof *element);
    if (element == NULL)  exit(EXIT_FAILURE);
    
    element->back = sRunningStack;
    element->current = script;
    sRunningStack = element;
}

References RunningStack::back, RunningStack::current, and sRunningStack.

Referenced by OOJSFunction::evaluateWithContext:scope:argc:argv:result:, MissionRunCallback(), OOJSGuiScreenKeyDefinition::runCallback:, OOJSInterfaceDefinition::runCallback:, OOJSPopulatorDefinition::runCallback:, and OOJSTimer::timerFired.

Here is the caller graph for this function:

runWithTarget:

- (void) runWithTarget: (Entity *) target

implementation

Reimplemented from OOScript.

Definition at line 389 of file OOJSScript.m.

                     :(Entity *)target
{
    
}

scriptDescription

- (NSString *) scriptDescription

implementation

Reimplemented from OOScript.

Definition at line 377 of file OOJSScript.m.

{
    return description;
}

References description, and scriptDescription.

Referenced by scriptDescription.

Here is the call graph for this function:

Here is the caller graph for this function:

scriptNameFromPath:

- (NSString *) scriptNameFromPath: (NSString *) path

implementation

Provided by category OOJSScript(OOPrivate).

Definition at line 582 of file OOJSScript.m.

                                :(NSString *)path
{
    NSString        *lastComponent = nil;
    NSString        *truncatedPath = nil;
    NSString        *theName = nil;
    
    if (path == nil) theName = [NSString stringWithFormat:@"%p", self];
    else
    {
        lastComponent = [path lastPathComponent];
        if (![lastComponent hasPrefix:@"script."]) theName = lastComponent;
        else
        {
            truncatedPath = [path stringByDeletingLastPathComponent];
            if (NSOrderedSame == [[truncatedPath lastPathComponent] caseInsensitiveCompare:@"Config"])
            {
                truncatedPath = [truncatedPath stringByDeletingLastPathComponent];
            }
            if (NSOrderedSame == [[truncatedPath pathExtension] caseInsensitiveCompare:@"oxp"])
            {
                truncatedPath = [truncatedPath stringByDeletingPathExtension];
            }
            
            lastComponent = [truncatedPath lastPathComponent];
            theName = lastComponent;
        }
    }
    
    if (0 == [theName length]) theName = path;
    
    return StrippedName([theName stringByAppendingString:@".anon-script"]);
}

Referenced by initWithPath:properties:.

Here is the caller graph for this function:

scriptStack

+ (NSArray *) scriptStack

Definition at line 346 of file OOJSScript.m.

{
    NSMutableArray          *result = nil;
    
    result = [NSMutableArray array];
    AddStackToArrayReversed(result, sRunningStack);
    return result;
}

References AddStackToArrayReversed(), nil, scriptStack, and sRunningStack.

Referenced by scriptStack.

Here is the call graph for this function:

Here is the caller graph for this function:

scriptWithPath:properties:

+ (id) scriptWithPath:		(NSString *)	path
properties:		(NSDictionary *)	properties

Definition at line 112 of file OOJSScript.m.

                     :(NSString *)path properties:(NSDictionary *)properties
{
    return [[[self alloc] initWithPath:path properties:properties] autorelease];
}

Referenced by OOScript::jsAIScriptFromFileNamed:properties:, OOScript::jsScriptFromFileNamed:properties:, OOCheckJSSyntaxVerifierStage::run, OOScript::scriptsFromFileAtPath:, OODebugMonitor(Private)::setUpDebugConsoleScript, and OOScript::worldScriptsAtPath:.

Here is the caller graph for this function:

setProperty:named:

- (BOOL) setProperty:		(id)	value
named:		(NSString *)	name

Definition at line 504 of file OOJSScript.m.

                    :(id)value named:(NSString *)propName
{
    if (value == nil || propName == nil)  return NO;
    if (_jsSelf == NULL)  return NO;
    
    JSContext *context = OOJSAcquireContext();
    BOOL result = [self setProperty:value withID:OOJSIDFromString(propName) inContext:context];
    OOJSRelinquishContext(context);
    
    return result;
}

References _jsSelf, nil, OOJSAcquireContext(), OOJSRelinquishContext(), and setProperty:withID:inContext:.

Referenced by initWithPath:properties:.

Here is the call graph for this function:

Here is the caller graph for this function:

setProperty:withID:inContext:

- (BOOL) setProperty:		(id)	value
withID:		(jsid)	propID
inContext:		(JSContext *)	context

Definition at line 471 of file OOJSScript.m.

                    :(id)value withID:(jsid)propID inContext:(JSContext *)context
{
    NSParameterAssert(context != NULL && JS_IsInRequest(context));
    if (_jsSelf == NULL)  return NO;
    
    jsval jsValue = OOJSValueFromNativeObject(context, value);
    return JS_SetPropertyById(context, _jsSelf, propID, &jsValue);
}

References _jsSelf, JS_IsInRequest, and OOJSValueFromNativeObject().

Referenced by initWithPath:properties:, and setProperty:named:.

Here is the call graph for this function:

Here is the caller graph for this function:

weakRefDied:

- (void) weakRefDied: (OOWeakReference *) weakRef

implementation

Reimplemented from <OOWeakReferenceSupport>.

Definition at line 363 of file OOJSScript.m.

                    :(OOWeakReference *)weakRef
{
    if (weakRef == weakSelf)  weakSelf = nil;
}

References nil, and weakSelf.

weakRetain

- (id) weakRetain

implementation

Definition at line 356 of file OOJSScript.m.

{
    if (weakSelf == nil)  weakSelf = [OOWeakReference weakRefWithObject:self];
    return [weakSelf retain];
}

References nil, OOWeakReference::weakRefWithObject:, weakRetain, and weakSelf.

Referenced by OOJSGuiScreenKeyDefinition::init, OOJSInterfaceDefinition::init, OOJSPopulatorDefinition::init, OOJSTimer(Private)::initWithDelay:interval:context:function:this:, initWithPath:properties:, OODebugMonitor(Private)::jsEngine:context:error:stackSkip:showingLocation:withMessage:, ReportJSError(), and weakRetain.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

_jsSelf

- (JSObject*) _jsSelf

private

Definition at line 35 of file OOJSScript.h.

Referenced by callMethod:inContext:withArguments:count:result:, dealloc, defineProperty:named:, defineProperty:withID:inContext:, descriptionComponents, initWithPath:properties:, javaScriptEngineWillReset:, oo_jsValueInContext:, propertyNamed:, propertyWithID:inContext:, setProperty:named:, and setProperty:withID:inContext:.

description

- (NSString*) description

private

Definition at line 38 of file OOJSScript.h.

Referenced by dealloc, initWithPath:properties:, and scriptDescription.

filePath

- (NSString*) filePath

private

Definition at line 40 of file OOJSScript.h.

Referenced by dealloc, and initWithPath:properties:.

name

- (NSString *) name

private

Definition at line 369 of file OOJSScript.m.

{
    if (name == nil)  name = [[self propertyNamed:@"name"] copy];
    if (name == nil)  return [self scriptNameFromPath:filePath]; // Special case for parse errors during load.
    return name;
}

Referenced by callMethod:inContext:withArguments:count:result:, dealloc, initWithPath:properties:, MissionSetInstructionsInternal(), and OOShipDebugInspectorModule::update.

version

- (NSString *) version

private

Definition at line 383 of file OOJSScript.m.

{
    return version;
}

Referenced by dealloc, and initWithPath:properties:.

weakSelf

- (OOWeakReference*) weakSelf

private

Definition at line 42 of file OOJSScript.h.

Referenced by weakRefDied:, and weakRetain.

---

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

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