gridsim.datagrid.filter
Class FilterDataResult

Object
  Sim_predicate
      FilterDataResult

public class FilterDataResult
extends Sim_predicate

Look for a specific incoming event that matches a given event tag name and a logical file name (lfn). Incoming events with a matching tag name must contain a data object of type Object[], where Object[0] stores the lfn.

This class is used by Sim_system to select or filter an event already present in the entity's deferred queue (incoming buffer), or used to selectively wait for a future event.

An example on how to use this class:
Imagine we have a scenario where Entity_A sends one or more events to Entity_B with different tag names and data objects.
Entity_B wants to get an event with a HIGH_PRIORITY tag and a lfn of Data01 in this example.
Therefore, inside the Entity_B code:

... // other code

String lfn = "Data01";
int tag = HIGH_PRIORITY;
Sim_event ev = new Sim_event();
FilterDataResult filter = new FilterDataResult(lfn, tag);

// get an incoming event that matches a given filter
super.sim_get_next(filter, ev);

// get the matching event data
Object[] result = (Object[]) ev.get_data();


NOTE:

• both Entity_A and Entity_B must be an instance of Sim_entity class.
• Entity_A must send the correct data object to Entity_B for this type of filtering.
  The event data object must be of type Object[].
• if no incoming events match the given condition, then Sim_entity.sim_get_next(Sim_predicate, Sim_event) method will wait indefinitely.

Since:

GridSim Toolkit 4.0

Author:

Uros Cibej and Anthony Sulistio

Constructor Summary

FilterDataResult(String lfn, int tag)
Creates a new filter to select an incoming event based on the logical file name (lfn) and tag name

Method Summary

boolean

match(Sim_event ev) Checks whether an event matches the required constraints or not. NOTE: This method is not used directly by the user.

Methods inherited from class Object

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

Constructor Detail

FilterDataResult

public FilterDataResult(String lfn,
                        int tag)

Creates a new filter to select an incoming event based on the logical file name (lfn) and tag name

Parameters:

lfn - the logical file name

tag - a matching event tag name

Method Detail

match

public boolean match(Sim_event ev)

Checks whether an event matches the required constraints or not.
NOTE: This method is not used directly by the user. Instead, it is called by Sim_system.

Specified by:

match in class Sim_predicate

Parameters:

ev - an incoming event to compare with

Returns:

true if an event matches, false otherwise