From 7b3b23d506b17635209bd8b3b3671e42f9ccacb1 Mon Sep 17 00:00:00 2001 From: mkersten Date: Wed, 7 Apr 2004 04:09:26 +0000 Subject: [PATCH] Regenerated test data. --- .../spacewar/doc/allclasses-frame.html | 2 +- .../spacewar/doc/allclasses-noframe.html | 2 +- .../spacewar/doc/constant-values.html | 2 +- .../spacewar/doc/coordination/Condition.html | 12 +- .../doc/coordination/CoordinationAction.html | 13 +- .../doc/coordination/Coordinator.html | 221 ++++++++++++++++-- .../spacewar/doc/coordination/Exclusion.html | 2 +- .../spacewar/doc/coordination/Method.html | 2 +- .../doc/coordination/MethodState.html | 2 +- .../spacewar/doc/coordination/Mutex.html | 2 +- .../spacewar/doc/coordination/Selfex.html | 2 +- .../doc/coordination/TimeoutException.html | 2 +- .../doc/coordination/package-frame.html | 2 +- .../doc/coordination/package-summary.html | 2 +- .../doc/coordination/package-tree.html | 2 +- .../spacewar/doc/deprecated-list.html | 2 +- ajdoc/testdata/spacewar/doc/help-doc.html | 2 +- ajdoc/testdata/spacewar/doc/index-all.html | 2 +- ajdoc/testdata/spacewar/doc/index.html | 2 +- .../testdata/spacewar/doc/overview-frame.html | 2 +- .../spacewar/doc/overview-summary.html | 2 +- .../testdata/spacewar/doc/overview-tree.html | 2 +- ajdoc/testdata/spacewar/doc/packages.html | 2 +- .../spacewar/doc/serialized-form.html | 2 +- .../spacewar/doc/spacewar/Bullet.html | 4 +- .../testdata/spacewar/doc/spacewar/Debug.html | 58 +++-- .../doc/spacewar/Display.DisplayAspect.html | 6 +- .../spacewar/doc/spacewar/Display.html | 13 +- .../Display1.SpaceObjectPainting.html | 2 +- .../spacewar/doc/spacewar/Display1.html | 7 +- .../Display2.SpaceObjectPainting.html | 2 +- .../spacewar/doc/spacewar/Display2.html | 7 +- .../spacewar/doc/spacewar/EnergyPacket.html | 10 +- .../doc/spacewar/EnergyPacketProducer.html | 2 +- .../doc/spacewar/EnsureShipIsAlive.html | 4 +- .../testdata/spacewar/doc/spacewar/Game.html | 52 ++++- .../doc/spacewar/GameSynchronization.html | 18 +- .../spacewar/doc/spacewar/InfoWin.html | 2 +- .../spacewar/doc/spacewar/KeyMapping.html | 2 +- .../testdata/spacewar/doc/spacewar/Pilot.html | 3 +- .../spacewar/doc/spacewar/Player.html | 2 +- .../Registry.RegistrationProtection.html | 2 +- .../spacewar/doc/spacewar/Registry.html | 6 +- .../doc/spacewar/RegistrySynchronization.html | 15 +- .../testdata/spacewar/doc/spacewar/Robot.html | 4 +- .../spacewar/doc/spacewar/SWFrame.html | 2 +- .../testdata/spacewar/doc/spacewar/Ship.html | 44 ++-- .../spacewar/doc/spacewar/SpaceObject.html | 24 +- .../testdata/spacewar/doc/spacewar/Timer.html | 2 +- .../spacewar/doc/spacewar/package-frame.html | 2 +- .../doc/spacewar/package-summary.html | 2 +- .../spacewar/doc/spacewar/package-tree.html | 2 +- 52 files changed, 458 insertions(+), 129 deletions(-) diff --git a/ajdoc/testdata/spacewar/doc/allclasses-frame.html b/ajdoc/testdata/spacewar/doc/allclasses-frame.html index e0a5206b1..3e89615bc 100644 --- a/ajdoc/testdata/spacewar/doc/allclasses-frame.html +++ b/ajdoc/testdata/spacewar/doc/allclasses-frame.html @@ -2,7 +2,7 @@ - + All Classes diff --git a/ajdoc/testdata/spacewar/doc/allclasses-noframe.html b/ajdoc/testdata/spacewar/doc/allclasses-noframe.html index 39cb11cd2..43a9af989 100644 --- a/ajdoc/testdata/spacewar/doc/allclasses-noframe.html +++ b/ajdoc/testdata/spacewar/doc/allclasses-noframe.html @@ -2,7 +2,7 @@ - + All Classes diff --git a/ajdoc/testdata/spacewar/doc/constant-values.html b/ajdoc/testdata/spacewar/doc/constant-values.html index bf9221973..da02af6fc 100644 --- a/ajdoc/testdata/spacewar/doc/constant-values.html +++ b/ajdoc/testdata/spacewar/doc/constant-values.html @@ -2,7 +2,7 @@ - + Constant Field Values diff --git a/ajdoc/testdata/spacewar/doc/coordination/Condition.html b/ajdoc/testdata/spacewar/doc/coordination/Condition.html index f59e7c297..11a17148c 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/Condition.html +++ b/ajdoc/testdata/spacewar/doc/coordination/Condition.html @@ -2,7 +2,7 @@ - + Condition @@ -90,6 +90,10 @@ Interface Condition

+ Interface for pre-conditions that are passed to guardedEntry methods of + Coordinator. + Conditions should be passed as anonymous classes that simply implement + the checkit method.

@@ -119,7 +123,9 @@ Interface Condition checkit()
- + + This method is called automatically by Coordinator.guardedEntry(...) + and it's called everytime the coordination state changes. @@ -147,6 +153,8 @@ checkit public boolean checkit()

+ This method is called automatically by Coordinator.guardedEntry(...) + and it's called everytime the coordination state changes.

diff --git a/ajdoc/testdata/spacewar/doc/coordination/CoordinationAction.html b/ajdoc/testdata/spacewar/doc/coordination/CoordinationAction.html index 6898803ea..89fdcbad9 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/CoordinationAction.html +++ b/ajdoc/testdata/spacewar/doc/coordination/CoordinationAction.html @@ -2,7 +2,7 @@ - + CoordinationAction @@ -90,6 +90,10 @@ Interface CoordinationAction

+ Interface for coordination actions that are passed to guardedEntry methods of + Coordinator. + Coordination actions should be passed as anonymous classes that simply + implement the doit method.

@@ -119,7 +123,9 @@ Interface CoordinationAction doit()
- + + This method is called by Coordinator.guardedEntry(...) and + Coordinator.guardedExit(...). @@ -147,6 +153,9 @@ doit public void doit()

+ This method is called by Coordinator.guardedEntry(...) and + Coordinator.guardedExit(...). Use it for changing coordination state + upon entering and exiting methods.

diff --git a/ajdoc/testdata/spacewar/doc/coordination/Coordinator.html b/ajdoc/testdata/spacewar/doc/coordination/Coordinator.html index 8765d0636..8dd0a7095 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/Coordinator.html +++ b/ajdoc/testdata/spacewar/doc/coordination/Coordinator.html @@ -2,7 +2,7 @@ - + Coordinator @@ -97,6 +97,39 @@ java.lang.Object

+ The Coordinator class provides the basic functionality for synchronizing + and coordinating different threads upon entering and exiting methods. + It can be used in two different ways: + 1) by instantiating regular coordinator objects that are used by aspects; or + 2) by extending it (sub-classing) with coordinator aspects. +

+ Method invocations are the smallest units for defining critical sections + and pre-conditions. The use of coordinators, either regular objects or aspect + instances, should always end up by invoking guardedEntry(...) in a + before weave and guardedExit(...) in an after weave for all methods that + need coordination. guardedEntry and guardedExit are the methods that + actually manage the synchronization and coordination constraints given + by their parameters and by pre-existent exclusion markers. +

+ The synchronization of threads for the execution of critical section + methods in an object is done by marking those methods as self- and/or + mutually-exclusive (addSelfex, addMutex). + Just by itself, addSelfex("M") does not enforce the self-exclusion + of method M - enforcement is done by invoking guardedEntry before + M is executed. Similarly, addMutex(new String[] {"M1", "M2"}) does + not enforce the mutual exclusion between methods M1 and M2. +

+ A guardedEntry on a method that has been marked as self-exclusive + ensures that the method is executed in the invoked object by only one thread + at a time. A guardedEntry on a method that has been marked has mutually- + exclusive with other methods ensures that the execution of that method + by a thread in the invoked object temporarily blocks the execution by + other threads of the methods that are in the same mutex set. +

+ The coordination of threads, i.e. their explicit suspension and + resumption, is done through the use of pre-conditions and coordination + actions that are passed as parameters to guardedEntry and guardedExit + with the form of anonymous classes.

@@ -155,7 +188,9 @@ java.lang.Object addMutex(java.lang.String[] methNames)
-           +           + Takes an array of multi-part method names and marks those + methods as mutually exclusive. @@ -163,7 +198,9 @@ java.lang.Object addSelfex(java.lang.String methName)
-           +           + Takes a multi-part method name (eg "BoundedBuffer.put") + and marks that method as self-exclusive. @@ -171,7 +208,10 @@ java.lang.Object guardedEntry(java.lang.String methName)
-           +           + This method is the guard for enforcing all synchronization and + coordination constraints of a given method, and it should be called + just before the method is executed. @@ -180,7 +220,9 @@ java.lang.Object Condition condition)
-           +           + Just like guardedEntry(String methName), but the given method is executed + only when the given condition is true. @@ -190,7 +232,11 @@ java.lang.Object CoordinationAction action)
-           +           + Just like guardedEntry(String methName), but the given method is executed + only when the given condition is true; the additional + coordination action that is executed before the given method is + executed. @@ -199,7 +245,10 @@ java.lang.Object CoordinationAction action)
-           +           + Just like guardedEntry(String methName), but with an additional + coordination action that is executed before the given method is + executed. @@ -210,7 +259,10 @@ java.lang.Object long millis)
-           +           + This method is similar to guardedEntry, but it takes + an additional parameter - the milliseconds after which any suspension + will abort with a timeout. @@ -220,7 +272,10 @@ java.lang.Object long millis)
-           +           + This method is similar to guardedEntry, but it takes + an additional parameter - the milliseconds after which any suspension + will abort with a timeout. @@ -230,7 +285,10 @@ java.lang.Object long millis)
-           +           + This method is similar to guardedEntry, but it takes + an additional parameter - the milliseconds after which any suspension + will abort with a timeout. @@ -239,7 +297,10 @@ java.lang.Object long millis)
-           +           + This method is similar to guardedEntry, but it takes + an additional parameter - the milliseconds after which any suspension + will abort with a timeout. @@ -247,7 +308,10 @@ java.lang.Object guardedExit(java.lang.String methName)
-           +           + This method provides the means for updating all synchronization and + coordination state after the execution of a given method, and it should be + called after the method is executed. @@ -256,7 +320,9 @@ java.lang.Object CoordinationAction action)
-           +           + Just like guardedExit(String methName) but with an additional + coordination action that is executed. @@ -264,7 +330,9 @@ java.lang.Object removeMutex(java.lang.String[] methNames)
-           +           + Takes an array of multi-part method names that correspond + to an existing mutex set and remove the mutual exclusion constraint. @@ -272,7 +340,8 @@ java.lang.Object removeSelfex(java.lang.String methName)
-           +           + Takes a multi-part method name (e.g. @@ -306,12 +375,12 @@ java.lang.Object

before

before(): synchronizationPoint.. -

Advises: spacewar.Display1.paintObjects, spacewar.Display2.paintObjects, spacewar.Game.resetShips, spacewar.Game.newPlayer, spacewar.Game.newRobot, spacewar.Game.clockTick, spacewar.Game.handleCollisions, spacewar.Registry.dummy, spacewar.Robot.run, spacewar.SpaceObject, spacewar.SpaceObject.die
+

after

after(): synchronizationPoint.. -

@@ -351,6 +420,10 @@ addSelfex public void addSelfex(java.lang.String methName)

+ Takes a multi-part method name (eg "BoundedBuffer.put") + and marks that method as self-exclusive. + No checks are made with respect to the existence of the method + whose name is given.

@@ -364,6 +437,8 @@ removeSelfex public void removeSelfex(java.lang.String methName)

+ Takes a multi-part method name (e.g. "BoundedBuffer.put") + and removes that method from the list of self-exclusive methods.

@@ -377,6 +452,10 @@ addMutex public void addMutex(java.lang.String[] methNames)

+ Takes an array of multi-part method names and marks those + methods as mutually exclusive. + No checks are made with respect to the existence of the methods + whose names are given.

@@ -390,6 +469,9 @@ removeMutex public void removeMutex(java.lang.String[] methNames)

+ Takes an array of multi-part method names that correspond + to an existing mutex set and remove the mutual exclusion constraint. + If the given mutex set does not exist, removeMutex does nothing.

@@ -403,6 +485,18 @@ guardedEntry public void guardedEntry(java.lang.String methName)

+ This method is the guard for enforcing all synchronization and + coordination constraints of a given method, and it should be called + just before the method is executed. + In this form, only the method name is given. The only constraints + checked are the exclusion constraints. + If the method was previousely marked as selfex (through addSelfex), + guardedEntry ensures that the method is executed only when no other + thread is executing it. + If the method was previousely marked as being in one or more mutex + sets, guardedEntry ensures that the method is executed only when no other + thread is executing any of the methods with which the give method is + mutexed.

@@ -417,6 +511,26 @@ public void guardedEntry(java.lang.String methName, Condition condition)

+ Just like guardedEntry(String methName), but the given method is executed + only when the given condition is true. + guardedEntry is the guard for enforcing all synchronization and + coordination constraints of a given method, and it should be called + just before the method is executed. + In this form, the method name is given along with a condition. + The constraints checked are the exclusion constraints and whether + the given condition is true. + If the method was previousely marked as selfex (through addSelfex), + guardedEntry ensures that the method is executed only when no other + thread is executing it. + If the method was previousely marked as being in one or more mutex + sets, guardedEntry ensures that the method is executed only when no other + thread is executing any of the methods with which the give method is + mutexed. + If the condition is false, guardedEntry suspends the current thread. + That thread remains suspended until the condition becomes true, in + which case all constraints are rechecked before the method is executed. + When all exclusion constraints are checked and the given condition is + true, the given method is executed.

@@ -431,6 +545,23 @@ public void guardedEntry(java.lang.String methName, CoordinationAction action)

+ Just like guardedEntry(String methName), but with an additional + coordination action that is executed before the given method is + executed. + guardedEntry is the guard for enforcing all synchronization and + coordination constraints of a given method, and it should be called + just before the method is executed. + In this form, the method name is given along with a coordination action. + The only constraints checked are the exclusion constraints. + If the method was previousely marked as selfex (through addSelfex), + guardedEntry ensures that the method is executed only when no other + thread is executing it. + If the method was previousely marked as being in one or more mutex + sets, guardedEntry ensures that the method is executed only when no other + thread is executing any of the methods with which the give method is + mutexed. + The given coordination action is executed just before the given method + is executed.

@@ -446,6 +577,31 @@ public void guardedEntry(java.lang.String methName, CoordinationAction action)

+ Just like guardedEntry(String methName), but the given method is executed + only when the given condition is true; the additional + coordination action that is executed before the given method is + executed. + guardedEntry is the guard for enforcing all synchronization and + coordination constraints of a given method, and it should be called + just before the method is executed. + In this form, the method name is given along with a condition and + a coordination action. + The constraints checked are the exclusion constraints and whether the + given condition is true. + If the method was previousely marked as selfex (through addSelfex), + guardedEntry ensures that the method is executed only when no other + thread is executing it. + If the method was previousely marked as being in one or more mutex + sets, guardedEntry ensures that the method is executed only when no other + thread is executing any of the methods with which the give method is + mutexed. + If the condition is false, guardedEntry suspends the current thread. + That thread remains suspended until the condition becomes true, in + which case all constraints are rechecked before the method is executed. + When all exclusion constraints are checked and the given condition is + true, the given method is executed. + The given coordination action is executed just before the given method + is executed.

@@ -461,6 +617,9 @@ public void guardedEntryWithTimeout(java.lang.String methName, throws TimeoutException

+ This method is similar to guardedEntry, but it takes + an additional parameter - the milliseconds after which any suspension + will abort with a timeout.

@@ -479,6 +638,9 @@ public void guardedEntryWithTimeout(java.lang.String methName, throws TimeoutException

+ This method is similar to guardedEntry, but it takes + an additional parameter - the milliseconds after which any suspension + will abort with a timeout.

@@ -497,6 +659,9 @@ public void guardedEntryWithTimeout(java.lang.String methName, throws TimeoutException

+ This method is similar to guardedEntry, but it takes + an additional parameter - the milliseconds after which any suspension + will abort with a timeout.

@@ -516,6 +681,9 @@ public void guardedEntryWithTimeout(java.lang.String methName, throws TimeoutException

+ This method is similar to guardedEntry, but it takes + an additional parameter - the milliseconds after which any suspension + will abort with a timeout.

@@ -531,6 +699,12 @@ guardedExit public void guardedExit(java.lang.String methName)

+ This method provides the means for updating all synchronization and + coordination state after the execution of a given method, and it should be + called after the method is executed. + In this form, only the method name is given. + The synchronization state for self- and mutual-exclusion is + automatically upadted.

@@ -545,6 +719,15 @@ public void guardedExit(java.lang.String methName, CoordinationAction action)

+ Just like guardedExit(String methName) but with an additional + coordination action that is executed. + guardedExit provides the means for updating all synchronization and + coordination state after the execution of a given method, and it should be + called after the method is executed. + In this form, the method name is given along with a coordination action. + The synchronization state for self- and mutual-exclusion is + automatically upadted. + The given coordination action is executed.

diff --git a/ajdoc/testdata/spacewar/doc/coordination/Exclusion.html b/ajdoc/testdata/spacewar/doc/coordination/Exclusion.html index 3adbbcbd8..fb2b2a4cc 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/Exclusion.html +++ b/ajdoc/testdata/spacewar/doc/coordination/Exclusion.html @@ -2,7 +2,7 @@ - + Exclusion diff --git a/ajdoc/testdata/spacewar/doc/coordination/Method.html b/ajdoc/testdata/spacewar/doc/coordination/Method.html index ec6596b3a..8ed9da7ab 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/Method.html +++ b/ajdoc/testdata/spacewar/doc/coordination/Method.html @@ -2,7 +2,7 @@ - + Method diff --git a/ajdoc/testdata/spacewar/doc/coordination/MethodState.html b/ajdoc/testdata/spacewar/doc/coordination/MethodState.html index df5cad790..324788f53 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/MethodState.html +++ b/ajdoc/testdata/spacewar/doc/coordination/MethodState.html @@ -2,7 +2,7 @@ - + MethodState diff --git a/ajdoc/testdata/spacewar/doc/coordination/Mutex.html b/ajdoc/testdata/spacewar/doc/coordination/Mutex.html index ceb108de9..aca1f71b7 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/Mutex.html +++ b/ajdoc/testdata/spacewar/doc/coordination/Mutex.html @@ -2,7 +2,7 @@ - + Mutex diff --git a/ajdoc/testdata/spacewar/doc/coordination/Selfex.html b/ajdoc/testdata/spacewar/doc/coordination/Selfex.html index 5836f9bd9..5e09bb6e8 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/Selfex.html +++ b/ajdoc/testdata/spacewar/doc/coordination/Selfex.html @@ -2,7 +2,7 @@ - + Selfex diff --git a/ajdoc/testdata/spacewar/doc/coordination/TimeoutException.html b/ajdoc/testdata/spacewar/doc/coordination/TimeoutException.html index 6c0ed5e8c..9cc93e7ff 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/TimeoutException.html +++ b/ajdoc/testdata/spacewar/doc/coordination/TimeoutException.html @@ -2,7 +2,7 @@ - + TimeoutException diff --git a/ajdoc/testdata/spacewar/doc/coordination/package-frame.html b/ajdoc/testdata/spacewar/doc/coordination/package-frame.html index 881d93bd3..3b2752a15 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/package-frame.html +++ b/ajdoc/testdata/spacewar/doc/coordination/package-frame.html @@ -2,7 +2,7 @@ - + coordination diff --git a/ajdoc/testdata/spacewar/doc/coordination/package-summary.html b/ajdoc/testdata/spacewar/doc/coordination/package-summary.html index eb7fd0ecc..a1d3ffd30 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/package-summary.html +++ b/ajdoc/testdata/spacewar/doc/coordination/package-summary.html @@ -1 +1 @@ -coordination

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV PACKAGE NEXT PACKAGE

FRAMES NO FRAMES

Package coordination

Interface Summary
Condition
CoordinationAction
Exclusion

Class Summary
Coordinator
Method
MethodState
Mutex
Selfex

Exception Summary
TimeoutException

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV PACKAGE NEXT PACKAGE

FRAMES NO FRAMES

\ No newline at end of file +coordination

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV PACKAGE NEXT PACKAGE

FRAMES NO FRAMES

Package coordination

Interface Summary
Condition	Interface for pre-conditions that are passed to guardedEntry methods of Coordinator.
CoordinationAction	Interface for coordination actions that are passed to guardedEntry methods of Coordinator.
Exclusion

Class Summary
Coordinator The Coordinator class provides the basic functionality for synchronizing and coordinating different threads upon entering and exiting methods.
Method
MethodState
Mutex
Selfex

Exception Summary
TimeoutException

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV PACKAGE NEXT PACKAGE

FRAMES NO FRAMES

\ No newline at end of file diff --git a/ajdoc/testdata/spacewar/doc/coordination/package-tree.html b/ajdoc/testdata/spacewar/doc/coordination/package-tree.html index 2bdabe26d..3c51367e6 100644 --- a/ajdoc/testdata/spacewar/doc/coordination/package-tree.html +++ b/ajdoc/testdata/spacewar/doc/coordination/package-tree.html @@ -2,7 +2,7 @@ - + coordination Class Hierarchy diff --git a/ajdoc/testdata/spacewar/doc/deprecated-list.html b/ajdoc/testdata/spacewar/doc/deprecated-list.html index 9782a0275..ee96282eb 100644 --- a/ajdoc/testdata/spacewar/doc/deprecated-list.html +++ b/ajdoc/testdata/spacewar/doc/deprecated-list.html @@ -2,7 +2,7 @@ - + Deprecated List diff --git a/ajdoc/testdata/spacewar/doc/help-doc.html b/ajdoc/testdata/spacewar/doc/help-doc.html index 33cc34a68..9ec0b1d1e 100644 --- a/ajdoc/testdata/spacewar/doc/help-doc.html +++ b/ajdoc/testdata/spacewar/doc/help-doc.html @@ -2,7 +2,7 @@ - + API Help diff --git a/ajdoc/testdata/spacewar/doc/index-all.html b/ajdoc/testdata/spacewar/doc/index-all.html index ce298f72e..c11713e05 100644 --- a/ajdoc/testdata/spacewar/doc/index-all.html +++ b/ajdoc/testdata/spacewar/doc/index-all.html @@ -1 +1 @@ -Index

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV NEXT

FRAMES NO FRAMES

A B C D E F G H I K L M N O P Q R S T U W

A

accelerate(double, double) - Method in class spacewar.SpaceObject
actionPerformed(ActionEvent) - Method in class spacewar.SWFrame
addExclusion(Exclusion) - Method in class coordination.Method
addMutex(String[]) - Method in class coordination.Coordinator
addRobot() - Method in class spacewar.Game
addSelfex(String) - Method in class coordination.Coordinator

B

BULLET_SPEED - Static variable in class spacewar.Ship
Bullet - class spacewar.Bullet.
Bullet(Game, double, double, double, double) - Constructor for class spacewar.Bullet
bounce(Ship, Ship) - Static method in class spacewar.Ship

C

CLOCKWISE - Static variable in class spacewar.Ship
COUNTERCLOCKWISE - Static variable in class spacewar.Ship
Condition - interface coordination.Condition.
CoordinationAction - interface coordination.CoordinationAction.: __AJDECLID:300:__
Coordinator - class coordination.Coordinator.: __AJDECLID:302:__
Coordinator() - Constructor for class coordination.Coordinator
checkit() - Method in interface coordination.Condition
clear() - Method in class spacewar.InfoWin
clockTick() - Method in class spacewar.Bullet
clockTick() - Method in class spacewar.Game
clockTick() - Method in class spacewar.Registry
clockTick() - Method in class spacewar.Ship
clockTick() - Method in class spacewar.SpaceObject
coordination - package coordination
count - Variable in class coordination.Selfex

D

DEFAULT_ACCELERATION - Static variable in class spacewar.Ship
DEFAULT_ANGULAR_VELOCITY - Static variable in class spacewar.Ship
Debug - class spacewar.Debug.
Debug() - Constructor for class spacewar.Debug
Display - class spacewar.Display.
Display(Game) - Constructor for class spacewar.Display
Display.DisplayAspect - class spacewar.Display.DisplayAspect.
Display.DisplayAspect() - Constructor for class spacewar.Display.DisplayAspect
Display1 - class spacewar.Display1.
Display1(Game) - Constructor for class spacewar.Display1
Display1.SpaceObjectPainting - class spacewar.Display1.SpaceObjectPainting.
Display1.SpaceObjectPainting() - Constructor for class spacewar.Display1.SpaceObjectPainting
Display2 - class spacewar.Display2.
Display2(Game) - Constructor for class spacewar.Display2
Display2.SpaceObjectPainting - class spacewar.Display2.SpaceObjectPainting.
Display2.SpaceObjectPainting() - Constructor for class spacewar.Display2.SpaceObjectPainting
destroy() - Method in class spacewar.Robot
die() - Method in class spacewar.SpaceObject
doit() - Method in interface coordination.CoordinationAction
dummy() - Method in class spacewar.Registry

E

EnergyPacket - class spacewar.EnergyPacket.
EnergyPacket(Game, double, double, double, double, double) - Constructor for class spacewar.EnergyPacket
EnergyPacketProducer - class spacewar.EnergyPacketProducer.
EnergyPacketProducer(Game) - Constructor for class spacewar.EnergyPacketProducer
EnsureShipIsAlive - class spacewar.EnsureShipIsAlive.
EnsureShipIsAlive() - Constructor for class spacewar.EnsureShipIsAlive
Exclusion - interface coordination.Exclusion.
enterExclusion(String) - Method in interface coordination.Exclusion
enterExclusion(String) - Method in class coordination.Mutex
enterExclusion(String) - Method in class coordination.Selfex
enterInThread(Thread) - Method in class coordination.MethodState
error(Object) - Method in class spacewar.Game
exes - Variable in class coordination.Method
exitExclusion(String) - Method in interface coordination.Exclusion
exitExclusion(String) - Method in class coordination.Mutex
exitExclusion(String) - Method in class coordination.Selfex
exitInThread(Thread) - Method in class coordination.MethodState
expendEnergy(double) - Method in class spacewar.Ship

F

fire - Variable in class spacewar.KeyMapping
fire() - Method in class spacewar.Ship
frame - Variable in class spacewar.Display

G

Game - class spacewar.Game.
Game(String) - Constructor for class spacewar.Game
GameSynchronization - class spacewar.GameSynchronization.
GameSynchronization() - Constructor for class spacewar.GameSynchronization
game - Variable in class spacewar.Display
getDamage() - Method in class spacewar.Ship
getDamageLevel() - Method in class spacewar.Ship
getDisplay() - Method in class spacewar.SWFrame
getEnergy() - Method in class spacewar.EnergyPacket
getEnergy() - Method in class spacewar.Ship
getEnergyLevel() - Method in class spacewar.Ship
getGame() - Method in class spacewar.Display
getGame() - Method in class spacewar.EnergyPacketProducer
getGame() - Method in class spacewar.Pilot
getGame() - Method in class spacewar.Registry
getGame() - Method in class spacewar.SWFrame
getGame() - Method in class spacewar.SpaceObject
getGame() - Method in class spacewar.Timer
getHeight() - Method in class spacewar.Game
getMenu() - Method in class spacewar.SWFrame
getNumber() - Method in class spacewar.Pilot
getObjects() - Method in class spacewar.Registry
getOldXPos() - Method in class spacewar.SpaceObject
getOldYPos() - Method in class spacewar.SpaceObject
getOrientation() - Method in class spacewar.Ship
getPilot() - Method in class spacewar.Ship
getPilot1() - Static method in class spacewar.Display
getPilot1() - Method in class spacewar.Game
getPilot2() - Static method in class spacewar.Display
getPilot2() - Method in class spacewar.Game
getRAcc() - Method in class spacewar.Ship
getRegistry() - Method in class spacewar.Game
getShip() - Method in class spacewar.Pilot
getShips() - Method in class spacewar.Registry
getSize() - Method in class spacewar.Bullet
getSize() - Method in class spacewar.EnergyPacket
getSize() - Method in class spacewar.Ship
getSize() - Method in class spacewar.SpaceObject
getTable() - Method in class spacewar.Registry
getWidth() - Method in class spacewar.Game
getXPos() - Method in class spacewar.SpaceObject
getXVel() - Method in class spacewar.SpaceObject
getYPos() - Method in class spacewar.SpaceObject
getYVel() - Method in class spacewar.SpaceObject
guardedEntry(String) - Method in class coordination.Coordinator
guardedEntry(String, Condition) - Method in class coordination.Coordinator
guardedEntry(String, CoordinationAction) - Method in class coordination.Coordinator
guardedEntry(String, Condition, CoordinationAction) - Method in class coordination.Coordinator
guardedEntryWithTimeout(String, long) - Method in class coordination.Coordinator
guardedEntryWithTimeout(String, Condition, long) - Method in class coordination.Coordinator
guardedEntryWithTimeout(String, CoordinationAction, long) - Method in class coordination.Coordinator
guardedEntryWithTimeout(String, Condition, CoordinationAction, long) - Method in class coordination.Coordinator
guardedExit(String) - Method in class coordination.Coordinator
guardedExit(String, CoordinationAction) - Method in class coordination.Coordinator

H

handleCollision(SpaceObject) - Method in class spacewar.Bullet
handleCollision(SpaceObject) - Method in class spacewar.EnergyPacket
handleCollision(SpaceObject) - Method in class spacewar.Ship
handleCollision(SpaceObject) - Method in class spacewar.SpaceObject
handleCollisions() - Method in class spacewar.Game
hasOtherThreadThan(Thread) - Method in class coordination.MethodState

I

InfoWin - class spacewar.InfoWin.
InfoWin() - Constructor for class spacewar.InfoWin
inflictDamage(double) - Method in class spacewar.Ship
isAlive() - Method in class spacewar.SpaceObject
isCollision(SpaceObject, SpaceObject) - Static method in class spacewar.Game

K

KeyMapping - class spacewar.KeyMapping.
KeyMapping(int, int, int, int) - Constructor for class spacewar.KeyMapping
keyMapping1 - Static variable in class spacewar.KeyMapping
keyMapping2 - Static variable in class spacewar.KeyMapping
keyPressed(KeyEvent) - Method in class spacewar.Player
keyReleased(KeyEvent) - Method in class spacewar.Player
keyTyped(KeyEvent) - Method in class spacewar.Player

L

left - Variable in class spacewar.KeyMapping

M

MAX_DAMAGE - Static variable in class spacewar.Ship
Method - class coordination.Method.
Method(String) - Constructor for class coordination.Method
MethodState - class coordination.MethodState.
MethodState() - Constructor for class coordination.MethodState
Mutex - class coordination.Mutex.
Mutex(String[]) - Constructor for class coordination.Mutex
main(String[]) - Static method in class spacewar.Game
methodName - Variable in class coordination.Selfex
methodNames - Variable in class coordination.Mutex
methodStates - Variable in class coordination.Mutex

N

name - Variable in class coordination.Method
newPlayer(int) - Method in class spacewar.Game
newRobot(int) - Method in class spacewar.Game
newShip(Pilot) - Method in class spacewar.Game
noticeSizeChange() - Method in class spacewar.Display
noticeSizeChange() - Method in class spacewar.Display1
noticeSizeChange() - Method in class spacewar.Display2

O

offGraphics - Variable in class spacewar.Display
offImage - Variable in class spacewar.Display

P

Pilot - class spacewar.Pilot.
Pilot(Game, int) - Constructor for class spacewar.Pilot
Player - class spacewar.Player.
Player(Game, int) - Constructor for class spacewar.Player
paint(Graphics) - Method in class spacewar.Display
paintLevels(Graphics, Ship, int, int) - Static method in class spacewar.Display1
paintLevels(Graphics, Ship, int, int) - Method in class spacewar.Display2
paintObjects(Graphics) - Method in class spacewar.Display
paintObjects(Graphics) - Method in class spacewar.Display1
paintObjects(Graphics) - Method in class spacewar.Display2
paintStatus(Graphics) - Method in class spacewar.Display
paintStatus(Graphics) - Method in class spacewar.Display1
paintStatus(Graphics) - Method in class spacewar.Display2
prettyName - Variable in class coordination.Mutex
print(String) - Method in class spacewar.InfoWin
printNames() - Method in interface coordination.Exclusion
printNames() - Method in class coordination.Mutex
printNames() - Method in class coordination.Selfex
println(String) - Method in class spacewar.InfoWin
produceAPacket() - Method in class spacewar.EnergyPacketProducer

Q

quit() - Method in class spacewar.Game

R

Registry - class spacewar.Registry.
Registry(Game) - Constructor for class spacewar.Registry
Registry.RegistrationProtection - class spacewar.Registry.RegistrationProtection.
Registry.RegistrationProtection() - Constructor for class spacewar.Registry.RegistrationProtection
RegistrySynchronization - class spacewar.RegistrySynchronization.
RegistrySynchronization() - Constructor for class spacewar.RegistrySynchronization
Robot - class spacewar.Robot.
Robot(Game, int) - Constructor for class spacewar.Robot
register(SpaceObject) - Method in class spacewar.Registry
removeExclusion(Exclusion) - Method in class coordination.Method
removeMutex(String[]) - Method in class coordination.Coordinator
removeSelfex(String) - Method in class coordination.Coordinator
repairDamage(double) - Method in class spacewar.Ship
resetShips() - Method in class spacewar.Game
right - Variable in class spacewar.KeyMapping
rotate(int) - Method in class spacewar.Ship
run() - Method in class spacewar.EnergyPacketProducer
run() - Method in class spacewar.Game
run() - Method in class spacewar.Robot
run() - Method in class spacewar.Timer

S

STOP - Static variable in class spacewar.Ship
SWFrame - class spacewar.SWFrame.
SWFrame(Game, Display) - Constructor for class spacewar.SWFrame
Selfex - class coordination.Selfex.
Selfex(String) - Constructor for class coordination.Selfex
Ship - class spacewar.Ship.
Ship(Game, double, double, double) - Constructor for class spacewar.Ship
SpaceObject - class spacewar.SpaceObject.
SpaceObject(Game, double, double, double, double) - Constructor for class spacewar.SpaceObject
setAcceleration(double) - Method in class spacewar.Ship
setAngularVelocity(double) - Method in class spacewar.Ship
setIsAlive(boolean) - Method in class spacewar.SpaceObject
setPilot(Pilot) - Method in class spacewar.Ship
setShip(Ship) - Method in class spacewar.Pilot
setXVel(double) - Method in class spacewar.SpaceObject
setYVel(double) - Method in class spacewar.SpaceObject
ship - Variable in class spacewar.Pilot
sleepForABit(int) - Method in class spacewar.Robot
spacewar - package spacewar
start() - Method in class spacewar.Robot

T

TimeoutException - exception coordination.TimeoutException.
TimeoutException(long) - Constructor for class coordination.TimeoutException
Timer - class spacewar.Timer.
Timer(Game) - Constructor for class spacewar.Timer
testExclusion(String) - Method in interface coordination.Exclusion
testExclusion(String) - Method in class coordination.Mutex
testExclusion(String) - Method in class coordination.Selfex
thread - Variable in class coordination.Selfex
threads - Variable in class coordination.MethodState
thrust - Variable in class spacewar.KeyMapping
thrust(boolean) - Method in class spacewar.Ship
time - Variable in class coordination.TimeoutException

U

unregister(SpaceObject) - Method in class spacewar.Registry
update(Graphics) - Method in class spacewar.Display

W

waitForABit() - Method in class spacewar.EnergyPacketProducer

A B C D E F G H I K L M N O P Q R S T U W

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV NEXT

FRAMES NO FRAMES

\ No newline at end of file +Index

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV NEXT

FRAMES NO FRAMES

A B C D E F G H I K L M N O P Q R S T U W

A

accelerate(double, double) - Method in class spacewar.SpaceObject
actionPerformed(ActionEvent) - Method in class spacewar.SWFrame
addExclusion(Exclusion) - Method in class coordination.Method
addMutex(String[]) - Method in class coordination.Coordinator: Takes an array of multi-part method names and marks those methods as mutually exclusive.
addRobot() - Method in class spacewar.Game: add a robot to the game.
addSelfex(String) - Method in class coordination.Coordinator: Takes a multi-part method name (eg "BoundedBuffer.put") and marks that method as self-exclusive.

B

BULLET_SPEED - Static variable in class spacewar.Ship
Bullet - class spacewar.Bullet.
Bullet(Game, double, double, double, double) - Constructor for class spacewar.Bullet
bounce(Ship, Ship) - Static method in class spacewar.Ship

C

CLOCKWISE - Static variable in class spacewar.Ship
COUNTERCLOCKWISE - Static variable in class spacewar.Ship
Condition - interface coordination.Condition.: Interface for pre-conditions that are passed to guardedEntry methods of Coordinator.
CoordinationAction - interface coordination.CoordinationAction.: Interface for coordination actions that are passed to guardedEntry methods of Coordinator.
Coordinator - class coordination.Coordinator.: The Coordinator class provides the basic functionality for synchronizing and coordinating different threads upon entering and exiting methods.
Coordinator() - Constructor for class coordination.Coordinator
checkit() - Method in interface coordination.Condition: This method is called automatically by Coordinator.guardedEntry(...) and it's called everytime the coordination state changes.
clear() - Method in class spacewar.InfoWin
clockTick() - Method in class spacewar.Bullet
clockTick() - Method in class spacewar.Game
clockTick() - Method in class spacewar.Registry
clockTick() - Method in class spacewar.Ship
clockTick() - Method in class spacewar.SpaceObject: Move 1 unit of time's worth of distance.
coordination - package coordination
count - Variable in class coordination.Selfex

D

DEFAULT_ACCELERATION - Static variable in class spacewar.Ship
DEFAULT_ANGULAR_VELOCITY - Static variable in class spacewar.Ship
Debug - class spacewar.Debug.: This aspect specifies debugging information to be output to the information window.
Debug() - Constructor for class spacewar.Debug
Display - class spacewar.Display.: The display aspects capture the look and feel of the Game in modular pluggable units.
Display(Game) - Constructor for class spacewar.Display
Display.DisplayAspect - class spacewar.Display.DisplayAspect.
Display.DisplayAspect() - Constructor for class spacewar.Display.DisplayAspect
Display1 - class spacewar.Display1.: This is the standard display aspect.
Display1(Game) - Constructor for class spacewar.Display1
Display1.SpaceObjectPainting - class spacewar.Display1.SpaceObjectPainting.
Display1.SpaceObjectPainting() - Constructor for class spacewar.Display1.SpaceObjectPainting
Display2 - class spacewar.Display2.: This is the cheap Display aspect.
Display2(Game) - Constructor for class spacewar.Display2
Display2.SpaceObjectPainting - class spacewar.Display2.SpaceObjectPainting.
Display2.SpaceObjectPainting() - Constructor for class spacewar.Display2.SpaceObjectPainting
destroy() - Method in class spacewar.Robot
die() - Method in class spacewar.SpaceObject
doit() - Method in interface coordination.CoordinationAction: This method is called by Coordinator.guardedEntry(...) and Coordinator.guardedExit(...).
dummy() - Method in class spacewar.Registry

E

EnergyPacket - class spacewar.EnergyPacket.
EnergyPacket(Game, double, double, double, double, double) - Constructor for class spacewar.EnergyPacket
EnergyPacketProducer - class spacewar.EnergyPacketProducer.
EnergyPacketProducer(Game) - Constructor for class spacewar.EnergyPacketProducer
EnsureShipIsAlive - class spacewar.EnsureShipIsAlive.: This aspect makes sure that the ship is alive before performing any console commands.
EnsureShipIsAlive() - Constructor for class spacewar.EnsureShipIsAlive
Exclusion - interface coordination.Exclusion.
enterExclusion(String) - Method in interface coordination.Exclusion
enterExclusion(String) - Method in class coordination.Mutex
enterExclusion(String) - Method in class coordination.Selfex
enterInThread(Thread) - Method in class coordination.MethodState
error(Object) - Method in class spacewar.Game
exes - Variable in class coordination.Method
exitExclusion(String) - Method in interface coordination.Exclusion
exitExclusion(String) - Method in class coordination.Mutex
exitExclusion(String) - Method in class coordination.Selfex
exitInThread(Thread) - Method in class coordination.MethodState
expendEnergy(double) - Method in class spacewar.Ship: returns false if energy is out, otherwise decrements energy by amount and returns true

F

fire - Variable in class spacewar.KeyMapping
fire() - Method in class spacewar.Ship: create a bullet and fire it
frame - Variable in class spacewar.Display

G

Game - class spacewar.Game.: The Game class is the root of the spacewar game.
Game(String) - Constructor for class spacewar.Game
GameSynchronization - class spacewar.GameSynchronization.: This aspect ensures synchronized access to methods of the Game in the presence of several threads.
GameSynchronization() - Constructor for class spacewar.GameSynchronization
game - Variable in class spacewar.Display
getDamage() - Method in class spacewar.Ship
getDamageLevel() - Method in class spacewar.Ship
getDisplay() - Method in class spacewar.SWFrame
getEnergy() - Method in class spacewar.EnergyPacket
getEnergy() - Method in class spacewar.Ship
getEnergyLevel() - Method in class spacewar.Ship
getGame() - Method in class spacewar.Display
getGame() - Method in class spacewar.EnergyPacketProducer
getGame() - Method in class spacewar.Pilot
getGame() - Method in class spacewar.Registry
getGame() - Method in class spacewar.SWFrame
getGame() - Method in class spacewar.SpaceObject
getGame() - Method in class spacewar.Timer
getHeight() - Method in class spacewar.Game: returns the height of the screen, delegating to screenSize
getMenu() - Method in class spacewar.SWFrame
getNumber() - Method in class spacewar.Pilot
getObjects() - Method in class spacewar.Registry
getOldXPos() - Method in class spacewar.SpaceObject
getOldYPos() - Method in class spacewar.SpaceObject
getOrientation() - Method in class spacewar.Ship
getPilot() - Method in class spacewar.Ship
getPilot1() - Static method in class spacewar.Display
getPilot1() - Method in class spacewar.Game
getPilot2() - Static method in class spacewar.Display
getPilot2() - Method in class spacewar.Game
getRAcc() - Method in class spacewar.Ship
getRegistry() - Method in class spacewar.Game
getShip() - Method in class spacewar.Pilot
getShips() - Method in class spacewar.Registry
getSize() - Method in class spacewar.Bullet
getSize() - Method in class spacewar.EnergyPacket
getSize() - Method in class spacewar.Ship
getSize() - Method in class spacewar.SpaceObject
getTable() - Method in class spacewar.Registry
getWidth() - Method in class spacewar.Game: returns the width of the screen, delegating to screenSize
getXPos() - Method in class spacewar.SpaceObject
getXVel() - Method in class spacewar.SpaceObject
getYPos() - Method in class spacewar.SpaceObject
getYVel() - Method in class spacewar.SpaceObject
guardedEntry(String) - Method in class coordination.Coordinator: This method is the guard for enforcing all synchronization and coordination constraints of a given method, and it should be called just before the method is executed.
guardedEntry(String, Condition) - Method in class coordination.Coordinator: Just like guardedEntry(String methName), but the given method is executed only when the given condition is true.
guardedEntry(String, CoordinationAction) - Method in class coordination.Coordinator: Just like guardedEntry(String methName), but with an additional coordination action that is executed before the given method is executed.
guardedEntry(String, Condition, CoordinationAction) - Method in class coordination.Coordinator: Just like guardedEntry(String methName), but the given method is executed only when the given condition is true; the additional coordination action that is executed before the given method is executed.
guardedEntryWithTimeout(String, long) - Method in class coordination.Coordinator: This method is similar to guardedEntry, but it takes an additional parameter - the milliseconds after which any suspension will abort with a timeout.
guardedEntryWithTimeout(String, Condition, long) - Method in class coordination.Coordinator: This method is similar to guardedEntry, but it takes an additional parameter - the milliseconds after which any suspension will abort with a timeout.
guardedEntryWithTimeout(String, CoordinationAction, long) - Method in class coordination.Coordinator: This method is similar to guardedEntry, but it takes an additional parameter - the milliseconds after which any suspension will abort with a timeout.
guardedEntryWithTimeout(String, Condition, CoordinationAction, long) - Method in class coordination.Coordinator: This method is similar to guardedEntry, but it takes an additional parameter - the milliseconds after which any suspension will abort with a timeout.
guardedExit(String) - Method in class coordination.Coordinator: This method provides the means for updating all synchronization and coordination state after the execution of a given method, and it should be called after the method is executed.
guardedExit(String, CoordinationAction) - Method in class coordination.Coordinator: Just like guardedExit(String methName) but with an additional coordination action that is executed.

H

handleCollision(SpaceObject) - Method in class spacewar.Bullet
handleCollision(SpaceObject) - Method in class spacewar.EnergyPacket
handleCollision(SpaceObject) - Method in class spacewar.Ship
handleCollision(SpaceObject) - Method in class spacewar.SpaceObject: resolve the effects of colliding with a space object.
handleCollisions() - Method in class spacewar.Game
hasOtherThreadThan(Thread) - Method in class coordination.MethodState

I

InfoWin - class spacewar.InfoWin.
InfoWin() - Constructor for class spacewar.InfoWin
inflictDamage(double) - Method in class spacewar.Ship: increments damage by amount and handles the destruction of a ship if damage reaches MAX_DAMAGE.
isAlive() - Method in class spacewar.SpaceObject
isCollision(SpaceObject, SpaceObject) - Static method in class spacewar.Game

K

KeyMapping - class spacewar.KeyMapping.
KeyMapping(int, int, int, int) - Constructor for class spacewar.KeyMapping
keyMapping1 - Static variable in class spacewar.KeyMapping
keyMapping2 - Static variable in class spacewar.KeyMapping
keyPressed(KeyEvent) - Method in class spacewar.Player
keyReleased(KeyEvent) - Method in class spacewar.Player
keyTyped(KeyEvent) - Method in class spacewar.Player

L

left - Variable in class spacewar.KeyMapping

M

MAX_DAMAGE - Static variable in class spacewar.Ship
Method - class coordination.Method.
Method(String) - Constructor for class coordination.Method
MethodState - class coordination.MethodState.
MethodState() - Constructor for class coordination.MethodState
Mutex - class coordination.Mutex.
Mutex(String[]) - Constructor for class coordination.Mutex
main(String[]) - Static method in class spacewar.Game: To run the game from top level, simply say Java Game, as usual.
methodName - Variable in class coordination.Selfex
methodNames - Variable in class coordination.Mutex
methodStates - Variable in class coordination.Mutex

N

name - Variable in class coordination.Method
newPlayer(int) - Method in class spacewar.Game: returns a new player.
newRobot(int) - Method in class spacewar.Game: returns a new robot.
newShip(Pilot) - Method in class spacewar.Game: returns a new ship.
noticeSizeChange() - Method in class spacewar.Display
noticeSizeChange() - Method in class spacewar.Display1
noticeSizeChange() - Method in class spacewar.Display2

O

offGraphics - Variable in class spacewar.Display
offImage - Variable in class spacewar.Display

P

Pilot - class spacewar.Pilot.: Pilot is the abstract superclass of Player and Robot.
Pilot(Game, int) - Constructor for class spacewar.Pilot
Player - class spacewar.Player.
Player(Game, int) - Constructor for class spacewar.Player
paint(Graphics) - Method in class spacewar.Display
paintLevels(Graphics, Ship, int, int) - Static method in class spacewar.Display1
paintLevels(Graphics, Ship, int, int) - Method in class spacewar.Display2
paintObjects(Graphics) - Method in class spacewar.Display
paintObjects(Graphics) - Method in class spacewar.Display1
paintObjects(Graphics) - Method in class spacewar.Display2
paintStatus(Graphics) - Method in class spacewar.Display
paintStatus(Graphics) - Method in class spacewar.Display1
paintStatus(Graphics) - Method in class spacewar.Display2
prettyName - Variable in class coordination.Mutex
print(String) - Method in class spacewar.InfoWin
printNames() - Method in interface coordination.Exclusion
printNames() - Method in class coordination.Mutex
printNames() - Method in class coordination.Selfex
println(String) - Method in class spacewar.InfoWin
produceAPacket() - Method in class spacewar.EnergyPacketProducer

Q

quit() - Method in class spacewar.Game: leave the game.

R

Registry - class spacewar.Registry.: The Registry keeps track of all the space objects that are floating around.
Registry(Game) - Constructor for class spacewar.Registry
Registry.RegistrationProtection - class spacewar.Registry.RegistrationProtection.
Registry.RegistrationProtection() - Constructor for class spacewar.Registry.RegistrationProtection
RegistrySynchronization - class spacewar.RegistrySynchronization.: This aspect ensures synchronized access to methods of the Registry in the presence of several threads.
RegistrySynchronization() - Constructor for class spacewar.RegistrySynchronization
Robot - class spacewar.Robot.: Robot is an automatic pilot that now has quite a bit of intelligence.
Robot(Game, int) - Constructor for class spacewar.Robot
register(SpaceObject) - Method in class spacewar.Registry
removeExclusion(Exclusion) - Method in class coordination.Method
removeMutex(String[]) - Method in class coordination.Coordinator: Takes an array of multi-part method names that correspond to an existing mutex set and remove the mutual exclusion constraint.
removeSelfex(String) - Method in class coordination.Coordinator: Takes a multi-part method name (e.g.
repairDamage(double) - Method in class spacewar.Ship: repairs some damage
resetShips() - Method in class spacewar.Game: resurrect the ships in the game.
right - Variable in class spacewar.KeyMapping
rotate(int) - Method in class spacewar.Ship: affect rotation thrusters.
run() - Method in class spacewar.EnergyPacketProducer
run() - Method in class spacewar.Game
run() - Method in class spacewar.Robot
run() - Method in class spacewar.Timer

S

STOP - Static variable in class spacewar.Ship
SWFrame - class spacewar.SWFrame.
SWFrame(Game, Display) - Constructor for class spacewar.SWFrame
Selfex - class coordination.Selfex.
Selfex(String) - Constructor for class coordination.Selfex
Ship - class spacewar.Ship.
Ship(Game, double, double, double) - Constructor for class spacewar.Ship
SpaceObject - class spacewar.SpaceObject.: SpaceObjects are objects that float around in space.
SpaceObject(Game, double, double, double, double) - Constructor for class spacewar.SpaceObject
setAcceleration(double) - Method in class spacewar.Ship: First check to make sure we have enough energy to accelerate.
setAngularVelocity(double) - Method in class spacewar.Ship: First check to make sure we have enough energy to rotate.
setIsAlive(boolean) - Method in class spacewar.SpaceObject
setPilot(Pilot) - Method in class spacewar.Ship
setShip(Ship) - Method in class spacewar.Pilot
setXVel(double) - Method in class spacewar.SpaceObject
setYVel(double) - Method in class spacewar.SpaceObject
ship - Variable in class spacewar.Pilot
sleepForABit(int) - Method in class spacewar.Robot
spacewar - package spacewar
start() - Method in class spacewar.Robot

T

TimeoutException - exception coordination.TimeoutException.
TimeoutException(long) - Constructor for class coordination.TimeoutException
Timer - class spacewar.Timer.
Timer(Game) - Constructor for class spacewar.Timer
testExclusion(String) - Method in interface coordination.Exclusion
testExclusion(String) - Method in class coordination.Mutex
testExclusion(String) - Method in class coordination.Selfex
thread - Variable in class coordination.Selfex
threads - Variable in class coordination.MethodState
thrust - Variable in class spacewar.KeyMapping
thrust(boolean) - Method in class spacewar.Ship: turn on acceleration
time - Variable in class coordination.TimeoutException

U

unregister(SpaceObject) - Method in class spacewar.Registry
update(Graphics) - Method in class spacewar.Display

W

waitForABit() - Method in class spacewar.EnergyPacketProducer

A B C D E F G H I K L M N O P Q R S T U W

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV NEXT

FRAMES NO FRAMES

\ No newline at end of file diff --git a/ajdoc/testdata/spacewar/doc/index.html b/ajdoc/testdata/spacewar/doc/index.html index 94af92a16..917bdddf3 100644 --- a/ajdoc/testdata/spacewar/doc/index.html +++ b/ajdoc/testdata/spacewar/doc/index.html @@ -2,7 +2,7 @@ - + Generated Documentation (Untitled) diff --git a/ajdoc/testdata/spacewar/doc/overview-frame.html b/ajdoc/testdata/spacewar/doc/overview-frame.html index efda1d625..892d024b8 100644 --- a/ajdoc/testdata/spacewar/doc/overview-frame.html +++ b/ajdoc/testdata/spacewar/doc/overview-frame.html @@ -2,7 +2,7 @@ - + Overview diff --git a/ajdoc/testdata/spacewar/doc/overview-summary.html b/ajdoc/testdata/spacewar/doc/overview-summary.html index a0838bc1d..a98c390a1 100644 --- a/ajdoc/testdata/spacewar/doc/overview-summary.html +++ b/ajdoc/testdata/spacewar/doc/overview-summary.html @@ -2,7 +2,7 @@ - + Overview diff --git a/ajdoc/testdata/spacewar/doc/overview-tree.html b/ajdoc/testdata/spacewar/doc/overview-tree.html index a16f651e9..92ee3fbca 100644 --- a/ajdoc/testdata/spacewar/doc/overview-tree.html +++ b/ajdoc/testdata/spacewar/doc/overview-tree.html @@ -2,7 +2,7 @@ - + Class Hierarchy diff --git a/ajdoc/testdata/spacewar/doc/packages.html b/ajdoc/testdata/spacewar/doc/packages.html index bd8d6ef9e..7c7020cd9 100644 --- a/ajdoc/testdata/spacewar/doc/packages.html +++ b/ajdoc/testdata/spacewar/doc/packages.html @@ -2,7 +2,7 @@ - + diff --git a/ajdoc/testdata/spacewar/doc/serialized-form.html b/ajdoc/testdata/spacewar/doc/serialized-form.html index 32345c902..1fbe6e337 100644 --- a/ajdoc/testdata/spacewar/doc/serialized-form.html +++ b/ajdoc/testdata/spacewar/doc/serialized-form.html @@ -1 +1 @@ -Serialized Form

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV NEXT

FRAMES NO FRAMES

Serialized Form

Package coordination

Class coordination.TimeoutException extends java.lang.Exception implements Serializable

Serialized Fields

time

long time

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV NEXT

FRAMES NO FRAMES

\ No newline at end of file +Serialized Form

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV NEXT

FRAMES NO FRAMES

Serialized Form

Package coordination

Class coordination.TimeoutException extends java.lang.Exception implements Serializable

Serialized Fields

time

long time

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV NEXT

FRAMES NO FRAMES

\ No newline at end of file diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Bullet.html b/ajdoc/testdata/spacewar/doc/spacewar/Bullet.html index bbd332bbd..855b30afe 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Bullet.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Bullet.html @@ -2,7 +2,7 @@ - + Bullet @@ -360,7 +360,7 @@ void handleCollision(handleCollision in class SpaceObject

- +

Parameters:

obj - the space object that this object is colliding with.

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Debug.html b/ajdoc/testdata/spacewar/doc/spacewar/Debug.html index 512f579fe..644872feb 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Debug.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Debug.html @@ -2,7 +2,7 @@ - + Debug @@ -94,6 +94,30 @@ java.lang.Object

+ This aspect specifies debugging information to be output to the + information window. + + When the debug aspect is compiled in the Frame menu has several checkbox + items that can be used to control the amount of tracing information + displayed. (By default the first three are off, because they generate + so much information.) + + There are two reasons to gather all this debugging code into an aspect + like this: + + (1) It makes it easier to understand when it is all in one place. + + (2) It means that we can "plug and debug". We can enable/disable + the debugging code simply by weaving or not weaving this + aspect in. + + All in all, this is a lot better than the usual practice of writing + complex debugging code and then deleting it when the bug is found, + only to regret it a month later when a related bug surfaces. (Or even + the same bug!) + + This file also defines a class InfoWin, which it uses to display all the + debugging information.

afterReturning

afterReturning(SWFrame): -

Advises: spacewar.Display
+

Advises: spacewar.Display

before

before(): allConstructorsCut.. -

Advises: spacewar.DisplayAspect.afterReturning, spacewar.Display, spacewar.EnergyPacketProducer.produceAPacket, spacewar.Game.main, spacewar.Game, spacewar.Game.newPlayer, spacewar.Game.newRobot, spacewar.Game.newShip, spacewar.KeyMapping, spacewar.Ship.fire
+

afterReturning

afterReturning(): allConstructorsCut.. -

before

before(): allInitializationsCut.. -

Advises: spacewar.EnsureShipIsAlive, spacewar.GameSynchronization, spacewar.RegistrySynchronization, spacewar.Bullet, spacewar.Display, spacewar.Display1, spacewar.Display2, spacewar.EnergyPacket, spacewar.EnergyPacketProducer, spacewar.Game, spacewar.Pilot, spacewar.Player, spacewar.KeyMapping, spacewar.Registry, spacewar.Robot, spacewar.Ship, spacewar.SpaceObject, spacewar.SWFrame, spacewar.Timer
+

afterReturning

afterReturning(): allInitializationsCut.. -

before

before(): allMethodsCut.. -

afterReturning

afterReturning(): allMethodsCut.. -

@@ -250,7 +274,7 @@ java.lang.Object

afterReturning

afterReturning(Registry): .. -

Advises: spacewar.Registry.dummy, spacewar.SpaceObject, spacewar.SpaceObject.die
+

Advises: spacewar.Registry.dummy, spacewar.SpaceObject, spacewar.SpaceObject.die

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Display.DisplayAspect.html b/ajdoc/testdata/spacewar/doc/spacewar/Display.DisplayAspect.html index c8db3e6b4..7757aed41 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Display.DisplayAspect.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Display.DisplayAspect.html @@ -2,7 +2,7 @@ - + Display.DisplayAspect @@ -118,7 +118,7 @@ java.lang.Object afterReturning(Display):

Advises: spacewar.DisplayAspect.afterReturning,

-afterReturning(Display): ..

Advises: spacewar.SWFrame

+afterReturning(Display): ..

Advises: spacewar.SWFrame

afterReturning():

Advises: spacewar.Timer.run

@@ -183,7 +183,7 @@ java.lang.Object

afterReturning

afterReturning(Display): .. -

Advises: spacewar.SWFrame
+

Advises: spacewar.SWFrame

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Display.html b/ajdoc/testdata/spacewar/doc/spacewar/Display.html index 4eb03a6ef..3237e2028 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Display.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Display.html @@ -2,7 +2,7 @@ - + Display @@ -102,6 +102,13 @@ java.lang.Object

+ The display aspects capture the look and feel of the Game in modular + pluggable units. + + The model is that constructing a concrete subclass of Display attaches that + kind of display to the game. It will Display the game as it goes along. + A game can have any number of displays. Any of the displays will accept + keyboard input.

@@ -158,7 +165,7 @@ java.lang.Object afterReturning(Display):

Advises: spacewar.DisplayAspect.afterReturning,
-afterReturning(Display): ..

Advises: spacewar.SWFrame
+afterReturning(Display): ..

Advises: spacewar.SWFrame
afterReturning():

Advises: spacewar.Timer.run
@@ -379,7 +386,7 @@ java.lang.Object

afterReturning

afterReturning(Display): .. -

Advises: spacewar.SWFrame
+

Advises: spacewar.SWFrame

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Display1.SpaceObjectPainting.html b/ajdoc/testdata/spacewar/doc/spacewar/Display1.SpaceObjectPainting.html index 59aee10dc..7fc01e317 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Display1.SpaceObjectPainting.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Display1.SpaceObjectPainting.html @@ -2,7 +2,7 @@ - + Display1.SpaceObjectPainting diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Display1.html b/ajdoc/testdata/spacewar/doc/spacewar/Display1.html index f00405e62..548f6275c 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Display1.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Display1.html @@ -2,7 +2,7 @@ - + Display1 @@ -100,6 +100,7 @@ java.lang.Object

+ This is the standard display aspect.

@@ -164,7 +165,7 @@ java.lang.Object afterReturning(Display):

Advises: spacewar.DisplayAspect.afterReturning,
-afterReturning(Display): ..

Advises: spacewar.SWFrame
+afterReturning(Display): ..

Advises: spacewar.SWFrame
afterReturning():

Advises: spacewar.Timer.run
@@ -404,7 +405,7 @@ java.lang.Object

afterReturning

afterReturning(Display): .. -

Advises: spacewar.SWFrame
+

Advises: spacewar.SWFrame

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Display2.SpaceObjectPainting.html b/ajdoc/testdata/spacewar/doc/spacewar/Display2.SpaceObjectPainting.html index 0d07c0c1f..5d32c6a58 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Display2.SpaceObjectPainting.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Display2.SpaceObjectPainting.html @@ -2,7 +2,7 @@ - + Display2.SpaceObjectPainting diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Display2.html b/ajdoc/testdata/spacewar/doc/spacewar/Display2.html index abdaa720a..542e04fca 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Display2.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Display2.html @@ -2,7 +2,7 @@ - + Display2 @@ -100,6 +100,7 @@ java.lang.Object

+ This is the cheap Display aspect.

afterReturning

afterReturning(Display): .. -

Advises: spacewar.SWFrame
+

Advises: spacewar.SWFrame

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/EnergyPacket.html b/ajdoc/testdata/spacewar/doc/spacewar/EnergyPacket.html index b918117b4..577088599 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/EnergyPacket.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/EnergyPacket.html @@ -2,7 +2,7 @@ - + EnergyPacket @@ -155,7 +155,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning

- + + Move 1 unit of time's worth of distance. @@ -385,7 +386,7 @@ void handleCollision(handleCollision in class SpaceObject

- +

Parameters:

obj - the space object that this object is colliding with.

@@ -551,6 +552,9 @@ void clockTick()

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning

+ Move 1 unit of time's worth of distance. I.e. increment xPos by xVel + and yPos by yVel. If we move off an edge of the screen move us back + in the opposite edge.

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/EnergyPacketProducer.html b/ajdoc/testdata/spacewar/doc/spacewar/EnergyPacketProducer.html index 9bfaa3e10..419598fd5 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/EnergyPacketProducer.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/EnergyPacketProducer.html @@ -2,7 +2,7 @@ - + EnergyPacketProducer diff --git a/ajdoc/testdata/spacewar/doc/spacewar/EnsureShipIsAlive.html b/ajdoc/testdata/spacewar/doc/spacewar/EnsureShipIsAlive.html index bda2f637c..df30697b9 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/EnsureShipIsAlive.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/EnsureShipIsAlive.html @@ -2,7 +2,7 @@ - + EnsureShipIsAlive @@ -94,6 +94,8 @@ java.lang.Object

+ This aspect makes sure that the ship is alive before performing any console + commands.

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Game.html b/ajdoc/testdata/spacewar/doc/spacewar/Game.html index 7991cff92..6513d54cc 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Game.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Game.html @@ -2,7 +2,7 @@ - + Game @@ -98,6 +98,11 @@ java.lang.Object

+ The Game class is the root of the spacewar game. To start a spacewar + game, you can either call the main method, or instantiate this class + directly. + + Synchronization is done by the GameSynchronization aspect.

@@ -157,7 +162,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + + add a robot to the game. @@ -184,7 +190,7 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + returns the height of the screen, delegating to screenSize @@ -220,7 +226,7 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + returns the width of the screen, delegating to screenSize @@ -248,7 +254,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + + To run the game from top level, simply say Java Game, as usual. @@ -257,7 +264,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + + returns a new player. @@ -266,7 +274,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + + returns a new robot. @@ -275,7 +284,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + + returns a new ship. @@ -284,7 +294,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + + leave the game. @@ -293,7 +304,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + + resurrect the ships in the game. @@ -365,6 +377,9 @@ public static void main(java.lang.String[] args)

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
+ To run the game from top level, simply say Java Game, as usual. Passing + an argument makes the game run in demo mode. Without an argument it runs + in the normal player mode.; @@ -420,7 +435,7 @@ getWidth int getWidth()

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + returns the width of the screen, delegating to screenSize

@@ -434,7 +449,7 @@ getHeight int getHeight()

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + returns the height of the screen, delegating to screenSize

@@ -463,6 +478,7 @@ void addRobot()

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
+ add a robot to the game. This is a menu command.

@@ -477,6 +493,7 @@ void resetShips()

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
+ resurrect the ships in the game. This is a menu command.

@@ -491,6 +508,7 @@ void quit()

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
+ leave the game. This is a menu command.

@@ -519,6 +537,9 @@ newPlayer

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
+ returns a new player. With newRobot(int) and newShip(spacewar.Pilot), the only ways to make a Player, a Robot, or a Ship. + The structural invariant is that there should be no calls to + new of one of these three classes outside these three methods.

@@ -533,6 +554,9 @@ newRobot

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
+ returns a new robot. With newPlayer(int) and newShip(spacewar.Pilot), the only ways to make a Player, a Robot, or a Ship. + The structural invariant is that there should be no calls to + new of one of these three classes outside these three methods.

@@ -547,6 +571,10 @@ newShip

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
+ returns a new ship. With newRobot(int) and newPlayer(int), the only ways to make a Player, a Robot, or a + Ship. The structural invariant is that there should be no + calls to new of one of these three classes outside these three + methods.

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/GameSynchronization.html b/ajdoc/testdata/spacewar/doc/spacewar/GameSynchronization.html index c6e9902b5..81de1d506 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/GameSynchronization.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/GameSynchronization.html @@ -2,7 +2,7 @@ - + GameSynchronization @@ -95,6 +95,22 @@ java.lang.Object
+ This aspect ensures synchronized access to methods of the Game in the + presence of several threads. + + It uses the Coordinator class, from the AspectJ coordination library. + (This case is right on the borderline of being too simple to use the + coordination library, but we use it anyways to keep the similarity + with the RegistrySynchronizer.) + + It uses a per-Game coordination scheme, so there is one instance of + this class for each instance of the Game class. When this class is + constructed, it registers appropriate mutexes and selfexes using + the behavior inherited from Coordinator. + + The coordination constraints for the Game are simple. We just need to + make sure that newShip and handleCollisions are mutually exclusive. That + ensures that they we can't destroy a ship that has just been replaced.

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/InfoWin.html b/ajdoc/testdata/spacewar/doc/spacewar/InfoWin.html index ef55bd6e9..d68b46a6f 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/InfoWin.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/InfoWin.html @@ -2,7 +2,7 @@ - + InfoWin diff --git a/ajdoc/testdata/spacewar/doc/spacewar/KeyMapping.html b/ajdoc/testdata/spacewar/doc/spacewar/KeyMapping.html index 922f971eb..fb941109b 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/KeyMapping.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/KeyMapping.html @@ -2,7 +2,7 @@ - + KeyMapping diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Pilot.html b/ajdoc/testdata/spacewar/doc/spacewar/Pilot.html index ae41a1ad7..141cc4fab 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Pilot.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Pilot.html @@ -2,7 +2,7 @@ - + Pilot @@ -97,6 +97,7 @@ java.lang.Object
+ Pilot is the abstract superclass of Player and Robot.

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Player.html b/ajdoc/testdata/spacewar/doc/spacewar/Player.html index 9aba07d04..aac1d01dc 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Player.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Player.html @@ -2,7 +2,7 @@ - + Player diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Registry.RegistrationProtection.html b/ajdoc/testdata/spacewar/doc/spacewar/Registry.RegistrationProtection.html index 387ee4886..c6dfe8be0 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Registry.RegistrationProtection.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Registry.RegistrationProtection.html @@ -2,7 +2,7 @@ - + Registry.RegistrationProtection diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Registry.html b/ajdoc/testdata/spacewar/doc/spacewar/Registry.html index eba5e6a94..5f718c7d6 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Registry.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Registry.html @@ -2,7 +2,7 @@ - + Registry @@ -94,6 +94,10 @@ java.lang.Object
+ The Registry keeps track of all the space objects that are floating around. + It basically supports register, unregister and contents type operations. + + The synchronization is done by the RegistrySynchronization aspect.

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/RegistrySynchronization.html b/ajdoc/testdata/spacewar/doc/spacewar/RegistrySynchronization.html index ec9073730..395ea7278 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/RegistrySynchronization.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/RegistrySynchronization.html @@ -2,7 +2,7 @@ - + RegistrySynchronization @@ -95,6 +95,19 @@ java.lang.Object
+ This aspect ensures synchronized access to methods of the Registry in + the presence of several threads. + + It uses the Coordinator class, from the AspectJ coordination library. + + It uses a per-Registry coordination scheme, so there is one instance of + this class for each instance of the Registry class. When this class is + constructed, it registers appropriate mutexes and selfexes using the + behavior inherited from Coordinator. + + The mutating methods (register and unregister) should be self-exclusive. + Each reader method should be mutually exclusive with the mutating + methods. But the readers can run concurrently.

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Robot.html b/ajdoc/testdata/spacewar/doc/spacewar/Robot.html index fc0bca96a..f8369f0de 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Robot.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Robot.html @@ -2,7 +2,7 @@ - + Robot @@ -98,6 +98,8 @@ java.lang.Object
+ Robot is an automatic pilot that now has quite a bit of intelligence. + So, beware !

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/SWFrame.html b/ajdoc/testdata/spacewar/doc/spacewar/SWFrame.html index cf56119db..ad4d898af 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/SWFrame.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/SWFrame.html @@ -2,7 +2,7 @@ - + SWFrame diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Ship.html b/ajdoc/testdata/spacewar/doc/spacewar/Ship.html index 7e6a96ffc..7b68cf9cb 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Ship.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Ship.html @@ -2,7 +2,7 @@ - + Ship @@ -250,7 +250,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + returns false if energy is out, otherwise decrements energy by amount + and returns true @@ -259,7 +260,7 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + create a bullet and fire it @@ -412,7 +413,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + increments damage by amount and handles the destruction of a ship if + damage reaches MAX_DAMAGE. @@ -430,7 +432,7 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + repairs some damage @@ -439,7 +441,7 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + affect rotation thrusters. @@ -448,7 +450,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + + First check to make sure we have enough energy to accelerate. @@ -457,7 +460,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + + First check to make sure we have enough energy to rotate. @@ -502,7 +506,7 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + turn on acceleration @@ -786,7 +790,8 @@ expendEnergy boolean expendEnergy(double amount)

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + returns false if energy is out, otherwise decrements energy by amount + and returns true

@@ -800,7 +805,8 @@ inflictDamage void inflictDamage(double amount)

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + increments damage by amount and handles the destruction of a ship if + damage reaches MAX_DAMAGE.

@@ -814,7 +820,7 @@ repairDamage void repairDamage(double amount)

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + repairs some damage

@@ -846,6 +852,9 @@ void setAcceleration(double acc)

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
+ First check to make sure we have enough energy to accelerate. If + we do, then go ahead and do so. Acceleration is in the direction + we are already facing (i.e. orientation).

@@ -860,6 +869,8 @@ void setAngularVelocity(double omega)

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
+ First check to make sure we have enough energy to rotate. If + we do, then go ahead and do so.

@@ -873,7 +884,8 @@ rotate void rotate(int direction)

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + affect rotation thrusters. Direction can be one of CLOCKWISE, COUNTERCLOCKWISE, or zero for turning off + the thrusters.

@@ -887,7 +899,7 @@ thrust void thrust(boolean onOff)

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + turn on acceleration

@@ -901,7 +913,7 @@ fire void fire()

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + create a bullet and fire it

@@ -921,7 +933,7 @@ void handleCollision(handleCollision in class SpaceObject

-
+
Parameters:
obj - the space object that this object is colliding with.

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/SpaceObject.html b/ajdoc/testdata/spacewar/doc/spacewar/SpaceObject.html index 30d54d689..3859be498 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/SpaceObject.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/SpaceObject.html @@ -2,7 +2,7 @@ - + SpaceObject @@ -97,6 +97,16 @@ java.lang.Object
+ SpaceObjects are objects that float around in space. They support the + minimal SpaceObject protocol, having to do with position, velocity, + size and liveness. They are constructed with game, position, velocity + and size. When constructed, a spaceobject adds itself to the registry. + + When it dies, a spaceobject removes itself from the registry. But note + that it doesn't decide when to die, subclasses do that. + + The display aspects actually draw the space object on the screen and say + how much space it takes up there.

@@ -156,7 +166,8 @@ java.lang.Object

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
- + + Move 1 unit of time's worth of distance. @@ -244,7 +255,7 @@ java.lang.Object handleCollision(SpaceObject obj)
-           +           resolve the effects of colliding with a space object. @@ -492,6 +503,9 @@ void clockTick()

Advised by: spacewar.Debug.before, spacewar.Debug.afterReturning
+ Move 1 unit of time's worth of distance. I.e. increment xPos by xVel + and yPos by yVel. If we move off an edge of the screen move us back + in the opposite edge.

@@ -546,10 +560,10 @@ handleCollision
abstract void handleCollision(SpaceObject obj)

-
+
resolve the effects of colliding with a space object.

-
+
Parameters:
obj - the space object that this object is colliding with.

diff --git a/ajdoc/testdata/spacewar/doc/spacewar/Timer.html b/ajdoc/testdata/spacewar/doc/spacewar/Timer.html index b8c74608f..1c0a70d63 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/Timer.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/Timer.html @@ -2,7 +2,7 @@ - + Timer diff --git a/ajdoc/testdata/spacewar/doc/spacewar/package-frame.html b/ajdoc/testdata/spacewar/doc/spacewar/package-frame.html index 1f9712e29..90897079f 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/package-frame.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/package-frame.html @@ -2,7 +2,7 @@ - + spacewar diff --git a/ajdoc/testdata/spacewar/doc/spacewar/package-summary.html b/ajdoc/testdata/spacewar/doc/spacewar/package-summary.html index 653293061..6a4dc6002 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/package-summary.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/package-summary.html @@ -1 +1 @@ -spacewar

Overview Package Class Tree Deprecated Index Help
PREV PACKAGE  NEXT PACKAGE FRAMES   NO FRAMES
Package spacewar
Class Summary
Bullet
Debug
Display
Display.DisplayAspect
Display1
Display1.SpaceObjectPainting
Display2
Display2.SpaceObjectPainting
EnergyPacket
EnergyPacketProducer
EnsureShipIsAlive
Game
GameSynchronization
InfoWin
KeyMapping
Pilot
Player
Registry
Registry.RegistrationProtection
RegistrySynchronization
Robot
Ship
SpaceObject
SWFrame
Timer

Overview Package Class Tree Deprecated Index Help
PREV PACKAGE  NEXT PACKAGE FRAMES   NO FRAMES
\ No newline at end of file +spacewar

Overview Package Class Tree Deprecated Index Help
PREV PACKAGE  NEXT PACKAGE FRAMES   NO FRAMES
Package spacewar
Class Summary
Bullet
Debug This aspect specifies debugging information to be output to the information window.
Display The display aspects capture the look and feel of the Game in modular pluggable units.
Display.DisplayAspect
Display1 This is the standard display aspect.
Display1.SpaceObjectPainting
Display2 This is the cheap Display aspect.
Display2.SpaceObjectPainting
EnergyPacket
EnergyPacketProducer
EnsureShipIsAlive This aspect makes sure that the ship is alive before performing any console commands.
Game The Game class is the root of the spacewar game.
GameSynchronization This aspect ensures synchronized access to methods of the Game in the presence of several threads.
InfoWin
KeyMapping
Pilot Pilot is the abstract superclass of Player and Robot.
Player
Registry The Registry keeps track of all the space objects that are floating around.
Registry.RegistrationProtection
RegistrySynchronization This aspect ensures synchronized access to methods of the Registry in the presence of several threads.
Robot Robot is an automatic pilot that now has quite a bit of intelligence.
Ship
SpaceObject SpaceObjects are objects that float around in space.
SWFrame
Timer

Overview Package Class Tree Deprecated Index Help
PREV PACKAGE  NEXT PACKAGE FRAMES   NO FRAMES
\ No newline at end of file diff --git a/ajdoc/testdata/spacewar/doc/spacewar/package-tree.html b/ajdoc/testdata/spacewar/doc/spacewar/package-tree.html index c8fed0c3b..1ad39f60b 100644 --- a/ajdoc/testdata/spacewar/doc/spacewar/package-tree.html +++ b/ajdoc/testdata/spacewar/doc/spacewar/package-tree.html @@ -2,7 +2,7 @@ - + spacewar Class Hierarchy -- 2.39.5

Class Summary
Coordinator
Method
MethodState
Mutex
Selfex

Class Summary
Coordinator	The Coordinator class provides the basic functionality for synchronizing and coordinating different threads upon entering and exiting methods.
Method
MethodState
Mutex
Selfex

Class Summary
Bullet
Debug
Display
Display.DisplayAspect
Display1
Display1.SpaceObjectPainting
Display2
Display2.SpaceObjectPainting
EnergyPacket
EnergyPacketProducer
EnsureShipIsAlive
Game
GameSynchronization
InfoWin
KeyMapping
Pilot
Player
Registry
Registry.RegistrationProtection
RegistrySynchronization
Robot
Ship
SpaceObject
SWFrame
Timer

before

after

Package coordination

Package coordination

A

B

C

D

E

F

G

H

I

K

L

M

N

O

P

Q

R

S

T

U

W

A

B

C

D

E

F

G

H

I

K

L

M

N

O

P

Q

R

S

T

U

W

Serialized Form

time

Serialized Form

time

afterReturning

before

afterReturning

before

afterReturning

before

afterReturning

afterReturning

afterReturning

afterReturning

afterReturning

afterReturning

Package spacewar

Package spacewar