Java Doc for GLMTransOneToManyExpanderPlugin.java in  » Science » Cougaar12_4 » org » cougaar » logistics » plugin » trans » base » Java Source Code / Java DocumentationJava Source Code and Java Documentation

 Attaches two preps to task : SEAROUTE and SEAROUTE_DISTANCE 
 SEAROUTE will appear in the TPFDD Viewer as the path of the ship, if the 
 item goes by ship.

 Function that breaks up a AssetGroup or AggregateAsset into smaller pieces.
 Return values should only by Assets and small AggregateAssets (derived classes
 must determine how big is OK.

 Implemented for UTILExpanderPlugin interface
 Break up tasks into constituent parts.
 There are three possible paths a task can take:
 1) If the task is already a LEVEL 2 task, attaches a lowFiAssetPG to the asset and 
 passes it through.
 2) If the task's dates and the operating mode VTH determine it should be handled
 in level-2 mode, create a level-2 task from the original
 3) If the task should be handled in level-6, expand it's d.o.

 Tries to determine if direct object is a person aggregate.
 Can be tricky since sometimes the d.o.

 Examines task to see if task looks like what the plugin 
 expects it to look like.

 Takes a collection of assets and sets the dimensions of the physical pg
 to be their sum, in area, volume, and weight.

 NOTE : This is called magically by reflection from BindingUtility.setServices 
 setServices looks for any method in a component that starts with "set" and 
 tries to find a service X.

 Attaches two preps to task : SEAROUTE and SEAROUTE_DISTANCE 
 SEAROUTE will appear in the TPFDD Viewer as the path of the ship, if the 
 item goes by ship.  SEAROUTE_DISTANCE is used by the TRANSCOM vishnu scheduler
 to make the sea-vs-air decision.  (Specifically, it decides if at a reasonable
 ship speed (~15 knots), the task could be completed in the time allowed by ship,
 and if so, decides to send the item by ship.)
 

 Function that breaks up a AssetGroup or AggregateAsset into smaller pieces.
 Return values should only by Assets and small AggregateAssets (derived classes
 must determine how big is OK.  By default all Aggregate are broken up).
 If myExpandAggregates is true, expands both aggregate assets and asset groups.
 If it's false, only expands asset groups.
 

 Implemented for UTILExpanderPlugin interface
 Break up tasks into constituent parts.
 There are three possible paths a task can take:
 1) If the task is already a LEVEL 2 task, attaches a lowFiAssetPG to the asset and 
 passes it through.
 2) If the task's dates and the operating mode VTH determine it should be handled
 in level-2 mode, create a level-2 task from the original
 3) If the task should be handled in level-6, expand it's d.o. as usual
 4) TBD - perhaps, in the future, we'll ignore tasks that are far into the future
 until the current time advances far enough.  This would require the buffering thread
 to wake up periodically, however, using the alarm service.  Hmmm...
 There is also the possibility of rescinding level 2 and replanning as level 6.  
 That would be real work though.
 

 Tries to determine if direct object is a person aggregate.
 Can be tricky since sometimes the d.o. is a group of aggregates.
 

 Examines task to see if task looks like what the plugin 
 expects it to look like.
 Checks FROM and TO prepositions to see they're all there.
 

If the task somehow got it's plan element removed by the time this is called, just skip it. Somehow a logic provider seems to be able to remove the task's expansion during my transaction.

Parameters:
  level2Tasks - tasks that were previously expanded into level 2that we want to replan.

 Takes a collection of assets and sets the dimensions of the physical pg
 to be their sum, in area, volume, and weight.
 It doesn't make sense to aggregate length, width, and height, since they
 wouldn't correspond to area and volume.
 

 NOTE : This is called magically by reflection from BindingUtility.setServices 
 setServices looks for any method in a component that starts with "set" and 
 tries to find a service X.  
 More specifically, it's looking for a method signature like:
 setXService (XService s)