npunix.c
上传用户:riyaled888
上传日期:2009-03-27
资源大小:7338k
文件大小:14k
源码类别:

多媒体

开发平台:

MultiPlatform

  1. /* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
  2.  *
  3.  * The contents of this file are subject to the Mozilla Public
  4.  * License Version 1.1 (the "License"); you may not use this file
  5.  * except in compliance with the License. You may obtain a copy of
  6.  * the License at http://www.mozilla.org/MPL/
  7.  * 
  8.  * Software distributed under the License is distributed on an "AS
  9.  * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
  10.  * implied. See the License for the specific language governing
  11.  * rights and limitations under the License.
  12.  * 
  13.  * The Original Code is mozilla.org code.
  14.  *
  15.  * The Initial Developer of the Original Code is Netscape
  16.  * Communications Corporation.  Portions created by Netscape are
  17.  * Copyright (C) 1998 Netscape Communications Corporation. All
  18.  * Rights Reserved.
  19.  *
  20.  * Contributor(s): 
  21.  * Stephen Mak <smak@sun.com>
  22.  */
  23. /*
  24.  * npunix.c
  25.  *
  26.  * Netscape Client Plugin API
  27.  * - Wrapper function to interface with the Netscape Navigator
  28.  *
  29.  * dp Suresh <dp@netscape.com>
  30.  *
  31.  *----------------------------------------------------------------------
  32.  * PLUGIN DEVELOPERS:
  33.  *  YOU WILL NOT NEED TO EDIT THIS FILE.
  34.  * TO NETSCAPE DEVELOPERS:
  35.  *  OF COURSE I WILL NEED TO EDIT THIS FILE, YOU BORKED IT ALL AROUND YOU
  36.  *  IGNORANT FOOLS -- sam
  37.  *----------------------------------------------------------------------
  38.  */
  39. #define XP_UNIX 1
  40. #include <stdio.h>
  41. #include "nscore.h"
  42. #include "npapi.h"
  43. #include "npupp.h"
  44. /*
  45.  * Define PLUGIN_TRACE to have the wrapper functions print
  46.  * messages to stderr whenever they are called.
  47.  */
  48. #ifdef PLUGIN_TRACE
  49. #include <stdio.h>
  50. #define PLUGINDEBUGSTR(msg) fprintf(stderr, "%sn", msg)
  51. #else
  52. #define PLUGINDEBUGSTR(msg)
  53. #endif
  54. /***********************************************************************
  55.  *
  56.  * Globals
  57.  *
  58.  ***********************************************************************/
  59. static NPNetscapeFuncs   gNetscapeFuncs;    /* Netscape Function table */
  60. /***********************************************************************
  61.  *
  62.  * Wrapper functions : plugin calling Netscape Navigator
  63.  *
  64.  * These functions let the plugin developer just call the APIs
  65.  * as documented and defined in npapi.h, without needing to know
  66.  * about the function table and call macros in npupp.h.
  67.  *
  68.  ***********************************************************************/
  69. void
  70. NPN_Version(int* plugin_major, int* plugin_minor,
  71.          int* netscape_major, int* netscape_minor)
  72. {
  73.     *plugin_major = NP_VERSION_MAJOR;
  74.     *plugin_minor = NP_VERSION_MINOR;
  75.     /* Major version is in high byte */
  76.     *netscape_major = gNetscapeFuncs.version >> 8;
  77.     /* Minor version is in low byte */
  78.     *netscape_minor = gNetscapeFuncs.version & 0xFF;
  79. }
  80. NPError
  81. NPN_GetValue(NPP instance, NPNVariable variable, void *r_value)
  82. {
  83.     return CallNPN_GetValueProc(gNetscapeFuncs.getvalue,
  84.                     instance, variable, r_value);
  85. }
  86. NPError
  87. NPN_SetValue(NPP instance, NPPVariable variable, void *value)
  88. {
  89.     return CallNPN_SetValueProc(gNetscapeFuncs.setvalue,
  90.                     instance, variable, value);
  91. }
  92. NPError
  93. NPN_GetURL(NPP instance, const char* url, const char* window)
  94. {
  95.     return CallNPN_GetURLProc(gNetscapeFuncs.geturl, instance, url, window);
  96. }
  97. NPError
  98. NPN_GetURLNotify(NPP instance, const char* url, const char* window, void* notifyData)
  99. {
  100.     return CallNPN_GetURLNotifyProc(gNetscapeFuncs.geturlnotify, instance, url, window, notifyData);
  101. }
  102. NPError
  103. NPN_PostURL(NPP instance, const char* url, const char* window,
  104.          uint32 len, const char* buf, NPBool file)
  105. {
  106.     return CallNPN_PostURLProc(gNetscapeFuncs.posturl, instance,
  107.                     url, window, len, buf, file);
  108. }
  109. NPError
  110. NPN_PostURLNotify(NPP instance, const char* url, const char* window, uint32 len,
  111.                   const char* buf, NPBool file, void* notifyData)
  112. {
  113.     return CallNPN_PostURLNotifyProc(gNetscapeFuncs.posturlnotify,
  114.             instance, url, window, len, buf, file, notifyData);
  115. }
  116. NPError
  117. NPN_RequestRead(NPStream* stream, NPByteRange* rangeList)
  118. {
  119.     return CallNPN_RequestReadProc(gNetscapeFuncs.requestread,
  120.                     stream, rangeList);
  121. }
  122. NPError
  123. NPN_NewStream(NPP instance, NPMIMEType type, const char *window,
  124.           NPStream** stream_ptr)
  125. {
  126.     return CallNPN_NewStreamProc(gNetscapeFuncs.newstream, instance,
  127.                     type, window, stream_ptr);
  128. }
  129. int32
  130. NPN_Write(NPP instance, NPStream* stream, int32 len, void* buffer)
  131. {
  132.     return CallNPN_WriteProc(gNetscapeFuncs.write, instance,
  133.                     stream, len, buffer);
  134. }
  135. NPError
  136. NPN_DestroyStream(NPP instance, NPStream* stream, NPError reason)
  137. {
  138.     return CallNPN_DestroyStreamProc(gNetscapeFuncs.destroystream,
  139.                         instance, stream, reason);
  140. }
  141. void
  142. NPN_Status(NPP instance, const char* message)
  143. {
  144.     CallNPN_StatusProc(gNetscapeFuncs.status, instance, message);
  145. }
  146. const char*
  147. NPN_UserAgent(NPP instance)
  148. {
  149.     return CallNPN_UserAgentProc(gNetscapeFuncs.uagent, instance);
  150. }
  151. void*
  152. NPN_MemAlloc(uint32 size)
  153. {
  154.     return CallNPN_MemAllocProc(gNetscapeFuncs.memalloc, size);
  155. }
  156. void NPN_MemFree(void* ptr)
  157. {
  158.     CallNPN_MemFreeProc(gNetscapeFuncs.memfree, ptr);
  159. }
  160. uint32 NPN_MemFlush(uint32 size)
  161. {
  162.     return CallNPN_MemFlushProc(gNetscapeFuncs.memflush, size);
  163. }
  164. void NPN_ReloadPlugins(NPBool reloadPages)
  165. {
  166.     CallNPN_ReloadPluginsProc(gNetscapeFuncs.reloadplugins, reloadPages);
  167. }
  168. JRIEnv* NPN_GetJavaEnv()
  169. {
  170.     return CallNPN_GetJavaEnvProc(gNetscapeFuncs.getJavaEnv);
  171. }
  172. jref NPN_GetJavaPeer(NPP instance)
  173. {
  174.     return CallNPN_GetJavaPeerProc(gNetscapeFuncs.getJavaPeer,
  175.                        instance);
  176. }
  177. void
  178. NPN_InvalidateRect(NPP instance, NPRect *invalidRect)
  179. {
  180.     CallNPN_InvalidateRectProc(gNetscapeFuncs.invalidaterect, instance,
  181.         invalidRect);
  182. }
  183. void
  184. NPN_InvalidateRegion(NPP instance, NPRegion invalidRegion)
  185. {
  186.     CallNPN_InvalidateRegionProc(gNetscapeFuncs.invalidateregion, instance,
  187.         invalidRegion);
  188. }
  189. void
  190. NPN_ForceRedraw(NPP instance)
  191. {
  192.     CallNPN_ForceRedrawProc(gNetscapeFuncs.forceredraw, instance);
  193. }
  194. /***********************************************************************
  195.  *
  196.  * Wrapper functions : Netscape Navigator -> plugin
  197.  *
  198.  * These functions let the plugin developer just create the APIs
  199.  * as documented and defined in npapi.h, without needing to 
  200.  * install those functions in the function table or worry about
  201.  * setting up globals for 68K plugins.
  202.  *
  203.  ***********************************************************************/
  204. NPError
  205. Private_New(NPMIMEType pluginType, NPP instance, uint16 mode,
  206.         int16 argc, char* argn[], char* argv[], NPSavedData* saved)
  207. {
  208.     NPError ret;
  209.     PLUGINDEBUGSTR("New");
  210.     ret = NPP_New(pluginType, instance, mode, argc, argn, argv, saved);
  211.     return ret; 
  212. }
  213. NPError
  214. Private_Destroy(NPP instance, NPSavedData** save)
  215. {
  216.     PLUGINDEBUGSTR("Destroy");
  217.     return NPP_Destroy(instance, save);
  218. }
  219. NPError
  220. Private_SetWindow(NPP instance, NPWindow* window)
  221. {
  222.     NPError err;
  223.     PLUGINDEBUGSTR("SetWindow");
  224.     err = NPP_SetWindow(instance, window);
  225.     return err;
  226. }
  227. NPError
  228. Private_NewStream(NPP instance, NPMIMEType type, NPStream* stream,
  229.             NPBool seekable, uint16* stype)
  230. {
  231.     NPError err;
  232.     PLUGINDEBUGSTR("NewStream");
  233.     err = NPP_NewStream(instance, type, stream, seekable, stype);
  234.     return err;
  235. }
  236. int32
  237. Private_WriteReady(NPP instance, NPStream* stream)
  238. {
  239.     unsigned int result;
  240.     PLUGINDEBUGSTR("WriteReady");
  241.     result = NPP_WriteReady(instance, stream);
  242.     return result;
  243. }
  244. int32
  245. Private_Write(NPP instance, NPStream* stream, int32 offset, int32 len,
  246.         void* buffer)
  247. {
  248.     unsigned int result;
  249.     PLUGINDEBUGSTR("Write");
  250.     result = NPP_Write(instance, stream, offset, len, buffer);
  251.     return result;
  252. }
  253. void
  254. Private_StreamAsFile(NPP instance, NPStream* stream, const char* fname)
  255. {
  256.     PLUGINDEBUGSTR("StreamAsFile");
  257.     NPP_StreamAsFile(instance, stream, fname);
  258. }
  259. NPError
  260. Private_DestroyStream(NPP instance, NPStream* stream, NPError reason)
  261. {
  262.     NPError err;
  263.     PLUGINDEBUGSTR("DestroyStream");
  264.     err = NPP_DestroyStream(instance, stream, reason);
  265.     return err;
  266. }
  267. void
  268. Private_URLNotify(NPP instance, const char* url,
  269.                 NPReason reason, void* notifyData)
  270.                 
  271. {
  272.     PLUGINDEBUGSTR("URLNotify");
  273.     NPP_URLNotify(instance, url, reason, notifyData);
  274. }
  275. void
  276. Private_Print(NPP instance, NPPrint* platformPrint)
  277. {
  278.     PLUGINDEBUGSTR("Print");
  279.     NPP_Print(instance, platformPrint);
  280. }
  281. NPError
  282. Private_GetValue(NPP instance, NPPVariable variable, void *r_value)
  283. {
  284.     PLUGINDEBUGSTR("GetValue");
  285. return NPP_GetValue(instance, variable, r_value);
  286. }
  287. JRIGlobalRef
  288. Private_GetJavaClass(void)
  289. {
  290.     jref clazz = NPP_GetJavaClass();
  291.     if (clazz) {
  292.     JRIEnv* env = NPN_GetJavaEnv();
  293.     return JRI_NewGlobalRef(env, clazz);
  294.     }
  295.     return NULL;
  296. }
  297. /*********************************************************************** 
  298.  *
  299.  * These functions are located automagically by netscape.
  300.  *
  301.  ***********************************************************************/
  302. /*
  303.  * NP_GetMIMEDescription
  304.  *  - Netscape needs to know about this symbol
  305.  *  - Netscape uses the return value to identify when an object instance
  306.  *    of this plugin should be created.
  307.  */
  308. char *
  309. NP_GetMIMEDescription(void)
  310. {
  311.     return NPP_GetMIMEDescription();
  312. }
  313. /*
  314.  * NP_GetValue [optional]
  315.  *  - Netscape needs to know about this symbol.
  316.  *  - Interfaces with plugin to get values for predefined variables
  317.  *    that the navigator needs.
  318.  */
  319. NPError
  320. NP_GetValue(void *future, NPPVariable variable, void *value)
  321. {
  322.     return NPP_GetValue(future, variable, value);
  323. }
  324. /*
  325.  * NP_Initialize
  326.  *  - Netscape needs to know about this symbol.
  327.  *  - It calls this function after looking up its symbol before it
  328.  *    is about to create the first ever object of this kind.
  329.  *
  330.  * PARAMETERS
  331.  *    nsTable   - The netscape function table. If developers just use these
  332.  *        wrappers, they dont need to worry about all these function
  333.  *        tables.
  334.  * RETURN
  335.  *    pluginFuncs
  336.  *      - This functions needs to fill the plugin function table
  337.  *        pluginFuncs and return it. Netscape Navigator plugin
  338.  *        library will use this function table to call the plugin.
  339.  *
  340.  */
  341. NPError
  342. NP_Initialize(NPNetscapeFuncs* nsTable, NPPluginFuncs* pluginFuncs)
  343. {
  344.     NPError err = NPERR_NO_ERROR;
  345.     PLUGINDEBUGSTR("NP_Initialize");
  346.     
  347.     /* validate input parameters */
  348.     if ((nsTable == NULL) || (pluginFuncs == NULL))
  349.         err = NPERR_INVALID_FUNCTABLE_ERROR;
  350.     
  351.     /*
  352.      * Check the major version passed in Netscape's function table.
  353.      * We won't load if the major version is newer than what we expect.
  354.      * Also check that the function tables passed in are big enough for
  355.      * all the functions we need (they could be bigger, if Netscape added
  356.      * new APIs, but that's OK with us -- we'll just ignore them).
  357.      *
  358.      */
  359.     if (err == NPERR_NO_ERROR) {
  360.         if ((nsTable->version >> 8) > NP_VERSION_MAJOR)
  361.             err = NPERR_INCOMPATIBLE_VERSION_ERROR;
  362.         if (nsTable->size < sizeof(NPNetscapeFuncs))
  363.             err = NPERR_INVALID_FUNCTABLE_ERROR;
  364.         if (pluginFuncs->size < sizeof(NPPluginFuncs))      
  365.             err = NPERR_INVALID_FUNCTABLE_ERROR;
  366.     }
  367.         
  368.     
  369.     if (err == NPERR_NO_ERROR) {
  370.         /*
  371.          * Copy all the fields of Netscape function table into our
  372.          * copy so we can call back into Netscape later.  Note that
  373.          * we need to copy the fields one by one, rather than assigning
  374.          * the whole structure, because the Netscape function table
  375.          * could actually be bigger than what we expect.
  376.          */
  377.         gNetscapeFuncs.version       = nsTable->version;
  378.         gNetscapeFuncs.size          = nsTable->size;
  379.         gNetscapeFuncs.posturl       = nsTable->posturl;
  380.         gNetscapeFuncs.geturl        = nsTable->geturl;
  381.         gNetscapeFuncs.geturlnotify  = nsTable->geturlnotify;
  382.         gNetscapeFuncs.requestread   = nsTable->requestread;
  383.         gNetscapeFuncs.newstream     = nsTable->newstream;
  384.         gNetscapeFuncs.write         = nsTable->write;
  385.         gNetscapeFuncs.destroystream = nsTable->destroystream;
  386.         gNetscapeFuncs.status        = nsTable->status;
  387.         gNetscapeFuncs.uagent        = nsTable->uagent;
  388.         gNetscapeFuncs.memalloc      = nsTable->memalloc;
  389.         gNetscapeFuncs.memfree       = nsTable->memfree;
  390.         gNetscapeFuncs.memflush      = nsTable->memflush;
  391.         gNetscapeFuncs.reloadplugins = nsTable->reloadplugins;
  392.         gNetscapeFuncs.getJavaEnv    = nsTable->getJavaEnv;
  393.         gNetscapeFuncs.getJavaPeer   = nsTable->getJavaPeer;
  394.         gNetscapeFuncs.getvalue      = nsTable->getvalue;
  395.         /*
  396.          * Set up the plugin function table that Netscape will use to
  397.          * call us.  Netscape needs to know about our version and size
  398.          * and have a UniversalProcPointer for every function we
  399.          * implement.
  400.          */
  401.         pluginFuncs->version    = (NP_VERSION_MAJOR << 8) + NP_VERSION_MINOR;
  402.         pluginFuncs->size       = sizeof(NPPluginFuncs);
  403.         pluginFuncs->newp       = NewNPP_NewProc(Private_New);
  404.         pluginFuncs->destroy    = NewNPP_DestroyProc(Private_Destroy);
  405.         pluginFuncs->setwindow  = NewNPP_SetWindowProc(Private_SetWindow);
  406.         pluginFuncs->newstream  = NewNPP_NewStreamProc(Private_NewStream);
  407.         pluginFuncs->destroystream = NewNPP_DestroyStreamProc(Private_DestroyStream);
  408.         pluginFuncs->asfile     = NewNPP_StreamAsFileProc(Private_StreamAsFile);
  409.         pluginFuncs->writeready = NewNPP_WriteReadyProc(Private_WriteReady);
  410.         pluginFuncs->write      = NewNPP_WriteProc(Private_Write);
  411.         pluginFuncs->print      = NewNPP_PrintProc(Private_Print);
  412.         pluginFuncs->urlnotify  = NewNPP_URLNotifyProc(Private_URLNotify);
  413.         pluginFuncs->event      = NULL;
  414.         pluginFuncs->javaClass  = Private_GetJavaClass();
  415.         pluginFuncs->getvalue   = NewNPP_GetValueProc(Private_GetValue);
  416.         
  417.         err = NPP_Initialize();
  418.     }
  419.     
  420.     return err;
  421. }
  422. /*
  423.  * NP_Shutdown [optional]
  424.  *  - Netscape needs to know about this symbol.
  425.  *  - It calls this function after looking up its symbol after
  426.  *    the last object of this kind has been destroyed.
  427.  *
  428.  */
  429. NPError
  430. NP_Shutdown(void)
  431. {
  432.     PLUGINDEBUGSTR("NP_Shutdown");
  433.     NPP_Shutdown();
  434.     return NPERR_NO_ERROR;
  435. }