jsiruntime.hpp

Open VXI. This is a open source.

/*****************************************************************************
 *****************************************************************************
 *
 * $Id: JsiRuntime.hpp,v 1.7.6.1 2001/10/03 16:20:52 dmeyer Exp $
 *
 * JsiRuntime, class for managing JavaScript runtime environments
 *
 * The JsiRuntime class represents a JavaScript interpreter runtime
 * environment, which is the overall JavaScript engine execution space
 * (compiler, interpreter, decompiler, garbage collector, etc.) which
 * can hold zero or more JavaScript contexts (JsiContext objects).
 *
 *****************************************************************************
 ****************************************************************************/


/****************License************************************************
 *
 * Copyright 2000-2001.  SpeechWorks International, Inc.  
 *
 * Use of this software is subject to notices and obligations set forth
 * in the SpeechWorks Public License - Software Version 1.1 which is
 * included with this software.
 *
 * SpeechWorks is a registered trademark, and SpeechWorks Here, 
 * DialogModules and the SpeechWorks logo are trademarks of SpeechWorks 
 * International, Inc. in the United States and other countries. 
 * 
 ************************************************************************
 */

// -----1=0-------2=0-------3=0-------4=0-------5=0-------6=0-------7=0-------8

#ifndef _JSI_RUNTIME_H__
#define _JSI_RUNTIME_H__

#include "VXIjsi.h"              // For VXIjsiResult codes
#include "SBinetLogger.hpp"      // For SBinetLogger base class

#include <jspubtd.h>             // SpiderMonkey JavaScript typedefs (JS...)

#ifndef JS_DLL_CALLBACK
#define JS_DLL_CALLBACK CRT_CALL // For SpiderMonkey 1.5 RC 3 and earlier
#endif

#ifndef JS_THREADSAFE
extern "C" struct VXItrdMutex;
#endif

extern "C" struct VXIlogInterface;

class JsiRuntime : SBinetLogger {
 public:
  // Constructor and destructor
  JsiRuntime( );
  virtual ~JsiRuntime( );

  // Creation method
  VXIjsiResult Create (long              runtimeSize,
		       VXIlogInterface  *log,
		       VXIunsigned       diagTagBase);
  
 public:
  // These are only for JsiContext use!

  // Get a new JavaScript context for the runtime
  VXIjsiResult NewContext (long contextSize, JSContext **context);

  // Destroy a JavaScript context for the runtime
  VXIjsiResult DestroyContext (JSContext **context);

#ifndef JS_THREADSAFE
  // Flag that we are beginning and ending access of this runtime
  // (including any access of a context within this runtime), used to
  // ensure thread safety. For simplicity, return true on success,
  // false on failure (mutex error).
  bool AccessBegin( ) const;
  bool AccessEnd( ) const;
#endif
  
 private:
  // Static callback for diagnostic logging of garbage collection
  static JSBool JS_DLL_CALLBACK GCCallback (JSContext *cx, JSGCStatus status);

  // Disable the copy constructor and assignment operator
  JsiRuntime (const JsiRuntime &rt);
  JsiRuntime & operator= (const JsiRuntime &rt);

 private:
  VXIlogInterface  *log;         // For logging
  JSRuntime        *runtime;     // JavaScript runtime environment

#ifndef JS_THREADSAFE
  VXItrdMutex      *mutex;       // For thread safe evals
#endif
};

#endif  // _JSI_RUNTIME_H__