Update README.md to include information about how node-java handles memory.

joeferner · joeferner · commit e05f4b9c5f56 · 2013-12-09T13:17:13.000-05:00
diff --git a/README.md b/README.md
@@ -478,6 +478,10 @@ ShutdownHookHelper.setShutdownHookSync(java.newProxy('java.lang.Runnable', {
 }));
 ```
 
+# Object lifetime
+
+When you call a Java method through node-java, any arguments (V8/JavaScript objects) will be converted to Java objects  on the v8 main thread via a call to v8ToJava (found in utils.cpp). The JavaScript object is not held on to and can be garbage collected by v8. If this is an async call, the reference count on the Java objects will be incremented. The Java method will be invoked in a node.js async thread (see uv_queue_work). When the method returns, the resulting object will be returned to the main v8 thread and converted to JavaScript objects via a call to javaToV8 and the Java object's reference count will then be decremented to allow for garbage collection. The resulting v8 object will then be returned to the callers callback function.
+
 ## License
 
 (The MIT License)
