libjava/classpath/gnu/classpath/jdwp/event/ThreadStartEvent.java

   1 /* ThreadStartEvent.java -- An event specifying that a new thread
   2    has started in the virtual machine
   3    Copyright (C) 2005 Free Software Foundation
   4
   5 This file is part of GNU Classpath.
   6
   7 GNU Classpath is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 2, or (at your option)
  10 any later version.
  11
  12 GNU Classpath is distributed in the hope that it will be useful, but
  13 WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GNU Classpath; see the file COPYING.  If not, write to the
  19 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  20 02110-1301 USA.
  21
  22 Linking this library statically or dynamically with other modules is
  23 making a combined work based on this library.  Thus, the terms and
  24 conditions of the GNU General Public License cover the whole
  25 combination.
  26
  27 As a special exception, the copyright holders of this library give you
  28 permission to link this library with independent modules to produce an
  29 executable, regardless of the license terms of these independent
  30 modules, and to copy and distribute the resulting executable under
  31 terms of your choice, provided that you also meet, for each linked
  32 terms of your choice, provided that you also meet, for each linked
  33 independent module, the terms and conditions of the license of that
  34 module.  An independent module is a module which is not derived from
  35 or based on this library.  If you modify this library, you may extend
  36 this exception to your version of the library, but you are not
  37 obligated to do so.  If you do not wish to do so, delete this
  38 exception statement from your version. */
  39
  40
  41 package gnu.classpath.jdwp.event;
  42
  43 import gnu.classpath.jdwp.JdwpConstants;
  44 import gnu.classpath.jdwp.VMIdManager;
  45 import gnu.classpath.jdwp.id.ThreadId;
  46
  47 import java.io.DataOutputStream;
  48 import java.io.IOException;
  49
  50 /**
  51  * "Notification of a new running thread in the target VM. The new
  52  * thread can be the result of a call to {@link java.lang.Thread#start} or
  53  * the result of attaching a new thread to the VM though JNI. The
  54  * notification is generated by the new thread some time before its
  55  * execution starts. Because of this timing, it is possible to receive
  56  * other events for the thread before this event is received. (Notably,
  57  * Method Entry Events and Method Exit Events might occur during thread
  58  * initialization. It is also possible for the VirtualMachine AllThreads
  59  * command to return a thread before its thread start event is received.
  60  *
  61  * <p>Note that this event gives no information about the creation of the
  62  * thread object which may have happened much earlier, depending on the
  63  * VM being debugged." -- JDWP 1.4.2
  64  *
  65  * @author Keith Seitz  (keiths@redhat.com)
  66  */
  67 public class ThreadStartEvent
  68   extends Event
  69 {
  70   private Thread _thread;
  71
  72   /**
  73    * Constructs a new ThreadStartEvent object
  74    *
  75    * @param thread  the thread ID in which event occurred
  76    */
  77   public ThreadStartEvent (Thread thread) {
  78     super (JdwpConstants.EventKind.THREAD_END);
  79     _thread = thread;
  80   }
  81
  82   /**
  83    * Returns a specific filtering parameter for this event.
  84    * Valid types are ThreadId.
  85    *
  86    * @param type  the type of parameter desired
  87    * @returns the desired parameter or <code>null</code>
  88    */
  89   public Object getParameter (Class type)
  90   {
  91     if (type == ThreadId.class)
  92       return _thread;
  93
  94     return null;
  95   }
  96
  97   /**
  98    * Writes the event to the given stream
  99    *
 100    * @param outStream  the output stream to write the event to
 101    */
 102   protected void _writeData (DataOutputStream outStream)
 103     throws IOException
 104   {
 105     VMIdManager idm = VMIdManager.getDefault();
 106     ThreadId tid = (ThreadId) idm.getObjectId (_thread);
 107     tid.write (outStream);
 108   }
 109 }