com.sun.jdi.event
インタフェース EventSet

すべてのスーパーインタフェース:

Collection<Event>, Iterable<Event>, Mirror, Set<Event>

public interface EventSet
extends Mirror, Set<Event>

指定の時間にターゲットの VirtualMachine にいくつかの Event オブジェクトが生成されます。たとえば、特定の Location に対して複数の BreakpointRequest を指定したり、BreakpointRequest と同じ位置までステップ実行したりできます。これらの Event オブジェクトは、まとめて 1 つの EventSet として配布されます。一貫性を保つために、EventSet は常に Event オブジェクトを配布するときに使用されます。EventSet は、EventQueue によって配布されます。EventSet は変更できません。

イベントセットの発行と関連して、ターゲット VM 内で中断が発生する場合があります。この中断は、suspend policy に合致しています。確実に再開されるようにするためには、可能な場合は、EventSet.resume() を使ってイベントセットの処理を完了することをお勧めします。

EventSet にグループ化されるイベントには、次の制限が適用されます。

• 常に単独セット
  • VMStartEvent
  • VMDisconnectEvent
• ほかの VMDeathEvent とだけ
  • VMDeathEvent
• 同じスレッドに対するほかの ThreadStartEvent とだけ
  • ThreadStartEvent
• 同じスレッドに対するほかの ThreadDeathEvent とだけ
  • ThreadDeathEvent
• 同じクラスに対するほかの ClassPrepareEvent とだけ
  • ClassPrepareEvent
• 同じクラスに対するほかの ClassUnloadEvent とだけ
  • ClassUnloadEvent
• 同じフィールドアクセスに対するほかの AccessWatchpointEvent とだけ
  • AccessWatchpointEvent
• 同じフィールドの変更に対するほかの ModificationWatchpointEvent とだけ
  • ModificationWatchpointEvent
• 同一の例外発生に対するほかの例外イベントとのみ一緒にされる:
  • ExceptionEvent
• 同じメソッド終了に対するほかの MethodExitEvent とだけ
  • MethodExitEvent
• 同一位置および同一スレッド内の、このグループのほかのメンバとのみ一緒にされる:
  • BreakpointEvent
  • StepEvent
  • MethodEntryEvent

導入されたバージョン:

1.3

関連項目:

Event, EventQueue

メソッドの概要

EventIterator	eventIterator() Event オブジェクトに固有の反復子を返します。
void	resume() このイベントセットによって中断されたスレッドを再開します。
int	suspendPolicy() ターゲット VM でスレッドを中断するための、このイベントセットのポリシーを返します。

インタフェース com.sun.jdi.Mirror から継承されたメソッド

toString, virtualMachine

インタフェース java.util.Set から継承されたメソッド

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

メソッドの詳細

suspendPolicy

int suspendPolicy()

ターゲット VM でスレッドを中断するための、このイベントセットのポリシーを返します。このポリシーは、各イベントの要求の中断ポリシーから選択されます。ターゲット VM は、もっとも多くのスレッドを中断したポリシーを選択します。ターゲット VM はそのポリシーに従ってスレッドを中断し、そのポリシーがここで返されます。返されるポリシーの値については、EventRequest を参照してください。

デバッガのシステムスレッドで ClassPrepareEvent が発生した場合は、中断ポリシーが要求された値とは異なることがあります。詳細は、ClassPrepareEvent.thread() を参照してください。

戻り値:

SUSPEND_ALL、 SUSPEND_EVENT_THREAD、または SUSPEND_NONE の suspendPolicy のうち 1 つ

eventIterator

EventIterator eventIterator()

Event オブジェクトに固有の反復子を返します。

resume

void resume()

このイベントセットによって中断されたスレッドを再開します。suspendPolicy() が EventRequest.SUSPEND_ALL の場合は、このメソッドへの呼び出しは VirtualMachine.resume() と同じです。中断ポリシーが EventRequest.SUSPEND_EVENT_THREAD の場合は、このメソッドへの呼び出しは、イベントスレッドに対する ThreadReference.resume() と同じです。そうでない場合は、このメソッドへの呼び出しは無操作になります。