jyapayne/swig
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add Native Directive Example

Browse source
This commit is contained in:
TekuConcept 2019-05-08 17:45:05 -06:00
commit f16350e774
6 changed files with 141 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

3
Examples/javascript/native/Makefile Normal file
View file

@ -0,0 +1,3 @@
SRCS =
include $(SRCDIR)../example.mk

9
Examples/javascript/native/binding.gyp.in Normal file
View file

@ -0,0 +1,9 @@
{
"targets": [
{
"target_name": "example",
"sources": [ "example_wrap.cxx" ],
"include_dirs": ["$srcdir"]
}
]
}

92
Examples/javascript/native/example.i Normal file
View file

@ -0,0 +1,92 @@
/* File : example.i */
%module example
%wrapper
%{
#include <cstring>
#include <string>
#if (V8_MAJOR_VERSION-0) < 4 && (SWIG_V8_VERSION < 0x031903)
# define V8_RETURN(val) return scope.Close(val)
#else
# define V8_RETURN(val) args.GetReturnValue().Set(val); return
#endif
#if (V8_MAJOR_VERSION-0) < 4 && (SWIG_V8_VERSION < 0x032318)
# define V8_UNDEFINED() v8::Undefined()
#else
# define V8_UNDEFINED() v8::Undefined(v8::Isolate::GetCurrent())
#endif
// 'unused' attribute only necessary for GNUC < v3.4
static /* __attribute__ ((__unused__)) */ V8ErrorHandler V8_ErrorHandler;
typedef struct worker_packet {
// -- basic --
uv_work_t request;
v8::Persistent<v8::Function> callback;
// -- persistent variables --
std::string result;
// -- async operation --
void (*execute)(std::string&);
} worker_packet;
// async process - parallel with node thread
static void work_async(uv_work_t* request) {
worker_packet* packet = static_cast<worker_packet*>(request->data);
packet->execute(packet->result);
// add a delay for dramatic effect - not necessary
}
// send async result back to node's thread
static void work_complete(uv_work_t* request, int status) {
v8::Isolate* iso = v8::Isolate::GetCurrent();
v8::HandleScope scope(iso);
worker_packet* packet = static_cast<worker_packet*>(request->data);
const int argc = 1;
v8::Handle<v8::Value> argv[] = {
v8::String::NewFromUtf8(iso, packet->result.c_str())
};
v8::Local<v8::Function>::New(iso, packet->callback)->Call
(iso->GetCurrentContext()->Global(), argc, argv);
packet->callback.Reset();
delete work;
}
static void entry(const v8::FunctionCallbackInfo<v8::Value>& args) {
v8::Isolate* iso = v8::Isolate::GetCurrent();
v8::Local<v8::Value> value = args[0];
if (!value->IsFunction()) {
V8_ErrorHandler.error((-1), "Invalid parameter type.");
return;
}
worker_packet* packet = new worker_packet();
packet->request.data = packet;
packet->execute = [](std::string& res) { res = "My delayed message."; };
v8::Local<v8::Function> callback = v8::Local<v8::Function>::Cast(value);
packet->callback.Reset(iso, callback);
uv_queue_work(uv_default_loop(), &packet->request,
work_async, work_complete);
args.GetReturnValue().Set(Undefined(iso));
}
void JavaScript_exampleV8_callback_function(const v8::Arguments& args) {
v8::HandleScope scope
if (args.Length() != 1) {
V8_ErrorHandler.error((-1), "Illegal number of arguments.");
V8_RETURN(V8_UNDEFINED());
}
entry(args);
v8::Handle<v8::Value> jsresult = V8_UNDEFINED();
V8_RETURN(jsresult);
}
%}
%native(num_to_string) void JavaScript_exampleV8_callback_function();

1
Examples/javascript/native/example.js Normal file
View file

@ -0,0 +1 @@
module.exports = require("build/Release/example");

31
Examples/javascript/native/index.html Normal file
View file

@ -0,0 +1,31 @@
<html>
<head>
<title>SWIG:Examples:javascript:native</title>
</head>
<body bgcolor="#ffffff">
<tt>SWIG/Examples/javascript/native/</tt>
<hr>
<H2>Manually wrapped callback function in JavaScript</H2>
<p>
This example demonstrates how to manually add callback feature support to a SWIG module.
</p>
<ul>
<li><a href="example.i">example.i</a>. Interface file containing the API function and async behind-the-scenes functions.
<li><a href="runme.java">runme.js</a>. Sample JavaScript program showing the API function being called with a callback function parameter.
</ul>
<h2>Notes</h2>
The V8 code queues the callback request for processing using the UV interface. An async function callback is invoked when the system is ready to process the next request. When the async function finishes, a completion function callback is invoked to finalize the request. Here the callback function parameter is invoked.
<br/><br/>
UV request queueing is only necessary for operations that would take a really long or otherwise unpredictable amount of time (async operations). A callback parameter could also be invoked immediately within the API function.
<hr>
</body>
</html>

5
Examples/javascript/native/runme.js Normal file
View file

@ -0,0 +1,5 @@
var example = require("example");
function callback(msg) { console.log(msg); }
example.num_to_string(callback);