flex-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From aha...@apache.org
Subject [22/52] [abbrv] [partial] git commit: [flex-falcon] [refs/heads/feature/maven-migration-test] - move stuff to where I think Maven wants it
Date Fri, 22 Apr 2016 19:29:44 GMT
http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/DefaultDebuggerCallbacks.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/DefaultDebuggerCallbacks.java b/debugger/src/main/java/flash/tools/debugger/DefaultDebuggerCallbacks.java
new file mode 100644
index 0000000..d94ae46
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/DefaultDebuggerCallbacks.java
@@ -0,0 +1,431 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+import java.io.BufferedReader;
+import java.io.File;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.io.LineNumberReader;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+import flash.util.Trace;
+
+/**
+ * @author mmorearty
+ */
+public class DefaultDebuggerCallbacks implements IDebuggerCallbacks
+{
+	private boolean m_computedExeLocations;
+	private File m_httpExe;
+	private File m_playerExe;
+
+	private static final String UNIX_DEFAULT_BROWSER = "firefox"; //$NON-NLS-1$
+	private static final String UNIX_FLASH_PLAYER = "flashplayer"; //$NON-NLS-1$
+
+	private static final int WINDOWS = 0;
+	private static final int MAC = 1;
+	private static final int UNIX = 2;
+
+	// A pattern for a value that was output by reg.exe.  Warning,
+	// Windows XP and Windows Vista have different output; the following
+	// pattern needs to work for both.
+	private static final Pattern registryValuePattern = Pattern.compile("\\sREG_[^ \t]+\\s+(.*)$"); //$NON-NLS-1$
+
+	/**
+	 * Returns WINDOWS, MAC, or UNIX
+	 */
+	private static int getOS() {
+		String osName = System.getProperty("os.name").toLowerCase(); //$NON-NLS-1$
+		if (osName.startsWith("windows")) //$NON-NLS-1$
+			return WINDOWS;
+		else if (osName.startsWith("mac os x")) // as per http://developer.apple.com/technotes/tn2002/tn2110.html //$NON-NLS-1$
+			return MAC;
+		else
+			return UNIX;
+	}
+
+	/*
+	 * @see flash.tools.debugger.IDebuggerCallbacks#getHttpExe()
+	 */
+	public synchronized File getHttpExe()
+	{
+		if (!m_computedExeLocations)
+			recomputeExeLocations();
+		return m_httpExe;
+	}
+
+	/*
+	 * @see flash.tools.debugger.IDebuggerCallbacks#getPlayerExe()
+	 */
+	public synchronized File getPlayerExe()
+	{
+		if (!m_computedExeLocations)
+			recomputeExeLocations();
+		return m_playerExe;
+	}
+
+	/*
+	 * @see flash.tools.debugger.IDebuggerCallbacks#recomputeExeLocations()
+	 */
+	public synchronized void recomputeExeLocations()
+	{
+		int os = getOS();
+		if (os == WINDOWS)
+		{
+			m_httpExe = getDefaultWindowsBrowser();
+			m_playerExe = determineExeForType("ShockwaveFlash.ShockwaveFlash"); //$NON-NLS-1$
+		}
+		else if (os == MAC)
+		{
+			m_httpExe = null;
+			m_playerExe = null;
+		}
+		else // probably Unix
+		{
+			// "firefox" is default browser for unix
+			m_httpExe = findUnixProgram(UNIX_DEFAULT_BROWSER);
+
+			// "flashplayer" is standalone flash player on unix
+			m_playerExe = findUnixProgram(UNIX_FLASH_PLAYER);
+		}
+		m_computedExeLocations = true;
+	}
+
+	public String getHttpExeName()
+	{
+		if (getOS() == UNIX)
+			return UNIX_DEFAULT_BROWSER;
+		else
+			return Bootstrap.getLocalizationManager().getLocalizedTextString("webBrowserGenericName"); //$NON-NLS-1$
+	}
+
+	public String getPlayerExeName()
+	{
+		if (getOS() == UNIX)
+			return UNIX_FLASH_PLAYER;
+		else
+			return Bootstrap.getLocalizationManager().getLocalizedTextString("flashPlayerGenericName"); //$NON-NLS-1$
+	}
+
+	/**
+	 * Looks for a Unix program.  Checks the PATH, and if not found there,
+	 * checks the directory specified by the "application.home" Java property.
+	 * ("application.home" was set by the "fdb" shell script.)
+	 * 
+	 * @param program program to find, e.g. "firefox"
+	 * @return path, or <code>null</code> if not found.
+	 */
+	private File findUnixProgram(String program)
+	{
+		String[] cmd = { "/bin/sh", "-c", "which " + program }; //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$
+		try
+		{
+			Process process = Runtime.getRuntime().exec(cmd);
+			BufferedReader reader = new BufferedReader(new InputStreamReader(process.getInputStream()));
+			String line = reader.readLine();
+			if (line != null)
+			{
+				File f = new File(line);
+				if (f.exists())
+				{
+					return f;
+				}
+			}
+
+			// Check in the Flex SDK's "bin" directory.  The "application.home"
+			// property is set by the "fdb" shell script.
+			String flexHome = System.getProperty("application.home"); //$NON-NLS-1$
+			if (flexHome != null)
+			{
+				File f = new File(flexHome, "bin/" + program); //$NON-NLS-1$
+				if (f.exists())
+				{
+					return f;
+				}
+			}
+		}
+		catch (IOException e)
+		{
+			// ignore
+		}
+		return null;
+	}
+
+	private File getDefaultWindowsBrowser() {
+		try {
+			String browser = null;
+
+			double osVersion;
+			try {
+				osVersion = Double.parseDouble(System.getProperty("os.version")); //$NON-NLS-1$
+			} catch (NumberFormatException e) {
+				osVersion = 0;
+			}
+
+			if (osVersion >= 6) { // Vista or higher
+				String progid = queryWindowsRegistry(
+					"HKEY_CURRENT_USER\\Software\\Microsoft\\Windows\\Shell\\Associations\\UrlAssociations\\http\\UserChoice", //$NON-NLS-1$
+					"Progid"); //$NON-NLS-1$
+				if (progid != null) {
+					browser = getClassShellOpenCommand(progid);
+				}
+			}
+
+			if (browser == null) {
+				browser = getClassShellOpenCommand("http"); //$NON-NLS-1$
+			}
+
+			if (browser != null) {
+				browser = extractExenameFromCommandString(browser);
+				return new File(browser);
+			} else {
+				return null;
+			}
+		} catch (IOException e) {
+			return null;
+		}
+	}
+
+	private String getClassShellOpenCommand(String clazz) throws IOException {
+		return queryWindowsRegistry("HKEY_CLASSES_ROOT\\" + clazz + "\\shell\\open\\command", null); //$NON-NLS-1$ //$NON-NLS-2$
+	}
+
+	/**
+	 * Note, this function is Windows-specific.
+	 */
+	private File determineExeForType(String type)
+	{
+		String it = null;
+		try
+		{
+			String[] cmd = new String[] { "cmd", "/d", "/c", "ftype", type }; //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ //$NON-NLS-4$
+			Process p = Runtime.getRuntime().exec(cmd);
+			LineNumberReader lnr = new LineNumberReader(new InputStreamReader(p.getInputStream()));
+			String line = null;
+			type += "="; //$NON-NLS-1$
+			while( it == null && (line = lnr.readLine()) != null)
+			{
+				if (line.length() < type.length() ||
+					line.substring(0, type.length()).compareToIgnoreCase(type) == 0)
+				{
+					it = line;
+					break;
+				}
+			}
+			p.destroy();
+
+			// if we have one extract cmd = " "
+			if (it != null)
+			{
+				int equalSign = it.indexOf('=');
+				if (equalSign != -1)
+					it = it.substring(equalSign+1);
+
+				it = extractExenameFromCommandString(it);
+			}
+		}
+		catch (IOException e)
+		{
+			// means it didn't work
+		}
+
+		if (it != null)
+			return new File(it);
+		else
+			return null;
+	}
+
+	/**
+	 * Given a command string of the form
+	 * 		"path_to_exe" args
+	 * or
+	 * 		path_to_exe args
+	 * 
+	 * return the path_to_exe.  Note that path_to_exe may contain spaces.
+	 */
+	protected String extractExenameFromCommandString(String cmd)
+	{
+		// now strip trailing junk if any
+		if (cmd.startsWith("\"")) { //$NON-NLS-1$
+			// ftype is enclosed in quotes
+			int closingQuote =  cmd.indexOf('"', 1);
+			if (closingQuote == -1)
+				closingQuote = cmd.length();
+			cmd = cmd.substring(1, closingQuote);
+		} else {
+			// Some ftypes don't use enclosing quotes.  This is tricky -- we have to
+			// scan through the string, stopping at each space and checking whether
+			// the filename up to that point refers to a valid filename.  For example,
+			// if the input string is
+			//
+			//     C:\Program Files\Macromedia\Flash 9\Players\SAFlashPlayer.exe %1
+			//
+			// then we need to stop at each space and see if that is an EXE name:
+			//
+			//     C:\Program.exe
+			//     C:\Program Files\Macromedia\Flash.exe
+			//     C:\Program Files\Macromedia\Flash 9\Players\SAFlashPlayer.exe
+
+			int endOfFilename = -1;
+			for (;;) {
+				int nextSpace = cmd.indexOf(' ', endOfFilename+1);
+				if (nextSpace == -1) {
+					endOfFilename = -1;
+					break;
+				}
+				String filename = cmd.substring(0, nextSpace);
+				if (!filename.toLowerCase().endsWith(".exe")) //$NON-NLS-1$
+					filename += ".exe"; //$NON-NLS-1$
+				if (new File(filename).exists()) {
+					endOfFilename = nextSpace;
+					break;
+				}
+				endOfFilename = nextSpace;
+			}
+			if (endOfFilename != -1 && endOfFilename < cmd.length())
+				cmd = cmd.substring(0, endOfFilename);
+		}
+		return cmd;
+	}
+
+	/*
+	 * @see flash.tools.debugger.IDebuggerCallbacks#launchDebugTarget(java.lang.String[])
+	 */
+	public Process launchDebugTarget(String[] cmd) throws IOException
+	{
+		return Runtime.getRuntime().exec(cmd);
+	}
+	
+	@Override
+	public Process launchDebugTarget(String[] cmd, ILauncher launcher) throws IOException {
+		return launcher.launch(cmd);
+	}
+	
+	/*
+	 * @see flash.tools.debugger.IDebuggerCallbacks#terminateDebugTarget(java.lang.Process)
+	 */
+	public void terminateDebugTarget(Process process) throws IOException
+	{
+		terminateDebugTarget(process, null);
+	}
+	
+	@Override
+	public void terminateDebugTarget(Process process, ILauncher launcher) throws IOException {
+		if(null == launcher)
+		{
+			process.destroy();
+		}
+		else
+		{
+			launcher.terminate(process);
+		}
+		
+	}
+	
+	public String queryWindowsRegistry(String key, String value) throws IOException
+	{
+		return queryWindowsRegistry(key, value, 0);
+	}
+
+	/**
+	 * This implementation of queryWindowsRegistry() does not make any native
+	 * calls.  I had to do it this way because it is too hard, at this point,
+	 * to add native code to the Flex code tree.
+	 */
+	public String queryWindowsRegistry(String key, String value, int registryBitMode) throws IOException
+	{
+		Process p = null;
+		String result = null;
+
+		List<String> arguments = new ArrayList<String>(6);
+		arguments.add("reg.exe"); //$NON-NLS-1$
+		arguments.add("query"); //$NON-NLS-1$
+		arguments.add(key);
+		if (value == null || value.length() == 0)
+		{
+			arguments.add("/ve"); //$NON-NLS-1$
+		}
+		else
+		{
+			arguments.add("/v"); //$NON-NLS-1$
+			arguments.add(value);
+		}
+
+		// This line must not be in try/catch -- if it throws an exception,
+		// we want that to propagate out to our caller.
+		p = Runtime.getRuntime().exec(arguments.toArray(new String[arguments.size()]));
+
+		try
+		{
+			BufferedReader reader = new BufferedReader(new InputStreamReader(p.getInputStream()));
+
+			String line;
+			while ((line = reader.readLine()) != null)
+			{
+				if (line.equalsIgnoreCase(key))
+				{
+					line = reader.readLine();
+					if (line != null)
+					{
+						Matcher matcher = registryValuePattern.matcher(line);
+						if (matcher.find()) {
+							result = matcher.group(1);
+						}
+					}
+					break;
+				}
+			}
+		}
+		catch (IOException e)
+		{
+			if (Trace.error)
+				e.printStackTrace();
+		}
+		finally
+		{
+			if (p != null)
+			{
+				p.destroy();
+				p = null;
+			}
+		}
+
+		return result;
+	}
+
+	/**
+	 * Default implementation does not know how to get the version
+	 * of an application.
+	 */
+	public int[] getAppVersion(File application) throws IOException {
+		return null;
+	}
+	
+	/**
+	 * Default application does not have any extra arguments for the
+	 * browser.
+	 */
+	public String[] getBrowserParameters(String uri)
+	{
+		return null;
+	}
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/Frame.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/Frame.java b/debugger/src/main/java/flash/tools/debugger/Frame.java
new file mode 100644
index 0000000..9c757ec
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/Frame.java
@@ -0,0 +1,122 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+/**
+ * The Frame object represents a single frame of the actionscript call stack.
+ * Each Frame contains a Location object, which identifies the line of source 
+ * for the frame, and a set of variables that are available within the frame.
+ * The set of variables includes a 'this' pointer, arguments passed into 
+ * the function and locals available within the scope of the function.
+ * A given frame is only valid when execution has suspended.  
+ * @since Version 2
+ */
+public interface Frame
+{
+	/**
+	 * Location object related to this frame.
+	 */
+	public Location getLocation();
+
+	/**
+	 * 'this' variable for the frame.  Will return null
+	 * if no 'this' pointer available for the frame.
+	 * @throws NoResponseException
+	 * @throws NotSuspendedException
+	 * @throws NotConnectedException
+	 */
+    public Variable getThis(Session s) throws NoResponseException, NotSuspendedException, NotConnectedException;
+
+	/**
+	 * Arguments that were passed into the function.  An empty
+	 * array is used to denote that no arguments were passed into 
+	 * this function scope.
+	 * @throws NoResponseException
+	 * @throws NotSuspendedException 
+	 * @throws NotConnectedException 
+	 */
+    public Variable[] getArguments(Session s) throws NoResponseException, NotSuspendedException, NotConnectedException;
+
+	/**
+	 * Locals used within this function scope.  An empty
+	 * array is used to denote no locals are available 
+	 * within this function scope.
+	 * @throws NoResponseException
+	 * @throws NotSuspendedException 
+	 * @throws NotConnectedException 
+	 */
+    public Variable[] getLocals(Session s) throws NoResponseException, NotSuspendedException, NotConnectedException;
+
+	/**
+	 * Returns a string which contains the raw signature of
+	 * the call.  This information can be used for display
+	 * purposes in the event the Location object contains
+	 * a null SourceFile, which happens when a call is
+	 * made into or through a non-debug executable.
+	 * The format of the string is one of the following:
+	 * <ul>
+	 *  <li> <code>declaringClass/[[namespace::]function]</code> (for regular functions) </li>
+	 *  <li> <code>declaringClass$cinit</code> (class constructor for statics) </li>
+	 *  <li> <code>declaringClass$iinit</code> (class instance ctor)</li>
+	 *  <li> <code>global$init</code> </li>
+	 * </ul>
+	 *<p>
+	 * where <code>declaringClass</code> is the name of the
+	 * class in which the function is declared (even if it
+	 * is an anonymous inner function); <code>namespace</code>
+	 * is the namespace of the function (the meaning of this
+	 * varies depending on whether the function is private,
+	 * protected etc.; see <code>Variable.getNamespace()</code>
+	 * for more information); and <code>function</code> is
+	 * the name of the function, or <code>""</code> if the
+	 * function is anonymous.
+	 *</p><p> 
+	 * If the signature is unknown then the value
+	 * "" will be returned.  Note: this may occur even when
+	 * Location contains a non-null SourceFile.
+	 * </p><p>
+	 * Examples:
+	 * <ul>
+	 * <li> <code>MyClass/myFunction</code> for a public function </li>
+	 * <li> <code>MyClass/MyClass::myFunction</code> for a private function </li>
+	 * <li> <code>MyClass/</code> for an anonymous inner function declared
+	 *      somewhere inside <code>MyClass</code> </li>
+	 * <li> <code>""</code> if unknown </li>
+	 * </ul>
+	 * </p>
+	 */
+	public String getCallSignature();
+
+	/**
+	 * Returns a list of objects which make up the scope chain of
+	 * this frame.
+	 * <p>
+	 * Some of the entries will be classes; some will be instances
+	 * of classes; some will be functions; etc.
+	 * <p>
+	 * <b>Bug:</b> Currently, this does <em>not</em> include any
+	 * scope chain entries which were created via "with var".
+	 */
+	public Variable[] getScopeChain(Session s) throws NoResponseException, NotSuspendedException, NotConnectedException;
+	
+	/**
+	 * Returns the worker ID associated to this frame. This will return
+	 * Isolate.DEFAULT_ID, that is, the main worker.
+	 */
+	public int getIsolateId();
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/IDebuggerCallbacks.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/IDebuggerCallbacks.java b/debugger/src/main/java/flash/tools/debugger/IDebuggerCallbacks.java
new file mode 100644
index 0000000..8c97bca
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/IDebuggerCallbacks.java
@@ -0,0 +1,150 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+import java.io.File;
+import java.io.IOException;
+
+/**
+ * Miscellaneous callbacks from the DJAPI to the debugger which is using it.
+ * 
+ * @author mmorearty
+ */
+public interface IDebuggerCallbacks
+{
+	/**
+	 * Tells the debugger to recompute the values which will be returned by
+	 * getHttpExe() and getPlayerExe().
+	 * 
+	 * This does NOT need to be called before the first call to either of
+	 * those functions.  The intent of this function is to allow the debugger
+	 * to cache any expensive calculations, but still allow for the possibility
+	 * of recalculating the values from time to time (e.g. when a new launch
+	 * is going to happen).
+	 */
+	public void recomputeExeLocations();
+
+	/**
+	 * Returns the executable of the browser to launch for http: URLs, or
+	 * <code>null</code> if not known.
+	 */
+	public File getHttpExe();
+	
+	/**
+	 * Returns the parameters to pass to the browser or null if non-existent.
+	 * If this is present, URL is assumed to already exist in this array.
+	 */
+	public String[] getBrowserParameters(String uri);
+	
+	/**
+	 * Returns the executable for the standalone Flash player, or <code>null</code>
+	 * if not known.
+	 */
+	public File getPlayerExe();
+
+	/**
+	 * Returns a name such as "firefox" or "Web browser", the name of the
+	 * browser, useful for error messages. Never returns <code>null</code>.
+	 */
+	public String getHttpExeName();
+
+	/**
+	 * Returns a name such as "SAFlashPlayer.exe" or "gflashplayer" or "Flash
+	 * player", the name of the standalone player, useful for error messages.
+	 * Never returns <code>null</code>.
+	 */
+	public String getPlayerExeName();
+
+	/**
+	 * Launches a debug target.  The arguments are the same as those of
+	 * Runtime.exec().
+	 */
+	public Process launchDebugTarget(String[] cmd) throws IOException;
+
+	/**
+	 * Terminates a debug target process.
+	 */
+	public void terminateDebugTarget(Process process) throws IOException;
+	
+	/**
+	 * Launches a debug target using the launcher instance<code>ILauncher.launch(cmd)</code>.
+	 * 
+	 */
+	public Process launchDebugTarget(String[] cmd, ILauncher launcher) throws IOException;
+
+	/**
+	 * Terminates a debug target process by invoking <code>ILauncher.terminate(process)</code>
+	 */
+	public void terminateDebugTarget(Process process, ILauncher launcher) throws IOException;
+
+
+	/**
+	 * Query the Windows registry.
+	 * 
+	 * @param key
+	 *            The registry key, in a format suitable for the REG.EXE
+	 *            program. You must use full key names such as
+	 *            HKEY_LOCAL_MACHINE rather the shorter abbreviations such as
+	 *            HKLM.
+	 * @param value
+	 *            The value within that key, or null for the unnamed ("empty")
+	 *            value
+	 * @return the value stored at the location, or null if key or value was not
+	 *         found
+	 * @throws IOException
+	 *             indicates the registry query failed -- warning, this can
+	 *             really happen! Some implementations of this function don't
+	 *             work on Windows 2000. So, this function should not be counted
+	 *             on too heavily -- you should have a backup plan.
+	 */
+	public String queryWindowsRegistry(String key, String value) throws IOException;
+	
+	/**
+	 * Same as queryWindowsRegistry, but allows specific access to the 32-bit
+	 * or 64-bit part of the registry.
+	 */
+	public String queryWindowsRegistry(String key, String value, int registryBitMode) throws IOException;
+
+	/**
+	 * Returns the version number of an application. For example, Firefox 3.5.4
+	 * would return new int[] { 3, 5 }.
+	 * <p>
+	 * As of this writing, the only thing this is used for is to determine, on
+	 * Windows, whether the user is running IE 8; if he is, we need to pass the
+	 * "-noframemerging" command-line argument. It is generally okay to just
+	 * return <code>null</code> from this function; a robust implementation is
+	 * not required.
+	 * 
+	 * @param application
+	 *            the application whose version number is desired. On Windows,
+	 *            this will typically be a path to a .exe file. On Mac, it may
+	 *            point to a .app directory such as "/Applications/Safari.app",
+	 *            or it may point to the underlying binary, such as
+	 *            "/Applications/Safari.app/Contents/MacOS/Safari".
+	 * @return an array of two integers if the version can be determined, or
+	 *         null if it cannot be determined. The first integer is the major
+	 *         version number, and the second integer is the minor version
+	 *         number. More detailed information cannot be provided, because
+	 *         this function needs to be cross- platform, and the format of
+	 *         version information tends to vary widely from one platform to
+	 *         another.
+	 * @throws IOException
+	 *             e.g. for file not found, etc.
+	 */
+	public int[] getAppVersion(File application) throws IOException;
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/ILaunchNotification.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/ILaunchNotification.java b/debugger/src/main/java/flash/tools/debugger/ILaunchNotification.java
new file mode 100644
index 0000000..e01d724
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/ILaunchNotification.java
@@ -0,0 +1,39 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+import java.io.IOException;
+
+/**
+ * Used to notify caller in case of ADL Exit Code 1: Successful invocation of an already running 
+ * AIR application. ADL exits immediately.
+ * 
+ * @author sakkus
+ */
+public interface ILaunchNotification
+{
+	/**
+	 * Notifies the listener that the launch is done, and, if it failed,
+	 * an exception with information about why it failed.
+	 * 
+	 * @param e
+	 *            an exception if the launch failed, or null if the launch
+	 *            succeeded.
+	 */
+	public void notify(IOException e);
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/ILauncher.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/ILauncher.java b/debugger/src/main/java/flash/tools/debugger/ILauncher.java
new file mode 100644
index 0000000..68c87f7
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/ILauncher.java
@@ -0,0 +1,49 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package flash.tools.debugger;
+
+import java.io.IOException;
+
+/**
+ * A ILauncher which handles the launching of the URI or the command.
+ * 
+ * ILauncher is to provide more flexibility to handle the Player launch in different platforms.
+ * 
+ * @author ugs
+ *
+ */
+public interface ILauncher {
+
+	/**
+	 * Launches the debug target. 
+	 * 
+	 * @param cmd - Launch URL and other arguments
+	 * @return A handle to the process.
+	 * 
+	 * @throws IOException
+	 */
+	public Process launch(String[] cmd) throws IOException;
+
+	/**
+	 * Terminate the process started by launch method.
+	 * @param process - process started by launch.
+	 * @throws IOException
+	 */
+	public void terminate(Process process) throws IOException;
+	
+	
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/IProgress.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/IProgress.java b/debugger/src/main/java/flash/tools/debugger/IProgress.java
new file mode 100644
index 0000000..f63ec68
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/IProgress.java
@@ -0,0 +1,36 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+/**
+ * A simple interface to report progress on some operation.
+ * 
+ * @author mmorearty
+ */
+public interface IProgress
+{
+	/**
+	 * Reports how much work has been done.
+	 * 
+	 * @param current
+	 *            how much progress has been made toward the total
+	 * @param total
+	 *            the total amount of work
+	 */
+	public void setProgress(int current, int total);
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/InProgressException.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/InProgressException.java b/debugger/src/main/java/flash/tools/debugger/InProgressException.java
new file mode 100644
index 0000000..3bf6f2a
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/InProgressException.java
@@ -0,0 +1,28 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+/**
+ * InProgressException is thrown when a request cannot
+ * be fulfilled because some other activity is currently
+ * taking place that will alter the result of the request.
+ */
+public class InProgressException extends PlayerDebugException
+{
+    private static final long serialVersionUID = -8307030350432666820L;
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/Isolate.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/Isolate.java b/debugger/src/main/java/flash/tools/debugger/Isolate.java
new file mode 100644
index 0000000..982c2dd
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/Isolate.java
@@ -0,0 +1,40 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package flash.tools.debugger;
+
+/**
+ * The Isolate object uniquely identifies a "Worker" in ActionScript.
+ * Workers are conceptually similar to Threads, but their implementation
+ * closely follows more that of a web worker than an actual OS Thread.
+ * 
+ * By default there is a default isolate object with id DEFAULT_ID.
+ * @author anirudhs
+ *
+ */
+public interface Isolate {
+	
+	public static final int DEFAULT_ID = 1;
+	
+	/**
+	 * Get the unique integer ID associated with the
+	 * worker. This is Isolate.DEFAULT_ID for the
+	 * primordial. 
+	 * @return unique integer ID
+	 */
+	public int getId();
+	
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/IsolateController.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/IsolateController.java b/debugger/src/main/java/flash/tools/debugger/IsolateController.java
new file mode 100644
index 0000000..ed09477
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/IsolateController.java
@@ -0,0 +1,184 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package flash.tools.debugger;
+
+import flash.tools.debugger.expression.PlayerFaultException;
+
+/**
+ * Worker specific debug session commands. These are a subset of Session that
+ * can be individually routed to a specific worker (including the main worker if
+ * the player does not support concurrency). This is implemented by
+ * PlayerSession and used by the getWorkerSession() api.
+ * 
+ * @see flash.tools.debugger.IsolateSession,
+ *      flash.tools.debugger.Session#getWorkerSession(int)
+ * @author anirudhs
+ * 
+ */
+public interface IsolateController {
+	
+	/**
+	 * @see flash.tools.debugger.Session#resume()
+	 */
+	public void resumeWorker(int isolateId) throws NotSuspendedException, NotConnectedException, NoResponseException;
+
+	/**
+	 * @see flash.tools.debugger.Session#suspend()
+	 */
+	public void suspendWorker(int isolateId) throws SuspendedException, NotConnectedException, NoResponseException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#isSuspended()
+	 */
+	public boolean isWorkerSuspended(int isolateId) throws NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#isSuspended()
+	 */
+	public int suspendReasonWorker(int isolateId) throws NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#getFrames()
+	 */
+	public Frame[] getFramesWorker(int isolateId) throws NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#stepInto()
+	 */
+	public void stepIntoWorker(int isolateId) throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#stepOut()
+	 */
+	public void stepOutWorker(int isolateId)  throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#stepOver()
+	 */
+	public void stepOverWorker(int isolateId) throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#stepContinue()
+	 */
+	public void stepContinueWorker(int isolateId) throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#getSwfs()
+	 */
+	public SwfInfo[] getSwfsWorker(int isolateId) throws NoResponseException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#setBreakpoint(int, int)
+	 */
+	public Location setBreakpointWorker(int fileId, int lineNum, int isolateId) throws NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#getWatchList()
+	 */
+	public Watch[] getWatchListWorker(int isolateId) throws NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#getVariableList()
+	 */
+	public Variable[] getVariableListWorker(int isolateId) throws NotSuspendedException, NoResponseException, NotConnectedException, VersionException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#getValue(long)
+	 */
+	public Value getValueWorker(long valueId, int isolateId) throws NotSuspendedException, NoResponseException, NotConnectedException;
+
+	/**
+	 * @see flash.tools.debugger.Session#getGlobal(String)
+	 */
+	public Value getGlobalWorker(String name, int isolateId) throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#evalIs(Value, Value)
+	 */
+	public boolean evalIsWorker(Value value, Value type, int isolateId) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * @see flash.tools.debugger.Session#evalIs(Value, String)
+	 */
+	public boolean evalIsWorker(Value value, String type, int isolateId) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * @see flash.tools.debugger.Session#evalInstanceof(Value, Value)
+	 */
+	public boolean evalInstanceofWorker(Value value, Value type, int isolateId) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * @see flash.tools.debugger.Session#evalInstanceof(Value, String)
+	 */
+	public boolean evalInstanceofWorker(Value value, String type, int isolateId) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * @see flash.tools.debugger.Session#evalIn(Value, Value)
+	 */
+	public boolean evalInWorker(Value property, Value object, int isolateId) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * @see flash.tools.debugger.Session#evalAs(Value, Value)
+	 */
+	public Value evalAsWorker(Value value, Value type, int isolateId) throws PlayerDebugException, PlayerFaultException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#callFunction(Value, String, Value[])
+	 */
+	public Value callFunctionWorker(Value thisObject, String functionName, Value[] args, int isolateId) throws PlayerDebugException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#callConstructor(String, Value[])
+	 */
+	public Value callConstructorWorker(String classname, Value[] args, int isolateId) throws PlayerDebugException;
+
+	/**
+	 * @see flash.tools.debugger.Session#setExceptionBreakpoint(String)
+	 */
+	public boolean setExceptionBreakpointWorker(String exceptionClass, int isolateId) throws NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#clearExceptionBreakpoint(String)
+	 */
+	public boolean clearExceptionBreakpointWorker(String exceptionClass, int isolateId) throws NoResponseException, NotConnectedException;
+
+	/**
+	 * @see flash.tools.debugger.Session#breakOnCaughtExceptions(boolean)
+	 */
+	public void breakOnCaughtExceptions(boolean b, int isolateId) throws NotSupportedException, NoResponseException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#supportsWatchpoints()
+	 */
+	public boolean supportsWatchpoints(int isolateId);
+	
+	/**
+	 * @see flash.tools.debugger.Session#playerCanBreakOnAllExceptions()
+	 */
+	public boolean playerCanBreakOnAllExceptions(int isolateId);
+	
+	/**
+	 * @see flash.tools.debugger.Session#supportsWideLineNumbers()
+	 */
+	public boolean supportsWideLineNumbers(int isolateId);
+	
+	/**
+	 * @see flash.tools.debugger.Session#playerCanCallFunctions(String)
+	 */
+	public boolean playerCanCallFunctions(int isolateId);
+	
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/IsolateSession.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/IsolateSession.java b/debugger/src/main/java/flash/tools/debugger/IsolateSession.java
new file mode 100644
index 0000000..6b57d62
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/IsolateSession.java
@@ -0,0 +1,177 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package flash.tools.debugger;
+
+import flash.tools.debugger.expression.PlayerFaultException;
+
+/**
+ * Used to issue commands to a particular worker (isolate).
+ * @see Session
+ * @author anirudhs
+ */
+public interface IsolateSession {
+	
+	/**
+	 * @see flash.tools.debugger.Session#resume()
+	 */
+	public void resume() throws NotSuspendedException, NotConnectedException, NoResponseException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#suspend()
+	 */
+	public void suspend() throws SuspendedException, NotConnectedException, NoResponseException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#isSuspended()
+	 */
+	public boolean isSuspended() throws NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#isSuspended()
+	 */
+	public int suspendReason() throws NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#getFrames()
+	 */
+	public Frame[] getFrames() throws NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#stepInto()
+	 */
+	public void stepInto() throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#stepOut()
+	 */
+	public void stepOut()  throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#stepOver()
+	 */
+	public void stepOver() throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#stepContinue()
+	 */
+	public void stepContinue() throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#getSwfs()
+	 */
+	public SwfInfo[] getSwfs() throws NoResponseException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#setBreakpoint(int, int)
+	 */
+	public Location setBreakpoint(int fileId, int lineNum) throws NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#getWatchList()
+	 */
+	public Watch[] getWatchList() throws NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#getVariableList()
+	 */
+	public Variable[] getVariableList() throws NotSuspendedException, NoResponseException, NotConnectedException, VersionException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#getValue(long)
+	 */
+	public Value getValue(long valueId) throws NotSuspendedException, NoResponseException, NotConnectedException;
+
+	/**
+	 * @see flash.tools.debugger.Session#getGlobal(String)
+	 */
+	public Value getGlobal(String name) throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#evalIs(Value, Value)
+	 */
+	public boolean evalIs(Value value, Value type) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * @see flash.tools.debugger.Session#evalIs(Value, String)
+	 */
+	public boolean evalIs(Value value, String type) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * @see flash.tools.debugger.Session#evalInstanceof(Value, Value)
+	 */
+	public boolean evalInstanceof(Value value, Value type) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * @see flash.tools.debugger.Session#evalInstanceof(Value, String)
+	 */
+	public boolean evalInstanceof(Value value, String type) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * @see flash.tools.debugger.Session#evalIn(Value, Value)
+	 */
+	public boolean evalIn(Value property, Value object) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * @see flash.tools.debugger.Session#evalAs(Value, Value)
+	 */
+	public Value evalAs(Value value, Value type) throws PlayerDebugException, PlayerFaultException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#resume()
+	 */
+	public Value callFunction(Value thisObject, String functionName, Value[] args) throws PlayerDebugException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#callFunction(Value, String, Value[])
+	 */
+	public Value callConstructor(String classname, Value[] args) throws PlayerDebugException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#setExceptionBreakpoint(String)
+	 */
+	public boolean setExceptionBreakpoint(String exceptionClass) throws NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#clearExceptionBreakpoint(String)
+	 */
+	public boolean clearExceptionBreakpoint(String exceptionClass) throws NoResponseException, NotConnectedException;
+	
+	/**
+	 * @see flash.tools.debugger.Session#breakOnCaughtExceptions(boolean)
+	 */
+	public void breakOnCaughtExceptions(boolean b) throws NotSupportedException, NoResponseException;
+
+	/**
+	 * @see flash.tools.debugger.Session#supportsWatchpoints()
+	 */
+	public boolean supportsWatchpoints();
+	
+	/**
+	 * @see flash.tools.debugger.Session#playerCanBreakOnAllExceptions()
+	 */
+	public boolean playerCanBreakOnAllExceptions();
+	
+	/**
+	 * @see flash.tools.debugger.Session#supportsWideLineNumbers()
+	 */
+	public boolean supportsWideLineNumbers();
+	
+	/**
+	 * @see flash.tools.debugger.Session#playerCanCallFunctions()
+	 */
+	public boolean playerCanCallFunctions();
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/Location.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/Location.java b/debugger/src/main/java/flash/tools/debugger/Location.java
new file mode 100644
index 0000000..bf6103c
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/Location.java
@@ -0,0 +1,41 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+/**
+ * The Location object identifies a specific line number with a SourceFile.
+ * It is used for breakpoint manipulation and obtaining stack frame context.
+ */
+public interface Location
+{
+	/**
+	 * Source file for this location 
+	 */
+	public SourceFile getFile();
+
+	/**
+	 * Line number within the source for this location 
+	 */
+    public int getLine();
+    
+    /**
+     * Worker to which this location belongs.
+     */
+    public int getIsolateId();
+
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/NoResponseException.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/NoResponseException.java b/debugger/src/main/java/flash/tools/debugger/NoResponseException.java
new file mode 100644
index 0000000..b6756e6
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/NoResponseException.java
@@ -0,0 +1,61 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * NoResponseException is thrown when the Player does
+ * not respond to the command that was issued.
+ * 
+ * The field m_waitedFor contains the number of
+ * milliseconds waited for the response.
+ */
+public class NoResponseException extends PlayerDebugException
+{
+	private static final long serialVersionUID = -3704426811630352537L;
+    
+    /**
+	 * Number of milliseconds that elapsed causing the timeout
+	 * -1 means unknown.
+	 */
+	public int m_waitedFor;
+
+	public NoResponseException(int t) 
+	{
+		m_waitedFor = t;
+	}
+
+	@Override
+	public String getMessage()
+	{
+		Map<String, String> args = new HashMap<String, String>();
+		String formatString;
+		if (m_waitedFor != -1 && m_waitedFor != 0)
+		{
+			formatString = "timeout"; //$NON-NLS-1$
+			args.put("time", Integer.toString(m_waitedFor)); //$NON-NLS-1$
+		}
+		else
+		{
+			formatString = "timeoutAfterUnknownDelay"; //$NON-NLS-1$
+		}
+		return Bootstrap.getLocalizationManager().getLocalizedTextString(formatString, args);
+	}
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/NotConnectedException.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/NotConnectedException.java b/debugger/src/main/java/flash/tools/debugger/NotConnectedException.java
new file mode 100644
index 0000000..662a10a
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/NotConnectedException.java
@@ -0,0 +1,33 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+/**
+ * NotConnectedException is thrown when the Session
+ * is no longer connnected to the Player
+ */
+public class NotConnectedException extends PlayerDebugException
+{
+	private static final long serialVersionUID = -9087367591357152206L;
+
+    @Override
+	public String getMessage()
+	{
+		return Bootstrap.getLocalizationManager().getLocalizedTextString("notConnected"); //$NON-NLS-1$
+	}
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/NotSupportedException.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/NotSupportedException.java b/debugger/src/main/java/flash/tools/debugger/NotSupportedException.java
new file mode 100644
index 0000000..8e6dbd3
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/NotSupportedException.java
@@ -0,0 +1,39 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+/**
+ * Indicates that a debugger feature is not supported by the Flash
+ * player that is being targeted.  For example, newer players
+ * support the ability to have the debugger call arbitrary
+ * functions, but older ones do not.
+ * 
+ * @author Mike Morearty
+ */
+public class NotSupportedException extends PlayerDebugException {
+	private static final long serialVersionUID = -8873935118857320824L;
+
+	/**
+	 * @param s an error message, e.g. "Target player does not support
+	 * function calls," or "Target player does not support watchpoints".
+	 */
+	public NotSupportedException(String s)
+	{
+		super(s);
+	}
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/NotSuspendedException.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/NotSuspendedException.java b/debugger/src/main/java/flash/tools/debugger/NotSuspendedException.java
new file mode 100644
index 0000000..c5dad0e
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/NotSuspendedException.java
@@ -0,0 +1,33 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+/**
+ * NotSuspendedException is thrown when the Player 
+ * is in a state for which the action cannot be performed.
+ */
+public class NotSuspendedException extends PlayerDebugException
+{
+	private static final long serialVersionUID = 1373922470760042675L;
+
+    @Override
+	public String getMessage()
+	{
+		return Bootstrap.getLocalizationManager().getLocalizedTextString("notSuspended"); //$NON-NLS-1$
+	}
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/Player.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/Player.java b/debugger/src/main/java/flash/tools/debugger/Player.java
new file mode 100644
index 0000000..8b83250
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/Player.java
@@ -0,0 +1,82 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+import java.io.File;
+
+/**
+ * Describes a Flash player.
+ * 
+ * @author mmorearty
+ */
+public interface Player
+{
+	/**
+	 * Indicates a standalone Flash player, e.g. FlashPlayer.exe.
+	 * 
+	 * @see #getType()
+	 */
+	public static final int STANDALONE = 1;
+
+	/**
+	 * Indicates a Netscape-plugin Flash player, e.g. NPSWF32.dll. Used on
+	 * Windows by all Netscape-based browsers (e.g. Firefox etc.), and on Mac
+	 * and Linux by all browsers.
+	 * 
+	 * @see #getType()
+	 */
+	public static final int NETSCAPE_PLUGIN = 2;
+
+	/**
+	 * Indicates an ActiveX-control Flash player, e.g. Flash.ocx.  Used on Windows
+	 * by Internet Explorer.
+	 * 
+	 * @see #getType()
+	 */
+	public static final int ACTIVEX = 3;
+
+	/**
+	 * Indicates the Flash player inside AIR.
+	 */
+	public static final int AIR = 4;
+
+	/**
+	 * Returns what type of Player this is: <code>STANDALONE</code>, <code>NETSCAPE_PLUGIN</code>,
+	 * <code>ACTIVEX</code>, or <code>AIR</code>.
+	 */
+	public int getType();
+
+	/**
+	 * Returns the path to the Flash player file -- e.g. the path to
+	 * FlashPlayer.exe, NPSWF32.dll, Flash.ocx, or adl.exe -- or
+	 * <code>null</code> if not known. (Filenames are obviously
+	 * platform-specific.)
+	 * 
+	 * <p>
+	 * Note that the file is not guaranteed to exist. You can use File.exists()
+	 * to test that.
+	 */
+	public File getPath();
+
+	/**
+	 * Returns the web browser with which this player is associated,
+	 * or <code>null</code> if this is the standalone player or AIR,
+	 * or if we're not sure which browser will be run.
+	 */
+	public Browser getBrowser();
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/PlayerDebugException.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/PlayerDebugException.java b/debugger/src/main/java/flash/tools/debugger/PlayerDebugException.java
new file mode 100644
index 0000000..a8e9f7c
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/PlayerDebugException.java
@@ -0,0 +1,30 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+/**
+ * PlayerDebugException is the base class for all
+ * exceptions thrown by the playerdebug API
+ */
+public class PlayerDebugException extends Exception
+{
+	private static final long serialVersionUID = 757986761482127248L;
+
+    public PlayerDebugException()				{ super(); }
+	public PlayerDebugException(String s)		{ super(s); }
+}

http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/07f5a7de/debugger/src/main/java/flash/tools/debugger/Session.java
----------------------------------------------------------------------
diff --git a/debugger/src/main/java/flash/tools/debugger/Session.java b/debugger/src/main/java/flash/tools/debugger/Session.java
new file mode 100644
index 0000000..35ebed4
--- /dev/null
+++ b/debugger/src/main/java/flash/tools/debugger/Session.java
@@ -0,0 +1,604 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package flash.tools.debugger;
+
+import flash.tools.debugger.events.DebugEvent;
+import flash.tools.debugger.expression.PlayerFaultException;
+
+/**
+ * The Session object manages all aspects of debugging session with
+ * the Flash Player.  A program can be suspended, resumed, single
+ * stepping can be performed and state information can be obtained
+ * through this object.
+ */
+public interface Session
+{
+	/**
+	 * Returns the URL that identifies this Session.
+	 * Note: this may not be unique across Sessions if
+	 * the same launching mechanism and SWF are used.
+	 * @return URI received from the connected Player.
+	 * It identifies the debugging session
+	 */
+	public String getURI();
+
+	/**
+	 * Returns the Process object, if any, that triggered this Session.
+	 * @return the Process object that was used to create this Session.
+	 * If SessionManager.launch() was not used, then null is returned.
+	 */
+	public Process getLaunchProcess();
+
+	/**
+	 * Adjust the preferences for this session; see SessionManager
+	 * for a list of valid preference strings.
+	 *
+	 * If an invalid preference is passed, it will be silently ignored.
+	 * @param pref preference name, one of the strings listed above
+	 * @param value value to set for preference
+	 */
+	public void setPreference(String pref, int value);
+
+	/**
+	 * Return the value of a particular preference item
+	 *
+	 * @param pref preference name, one of the strings listed in <code>SessionManager</code>
+	 * @throws NullPointerException if pref does not exist
+	 * @see SessionManager
+	 */
+	public int getPreference(String pref) throws NullPointerException;
+
+	/**
+	 * Is the Player currently connected for this session.  This function
+	 * must be thread-safe.
+	 *
+	 * @return true if connection is alive
+	 */
+	public boolean isConnected();
+
+	/**
+	 * Allow the session to start communicating with the player.  This
+	 * call must be made PRIOR to any other Session method call.
+	 * @return true if bind was successful.
+	 * @throws VersionException connected to Player which does not support all API completely
+	 */
+	public boolean bind() throws VersionException;
+
+	/**
+	 * Permanently stops the debugging session and breaks the
+	 * connection.  If this Session is used for any subsequent
+	 * calls exceptions will be thrown.
+	 * <p>
+	 * Note: this method allows the caller to disconnect
+	 * from the debugging session (and Player) without
+	 * terminating the Player.  A subsequent call to terminate()
+	 * will destroy the Player process.
+	 * <p>
+	 * Under normal circumstances this method need not be
+	 * called since a call to terminate() performs both
+	 * actions of disconnecting from the Player and destroying
+	 * the Player process.
+	 */
+	public void unbind();
+
+	/**
+	 * Permanently stops the debugging session and breaks the connection. If
+	 * this session ID is used for any subsequent calls exceptions will be
+	 * thrown.
+	 * <p>
+	 * Note that due to platform and browser differences, it should not be
+	 * assumed that this function will necessarily kill the process being
+	 * debugged. For example:
+	 *
+	 * <ul>
+	 * <li> On all platforms, Firefox cannot be terminated. This is because when
+	 * we launch a new instance of Firefox, Firefox actually checks to see if
+	 * there is another already-running instance. If there is, then the new
+	 * instance just passes control to that old instance. So, the debugger
+	 * doesn't know the process ID of the browser. It would be bad to attempt to
+	 * figure out the PID and then kill that process, because the user might
+	 * have other browser windows open that they don't want to lose. </li>
+	 * <li> On Mac, similar problems apply to the Safari and Camino browsers:
+	 * all browsers are launched with /usr/bin/open, so we never know the
+	 * process ID, and we can't kill it. However, for Safari and Camino, what we
+	 * do attempt to do is communicate with the browser via AppleScript, and
+	 * tell it to close the window of the program that is being debugged. </li>
+	 * </ul>
+	 *
+	 * <p>
+	 * If SessionManager.launch() was used to initiate the Session then calling
+	 * this function also causes getLaunchProcess().destroy() to be called.
+	 * <p>
+	 * Note: this method first calls unbind() if needed.
+	 */
+	public void terminate();
+
+	/**
+	 * Continue a halted session.  Execution of the ActionScript
+	 * will commence until a reason for halting exists. That
+	 * is, a breakpoint is reached or the <code>suspend()</code> method is called.
+	 * <p>
+	 * This method will NOT block.  It will return immediately
+	 * after the Player resumes execution.  Use the isSuspended
+	 * method to determine when the Player has halted.
+	 *
+	 * @throws NoResponseException if times out
+	 * @throws NotSuspendedException if Player is already running
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 */
+	public void resume() throws NotSuspendedException, NotConnectedException, NoResponseException;
+
+	/**
+	 * Halt a running session.  Execution of the ActionScript
+	 * will stop at the next possible breakpoint.
+	 * <p>
+	 * This method WILL BLOCK until the Player halts for some
+	 * reason or an error occurs. During this period, one or
+	 * more callbacks may be initiated.
+	 *
+	 * @throws NoResponseException if times out
+	 * @throws SuspendedException if Player is already suspended
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 */
+	public void suspend() throws SuspendedException, NotConnectedException, NoResponseException;
+	
+	/**
+	 * Is the Player currently halted awaiting requests, such as continue,
+	 * stepOut, stepIn, stepOver. This function is guaranteed to be thread-safe.
+	 *
+	 * @return true if player halted
+	 * @throws NotConnectedException
+	 *             if Player is disconnected from Session
+	 */
+	public boolean isSuspended() throws NotConnectedException;
+
+	/**
+	 * Returns a SuspendReason integer which indicates
+	 * why the Player has suspended execution.
+	 * @return see SuspendReason
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 */
+	public int suspendReason() throws NotConnectedException;
+	
+	/**
+	 * Returns an array of frames that identify the location and contain
+	 * arguments, locals and 'this' information for each frame on the
+	 * function call stack.   The 0th frame contains the current location
+	 * and context for the actionscript program.  Likewise
+	 * getFrames[getFrames().length] is the topmost (or outermost) frame
+	 * of the call stack.
+	 * @return array of call frames with 0th element representing the current frame.
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 */
+	public Frame[] getFrames() throws NotConnectedException;
+	
+	/**
+	 * Step to the next executable source line within the
+	 * program, will enter into functions.
+	 * <p>
+	 * This method will NOT block.  It will return immediately
+	 * after the Player resumes execution.  Use the isSuspended
+	 * method to determine when the Player has halted.
+	 *
+	 * @throws NoResponseException if times out
+	 * @throws NotSuspendedException if Player is running
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 */
+	public void stepInto() throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * Step out of the current method/function onto the
+	 * next executable soruce line.
+	 * <p>
+	 * This method will NOT block.  It will return immediately
+	 * after the Player resumes execution.  Use the isSuspended
+	 * method to determine when the Player has halted.
+	 *
+	 * @throws NoResponseException if times out
+	 * @throws NotSuspendedException if Player is running
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 */
+	public void stepOut()  throws NotSuspendedException, NoResponseException, NotConnectedException;
+
+	/**
+	 * Step to the next executable source line within
+	 * the program, will NOT enter into functions.
+	 * <p>
+	 * This method will NOT block.  It will return immediately
+	 * after the Player resumes execution.  Use the isSuspended
+	 * method to determine when the Player has halted.
+	 *
+	 * @throws NoResponseException if times out
+	 * @throws NotSuspendedException if Player is running
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 */
+	public void stepOver() throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * Continue the process of stepping.
+	 * This call should only be issued if a previous
+	 * stepXXX() call was made and the Player suspended
+	 * execution due to a breakpoint being hit.
+	 * That is getSuspendReason() == SuspendReason.Break
+	 * This operation can be used for assisting with
+	 * the processing of conditional breakpoints.
+	 * @throws NoResponseException if times out
+	 * @throws NotSuspendedException if Player is running
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 */
+	public void stepContinue() throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * Obtain information about the various SWF(s) that have been
+	 * loaded into the Player, for this session.
+	 *
+	 * Note: As SWFs are loaded by the Player a SwfLoadedEvent is
+	 * fired.  At this point, a call to getSwfInfo() will provide
+	 * updated information.
+	 *
+	 * @return array of records describing the SWFs
+	 * @throws NoResponseException if times out
+	 */
+	public SwfInfo[] getSwfs() throws NoResponseException;
+	
+	/**
+	 * Get a list of the current breakpoints.  No specific ordering
+	 * of the breakpoints is implied by the array.
+	 * @return breakpoints currently set.
+	 * @throws NoResponseException if times out
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 */
+	public Location[] getBreakpointList() throws NoResponseException, NotConnectedException;
+
+	/**
+	 * Set a breakpoint on a line within the given file.
+	 * <p>
+	 * <em>Warning:</em> <code>setBreakpoint()</code> and
+	 * <code>clearBreakpoint()</code> do not keep track of how many times they
+	 * have been called for a given Location. For example, if you make two calls
+	 * to <code>setBreakpoint()</code> for file X.as line 10, and then one
+	 * call to <code>clearBreakpoint()</code> for that same file and line,
+	 * then the breakpoint is gone. So, the caller is responsible for keeping
+	 * track of whether the user has set two breakpoints at the same location.
+	 *
+	 * @return null if breakpoint not set, otherwise
+	 * Location of breakpoint.
+	 * @throws NoResponseException if times out
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 */
+	public Location setBreakpoint(int fileId, int lineNum) throws NoResponseException, NotConnectedException;
+	
+	/**
+	 * Remove a breakpoint at given location. The Location obtain can be a
+	 * clone/copy of a Location object returned from a previous call to
+	 * getBreakpointList().
+	 * <p>
+	 * <em>Warning:</em> <code>setBreakpoint()</code> and
+	 * <code>clearBreakpoint()</code> do not keep track of how many times they
+	 * have been called for a given Location. For example, if you make two calls
+	 * to <code>setBreakpoint()</code> for file X.as line 10, and then one
+	 * call to <code>clearBreakpoint()</code> for that same file and line,
+	 * then the breakpoint is gone. So, the caller is responsible for keeping
+	 * track of whether the user has set two breakpoints at the same location.
+	 *
+	 * @return null if breakpoint was not removed.
+	 * @throws NoResponseException
+	 *             if times out
+	 * @throws NotConnectedException
+	 *             if Player is disconnected from Session
+	 */
+	public Location clearBreakpoint(Location location) throws NoResponseException, NotConnectedException;
+
+	/**
+	 * Get a list of the current watchpoint.  No specific ordering
+	 * of the watchpoints is implied by the array.  Also, the
+	 * list may contain watchpoints that are no longer relevant due
+	 * to the variable going out of scope.
+	 * @return watchpoints currently set.
+	 * @throws NoResponseException if times out
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 * @since Version 2
+	 */
+	public Watch[] getWatchList() throws NoResponseException, NotConnectedException;
+	
+	/**
+	 * Set a watchpoint on a given variable.  A watchpoint is used
+	 * to suspend Player execution upon access of a particular variable.
+	 * If the variable upon which the watchpoint is set goes out of scope,
+	 * the watchpoint will NOT be automatically removed.
+	 * <p>
+	 * Specification of the variable item to be watched requires two
+	 * pieces of information (similar to setScalarMember())
+	 * The Variable and the name of the particular member to be watched
+	 * within the variable.
+	 * For example if the watchpoint is to be applied to 'a.b.c'.  First the
+	 * Value for object 'a.b' must be obtained and then the call
+	 * setWatch(v, "c", ...) can be issued.
+	 * The watchpoint can be triggered (i.e. the Player suspended) when either a read
+	 * or write (or either) occurs on the variable.  If the Player is suspended
+	 * due to a watchpoint being fired, then the suspendReason() call will
+	 * return SuspendReason.WATCH.
+	 * <p>
+	 * Setting a watchpoint multiple times on the same variable will result
+	 * in the old watchpoint being removed from the list and a new watchpoint
+	 * being added to the end of the list.
+	 * <p>
+	 * Likewise, if a previously existing watchpoint is modified by
+	 * specifiying a different kind variable then the old watchpoint
+	 * will be removed from the list and a new watchpoint will be added
+	 * to the end of the list.
+	 *
+	 * @param v the variable, upon whose member, the watch is to be placed.
+	 * @param varName is the mmeber name upon which the watch
+	 * should be placed.  This variable name may NOT contain the dot ('.')
+	 * character and MUST be a member of v.
+	 * @param kind access type that will trigger the watchpoint to fire --
+	 * read, write, or read/write.  See <code>WatchKind</code>.
+	 * @return null if watchpoint was not created.
+	 * @throws NoResponseException if times out
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 * @throws NotSupportedException if the Player does not support watchpoints,
+	 * or does not support watchpoints on this particular member (e.g. because
+	 * it is a getter or a dynamic variable).
+	 * @since Version 2
+	 * @see WatchKind
+	 */
+	public Watch setWatch(Value v, String memberName, int kind) throws NoResponseException, NotConnectedException, NotSupportedException;
+	
+	/**
+	 * Enables or disables a watchpoint.
+	 *
+	 * @param watch
+	 *            the watch to enable or disable
+	 * @param enabled
+	 *            whether to enable it or disable it
+	 * @throws NotSupportedException
+	 * @throws NotConnectedException
+	 * @throws NoResponseException
+	 */
+	public Watch setWatch(Watch watch) throws NoResponseException, NotConnectedException, NotSupportedException;
+
+	/**
+	 * Remove a previously created watchpoint.  The watchpoint
+	 * that was removed will be returned upon a sucessful call.
+	 * @return null if watchpoint was not removed.
+	 * @throws NoResponseException if times out
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 * @since Version 2
+	 */
+	public Watch clearWatch(Watch watch) throws NoResponseException, NotConnectedException;
+	
+	/**
+	 * Obtains a list of variables that are local to the current
+	 * halted state.
+	 * @deprecated As of version 2.
+	 * @see Frame#getLocals
+	 */
+	public Variable[] getVariableList() throws NotSuspendedException, NoResponseException, NotConnectedException, VersionException;
+	
+	/**
+	 * From a given value identifier return a Value.  This call
+	 * allows tools to access a specific value whenever the Player has
+	 * suspended.  A Value's id is maintained for the life of the
+	 * Value and is guaranteed not to change.  Values that
+	 * go out of scope are no longer accessible and will result
+	 * in a null being returned.   Also note, that scalar
+	 * variables do not contain an id that can be referenced in
+	 * this manner.  Therefore the caller must also maintain the
+	 * 'context' in which the variable was obtained.  For example
+	 * if a Number b exists on a, then the reference 'a.b' must be
+	 * managed, as the id of 'a' will be needed to obtain the
+	 * value of 'b'.
+	 * @param valueId identifier from Value class or
+	 * from a call to Value.getId()
+	 * @return null, if value cannot be found or
+	 * value with the specific id.
+	 * @throws NoResponseException if times out
+	 * @throws NotSuspendedException if Player is running
+	 * @throws NotConnectedException if Player is disconnected from Session
+	 */
+	public Value getValue(long valueId) throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * Looks up a global name, like "MyClass", "String", etc.
+	 *
+	 * @return its value, or <code>null</code> if the global does not exist.
+	 */
+	public Value getGlobal(String name) throws NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * Events provide a mechanism whereby status information is provided from
+	 * the Player in a timely fashion.
+	 * <p>
+	 * The caller has the option of either polling the event queue via
+	 * <code>nextEvent()</code> or calling <code>waitForEvent()</code> which
+	 * blocks the calling thread until one or more events exist in the queue.
+	 *
+	 * @throws NotConnectedException
+	 *             if Session is disconnected from Player
+	 * @throws InterruptedException
+	 */
+	public void waitForEvent() throws NotConnectedException, InterruptedException;
+
+	/**
+	 * Returns the number of events currently in the queue.  This function
+	 * is guaranteed to be thread-safe.
+	 */
+	public int getEventCount();
+
+	/**
+	 * Removes and returns the next event from queue
+	 */
+	public DebugEvent nextEvent();
+
+	/**
+	 * Gets the SourceLocator for this session.  If none has been
+	 * specified, returns null.
+	 */
+    public SourceLocator getSourceLocator();
+
+	/**
+	 * Sets the SourceLocator for this session.  This can be used in order
+	 * to override the default rules used for finding source files.
+	 */
+	public void setSourceLocator(SourceLocator sourceLocator);
+
+	/**
+	 * Invokes a constructor in the player. Returns the newly created object.
+	 * Not supported in Player 9 or AIR 1.0. If you call this function and the
+	 * player to which you are connected doesn't support this feature, this will
+	 * throw a PlayerDebugException.
+	 */
+	public Value callConstructor(String classname, Value[] args) throws PlayerDebugException;
+
+	/**
+	 * Invokes a function. For example, calling
+	 * <code>callFunction(myobj, "toString", new Value[0])</code> will call
+	 * <code>myobj.toString()</code>. Not supported in Player 9 or AIR 1.0.
+	 * If you call this function and the player to which you are connected
+	 * doesn't support this feature, this will throw a PlayerDebugException.
+	 */
+	public Value callFunction(Value thisObject, String functionName, Value[] args) throws PlayerDebugException;
+	
+	/**
+	 * The player always halts on exceptions that are not going to be caught;
+	 * this call allows the debugger to control its behavior when an exception
+	 * that *will* be caught is thrown.
+	 *
+	 * @throws NotSupportedException
+	 *             thrown by older players that don't support this feature.
+	 * @throws NoResponseException
+	 */
+	public void breakOnCaughtExceptions(boolean b) throws NotSupportedException, NoResponseException;
+
+	/**
+	 * Evaluate the ActionScript expression "value is type"
+	 *
+	 * @throws PlayerDebugException
+	 * @throws PlayerFaultException
+	 */
+	public boolean evalIs(Value value, Value type) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * Evaluate the ActionScript expression "value is type"
+	 *
+	 * @throws PlayerDebugException
+	 * @throws PlayerFaultException
+	 */
+	public boolean evalIs(Value value, String type) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * Evaluate the ActionScript expression "value instanceof type"
+	 *
+	 * @throws PlayerFaultException
+	 * @throws PlayerDebugException
+	 */
+	public boolean evalInstanceof(Value value, Value type) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * Evaluate the ActionScript expression "value instanceof type"
+	 *
+	 * @throws PlayerFaultException
+	 * @throws PlayerDebugException
+	 */
+	public boolean evalInstanceof(Value value, String type) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * Evaluate the ActionScript expression "property in object"
+	 *
+	 * @throws PlayerFaultException
+	 * @throws PlayerDebugException
+	 */
+	public boolean evalIn(Value property, Value object) throws PlayerDebugException, PlayerFaultException;
+
+	/**
+	 * Evaluate the ActionScript expression "value as type"
+	 *
+	 * @throws PlayerDebugException
+	 * @throws PlayerFaultException
+	 */
+	public Value evalAs(Value value, Value type) throws PlayerDebugException, PlayerFaultException;
+	
+	/**
+	 * Returns whether the target player supports watchpoints.
+	 * @see #setWatch(Value, String, int)
+	 */
+	public boolean supportsWatchpoints();
+	
+	/**
+	 * Returns the root SocketException that caused the rxMessage()
+	 * thread to shut down. This works in conjunction with 
+	 * PREF_SOCKET_TIMEOUT and helps in detecting broken connections.
+	 */
+	public Exception getDisconnectCause();
+
+	/**
+	 * Set an exception breakpoint. Returns true if succeeded.
+	 * @param exceptionClass
+	 * @return
+	 * @throws NoResponseException
+	 * @throws NotConnectedException
+	 */
+	public boolean setExceptionBreakpoint(String exceptionClass) throws NoResponseException, NotConnectedException;
+
+	/**
+	 * Clears an exception breakpoint. Returns true if succeeded.
+	 * @param exceptionClass
+	 * @return
+	 * @throws NoResponseException
+	 * @throws NotConnectedException
+	 */
+	public boolean clearExceptionBreakpoint(String exceptionClass) throws NoResponseException, NotConnectedException;
+	
+	// Concurrency begin
+	
+	/**
+	 * Returns whether the target player supports concurrency.
+	 * @see #setActiveIsolate(Value)
+	 */
+	public boolean supportsConcurrency();
+	
+	/**
+	 * Get an array of all workers that the debugger knows of.
+	 */
+	public Isolate[] getWorkers();
+	
+	/**
+	 * Ask the player again for a list of all workers. Use this
+	 * method with caution as it will also reset all state about
+	 * workers that the debugger is aware of.
+	 */
+	public Isolate[] refreshWorkers() throws  NotSupportedException, NotSuspendedException, NoResponseException, NotConnectedException;
+	
+	/**
+	 * Return the worker specific session object that can be used
+	 * to communicate with that worker.
+	 */
+	public IsolateSession getWorkerSession(int isolateId);
+	
+	/**
+	 * 
+	 * Sets the ILauncher instance which is associated with this session. 
+	 * ILauncher instance is used to terminate the process at the end of the debugging session.
+	 *
+	 * @param launcher 
+	 * 				ILauncher instance used to launch & terminate the process.
+	 */
+	public void setLauncher(ILauncher launcher);
+
+}


Mime
View raw message