desmoj.core.simulator

Class Event<E extends Entity>

java.lang.Object

desmoj.core.simulator.NamedObject

desmoj.core.simulator.ModelComponent

desmoj.core.simulator.Schedulable

desmoj.core.simulator.EventAbstract

desmoj.core.simulator.Event<E>

public abstract class Event<E extends Entity>
extends EventAbstract

Provides the class for user defined events to change a single entity's internal state. The state of a discrete model is changed by events that occur at distinct points of simulation time.

For events changing the state of two or three entities, refer to EventOf2Entities and EventOf3Entities. Events not associated to a specific entity are based on ExternalEvent.

For type safety it is recommended to generically assign the entity type an Event operates on by using the generic type Event<E> where E is derived from Entity.

All event object should be used only once. Implement the changes of state for the specific entity associated with this event by overriding the abstract method eventRoutine(E who).

Version:

DESMO-J, Ver. 2.5.1c copyright (c) 2015

Author:

Tim Lechler Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

See Also:

Entity, ExternalEvent, EventOf2Entities, EventOf3Entities, TimeInstant, TimeSpan

Constructor Summary

Constructors

Constructor and Description
Event(Model owner, java.lang.String name, boolean showInTrace) Creates a new event of the given model, with the given name and trace option.

Method Summary

Modifier and Type	Method and Description
Event<E>	clone() Creates and returns a copy of this event.
abstract void	eventRoutine(E who) Implement this abstract method to express the changes of state this event does to a single entity.
void	schedule(E who) Schedules this event to act on the given Entity now.
void	schedule(E who, NumericalDist<?> dist) Schedules this event to act on the given Entity at a point in simulation time determined by a sample from the distribution provided to the method.
void	schedule(E who, TimeInstant instant) Schedules this event to act on the given entity at a certain point in simulation time.
void	schedule(E who, TimeSpan dt) Schedules this event to act on the given Entity at the specified point in simulation time.
void	scheduleAfter(Schedulable after, E who) Schedules this event to act on the given Entity directly after the given Schedulable is already set to be activated.
void	scheduleBefore(Schedulable before, E who) Schedules this event to act on the given Entity directly before the given Schedulable is already set to be activated.
void	schedulePreempt(E who) Schedules this event to be executed immediately, preempting the process lifecycle executed at the moment.

Methods inherited from class desmoj.core.simulator.EventAbstract

getNumberOfEntities, getRealTimeConstraint, getSchedulingPriority, isExternal, setRealTimeConstraint, setSchedulingPriority

Methods inherited from class desmoj.core.simulator.Schedulable

assignReporter, cancel, getCorrespondingReportable, isCurrent, isScheduled, rename, reSchedule, reSchedule, reSchedulePreempt, scheduledNext, setCorrespondingReportable

Methods inherited from class desmoj.core.simulator.ModelComponent

current, currentEntity, currentEntityAll, currentEvent, currentModel, currentSimProcess, debugIsOn, debugOff, debugOn, getModel, isExperimentCompatible, isModelCompatible, presentTime, sendDebugNote, sendMessage, sendTraceNote, sendWarning, skipTraceNote, skipTraceNote, traceIsOn, traceOff, traceOn

Methods inherited from class desmoj.core.simulator.NamedObject

getName, getQuotedName, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Event

public Event(Model owner,
             java.lang.String name,
             boolean showInTrace)

Creates a new event of the given model, with the given name and trace option.

Parameters:

name - java.lang.String : The name of this event

owner - Model : The model this event is associated to

showInTrace - boolean : Flag for showing event in trace-files. Set it to true if event should show up in trace. Set it to false if event should not be shown in trace.

Method Detail

eventRoutine

public abstract void eventRoutine(E who)
                           throws SuspendExecution

Implement this abstract method to express the changes of state this event does to a single entity. This event is related to the entity it has been scheduled with. That Entity is given note that since class SimProcess inherits from class Entity, an event can also be given a process to operate on. In this case, the process is scheduled and manipulated by this event just like an entity. Implement this abstract method to express the changes of state this event does to an entity (as SimProcess is a subclass of Entity, a process can be passed as well).

For type safety, it is recommended to derive your events from the generic type Event<EntityOperatingOn> where EntityOperatingOn (which is derived from class Entity) represents the entity type your event is supposed to operate on.

Should you decide to derive your event from the raw type Event (which is not recommended), please take extra care in checking the given Entity parameter to your special eventRoutine since any subtype of Entity will be accepted! If your model uses several different entity types, chances are that while developing the model, wrong entity types might be passed.

Parameters:

who - Entity : The Entity associated to this event.

Throws:

SuspendExecution - Marker exception for Quasar.

schedule

public void schedule(E who,
                     TimeInstant instant)

Schedules this event to act on the given entity at a certain point in simulation time. No preemption, i.e. a process calling this method will continue until passivated or hold.

Parameters:

who - E : The first entity to be manipulated by this event

instant - TimeInstant : The point in simulation time this event is scheduled to happen.

schedule

public void schedule(E who,
                     TimeSpan dt)

Schedules this event to act on the given Entity at the specified point in simulation time. The point of time is given as an offset to the current simulation time as displayed by the simulation clock. Preemption is not allowed.

Parameters:

who - E : The Entity this event happens to

dt - TimeSpan : The offset to the current simulation time this Event is to happen

See Also:

SimClock

schedule

public void schedule(E who)

Schedules this event to act on the given Entity now. Preemption is not allowed.

Parameters:

who - E : The Entity this event happens to

See Also:

SimClock

schedulePreempt

public void schedulePreempt(E who)
                     throws SuspendExecution

Schedules this event to be executed immediately, preempting the process lifecycle executed at the moment.

Parameters:

who - E : The Entity this event happens to

Throws:

SuspendExecution

schedule

public void schedule(E who,
                     NumericalDist<?> dist)

Schedules this event to act on the given Entity at a point in simulation time determined by a sample from the distribution provided to the method. The sample is interpreted as offset from the the present time in the reference time unit.

Parameters:

who - E : The Entity this event happens to

dist - NumericalDist : Numerical distribution to sample the offset to the current simulation time from

See Also:

SimClock

scheduleAfter

public void scheduleAfter(Schedulable after,
                          E who)

Schedules this event to act on the given Entity directly after the given Schedulable is already set to be activated. Note that this event's point of simulation time will be set to be the same as the Schedulable's time. Thus this event will occur directly after the given Schedulable but the simulation clock will not change. Make sure that the Schedulable given as parameter is actually scheduled.

Parameters:

after - Schedulable : The Schedulable this entity should be scheduled after

who - E : The Entity to be manipulated by this event

scheduleBefore

public void scheduleBefore(Schedulable before,
                           E who)

Schedules this event to act on the given Entity directly before the given Schedulable is already set to be activated. Note that this event's point of simulation time will be set to be the same as the Schedulable's time. Thus this event will occur directly before the given Schedulable but the simulation clock will not change. Make sure that the Schedulable given as parameter is actually scheduled.

Parameters:

before - Schedulable : The Schedulable this entity should be scheduled before

who - E : The Entity to be manipulated by this event

clone

public Event<E> clone()
               throws java.lang.CloneNotSupportedException

Creates and returns a copy of this event. Note that subclasses have to implement the interface java.lang.Cloneable to actually use this method as otherwise, a CloneNotSupportedException will be thrown.

Returns:

Event : A copy of this event.

Throws:

java.lang.CloneNotSupportedException