brahms.base.directory
Class FindObject

java.lang.Object
  gov.nasa.arc.brahms.vm.api.jac.AbstractExternalActivity
      brahms.base.directory.FindObject

All Implemented Interfaces:

IExternalActivity

public class FindObject
extends AbstractExternalActivity

The FindObject activity tries to locate and load an object or object reference. The developer can specify a search strategy to indicate where the activity can search for the object, memory, disk or in the directory service. This activity requires four parameters in the Brahms java activity declaration:

• string name (the fully qualified name of the object to be found)
• symbol strategy (the search strategy)
• ActiveInstance obj (a variable to store the located object)
• boolean success (a variable indicating success or failure for the search)

Five different strategies are supported for finding an object:

• MEMORY - only look into the model's cache for the instance don't load it from disk or the directory service
• MEMORY_DISK - first look for the instance in the model's cache, if it doesn't exist load it from the local disk
• MEMORY_DIRECTORY - first look for the instance in the model's cache, if it doesn't exist try to locate it in the directory service and load a reference to it (default)
• MEMORY_DISK_DIRECTORY - first look for the instance in the model's cache, if it doesn't exist try to load if from the local disk, if it can't be found there, try to locate it in the directory service and load a reference to it
• MEMORY_DIRECTORY_DISK - first look for the instance in the model's cache, if it doesn't exist try to locate it in the directory service and load a reference to it, if it can't be found in the directory service try to load if from the local disk

Version:

$Revision: 1.1 $ $Date: 2007/10/10 14:02:53 $ $Author: rvhoof $

Author:

Ron van Hoof

Field Summary

static org.apache.log4j.Logger

LOGGER

Constructor Summary

FindObject()

Method Summary

void	doActivity() Executes the java activity action.

Methods inherited from class gov.nasa.arc.brahms.vm.api.jac.AbstractExternalActivity

addBeliefRelationConcept, addFactRelationConcept, assertBelief, assertFact, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, conclude, convertCurrent, getBeliefAttributeBoolean, getBeliefAttributeBoolean, getBeliefAttributeBoolean, getBeliefAttributeByte, getBeliefAttributeByte, getBeliefAttributeByte, getBeliefAttributeChar, getBeliefAttributeChar, getBeliefAttributeChar, getBeliefAttributeConcept, getBeliefAttributeConcept, getBeliefAttributeConcept, getBeliefAttributeDouble, getBeliefAttributeDouble, getBeliefAttributeDouble, getBeliefAttributeFloat, getBeliefAttributeFloat, getBeliefAttributeFloat, getBeliefAttributeInt, getBeliefAttributeInt, getBeliefAttributeInt, getBeliefAttributeJava, getBeliefAttributeJava, getBeliefAttributeJava, getBeliefAttributeLong, getBeliefAttributeLong, getBeliefAttributeLong, getBeliefAttributeMap, getBeliefAttributeShort, getBeliefAttributeShort, getBeliefAttributeShort, getBeliefAttributeSortedMap, getBeliefAttributeString, getBeliefAttributeString, getBeliefAttributeString, getBeliefAttributeValue, getBeliefAttributeValue, getBeliefAttributeValue, getBeliefRelationConcepts, getContext, getFactAttributeBoolean, getFactAttributeBoolean, getFactAttributeBoolean, getFactAttributeByte, getFactAttributeByte, getFactAttributeByte, getFactAttributeChar, getFactAttributeChar, getFactAttributeChar, getFactAttributeConcept, getFactAttributeConcept, getFactAttributeConcept, getFactAttributeDouble, getFactAttributeDouble, getFactAttributeDouble, getFactAttributeFloat, getFactAttributeFloat, getFactAttributeFloat, getFactAttributeInt, getFactAttributeInt, getFactAttributeInt, getFactAttributeJava, getFactAttributeJava, getFactAttributeJava, getFactAttributeLong, getFactAttributeLong, getFactAttributeLong, getFactAttributeMap, getFactAttributeShort, getFactAttributeShort, getFactAttributeShort, getFactAttributeSortedMap, getFactAttributeString, getFactAttributeString, getFactAttributeString, getFactAttributeValue, getFactAttributeValue, getFactAttributeValue, getFactRelationConcepts, getModel, getName, getParameter, getParameterBoolean, getParameterByte, getParameterChar, getParameterConcept, getParameterCount, getParameterDouble, getParameterFloat, getParameterInt, getParameterJava, getParameterLong, getParameterShort, getParameterString, getParameterStringOrSymbol, getParameterSymbol, getParameterValue, getParameterValues, getPerformedBy, getVMController, getWorldState, hasBeliefAttributeAnyValue, hasBeliefAttributeAnyValue, hasBeliefAttributeAnyValue, hasBeliefAttributeValue, hasBeliefAttributeValue, hasBeliefAttributeValue, hasBeliefRelationAnyValue, hasBeliefRelationValue, hasFactAttributeAnyValue, hasFactAttributeAnyValue, hasFactAttributeAnyValue, hasFactAttributeValue, hasFactAttributeValue, hasFactAttributeValue, hasFactRelationAnyValue, hasFactRelationValue, hasMultipleParameterValues, isParameterUnbound, isParameterUnknown, isValidTruthValue, removeAllBeliefRelationValues, removeAllFactRelationValues, removeBeliefRelationConcept, removeFactRelationConcept, retractBelief, retractFact, send, send, send, send, setActivity, setBeliefAttributeBoolean, setBeliefAttributeBoolean, setBeliefAttributeBoolean, setBeliefAttributeByte, setBeliefAttributeByte, setBeliefAttributeByte, setBeliefAttributeChar, setBeliefAttributeChar, setBeliefAttributeChar, setBeliefAttributeConcept, setBeliefAttributeConcept, setBeliefAttributeConcept, setBeliefAttributeDouble, setBeliefAttributeDouble, setBeliefAttributeDouble, setBeliefAttributeFloat, setBeliefAttributeFloat, setBeliefAttributeFloat, setBeliefAttributeInt, setBeliefAttributeInt, setBeliefAttributeInt, setBeliefAttributeJava, setBeliefAttributeJava, setBeliefAttributeJava, setBeliefAttributeJava, setBeliefAttributeJava, setBeliefAttributeJava, setBeliefAttributeLong, setBeliefAttributeLong, setBeliefAttributeLong, setBeliefAttributeShort, setBeliefAttributeShort, setBeliefAttributeShort, setBeliefAttributeString, setBeliefAttributeString, setBeliefAttributeString, setBeliefAttributeSymbol, setBeliefAttributeSymbol, setBeliefAttributeSymbol, setBeliefAttributeUnknown, setBeliefAttributeUnknown, setBeliefAttributeUnknown, setBeliefRelationUnknown, setFactAttributeBoolean, setFactAttributeBoolean, setFactAttributeBoolean, setFactAttributeByte, setFactAttributeByte, setFactAttributeByte, setFactAttributeChar, setFactAttributeChar, setFactAttributeChar, setFactAttributeConcept, setFactAttributeConcept, setFactAttributeConcept, setFactAttributeDouble, setFactAttributeDouble, setFactAttributeDouble, setFactAttributeFloat, setFactAttributeFloat, setFactAttributeFloat, setFactAttributeInt, setFactAttributeInt, setFactAttributeInt, setFactAttributeJava, setFactAttributeJava, setFactAttributeJava, setFactAttributeJava, setFactAttributeJava, setFactAttributeJava, setFactAttributeLong, setFactAttributeLong, setFactAttributeLong, setFactAttributeShort, setFactAttributeShort, setFactAttributeShort, setFactAttributeString, setFactAttributeString, setFactAttributeString, setFactAttributeSymbol, setFactAttributeSymbol, setFactAttributeSymbol, setFactAttributeUnknown, setFactAttributeUnknown, setFactAttributeUnknown, setFactRelationUnknown, setParameterBoolean, setParameterByte, setParameterChar, setParameterConcept, setParameterDouble, setParameterFloat, setParameterInt, setParameterJava, setParameterJava, setParameterLong, setParameterShort, setParameterString, setParameterUnknown, setProperties, toString

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

public static final org.apache.log4j.Logger LOGGER

Constructor Detail

FindObject

public FindObject()

Method Detail

doActivity

public void doActivity()
                throws ExternalException

Executes the java activity action.

Specified by:

doActivity in interface IExternalActivity

Specified by:

doActivity in class AbstractExternalActivity

Throws:

ExternalException - if an unrecoverable error occurs.