Add COM4J.wrapSta for wrapping STA com objects

Objects wrapped in this way can only be called from the same thread they
were created by (and wrapped in).

When using these wrapped objects calls to the COM object are done in the
same thread instead of using a second thread. This has the disadvantage
that these objects can't be passed around and used from anywhere, but
where a COM object has to be called from a specific thread it means they
can be used (mostly only a problem when the Java code is running in the
same process as an in-process COM server).

Fixes kohsuke#68

Author: tonyroberts

runtime/src/main/java/com4j/COM4J.java

@@ -142,6 +142,33 @@ public T call() {
         }.execute();
     }
 
+    /**
+     * Wraps an externally obtained single-threaded apartment interface pointer from the current
+     * thread into a COM wrapper object.
+     * <p>
+     * This method must be called by the same thread that the COM object belongs to.
+     * Object wrappers created with this method can only be accessed from that thread.
+     * <p>
+     * This method doesn't call addRef on the given interface pointer. Instead, this method
+     * takes over the ownership of the given pointer.
+     * </p>
+     *
+     * @param primaryInterface
+     *      The interface type to wrap the pointer into.
+     * @param ptr
+     *      The rar interface pointer value.
+     */
+    public static<T extends Com4jObject>
+    T wrapSta( final Class<T> primaryInterface, final long ptr ) throws ComException {
+        ComThread thread = ComThreadSingle.get();
+        return new Task<T>() {
+            @Override
+            public T call() {
+                return Wrapper.create(primaryInterface,ptr);
+            }
+        }.execute(thread);
+    }
+
     /**
      * Gets an already running object from the running object table.
      *
@@ -387,7 +414,8 @@ public static ByteBuffer createBuffer( long ptr, int size ) {
      * @see #removeListener(ComObjectListener)
      */
     public static void addListener( ComObjectListener listener ) {
-        ComThread.get().addListener(listener);
+        ComThreadMulti.get().addListener(listener);
+        ComThreadSingle.get().addListener(listener);
     }
 
     /**
@@ -400,7 +428,8 @@ public static void addListener( ComObjectListener listener ) {
      * @see #addListener(ComObjectListener)
      */
     public static void removeListener( ComObjectListener listener ) {
-        ComThread.get().removeListener(listener);
+        ComThreadMulti.get().removeListener(listener);
+        ComThreadSingle.get().removeListener(listener);
     }
 
     /**
@@ -416,7 +445,8 @@ public static void removeListener( ComObjectListener listener ) {
      * After this method is invoked, a thread can still go use other COM resources.
      */
     public static void cleanUp() {
-        ComThread.detach();
+        ComThreadMulti.detach();
+        ComThreadSingle.detach();
     }
 
     /**