Added NPL to LiveConnect java classes.

New file 'JSWrappedException' is used for passing exceptions between Java
and JavaScript.

js/ref/liveconnect/classes/netscape/javascript/JSException.java

@@ -1,58 +0,0 @@
-/* -*- Mode: C; tab-width: 8 -*-
- * Copyright (C) 1998 Netscape Communications Corporation, All Rights Reserved.
- */
-
-package netscape.javascript;
-
-/**
- * JSException is an exception which is thrown when JavaScript code
- * returns an error.
- */
-
-public
-class JSException extends Exception {
-    String filename;
-    int lineno;
-    String source;
-    int tokenIndex;
-
-    /**
-     * Constructs a JSException without a detail message.
-     * A detail message is a String that describes this particular exception.
-     */
-    public JSException() {
-	super();
-        filename = "unknown";
-        lineno = 0;
-        source = "";
-        tokenIndex = 0;
-    }
-
-    /**
-     * Constructs a JSException with a detail message.
-     * A detail message is a String that describes this particular exception.
-     * @param s the detail message
-     */
-    public JSException(String s) {
-	super(s);
-        filename = "unknown";
-        lineno = 0;
-        source = "";
-        tokenIndex = 0;
-    }
-
-    /**
-     * Constructs a JSException with a detail message and all the
-     * other info that usually comes with a JavaScript error.
-     * @param s the detail message
-     */
-    public JSException(String s, String filename, int lineno,
-                       String source, int tokenIndex) {
-	super(s);
-        this.filename = filename;
-        this.lineno = lineno;
-        this.source = source;
-        this.tokenIndex = tokenIndex;
-    }
-}
-

js/ref/liveconnect/classes/netscape/javascript/JSObject.java

@@ -1,154 +0,0 @@
-/* -*- Mode: C; tab-width: 8 -*-
- * Copyright (C) 1998 Netscape Communications Corporation, All Rights Reserved.
- */
-
-/* Insert copyright and license here 19** */
-
-/* more doc todo:
- *  threads
- *  gc
- *  
- *
- */
-
-package netscape.javascript;
-
-import java.applet.Applet;
-
-/**
- * JSObject allows Java to manipulate objects that are
- * defined in JavaScript.
- * Values passed from Java to JavaScript are converted as
- * follows:<ul>
- * <li>JSObject is converted to the original JavaScript object
- * <li>Any other Java object is converted to a JavaScript wrapper,
- *   which can be used to access methods and fields of the java object.
- *   Converting this wrapper to a string will call the toString method
- *   on the original object, converting to a number will call the
- *   doubleValue method if possible and fail otherwise.  Converting
- *   to a boolean will try to call the booleanValue method in the
- *   same way.
- * <li>Java arrays are wrapped with a JavaScript object that understands
- *   array.length and array[index]
- * <li>A Java boolean is converted to a JavaScript boolean
- * <li>Java byte, char, short, int, long, float, and double are converted
- *   to JavaScript numbers
- * </ul>
- * Values passed from JavaScript to Java are converted as follows:<ul>
- * <li>objects which are wrappers around java objects are unwrapped
- * <li>other objects are wrapped with a JSObject
- * <li>strings, numbers and booleans are converted to String, Double,
- *   and Boolean objects respectively
- * <li>undefined is converted to a string
- * </ul>
- * This means that all JavaScript values show up as some kind
- * of java.lang.Object in Java.  In order to make much use of them,
- * you will have to cast them to the appropriate subclass of Object,
- * e.g. <code>(String) window.getMember("name");</code> or
- * <code>(JSObject) window.getMember("document");</code>.
- */
-public final class JSObject {
-    /* the internal object data */
-    private int                               internal;
-
-    /**
-     * initialize
-     */
-    private static native void initClass();
-    static {
-        String liveConnectLibrary = null;
-        String OSName = System.getProperty("os.name", null);
-
-        // On MRJ, this property won't exist, because the library is preloaded.
-        liveConnectLibrary = System.getProperty("netscape.jsj.dll", null);
-        
-        // On Mac, native methods are statically linked and manually registered.
-        if ((liveConnectLibrary == null) && (OSName.indexOf("Mac") == -1))
-            liveConnectLibrary = "LiveConnect";
-
-        if (liveConnectLibrary != null) {
-            System.loadLibrary(liveConnectLibrary);
-            initClass();
-        }
-    }
-
-    /**
-     * it is illegal to construct a JSObject manually
-     */
-    private JSObject(int jsobj_addr) {
-        internal = jsobj_addr;
-    }
-
-    /**
-     * Retrieves a named member of a JavaScript object. 
-     * Equivalent to "this.<i>name</i>" in JavaScript.
-     */
-    public native Object        getMember(String name);
-
-    /**
-     * Retrieves an indexed member of a JavaScript object.
-     * Equivalent to "this[<i>index</i>]" in JavaScript.
-     */
-//    public Object             getMember(int index) { return getSlot(index); }
-    public native Object        getSlot(int index);
-
-    /**
-     * Sets a named member of a JavaScript object. 
-     * Equivalent to "this.<i>name</i> = <i>value</i>" in JavaScript.
-     */
-    public native void          setMember(String name, Object value);
-
-    /**
-     * Sets an indexed member of a JavaScript object. 
-     * Equivalent to "this[<i>index</i>] = <i>value</i>" in JavaScript.
-     */
-//    public void               setMember(int index, Object value) {
-//        setSlot(index, value);
-//    }
-    public native void          setSlot(int index, Object value);
-
-    /**
-     * Removes a named member of a JavaScript object.
-     */
-    public native void          removeMember(String name);
-
-    /**
-     * Calls a JavaScript method.
-     * Equivalent to "this.<i>methodName</i>(<i>args</i>[0], <i>args</i>[1], ...)" in JavaScript.
-     */
-    public native Object        call(String methodName, Object args[]);
-
-    /**
-     * Evaluates a JavaScript expression. The expression is a string 
-     * of JavaScript source code which will be evaluated in the context
-     * given by "this".
-     */
-    public native Object        eval(String s);
-
-    /**
-     * Converts a JSObject to a String.
-     */
-    public native String        toString();
-
-    // should use some sort of identifier rather than String
-    // is "property" the right word?
-    //    native String[]                         listProperties();
-
-
-    /**
-     * get a JSObject for the window containing the given applet
-     */
-    public static native JSObject       getWindow(Applet applet);
-
-    /**
-     * Finalization decrements the reference count on the corresponding
-     * JavaScript object.
-     */
-    protected native void       finalize();
-
-    /**
-     * Override java.lang.Object.equals() because identity is not preserved
-     * with instances of JSObject.
-     */
-    public native boolean       equals(Object obj);
-}

js/ref/liveconnect/classes/netscape/javascript/JSProxy.java

@@ -1,23 +0,0 @@
-/* -*- Mode: C; tab-width: 8 -*-
- * Copyright (C) 1998 Netscape Communications Corporation, All Rights Reserved.
- */
-/* ** */
-/**
- * The JSProxy interface allows applets and plugins to
- * share javascript contexts.
- */
-
-package netscape.javascript;
-import java.applet.Applet;
-
-public interface JSProxy {
-    Object  getMember(JSObject jso, String name);
-    Object  getSlot(JSObject jso, int index);
-    void    setMember(JSObject jso, String name, Object value);
-    void    setSlot(JSObject jso, int index, Object value);
-    void    removeMember(JSObject jso, String name);
-    Object  call(JSObject jso, String methodName, Object args[]);
-    Object  eval(JSObject jso, String s);
-    String      toString(JSObject jso);
-    JSObject    getWindow(Applet applet);
-}

js/ref/liveconnect/classes/netscape/javascript/JSRunnable.java

@@ -1,35 +0,0 @@
-/* -*- Mode: C; tab-width: 8 -*-
- * Copyright (C) 1998 Netscape Communications Corporation, All Rights Reserved.
- */
-
-package netscape.javascript;
-
-/**
- * Runs a JavaScript object with a run() method in a separate thread.
- */
-public class JSRunnable implements Runnable {
-	private JSObject runnable;
-
-	public JSRunnable(JSObject runnable) {
-		this.runnable = runnable;
-		synchronized(this) {
-			new Thread(this).start();
-			try {
-				this.wait();
-			} catch (InterruptedException ie) {
-			}
-		}
-	}
-	
-	public void run() {
-		try {
-			runnable.call("run", null);
-			synchronized(this) {
-				notifyAll();
-			}
-		} catch (Throwable t) {
-			System.err.println(t);
-			t.printStackTrace(System.err);
-		}
-	}
-}

js/ref/liveconnect/classes/netscape/javascript/JSUtil.java

@@ -1,24 +0,0 @@
-/* -*- Mode: C; tab-width: 8 -*-
- * Copyright (C) 1998 Netscape Communications Corporation, All Rights Reserved.
- */
-/* ** */
-
-package netscape.javascript;
-import java.io.*;
-
-public class JSUtil {
-
-    /* Return the stack trace of an exception or error as a String */
-    public static String getStackTrace(Throwable t) {
-	ByteArrayOutputStream captureStream;
-	PrintStream p;
-	
-	captureStream = new ByteArrayOutputStream();
-	p = new PrintStream(captureStream);
-
-	t.printStackTrace(p);
-	p.flush();
-
-	return captureStream.toString();
-    }
-}