/*******************************************************************************
 * Copyright (c) 2000, 2004 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials 
 * are made available under the terms of the Common Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/cpl-v10.html
 * 
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.jdi.internal.jdwp;


import java.io.DataInputStream;
import java.io.DataOutputStream;
import java.io.IOException;
import java.lang.reflect.Field;
import java.lang.reflect.Modifier;
import java.util.HashMap;
import java.util.Map;

/**
 * This class implements the corresponding Java Debug Wire Protocol (JDWP) packet
 * declared by the JDWP specification.
 *
 */
public class JdwpCommandPacket extends JdwpPacket {
	/** Command Sets. */
	public static final int CSET_VIRTUAL_MACHINE = 1;
	public static final int CSET_REFERENCE_TYPE = 2;
	public static final int CSET_CLASS_TYPE = 3;
	public static final int CSET_ARRAY_TYPE = 4;
	public static final int CSET_INTERFACE_TYPE = 5;
	public static final int CSET_METHOD = 6;
	public static final int CSET_FIELD = 8;
	public static final int CSET_OBJECT_REFERENCE = 9;
	public static final int CSET_STRING_REFERENCE = 10;
	public static final int CSET_THREAD_REFERENCE = 11;
	public static final int CSET_THREAD_GROUP_REFERENCE = 12;
	public static final int CSET_ARRAY_REFERENCE = 13;
	public static final int CSET_CLASS_LOADER_REFERENCE = 14;
	public static final int CSET_EVENT_REQUEST = 15;
	public static final int CSET_STACK_FRAME = 16;
	public static final int CSET_CLASS_OBJECT_REFERENCE = 17;
	public static final int CSET_EVENT = 64;
	public static final int CSET_HOT_CODE_REPLACEMENT = 128;

	/** Commands VirtualMachine. */
	public static final int VM_VERSION = 1						 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_CLASSES_BY_SIGNATURE = 2			 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_ALL_CLASSES = 3					 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_ALL_THREADS = 4					 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_TOP_LEVEL_THREAD_GROUPS = 5		 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_DISPOSE = 6						 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_ID_SIZES = 7						 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_SUSPEND = 8						 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_RESUME = 9						 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_EXIT = 10						 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_CREATE_STRING = 11				 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_CAPABILITIES = 12				 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_CLASS_PATHS = 13					 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_DISPOSE_OBJECTS = 14				 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_HOLD_EVENTS = 15					 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_RELEASE_EVENTS = 16				 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_CAPABILITIES_NEW = 17			 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_REDEFINE_CLASSES = 18			 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_SET_DEFAULT_STRATUM = 19			 + (CSET_VIRTUAL_MACHINE << 8);
	public static final int VM_ALL_CLASSES_WITH_GENERIC= 20		 + (CSET_VIRTUAL_MACHINE << 8);

	/** Commands ReferenceType. */
	public static final int RT_SIGNATURE = 1					 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_CLASS_LOADER = 2					 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_MODIFIERS = 3					 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_FIELDS = 4						 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_METHODS = 5						 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_GET_VALUES = 6					 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_SOURCE_FILE = 7					 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_NESTED_TYPES = 8					 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_STATUS = 9						 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_INTERFACES = 10					 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_CLASS_OBJECT = 11				 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_SOURCE_DEBUG_EXTENSION = 12		 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_SIGNATURE_WITH_GENERIC = 13		 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_FIELDS_WITH_GENERIC = 14			 + (CSET_REFERENCE_TYPE << 8);
	public static final int RT_METHODS_WITH_GENERIC = 15		 + (CSET_REFERENCE_TYPE << 8);

	/** Commands ClassType. */
	public static final int CT_SUPERCLASS = 1					 + (CSET_CLASS_TYPE << 8);
	public static final int CT_SET_VALUES = 2					 + (CSET_CLASS_TYPE << 8);
	public static final int CT_INVOKE_METHOD = 3				 + (CSET_CLASS_TYPE << 8);
	public static final int CT_NEW_INSTANCE = 4					 + (CSET_CLASS_TYPE << 8);

	/** Commands ArrayType. */
	public static final int AT_NEW_INSTANCE = 1					 + (CSET_ARRAY_TYPE << 8);

	/** Commands Method. */
	public static final int M_LINE_TABLE = 1					 + (CSET_METHOD << 8);
	public static final int M_VARIABLE_TABLE = 2				 + (CSET_METHOD << 8);
	public static final int M_BYTECODES = 3						 + (CSET_METHOD << 8);
	public static final int M_OBSOLETE = 4						 + (CSET_METHOD << 8);
	public static final int M_VARIABLE_TABLE_WITH_GENERIC = 5	 + (CSET_METHOD << 8);

	/** Commands ObjectReference. */
	public static final int OR_REFERENCE_TYPE = 1				 + (CSET_OBJECT_REFERENCE << 8);
	public static final int OR_GET_VALUES = 2					 + (CSET_OBJECT_REFERENCE << 8);
	public static final int OR_SET_VALUES = 3					 + (CSET_OBJECT_REFERENCE << 8);
	public static final int OR_MONITOR_INFO = 5					 + (CSET_OBJECT_REFERENCE << 8);
	public static final int OR_INVOKE_METHOD = 6				 + (CSET_OBJECT_REFERENCE << 8);
	public static final int OR_DISABLE_COLLECTION = 7			 + (CSET_OBJECT_REFERENCE << 8);
	public static final int OR_ENABLE_COLLECTION = 8			 + (CSET_OBJECT_REFERENCE << 8);
	public static final int OR_IS_COLLECTED = 9					 + (CSET_OBJECT_REFERENCE << 8);

	/** Commands StringReference. */
	public static final int SR_VALUE = 1						 + (CSET_STRING_REFERENCE << 8);

	/** Commands ThreadReference. */
	public static final int TR_NAME = 1							 + (CSET_THREAD_REFERENCE << 8);
	public static final int TR_SUSPEND = 2						 + (CSET_THREAD_REFERENCE << 8);
	public static final int TR_RESUME = 3						 + (CSET_THREAD_REFERENCE << 8);
	public static final int TR_STATUS = 4						 + (CSET_THREAD_REFERENCE << 8);
	public static final int TR_THREAD_GROUP = 5					 + (CSET_THREAD_REFERENCE << 8);
	public static final int TR_FRAMES = 6						 + (CSET_THREAD_REFERENCE << 8);
	public static final int TR_FRAME_COUNT = 7					 + (CSET_THREAD_REFERENCE << 8);
	public static final int TR_OWNED_MONITORS = 8				 + (CSET_THREAD_REFERENCE << 8);
	public static final int TR_CURRENT_CONTENDED_MONITOR = 9	 + (CSET_THREAD_REFERENCE << 8);
	public static final int TR_STOP = 10						 + (CSET_THREAD_REFERENCE << 8);
	public static final int TR_INTERRUPT = 11					 + (CSET_THREAD_REFERENCE << 8);
	public static final int TR_SUSPEND_COUNT = 12				 + (CSET_THREAD_REFERENCE << 8);

	/** Commands ThreadGroupReference. */
	public static final int TGR_NAME = 1						 + (CSET_THREAD_GROUP_REFERENCE << 8);
	public static final int TGR_PARENT = 2						 + (CSET_THREAD_GROUP_REFERENCE << 8);
	public static final int TGR_CHILDREN = 3					 + (CSET_THREAD_GROUP_REFERENCE << 8);

	/** Commands ArrayReference. */
	public static final int AR_LENGTH = 1						 + (CSET_ARRAY_REFERENCE << 8);
	public static final int AR_GET_VALUES = 2					 + (CSET_ARRAY_REFERENCE << 8);
	public static final int AR_SET_VALUES = 3					 + (CSET_ARRAY_REFERENCE << 8);

	/** Commands ClassLoaderReference. */
	public static final int CLR_VISIBLE_CLASSES = 1				 + (CSET_CLASS_LOADER_REFERENCE << 8);

	/** Commands EventRequest. */
	public static final int ER_SET = 1							 + (CSET_EVENT_REQUEST << 8);
	public static final int ER_CLEAR = 2						 + (CSET_EVENT_REQUEST << 8);
	public static final int ER_CLEAR_ALL_BREAKPOINTS = 3		 + (CSET_EVENT_REQUEST << 8);

	/** Commands StackFrame. */
	public static final int SF_GET_VALUES = 1					 + (CSET_STACK_FRAME << 8);
	public static final int SF_SET_VALUES = 2					 + (CSET_STACK_FRAME << 8);
	public static final int SF_THIS_OBJECT = 3					 + (CSET_STACK_FRAME << 8);
	public static final int SF_POP_FRAME = 4					 + (CSET_STACK_FRAME << 8);

	/** Commands ClassObjectReference. */
	public static final int COR_REFLECTED_TYPE = 1				 + (CSET_CLASS_OBJECT_REFERENCE << 8);

	/** Commands Event. */
	public static final int E_COMPOSITE = 100					 + (CSET_EVENT << 8);

	/** Commands Hot Code Replacement (OTI specific). */
	public static final int HCR_CLASSES_HAVE_CHANGED = 1		 + (CSET_HOT_CODE_REPLACEMENT << 8);
	public static final int HCR_GET_CLASS_VERSION = 2			 + (CSET_HOT_CODE_REPLACEMENT << 8);
	public static final int HCR_DO_RETURN = 3					 + (CSET_HOT_CODE_REPLACEMENT << 8);
	public static final int HCR_REENTER_ON_EXIT = 4				 + (CSET_HOT_CODE_REPLACEMENT << 8);
	public static final int HCR_CAPABILITIES = 5				 + (CSET_HOT_CODE_REPLACEMENT << 8);

	/** Mapping of command codes to strings. */
	private static Map fgCommandMap = null;

	/** Next id to be assigned. */
	private static int fgNextId = 1;
	/** Command, note that this field is 256 * JDWP CommandSet (unsigned) + JDWP Command. */
	private int fCommand;

	/**
	 * Creates new JdwpCommandPacket.
	 */
	protected JdwpCommandPacket() {
	}

	/**
	 * Creates new JdwpCommandPacket.
	 */
	public JdwpCommandPacket(int command) {
		setCommand(command);
		setId(getNewId());
	}
	
	/**
	 * @return Returns unique id for command packet.
	 */
	public static synchronized int getNewId() {
		return fgNextId++;
	}

	/**
	 * @return Returns JDWP command set of packet.
	 */
	public byte getCommandSet() {
		return (byte)(fCommand >>> 8);
	}

	/**
	 * @return Returns 256 * JDWP CommandSet (unsigned) + JDWP Command.
	 */
	public int getCommand() {
		return fCommand;
	}
	
	/**
	 * Assigns command (256 * JDWP CommandSet (unsigned) + JDWP Command)
	 */
	public void setCommand(int command) {
		fCommand = command;
	}
	
	/**
	 * Reads header fields that are specific for this type of packet.
	 */
	protected void readSpecificHeaderFields(DataInputStream dataInStream) throws IOException {
		byte commandSet = dataInStream.readByte();
		fCommand = dataInStream.readByte()  + (commandSet << 8);
	}

	/**
	 * Writes header fields that are specific for this type of packet.
	 */
	protected void writeSpecificHeaderFields(DataOutputStream dataOutStream) throws IOException {
		dataOutStream.writeByte(getCommandSet());
		dataOutStream.writeByte((byte)fCommand);
	}
	
	/**
	 * Retrieves constant mappings.
	 */
	public static void getConstantMaps() {
		if (fgCommandMap != null) {
			return;
		}
		
		Field[] fields = JdwpCommandPacket.class.getDeclaredFields();
		
		// First get the set names.
		Map setNames = new HashMap(fields.length);
		for (int i = 0; i < fields.length; i++) {
			Field field = fields[i];
			if ((field.getModifiers() & Modifier.PUBLIC) == 0 || (field.getModifiers() & Modifier.STATIC) == 0 || (field.getModifiers() & Modifier.FINAL) == 0)
				continue;

			try {
				String name = field.getName();
				// If it is not a set, continue.
				if (!name.startsWith("CSET_")) {//$NON-NLS-1$
					continue;
				}
				int value = field.getInt(null);
				setNames.put(new Integer(value), removePrefix(name));
			} catch (IllegalAccessException e) {
				// Will not occur for own class.
			} catch (IllegalArgumentException e) {
				// Should not occur.
				// We should take care that all public static final constants
				// in this class are numbers that are convertible to int.
			}
		}
		
		// Get the commands.	
		fgCommandMap = new HashMap();
		for (int i = 0; i < fields.length; i++) {
			Field field = fields[i];
			if ((field.getModifiers() & Modifier.PUBLIC) == 0 || (field.getModifiers() & Modifier.STATIC) == 0 || (field.getModifiers() & Modifier.FINAL) == 0) {
				continue;
			}
				
			try {
				String name = field.getName();
				
				// If it is a set, continue.
				if (name.startsWith("CSET_")) { //$NON-NLS-1$
					continue;
				}
				Integer val = (Integer)field.get(null);
				int value = val.intValue();	
				int set = value >>> 8;
				String setName = (String)setNames.get(new Integer(set));
				String entryName = setName + " - " + removePrefix(name); //$NON-NLS-1$
				
				fgCommandMap.put(val, entryName);
				
			} catch (IllegalAccessException e) {
				// Will not occur for own class.
			}
		}
	}

	/**
	 * @return Returns a map with string representations of error codes.
	 */
	public static Map commandMap() {
		getConstantMaps();
		return fgCommandMap;
	}
	
	/**
	 * @return Returns string without XXX_ prefix.
	 */
	public static String removePrefix(String str) {
		int i = str.indexOf('_');
		if (i < 0) {
			return str;
		} 
		return str.substring(i + 1);
	}
}