method createInstance

This method returns an object, which is a newly created instance of the class that was specified by the EE moniker. More information about EE monikers can be found in the EE Runtime documentation.

Example monikers:

  ee://aol/localStorage/recordset    (create the latest version of the localStorage service's recordset class)
  ee://aol/localStorage/recordset:3  (create version 3 of the localStorage service's recordset class)

Notes

• The serviceManager will use its current environment to create the requested class (the created class will inherit the current environment).
• Specifying a version number in the EE moniker will bypass both, the versioning logic and the client filter logic that is built into the EE Runtime. It is highly recommended to allow the runtime determine the best version of the class to instantiate.

    // This is the most common idiom for createInstance in JavaScript
    svc = shell.serviceManager.helloWorldService.HelloWorldObject;
    greeting = svc.hello("World");
    writeln(greeting);
    
    // However this is synonymous
    svc = shell.serviceManager.createInstance("ee://aol/helloWorldService/HelloWorldObject");
    greeting = svc.hello("Earth");
    alert(greeting);