jas.events
Class EventFactory

java.lang.Object
  jas.events.EventFactory

public class EventFactory
extends java.lang.Object

Create instances of any type of Event and manages a garbage list. In case of discrete event simulation, each agent potentially might create a great number of events. When an event is fired it is dropped. To avoid a bad use of memory, the EventFactory manages the recycling of fired events.

Title: JAS

Description: Java Agent-based Simulation library

Copyright (C) 2002 Michele Sonnessa

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

Author:

Michele Sonnessa

Constructor Summary

EventFactory()
Create the EventFactory and setup the garbage list.

Method Summary

SimCollectionEvent	newCollectionEvent(java.util.Collection elements, java.lang.Class objectType, java.lang.String method) Search for an used collection event and regenerate it or create a new instance.
SimCollectionEvent	newCollectionEvent(java.util.Collection elements, int actionType) Search for an used collection event and regenerate it or create a new instance.
SimGroupEvent	newGroupEvent() Search for an used group event and regenerate it or create a new instance.
SimMultiCastEvent	newMultiCastEvent(java.util.Collection elements, int actionType) Search for an used multicast event and regenerate it or create a new instance.
SimSimpleEvent	newSimpleEvent(java.lang.Object object, int actionType) Search for an used simple event and regenerate it or create a new instance.
SimSimpleEvent	newSimpleEvent(java.lang.Object object, java.lang.String method) Search for an used simple event and regenerate it or create a new instance.
void	trashEvent(SimEvent event) Put a no more used event into the garbage list, if the canBeTrashed() method of the event answer true.

Methods inherited from class java.lang.Object

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

Constructor Detail

EventFactory

public EventFactory()

Create the EventFactory and setup the garbage list.

Method Detail

newCollectionEvent

public SimCollectionEvent newCollectionEvent(java.util.Collection elements,
                                             java.lang.Class objectType,
                                             java.lang.String method)

Search for an used collection event and regenerate it or create a new instance.

newCollectionEvent

public SimCollectionEvent newCollectionEvent(java.util.Collection elements,
                                             int actionType)

Search for an used collection event and regenerate it or create a new instance.

newGroupEvent

public SimGroupEvent newGroupEvent()

Search for an used group event and regenerate it or create a new instance.

newMultiCastEvent

public SimMultiCastEvent newMultiCastEvent(java.util.Collection elements,
                                           int actionType)

Search for an used multicast event and regenerate it or create a new instance.

newSimpleEvent

public SimSimpleEvent newSimpleEvent(java.lang.Object object,
                                     int actionType)

Search for an used simple event and regenerate it or create a new instance.

newSimpleEvent

public SimSimpleEvent newSimpleEvent(java.lang.Object object,
                                     java.lang.String method)

Search for an used simple event and regenerate it or create a new instance.

trashEvent

public void trashEvent(SimEvent event)

Put a no more used event into the garbage list, if the canBeTrashed() method of the event answer true.