kaos.core.service.directory
Class DirectoryServiceProxy

java.lang.Object
  extended by kaos.core.service.util.MethodCallProxy
      extended by kaos.core.service.directory.DirectoryServiceProxy
All Implemented Interfaces:
OntologyService, PolicyAdvice, PolicyChecking, PolicyManagement, AuthenticationInterface, DirectoryEventNotifier, DirectoryService, DomainDirectoryService, DefinedPolicyTemplateInterface, OntologyRepositoryService, QueryKAoSOntologyService, GuardSynchronization, PolicyAnalyzes, PolicyModification, PolicySetDirectory, XMLRepository
Direct Known Subclasses:
KAoSAgentDirectoryServiceProxy, TunnelClient

public class DirectoryServiceProxy
extends MethodCallProxy
implements DirectoryService, GuardSynchronization, OntologyService, XMLRepository, DirectoryEventNotifier

Author:
jlott This class provides a remote interface to the DirectoryService. It uses MethodCallProxy to handle the synchronization of messages. This class does not bind to a MessageTransportService; rather, anyone using it needs to call the "init" method of the superclass to establish the binding.

Nested Class Summary
 
Nested classes/interfaces inherited from class kaos.core.service.util.MethodCallProxy
MethodCallProxy.OperationWaiter
 
Nested classes/interfaces inherited from interface kaos.core.csi.policy.PolicyManagement
PolicyManagement.OntologyPolicyIncorrect, PolicyManagement.PrecedenceUndeterminedException
 
Nested classes/interfaces inherited from interface kaos.policy.management.PolicyAnalyzes
PolicyAnalyzes.PriorityConditionNotMet
 
Field Summary
protected  ServiceProperties _serviceProps
           
static OntologyService localOntologyInterfaces
           
 
Fields inherited from class kaos.core.service.util.MethodCallProxy
_logger, _msgSender, _waiters
 
Constructor Summary
DirectoryServiceProxy()
           
 
Method Summary
 void addAuthenticationObject(KAoSAuthenticationObject kao)
          Allows to add an authentication object to the Directory Service database.
 void addDefinedPolicyTemplate(PolicyTemplate definedTemplate)
           
 void addEntityOntologicalType(java.lang.String entityNameAsString, java.lang.String typeName, java.lang.String damlDesc)
           
 void addEventListener(DirectoryEventListener listener)
           
 void addFilteredNamespace(java.lang.String namespace)
          This method add a namespace to the set of urls depicting ontology namespaces concept of which are filtered out when returned by methods of this repository.
 void addPolicies(java.util.List<PolicyMsg> policies)
           
 void addPolicy(PolicyMsg policy)
           
 void addPolicy(java.lang.String owlPolicyDescription)
           
 void addPolicySet(PolicySetMsg policySet)
           
 void addPolicySets(java.util.List<PolicySetMsg> policySets)
           
 void addPolicyUpdateListener(PolicyListener listener)
           
 void addRemoteEventListener(Locator l)
           
 java.lang.String analyzeWorkflow(java.lang.String owlsWorkflow)
           
 java.lang.String analyzeWorkflow(java.net.URL owlsWorkflow)
           
 boolean areClassesDisjoint(java.lang.String firstClass, java.lang.String secondClass)
          Test if two provided classes are disjoint
 java.util.Set askQuery(java.lang.String variableName, java.lang.String multiplyVariablesQuery)
          Get values of the selected variable satisfying the KIF query with possibly many variable.
 java.util.Vector changeComponentEnabledStatus(java.lang.String repType, java.lang.String associatedOntType, java.lang.Boolean state, java.lang.String guardRepMgrID)
           
 void changedPriority(java.lang.String policyId, int newPriority)
          Method allowing to modify priority of a policy to either eliminate conflict or to alter policy precedence relation
 void changePolicies(java.util.List<PolicyMsg> policies)
           
 void changePolicy(PolicyMsg policy)
           
 void changePolicy(java.lang.String policyID, java.lang.String owlPolicyDescription)
           
 void changePolicySet(PolicySetMsg policySet)
           
 void changePolicySets(java.util.List<PolicySetMsg> policySets)
           
 void checkDeepPermission(ActionInstanceDescription aid, PolicyDecisionObserver observer)
           
protected  void checkDeregisterResult(MethodCallResultMsg result, AgentDescription desc)
          DirectoryFailure - as a result of registration, deregistration or modify request NotRegisteredException - as a result of deregistration or modify request IllegalArgumentexception - as a result of registration, deregistration or modify request
protected  void checkModifyResult(MethodCallResultMsg result)
          NotRegisteredException - as a result of deregistration or modify request IllegalArgumentexception - as a result of registration, deregistration or modify request
 void checkPermission(ActionInstanceDescription aid, PolicyDecisionObserver observer)
           
protected  void checkRegisterResult(MethodCallResultMsg result, AgentDescription desc)
           
protected  AgentDescription[] checkSearchResult(MethodCallResultMsg result)
          The Exception may be one of the following: SearchException DirectoryFailure IllegalArgumentexception
 AgentDescription createAgentDescription()
           
protected  MethodCallRequestMsg createMessageToSend(AgentDescription adesc, java.lang.String requestedOperation, int parameterValue)
          Return an instance of the MethodCallRequestMsg specifying the requested Directory operation and the AgentDescription argument.
 void declareInstance(java.lang.String instanceName, java.lang.String className)
           
 void deleteAllLogs(java.lang.String historyMonitorID)
           
 java.util.Vector deleteLogsforActionType(java.lang.String actionType, java.lang.String historyMonitorID)
           
 java.util.Vector deleteLogsforActor(java.lang.String actorID, java.lang.String historyMonitorID)
           
 java.util.Vector deleteSpecifiedLogs(java.lang.String actionType, java.lang.String actorID, java.lang.String startTime, java.lang.String endTime, java.lang.Boolean latest, java.lang.String historyMonitorID)
           
 void deregister(AgentDescription desc)
           
 void editAuthenticationObject(KAoSAuthenticationObject kao)
          Allows to edit an authentication object at the Directory Service database.
 void editDefinedPolicyTemplate(PolicyTemplate definedTemplate)
           
 java.util.List findConflictingPolicies(java.lang.String policyId)
          Method find all the policies conflicting with the specified policy
 java.util.List<PolicyMsg> findPolicies(java.lang.String actionType, java.util.Map<java.util.List<java.lang.String>,java.lang.String> policyRestrictions)
           
 java.util.List findPoliciesMadeRedundant(java.lang.String policyId)
          Method find all the policies with higher priority making the specified policy redundant
 java.util.List findPoliciesMakingRedundant(java.lang.String policyId)
          Method find all the policies with higher priority making the specified policy redundant
 java.util.Vector findPolicyDecision(ActionInstanceDescription aid, PolicyDecisionObserver observer)
          For Policy Disclosure
 java.util.Set<ActionClassDescription> getActions(java.lang.String forActor)
          Get descriptions of the Action classes the specified Actor class or instance can perfom based on its class.
 KAoSAgentDescription getAgentDescriptionForAgentID(java.lang.String agentID)
           
 java.util.List getAllAgentsInDirectory()
          Get a Vector of descriptions of all agents in the directory.
 java.util.Vector getAllAgentsInDomain(java.lang.String domainName)
          Get a Vector of descriptions of all of the agents in a domain.
 java.util.Hashtable getAllAuthenticationObjects()
          Allows to get all the authentication objects from the Directory Service database.
 java.util.Map<java.lang.String,PolicyTemplate> getAllDefinedPolicyTemplate()
           
 java.util.Vector getAllDomainsInDirectory()
          Get a Vector of descriptions of all of the domains in a directory.
 java.util.List getAllGuardsInDirectory()
          Get a Vector of descriptions of all guards in the directory.
 java.util.List getAllLogs(java.lang.String historyMonitorID)
           
 java.util.Set getAllNamespaces()
          This method returns a set of urls depicting ontologies loaded into the JTP as well namespaces used internally by KAoS.
 java.util.Vector getAllowableValuesForActionProperties(ActionInstanceDescription actionDesc, PolicyDecisionObserver observer)
           
 java.util.Vector getAllowableValuesForActionProperties(java.util.Vector propertyNames, ActionInstanceDescription actionDesc, boolean tight, PolicyDecisionObserver observer)
           
 java.util.Set getAllowableValuesForActionProperty(java.lang.String origPropertyName, ActionInstanceDescription origActionDesc, java.util.Set allTargetValues, boolean tight, PolicyDecisionObserver observer)
           
 java.util.Vector getAllPolicies(java.lang.String policyDBManagerID)
           
 java.util.List<PolicyMsg> getAllPoliciesFor(java.lang.String conceptId)
           
 java.util.List getAllSchema()
          Retrieve all schemas in the repository.
 java.util.Set getClassesDefInNamespace(java.lang.String namespaceName)
          Get set of classes defined in the given namespace.
 java.util.Set getClassesOfActors(java.lang.String baseActorClass)
          Get names of the Actors classes known to the ontology repository being a subclass of the specified base class.
 java.util.Set getClassesOfActorsCapableOfPerformingActions(java.lang.String actionClass)
          Get names of Actor classes capable to perform a given action, without taking into consideration policy restrictions
 java.util.Set getClassesOfGroups(java.lang.String baseGroupClass)
          Get names of the Group classes known to the ontology repository being a subclass of the specified base class.
 java.util.Set getClassesOfPlaces(java.lang.String basePlaceClass)
          Get names of the Places classes known to the ontology repository being a subclass of the specified base class.
 java.util.Set getClassesOfTargets(java.lang.String baseTargetClass)
          Get names of the targets (Actors or Entities) classes known to the ontology repository being a subclass of the specified base class.
 java.lang.Boolean getComponentEnabledStatus(java.lang.String repType, java.lang.String associatedOntType, java.lang.String guardRepMgrID)
           
 SerializableOntModelImpl getConstructedOntologyStructure(java.lang.String structureId)
          This method get stored ontology structure references by its id in the repository.
 java.util.List getConstructedOntologyStructures()
          This method retrieves all user defined ontology structures in the repository.
 java.util.Vector getDirectPoliciesFor(java.lang.String entityId)
           
 DomainDescription getDomainDescription(java.lang.String domainName)
          Get the description of a domain
 java.util.List getDomainDescriptionsForGuard(java.lang.String guardGUID)
          Obtain a List containing DomainDescriptions of all domains the guard, whose GUID is specified, registered in.
 java.util.Vector getDomainNames()
           
 java.util.Map getDomainStructure(java.lang.String domainName)
          Obtain a Map containing the structure of a domain.
 java.util.Set getFilteredNamespaces()
          This method returns a set of urls depicting ontology namespaces concept of which are filtered out when returned by methods of this repository.
 java.util.Vector getForbiddenValuesForActionProperty(java.lang.String origPropertyName, ActionInstanceDescription origActionDesc, PolicyDecisionObserver observer)
           
 java.util.Vector getGuardDescriptionsForEntity(java.lang.String entityID)
           
 java.lang.String getGuardStateFor(java.lang.String guardID)
           
 java.util.Set getImmediateSubClassesOf(java.lang.String className)
          Get set of immediate subclasses of the given class.
 java.util.Set getIndividualActors(java.lang.String baseActorClass)
          Get names of the individual Actors known to the ontology repository being an instance of the specified base class.
 java.util.Set getIndividualGroups(java.lang.String baseGroupClass)
          Get names of the individual Groups known to the ontology repository being an instance of the specified base class.
 java.util.Set getIndividualPlaces(java.lang.String basePlaceClass)
          Get names of the individual Places known to the ontology repository being an instance of the specified base class.
 java.util.Set getIndividualTargets(java.lang.String baseTargetClass)
          Get names of the individual targets (Actors or Entities) known to the ontology repository being an instance of the specified base class.
 java.util.Set getInstancesDefInNamespace(java.lang.String namespaceName)
          Get set of instances defined in the given namespace.
 java.util.Set getInstancesOf(java.lang.String conceptName)
          Get set of instances of the given concept; if the concept is an instance itself the set contains just this instance.
 java.util.Set getListOfLoadedOntologies()
          This method returns a set of urls depicting ontologies loaded into the Ontology Service
 java.util.Vector getLogsforActionType(java.lang.String actionType, java.lang.String historyMonitorID)
           
 java.util.Vector getLogsforActor(java.lang.String actorID, java.lang.String historyMonitorID)
           
 java.util.Set getNamspacesImportedByNamespace(java.lang.String namespaceName)
          Get set of namespaces imported by the given namespace.
 java.util.List<ActionInstanceDescription> getObligationsForTriggerCondition(ActionInstanceDescription triggerAID, PolicyDecisionObserver observer)
           
 java.util.Set getOntologyDefinitionForConcept(java.lang.String conceptName)
          Get set of urls for the given short concept name.
 java.util.List getPolicies()
           
 java.util.Map getPoliciesByEntities()
           
 PolicyMsg getPolicy(java.lang.String policyId)
           
 PolicyInformation getPolicyInformation(java.lang.String policyID, java.lang.String policyDBManagerID)
           
 PolicySetMsg getPolicySet(java.lang.String policySetId)
           
 java.util.List getPolicySets()
          Obtain List over all policy sets.
 java.lang.Integer getPolicyUpdateCount()
           
 java.util.Vector getPropertiesApplicableTo(java.lang.String className)
          Get set of properties defined in the given namespace.
 java.util.Set getPropertiesDefInNamespace(java.lang.String namespaceName)
          Get set of properties defined in the given namespace.
 java.lang.String getRangeOnPropertyForClass(java.lang.String className, java.lang.String propertyName)
          Get the name of the class defining the range of the specified property for the given class.
 java.util.Hashtable getRepositoryTableInformation(java.lang.String repType, java.lang.String guardRepMgrID)
           
 java.util.Set getResourcesWithValueForProperty(java.lang.String property, java.lang.String value)
          Get values of the variable satisfying the KIF query: (property ?subject value).
 java.util.Vector getRootDomains()
          Obtain a Vector of the names of the root domains (domains with no parent)
 java.util.List<java.lang.String> getSchema(java.lang.String dataName)
          Get XML schema of the given concept if such a schema is available
 ServiceProperties getServiceProperties()
           
 java.util.Vector getSpecifiedLogs(java.lang.String actionType, java.lang.String actorID, java.lang.String startTime, java.lang.String endTime, java.lang.Boolean latest, java.lang.String historyMonitorID)
           
 java.util.Set getSubClassesOf(java.lang.String className)
          Get set of subclasses of the given class.
 java.util.Vector getSubdomains(java.lang.String domainName)
          Obtain a Vector of the names of subdomains of a particular domain (returns immediate children only)
 java.util.Set getSubPropertiesOf(java.lang.String propertyName)
          Get set of subproperties of the given property.
 java.util.Set getSuperClassesOf(java.lang.String className)
          Get set of superclasses of the given class.
 java.util.Set getSuperPropertiesOf(java.lang.String propertyName)
          Get set of superproperties of the given property.
 java.util.Set getUltimateOntologyTypesOfIndividual(java.lang.String individualName)
          Finds the ultimate Ontology type of the provided individual
 java.lang.String getUniqueValueForProperty(java.lang.String property, java.lang.String subject)
          Get a single value of the variable satisfying the KIF query: (property subject ?val).
 java.util.Set<java.lang.String> getValuesForProperty(java.lang.String property, java.lang.String subject)
          Get values of the variable satisfying the KIF query: (property subject ?val).
 java.util.List harmonizePolicy(java.lang.String harmonizedPolicy, java.lang.String harmonizingPolicy)
          Method deconflicting the added policy with policies currently in the Policy Directory
 void init(MsgSender msgSender)
           
 java.util.Vector initiateActionClassTargets(java.lang.String actionClassName, java.lang.String actorClassName)
          Get properties applicable to the action class
 void instancesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentInstancesClassesURL, java.util.List<java.lang.Long> myCurrentInstancesSetsTimeStamps)
          Send a list of the current classes for which instances set are stored in the Guard and associated with them timestamps in the second list.
 java.lang.Object invokeKAoSExtensionComponentMethod(java.lang.String repType, java.lang.String associatedOntType, java.lang.String methodName, java.util.Vector args, java.lang.String guardId)
           
protected  java.lang.Object invokeMethod(java.lang.String methodName, java.util.Vector args)
           
 boolean isEntityInDomain(java.lang.String domainName, java.lang.String id)
          Search for the domain entity with the specified id.
 boolean isFullyOverlappedBySecondPolicy(java.lang.String firstPolicyId, java.lang.String secondPolicyId)
          Method finds out if the specified policy is fully overlapped by the second specified policy, the necessary condition is that the two policies have the same modality
 boolean isFullyOverlappedByUnionOfPolicies(java.lang.String firstPolicyId, java.util.List<java.lang.String> listOfPolicies)
          Method finds out if the specified policy is fully overlapped by the union of specified policies, the necessary condition is that the all policies have the same modality
 java.lang.Boolean isGuardLoggingActive(java.lang.String historyMonitorID)
           
 boolean isMadeFullyRedundantByPolicyUnion(java.lang.String firstPolicyId, java.util.List<java.lang.String> listOfPolicies)
          Method finds out if the specified policy is being made redundant (fully covered) by the union of specified policies with higher priority in the repository
 boolean isMadeFullyRedundantBySecond(java.lang.String firstPolicyId, java.lang.String secondPolicyId)
          Method finds out if the specified policy is being made redundant (fully covered) by the second specified policy with higher priority in the repository
 boolean isMadeParitallyRedundantBySecond(java.lang.String firstPolicyId, java.lang.String secondPolicyId)
          Method finds out if the specified policy is being made partially redundant (partially covered) by the second specified policy with higher priority in the repository
 boolean isPartiallyOverlappedBySecondPolicy(java.lang.String firstPolicyId, java.lang.String secondPolicyId)
          Method finds out if the specified policy is partially overlapped by the second specified policy, the necessary condition is that the two policies have the same modality
 boolean isPolicyInConflict(java.lang.String policyId)
           
 boolean isPolicyMakingRedundantSomeOtherPolicy(java.lang.String policyId)
          Method finds out if the specified policy makes redundant (fully or partially) some policies with lower priority in the repository
 boolean isPolicyRedundant(java.lang.String policyId)
          Method finds out if the specified policy is being made redundant (fully or partially) by some policies with higher priority in the repository
 boolean isSynchronizationNeeded(java.lang.Long myLastUpdateTimeStamp)
          Check with DS if synchronization is needed by providing the timestamp of the last update.
 boolean isUsernameRegistered(java.lang.String userid, java.lang.String password)
          Checks if the username is in the Directory Service database.
 void loadOntologies(java.util.List<SerializableOntModelImpl> myDAMLModels, boolean recursiveLoad)
          Adds ontology included in the provide objects into the ontology repository.
 void loadOntology(SerializableOntModelImpl myDAMLModel, boolean recursiveLoad)
          Adds ontology included in the provide objects into the ontology repository.
 void loadOntology(java.lang.String loadedOWL)
          Loads ontology in OWL into the repository of the Ontology Service
 void loadOntology(java.lang.String myURL, boolean recursiveLoad)
          Loads ontology from the provided url.
 void loadSchema(java.lang.String fileName)
          Load schema definitions of data types from a file.
 void modify(AgentDescription desc)
           
 void modifyEntityProperties(java.lang.String entityGUID, java.util.List properties)
           
 void policiesSynchronizationRequest(java.util.List<java.lang.String> myCurrentPoliciesIds, java.util.List<java.lang.Long> myCurrentPoliciesTimeStamps)
          Send a list of the current policies ids and associated with them timestamps in the second list.
 void putConstructedOntologyStructures(java.util.List<SerializableOntModelImpl> ontologyStructureList)
          This method stores multiple ontology structures in the repository.
 void putMultipleSchema(java.util.List<XMLSchemaContainer> schemaList)
          Store multiple schemas in the repository.
 void putSchema(java.lang.String dataName, java.lang.String dataSchema)
          Add an XML schema for the given concept
 void register(AgentDescription desc)
           
 void removeAllPolicies(java.lang.String policyDBManagerID)
           
 void removeAuthenticationObject(KAoSAuthenticationObject kao)
          Allows to remove an authentication object from the Directory Service database.
 void removeConstructedOntologyStructure(java.lang.String structureId)
          This method removes a user defined ontology structure identified by the id from the repository.
 void removeConstructedOntologyStructures(java.util.List<java.lang.String> structureIds)
          This method removes multiple user defined ontology structure identified by the id from the repository.
 void removeDefinedPolicyTemplate(PolicyTemplate definedTemplate)
           
 void removeEventListener(DirectoryEventListener listener)
           
 void removeExecEnv(java.lang.String execEnvID)
          Remove ExecutionEnvironment with the specified ID from the domain structure.
 void removeFilteredNamespace(java.lang.String namespace)
          This method remove a namespace from the set of urls depicting ontology namespaces concept of which are filtered out when returned by methods of this repository.
 void removePolicies(java.util.List<PolicyMsg> policies)
           
 void removePolicy(PolicyMsg policy)
           
 void removePolicy(java.lang.String policyID)
           
 PolicyInformation removePolicyInformation(java.lang.String policyID, java.lang.String policyDBManagerID)
           
 void removePolicySet(PolicySetMsg policySet)
           
 void removePolicySets(java.util.List<PolicySetMsg> policySets)
           
 void removePolicyUpdateListener(PolicyListener listener)
           
 void removeRemoteEventListener(Locator l)
           
 void removeSchema(java.lang.String dataName)
          Remove the schema for the given data type from this repository.
 AgentDescription[] search(AgentDescription desc)
           
 AgentDescription[] search(AgentDescription desc, int maxResults)
           
 void setGuardLoggingState(java.lang.Boolean logging, java.lang.String historyMonitorID)
           
 void setServiceProperties(ServiceProperties props)
           
 java.util.List splitPolicy(java.lang.String splitPolicy, java.lang.String secondPolicy)
          Method splitting the controlled action of the selected policy one part that overlaps with the second policy and the other part which does not.
 void subclassesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSubclassesClassesURL, java.util.List<java.lang.Long> myCurrentSubclassesSetsTimeStamps)
          Send a list of the current classes for which subclasses set are stored in the Guard and associated with them timestamps in the second list.
 void subpropertiesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSubpropertiesPropertyURL, java.util.List<java.lang.Long> myCurrentSubpropertiesSetsTimeStamps)
          Send a list of the current properties for which subproperties set are stored in the Guard and associated with them timestamps in the second list.
 void superclassesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSuperclassesClassesURL, java.util.List<java.lang.Long> myCurrentSuperclassesSetsTimeStamps)
          Send a list of the current classes for which superclasses set are stored in the Guard and associated with them timestamps in the second list.
 void superpropertiesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSuperpropertiesPropertyURL, java.util.List<java.lang.Long> myCurrentSuperpropertiesSetsTimeStamps)
          Send a list of the current properties for which superproperties set are stored in the Guard and associated with them timestamps in the second list.
 boolean testTrue(java.lang.String statement)
          Test if the KIF statemant is true according to the ontologies in the ontology repository.
 void updateInForceValue(java.lang.String policyId, boolean inForce)
           
 void updatePolicies(java.util.List<PolicyMsg> addedPolicies, java.util.List<PolicyMsg> changedPolicies, java.util.List<PolicyMsg> removedPolicies)
           
 
Methods inherited from class kaos.core.service.util.MethodCallProxy
getResult, getResult, notifyWaitersOfError, receiveMessage, sendMessage, sendRequestNoWait
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

localOntologyInterfaces

public static OntologyService localOntologyInterfaces

_serviceProps

protected ServiceProperties _serviceProps
Constructor Detail

DirectoryServiceProxy

public DirectoryServiceProxy()
Method Detail

createAgentDescription

public AgentDescription createAgentDescription()

getServiceProperties

public ServiceProperties getServiceProperties()

setServiceProperties

public void setServiceProperties(ServiceProperties props)

addEntityOntologicalType

public void addEntityOntologicalType(java.lang.String entityNameAsString,
                                     java.lang.String typeName,
                                     java.lang.String damlDesc)
                              throws DirectoryFailure
Throws:
DirectoryFailure

getAllAgentsInDomain

public java.util.Vector getAllAgentsInDomain(java.lang.String domainName)
                                      throws DirectoryFailure
Description copied from interface: DomainDirectoryService
Get a Vector of descriptions of all of the agents in a domain.

Specified by:
getAllAgentsInDomain in interface DomainDirectoryService
Parameters:
domainName - Name of the domain to query
Returns:
Vector of AgentDescriptions of all agents in the specified domain.
Throws:
DirectoryFailure

getAllGuardsInDirectory

public java.util.List getAllGuardsInDirectory()
                                       throws DirectoryFailure
Description copied from interface: DomainDirectoryService
Get a Vector of descriptions of all guards in the directory.

Specified by:
getAllGuardsInDirectory in interface DomainDirectoryService
Returns:
Vector of AgentDescriptions of all guards in the directory.
Throws:
DirectoryFailure

getDomainDescriptionsForGuard

public java.util.List getDomainDescriptionsForGuard(java.lang.String guardGUID)
                                             throws DirectoryFailure
Description copied from interface: DomainDirectoryService
Obtain a List containing DomainDescriptions of all domains the guard, whose GUID is specified, registered in.

Specified by:
getDomainDescriptionsForGuard in interface DomainDirectoryService
Parameters:
guardGUID - GUID of the guard registered in all domains, whose descriptions are requested
Returns:
List of DomainDescriptions
Throws:
DirectoryFailure

getDomainNames

public java.util.Vector getDomainNames()
                                throws DirectoryFailure
Throws:
DirectoryFailure

getGuardDescriptionsForEntity

public java.util.Vector getGuardDescriptionsForEntity(java.lang.String entityID)
                                               throws DirectoryFailure
Throws:
DirectoryFailure

getValuesForProperty

public java.util.Set<java.lang.String> getValuesForProperty(java.lang.String property,
                                                            java.lang.String subject)
                                                     throws DirectoryFailure,
                                                            QueryFailure
Description copied from interface: OntologyRepositoryService
Get values of the variable satisfying the KIF query: (property subject ?val).

Specified by:
getValuesForProperty in interface OntologyService
Specified by:
getValuesForProperty in interface OntologyRepositoryService
Parameters:
property - the name of the property in the Jena format
subject - the name of the subject in the Jena format
Returns:
a set with values (as string in the Jena format) for the property on this subject
Throws:
DirectoryFailure
QueryFailure - if reasoning failed.

instancesSetSynchronizationRequest

public void instancesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentInstancesClassesURL,
                                               java.util.List<java.lang.Long> myCurrentInstancesSetsTimeStamps)
                                        throws DirectoryFailure
Description copied from interface: GuardSynchronization
Send a list of the current classes for which instances set are stored in the Guard and associated with them timestamps in the second list. This should allow DS to determine if an update is needed.

Specified by:
instancesSetSynchronizationRequest in interface GuardSynchronization
Parameters:
myCurrentInstancesClassesURL - The List of the current classes for which instances set are stored in the Guard identified by URLs.
myCurrentInstancesSetsTimeStamps - The List of the current instances set timestamps.
Throws:
DirectoryFailure

isSynchronizationNeeded

public boolean isSynchronizationNeeded(java.lang.Long myLastUpdateTimeStamp)
                                throws DirectoryFailure
Description copied from interface: GuardSynchronization
Check with DS if synchronization is needed by providing the timestamp of the last update.

Specified by:
isSynchronizationNeeded in interface GuardSynchronization
Parameters:
myLastUpdateTimeStamp - The timestamp of the last update
Throws:
DirectoryFailure

modify

public void modify(AgentDescription desc)
            throws NotRegisteredException,
                   DirectoryFailure
Throws:
NotRegisteredException
DirectoryFailure

modifyEntityProperties

public void modifyEntityProperties(java.lang.String entityGUID,
                                   java.util.List properties)
                            throws DirectoryFailure,
                                   NotRegisteredException,
                                   ModificationException
Throws:
DirectoryFailure
NotRegisteredException
ModificationException

policiesSynchronizationRequest

public void policiesSynchronizationRequest(java.util.List<java.lang.String> myCurrentPoliciesIds,
                                           java.util.List<java.lang.Long> myCurrentPoliciesTimeStamps)
                                    throws DirectoryFailure
Description copied from interface: GuardSynchronization
Send a list of the current policies ids and associated with them timestamps in the second list. This should allow DS to determine if an update is needed.

Specified by:
policiesSynchronizationRequest in interface GuardSynchronization
Parameters:
myCurrentPoliciesIds - The List of the current policies ids.
myCurrentPoliciesTimeStamps - The List of the current policies timestamps.
Throws:
DirectoryFailure

register

public void register(AgentDescription desc)
              throws AlreadyRegisteredException,
                     DirectoryFailure
Throws:
AlreadyRegisteredException
DirectoryFailure

deregister

public void deregister(AgentDescription desc)
                throws NotRegisteredException,
                       DirectoryFailure
Throws:
NotRegisteredException
DirectoryFailure

search

public AgentDescription[] search(AgentDescription desc)
                          throws SearchException,
                                 DirectoryFailure
Throws:
SearchException
DirectoryFailure

getAgentDescriptionForAgentID

public KAoSAgentDescription getAgentDescriptionForAgentID(java.lang.String agentID)
                                                   throws SearchException,
                                                          DirectoryFailure
Throws:
SearchException
DirectoryFailure

subclassesSetSynchronizationRequest

public void subclassesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSubclassesClassesURL,
                                                java.util.List<java.lang.Long> myCurrentSubclassesSetsTimeStamps)
                                         throws DirectoryFailure
Description copied from interface: GuardSynchronization
Send a list of the current classes for which subclasses set are stored in the Guard and associated with them timestamps in the second list. This should allow DS to determine if an update is needed.

Specified by:
subclassesSetSynchronizationRequest in interface GuardSynchronization
Parameters:
myCurrentSubclassesClassesURL - The List of the current classes for which subclasses set are stored in the Guard identified by URLs.
myCurrentSubclassesSetsTimeStamps - The List of the current subclasses set timestamps.
Throws:
DirectoryFailure

subpropertiesSetSynchronizationRequest

public void subpropertiesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSubpropertiesPropertyURL,
                                                   java.util.List<java.lang.Long> myCurrentSubpropertiesSetsTimeStamps)
                                            throws DirectoryFailure
Description copied from interface: GuardSynchronization
Send a list of the current properties for which subproperties set are stored in the Guard and associated with them timestamps in the second list. This should allow DS to determine if an update is needed.

Specified by:
subpropertiesSetSynchronizationRequest in interface GuardSynchronization
Parameters:
myCurrentSubpropertiesPropertyURL - The List of the current properties for which subproperties set are stored in the Guard identified by URLs.
myCurrentSubpropertiesSetsTimeStamps - The List of the current subproperties set timestamps.
Throws:
DirectoryFailure

superclassesSetSynchronizationRequest

public void superclassesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSuperclassesClassesURL,
                                                  java.util.List<java.lang.Long> myCurrentSuperclassesSetsTimeStamps)
                                           throws DirectoryFailure
Description copied from interface: GuardSynchronization
Send a list of the current classes for which superclasses set are stored in the Guard and associated with them timestamps in the second list. This should allow DS to determine if an update is needed.

Specified by:
superclassesSetSynchronizationRequest in interface GuardSynchronization
Parameters:
myCurrentSuperclassesClassesURL - The List of the current classes for which superclasses set are stored in the Guard identified by URLs.
myCurrentSuperclassesSetsTimeStamps - The List of the current superclasses set timestamps.
Throws:
DirectoryFailure

superpropertiesSetSynchronizationRequest

public void superpropertiesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSuperpropertiesPropertyURL,
                                                     java.util.List<java.lang.Long> myCurrentSuperpropertiesSetsTimeStamps)
                                              throws DirectoryFailure
Description copied from interface: GuardSynchronization
Send a list of the current properties for which superproperties set are stored in the Guard and associated with them timestamps in the second list. This should allow DS to determine if an update is needed.

Specified by:
superpropertiesSetSynchronizationRequest in interface GuardSynchronization
Parameters:
myCurrentSuperpropertiesPropertyURL - The List of the current properties for which superproperties set are stored in the Guard identified by URLs.
myCurrentSuperpropertiesSetsTimeStamps - The List of the current superproperties set timestamps.
Throws:
DirectoryFailure

addFilteredNamespace

public void addFilteredNamespace(java.lang.String namespace)
                          throws DirectoryFailure
Description copied from interface: OntologyRepositoryService
This method add a namespace to the set of urls depicting ontology namespaces concept of which are filtered out when returned by methods of this repository.

Specified by:
addFilteredNamespace in interface OntologyRepositoryService
Parameters:
namespace - The name of the namespace
Throws:
DirectoryFailure

addPolicies

public void addPolicies(java.util.List<PolicyMsg> policies)
                 throws PolicyManagement.OntologyPolicyIncorrect,
                        PoliciesHarmonizedException,
                        PolicyManagement.PrecedenceUndeterminedException,
                        DirectoryFailure
Specified by:
addPolicies in interface PolicyManagement
Throws:
PolicyManagement.OntologyPolicyIncorrect
PoliciesHarmonizedException
PolicyManagement.PrecedenceUndeterminedException
DirectoryFailure

addPolicy

public void addPolicy(PolicyMsg policy)
               throws PolicyManagement.OntologyPolicyIncorrect,
                      PoliciesHarmonizedException,
                      PolicyManagement.PrecedenceUndeterminedException,
                      DirectoryFailure
Specified by:
addPolicy in interface PolicyManagement
Throws:
PolicyManagement.OntologyPolicyIncorrect
PoliciesHarmonizedException
PolicyManagement.PrecedenceUndeterminedException
DirectoryFailure

addPolicySet

public void addPolicySet(PolicySetMsg policySet)
                  throws DirectoryFailure
Specified by:
addPolicySet in interface PolicySetDirectory
Throws:
DirectoryFailure

addPolicySets

public void addPolicySets(java.util.List<PolicySetMsg> policySets)
                   throws DirectoryFailure
Specified by:
addPolicySets in interface PolicySetDirectory
Throws:
DirectoryFailure

addPolicy

public void addPolicy(java.lang.String owlPolicyDescription)
               throws DirectoryFailure,
                      PolicyManagement.OntologyPolicyIncorrect,
                      PoliciesHarmonizedException,
                      PolicyManagement.PrecedenceUndeterminedException
Specified by:
addPolicy in interface PolicyManagement
Throws:
DirectoryFailure
PolicyManagement.OntologyPolicyIncorrect
PoliciesHarmonizedException
PolicyManagement.PrecedenceUndeterminedException

addPolicyUpdateListener

public void addPolicyUpdateListener(PolicyListener listener)
                             throws ServiceFailure
Specified by:
addPolicyUpdateListener in interface PolicyManagement
Throws:
ServiceFailure

removePolicyUpdateListener

public void removePolicyUpdateListener(PolicyListener listener)
                                throws ServiceFailure
Specified by:
removePolicyUpdateListener in interface PolicyManagement
Throws:
ServiceFailure

changePolicy

public void changePolicy(java.lang.String policyID,
                         java.lang.String owlPolicyDescription)
                  throws PolicyManagement.OntologyPolicyIncorrect,
                         PolicyManagement.PrecedenceUndeterminedException,
                         PoliciesHarmonizedException,
                         ServiceFailure
Specified by:
changePolicy in interface PolicyManagement
Throws:
PolicyManagement.OntologyPolicyIncorrect
PolicyManagement.PrecedenceUndeterminedException
PoliciesHarmonizedException
ServiceFailure

findPolicies

public java.util.List<PolicyMsg> findPolicies(java.lang.String actionType,
                                              java.util.Map<java.util.List<java.lang.String>,java.lang.String> policyRestrictions)
                                       throws ServiceFailure
Specified by:
findPolicies in interface PolicyManagement
Throws:
ServiceFailure

getAllPoliciesFor

public java.util.List<PolicyMsg> getAllPoliciesFor(java.lang.String conceptId)
                                            throws ServiceFailure
Specified by:
getAllPoliciesFor in interface PolicyManagement
Throws:
ServiceFailure

removeAllPolicies

public void removeAllPolicies(java.lang.String policyDBManagerID)
                       throws DirectoryFailure
Throws:
DirectoryFailure

removePolicy

public void removePolicy(PolicyMsg policy)
                  throws PolicyManagement.OntologyPolicyIncorrect,
                         ServiceFailure
Specified by:
removePolicy in interface PolicyManagement
Throws:
PolicyManagement.OntologyPolicyIncorrect
ServiceFailure

removePolicy

public void removePolicy(java.lang.String policyID)
                  throws ServiceFailure
Specified by:
removePolicy in interface PolicyManagement
Throws:
ServiceFailure

removePolicies

public void removePolicies(java.util.List<PolicyMsg> policies)
                    throws PolicyManagement.OntologyPolicyIncorrect,
                           ServiceFailure
Specified by:
removePolicies in interface PolicyManagement
Throws:
PolicyManagement.OntologyPolicyIncorrect
ServiceFailure

areClassesDisjoint

public boolean areClassesDisjoint(java.lang.String firstClass,
                                  java.lang.String secondClass)
                           throws QueryFailure,
                                  DirectoryFailure
Description copied from interface: OntologyRepositoryService
Test if two provided classes are disjoint

Specified by:
areClassesDisjoint in interface OntologyRepositoryService
Parameters:
firstClass - the name of the first class
secondClass - the name of the second class
Returns:
true if the classes are not disjoint
Throws:
QueryFailure - if reasoning failed.
DirectoryFailure

changeComponentEnabledStatus

public java.util.Vector changeComponentEnabledStatus(java.lang.String repType,
                                                     java.lang.String associatedOntType,
                                                     java.lang.Boolean state,
                                                     java.lang.String guardRepMgrID)
                                              throws java.lang.Exception
Throws:
java.lang.Exception

changePolicies

public void changePolicies(java.util.List<PolicyMsg> policies)
                    throws PolicyManagement.OntologyPolicyIncorrect,
                           PoliciesHarmonizedException,
                           PolicyManagement.PrecedenceUndeterminedException,
                           DirectoryFailure
Specified by:
changePolicies in interface PolicyManagement
Throws:
PolicyManagement.OntologyPolicyIncorrect
PoliciesHarmonizedException
PolicyManagement.PrecedenceUndeterminedException
DirectoryFailure

changePolicy

public void changePolicy(PolicyMsg policy)
                  throws PolicyManagement.OntologyPolicyIncorrect,
                         PoliciesHarmonizedException,
                         PolicyManagement.PrecedenceUndeterminedException,
                         DirectoryFailure
Specified by:
changePolicy in interface PolicyManagement
Throws:
PolicyManagement.OntologyPolicyIncorrect
PoliciesHarmonizedException
PolicyManagement.PrecedenceUndeterminedException
DirectoryFailure

changePolicySet

public void changePolicySet(PolicySetMsg policySet)
                     throws DirectoryFailure
Specified by:
changePolicySet in interface PolicySetDirectory
Throws:
DirectoryFailure

changePolicySets

public void changePolicySets(java.util.List<PolicySetMsg> policySets)
                      throws DirectoryFailure
Specified by:
changePolicySets in interface PolicySetDirectory
Throws:
DirectoryFailure

changedPriority

public void changedPriority(java.lang.String policyId,
                            int newPriority)
                     throws DirectoryFailure
Description copied from interface: PolicyModification
Method allowing to modify priority of a policy to either eliminate conflict or to alter policy precedence relation

Specified by:
changedPriority in interface PolicyModification
Parameters:
policyId - id of the policy
newPriority - new priority of the policy
Throws:
DirectoryFailure

updateInForceValue

public void updateInForceValue(java.lang.String policyId,
                               boolean inForce)
                        throws DirectoryFailure
Throws:
DirectoryFailure

checkDeepPermission

public void checkDeepPermission(ActionInstanceDescription aid,
                                PolicyDecisionObserver observer)
                         throws java.lang.NullPointerException,
                                ServiceFailure,
                                KAoSSecurityException
Specified by:
checkDeepPermission in interface PolicyChecking
Throws:
java.lang.NullPointerException
ServiceFailure
KAoSSecurityException

declareInstance

public void declareInstance(java.lang.String instanceName,
                            java.lang.String className)
                     throws UnknownConceptException,
                            DirectoryFailure
Throws:
UnknownConceptException
DirectoryFailure

deleteAllLogs

public void deleteAllLogs(java.lang.String historyMonitorID)
                   throws DirectoryFailure
Throws:
DirectoryFailure

deleteLogsforActionType

public java.util.Vector deleteLogsforActionType(java.lang.String actionType,
                                                java.lang.String historyMonitorID)
                                         throws DirectoryFailure
Throws:
DirectoryFailure

deleteLogsforActor

public java.util.Vector deleteLogsforActor(java.lang.String actorID,
                                           java.lang.String historyMonitorID)
                                    throws DirectoryFailure
Throws:
DirectoryFailure

deleteSpecifiedLogs

public java.util.Vector deleteSpecifiedLogs(java.lang.String actionType,
                                            java.lang.String actorID,
                                            java.lang.String startTime,
                                            java.lang.String endTime,
                                            java.lang.Boolean latest,
                                            java.lang.String historyMonitorID)
                                     throws DirectoryFailure
Throws:
DirectoryFailure

findConflictingPolicies

public java.util.List findConflictingPolicies(java.lang.String policyId)
                                       throws DirectoryFailure
Description copied from interface: PolicyAnalyzes
Method find all the policies conflicting with the specified policy

Specified by:
findConflictingPolicies in interface PolicyAnalyzes
Parameters:
policyId - id of the policy
Returns:
List of Policy Ids
Throws:
DirectoryFailure

findPoliciesMadeRedundant

public java.util.List findPoliciesMadeRedundant(java.lang.String policyId)
                                         throws DirectoryFailure
Description copied from interface: PolicyAnalyzes
Method find all the policies with higher priority making the specified policy redundant

Specified by:
findPoliciesMadeRedundant in interface PolicyAnalyzes
Parameters:
policyId - id of the policy
Returns:
List of Policy Ids
Throws:
DirectoryFailure

findPoliciesMakingRedundant

public java.util.List findPoliciesMakingRedundant(java.lang.String policyId)
                                           throws DirectoryFailure
Description copied from interface: PolicyAnalyzes
Method find all the policies with higher priority making the specified policy redundant

Specified by:
findPoliciesMakingRedundant in interface PolicyAnalyzes
Parameters:
policyId - id of the policy
Returns:
List of Policy Ids
Throws:
DirectoryFailure

findPolicyDecision

public java.util.Vector findPolicyDecision(ActionInstanceDescription aid,
                                           PolicyDecisionObserver observer)
                                    throws KAoSSecurityException,
                                           java.lang.NullPointerException,
                                           ServiceFailure
For Policy Disclosure

Specified by:
findPolicyDecision in interface PolicyChecking
Throws:
KAoSSecurityException
java.lang.NullPointerException
ServiceFailure

getAllDomainsInDirectory

public java.util.Vector getAllDomainsInDirectory()
                                          throws DirectoryFailure
Description copied from interface: DomainDirectoryService
Get a Vector of descriptions of all of the domains in a directory.

Specified by:
getAllDomainsInDirectory in interface DomainDirectoryService
Returns:
Vector of AgentDescriptions of all agents in the specified domain.
Throws:
DirectoryFailure

getAllLogs

public java.util.List getAllLogs(java.lang.String historyMonitorID)
                          throws DirectoryFailure
Throws:
DirectoryFailure

getAllNamespaces

public java.util.Set getAllNamespaces()
                               throws DirectoryFailure
Description copied from interface: OntologyRepositoryService
This method returns a set of urls depicting ontologies loaded into the JTP as well namespaces used internally by KAoS.

Specified by:
getAllNamespaces in interface OntologyRepositoryService
Throws:
DirectoryFailure

getAllPolicies

public java.util.Vector getAllPolicies(java.lang.String policyDBManagerID)
                                throws DirectoryFailure
Throws:
DirectoryFailure

getAllSchema

public java.util.List getAllSchema()
                            throws DirectoryFailure
Description copied from interface: XMLRepository
Retrieve all schemas in the repository.

Specified by:
getAllSchema in interface XMLRepository
Returns:
list containing XMLSchemaContainer objects.
Throws:
DirectoryFailure

getAllowableValuesForActionProperties

public java.util.Vector getAllowableValuesForActionProperties(ActionInstanceDescription actionDesc,
                                                              PolicyDecisionObserver observer)
                                                       throws ServiceFailure
Specified by:
getAllowableValuesForActionProperties in interface PolicyAdvice
Throws:
ServiceFailure

getAllowableValuesForActionProperties

public java.util.Vector getAllowableValuesForActionProperties(java.util.Vector propertyNames,
                                                              ActionInstanceDescription actionDesc,
                                                              boolean tight,
                                                              PolicyDecisionObserver observer)
                                                       throws ServiceFailure
Specified by:
getAllowableValuesForActionProperties in interface PolicyAdvice
Throws:
ServiceFailure

getAllowableValuesForActionProperty

public java.util.Set getAllowableValuesForActionProperty(java.lang.String origPropertyName,
                                                         ActionInstanceDescription origActionDesc,
                                                         java.util.Set allTargetValues,
                                                         boolean tight,
                                                         PolicyDecisionObserver observer)
                                                  throws ServiceFailure
Specified by:
getAllowableValuesForActionProperty in interface PolicyAdvice
Throws:
ServiceFailure

getClassesDefInNamespace

public java.util.Set getClassesDefInNamespace(java.lang.String namespaceName)
                                       throws UnknownNamespaceException,
                                              DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get set of classes defined in the given namespace.

Specified by:
getClassesDefInNamespace in interface OntologyRepositoryService
Parameters:
namespaceName - The name of the namespace in the Jena format
Returns:
Set of classes names in the Jena format
Throws:
UnknownNamespaceException - if namespaceName is unknown for the ontology repository
DirectoryFailure

getComponentEnabledStatus

public java.lang.Boolean getComponentEnabledStatus(java.lang.String repType,
                                                   java.lang.String associatedOntType,
                                                   java.lang.String guardRepMgrID)
                                            throws java.lang.Exception
Throws:
java.lang.Exception

getConstructedOntologyStructure

public SerializableOntModelImpl getConstructedOntologyStructure(java.lang.String structureId)
                                                         throws OntologyRepository.ReasoningException,
                                                                UnknownConceptException,
                                                                java.io.IOException,
                                                                DirectoryFailure
Description copied from interface: OntologyRepositoryService
This method get stored ontology structure references by its id in the repository.

Specified by:
getConstructedOntologyStructure in interface OntologyService
Specified by:
getConstructedOntologyStructure in interface OntologyRepositoryService
Parameters:
structureId - ontology structure id
Returns:
SerializableOntModelImpl object
Throws:
OntologyRepository.ReasoningException - or IOException when loading of the ontology failed.
UnknownConceptException
java.io.IOException
DirectoryFailure

getDomainStructure

public java.util.Map getDomainStructure(java.lang.String domainName)
                                 throws DirectoryFailure
Description copied from interface: DomainDirectoryService
Obtain a Map containing the structure of a domain.

Specified by:
getDomainStructure in interface DomainDirectoryService
Parameters:
domainName - name of the domain to map
Returns:
Map of hosts -> execution environments -> containers -> agents
Throws:
DirectoryFailure

getFilteredNamespaces

public java.util.Set getFilteredNamespaces()
                                    throws DirectoryFailure
Description copied from interface: OntologyRepositoryService
This method returns a set of urls depicting ontology namespaces concept of which are filtered out when returned by methods of this repository.

Specified by:
getFilteredNamespaces in interface OntologyRepositoryService
Throws:
DirectoryFailure

getForbiddenValuesForActionProperty

public java.util.Vector getForbiddenValuesForActionProperty(java.lang.String origPropertyName,
                                                            ActionInstanceDescription origActionDesc,
                                                            PolicyDecisionObserver observer)
                                                     throws ServiceFailure
Specified by:
getForbiddenValuesForActionProperty in interface PolicyAdvice
Throws:
ServiceFailure

getGuardStateFor

public java.lang.String getGuardStateFor(java.lang.String guardID)
                                  throws DirectoryFailure
Throws:
DirectoryFailure

getInstancesDefInNamespace

public java.util.Set getInstancesDefInNamespace(java.lang.String namespaceName)
                                         throws UnknownNamespaceException,
                                                DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get set of instances defined in the given namespace.

Specified by:
getInstancesDefInNamespace in interface OntologyRepositoryService
Parameters:
namespaceName - The name of the namespace in the Jena format
Returns:
Set of instances names in the Jena format
Throws:
UnknownNamespaceException - if namespaceName is unknown for the ontology repository
DirectoryFailure

getListOfLoadedOntologies

public java.util.Set getListOfLoadedOntologies()
                                        throws DirectoryFailure
Description copied from interface: OntologyService
This method returns a set of urls depicting ontologies loaded into the Ontology Service

Specified by:
getListOfLoadedOntologies in interface OntologyService
Throws:
DirectoryFailure

getLogsforActionType

public java.util.Vector getLogsforActionType(java.lang.String actionType,
                                             java.lang.String historyMonitorID)
                                      throws DirectoryFailure
Throws:
DirectoryFailure

getLogsforActor

public java.util.Vector getLogsforActor(java.lang.String actorID,
                                        java.lang.String historyMonitorID)
                                 throws DirectoryFailure
Throws:
DirectoryFailure

getNamspacesImportedByNamespace

public java.util.Set getNamspacesImportedByNamespace(java.lang.String namespaceName)
                                              throws UnknownNamespaceException,
                                                     DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get set of namespaces imported by the given namespace.

Specified by:
getNamspacesImportedByNamespace in interface OntologyRepositoryService
Parameters:
namespaceName - The name of the namespace in the Jena format
Returns:
Set of namespaces names in the Jena format
Throws:
UnknownNamespaceException - if namespaceName is unknown for the ontology repository
DirectoryFailure

getObligationsForTriggerCondition

public java.util.List<ActionInstanceDescription> getObligationsForTriggerCondition(ActionInstanceDescription triggerAID,
                                                                                   PolicyDecisionObserver observer)
                                                                            throws ServiceFailure
Specified by:
getObligationsForTriggerCondition in interface PolicyChecking
Throws:
ServiceFailure

getPoliciesByEntities

public java.util.Map getPoliciesByEntities()
                                    throws DirectoryFailure
Specified by:
getPoliciesByEntities in interface PolicyManagement
Throws:
DirectoryFailure

getPolicyInformation

public PolicyInformation getPolicyInformation(java.lang.String policyID,
                                              java.lang.String policyDBManagerID)
                                       throws DirectoryFailure
Throws:
DirectoryFailure

getPolicySet

public PolicySetMsg getPolicySet(java.lang.String policySetId)
                          throws DirectoryFailure
Specified by:
getPolicySet in interface PolicySetDirectory
Throws:
DirectoryFailure

getPolicySets

public java.util.List getPolicySets()
                             throws DirectoryFailure
Description copied from interface: PolicySetDirectory
Obtain List over all policy sets.

Specified by:
getPolicySets in interface PolicySetDirectory
Returns:
List of policy set Msgs.
Throws:
DirectoryFailure

getPolicyUpdateCount

public java.lang.Integer getPolicyUpdateCount()
                                       throws ServiceFailure
Specified by:
getPolicyUpdateCount in interface PolicyAdvice
Throws:
ServiceFailure

getPropertiesApplicableTo

public java.util.Vector getPropertiesApplicableTo(java.lang.String className)
                                           throws QueryFailure,
                                                  UnknownConceptException,
                                                  DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get set of properties defined in the given namespace.

Specified by:
getPropertiesApplicableTo in interface OntologyService
Specified by:
getPropertiesApplicableTo in interface OntologyRepositoryService
Parameters:
className - the name of the class
Returns:
set of properties names
Throws:
UnknownConceptException - if className is unknow for the ontology repository
QueryFailure
DirectoryFailure

getPropertiesDefInNamespace

public java.util.Set getPropertiesDefInNamespace(java.lang.String namespaceName)
                                          throws UnknownNamespaceException,
                                                 DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get set of properties defined in the given namespace.

Specified by:
getPropertiesDefInNamespace in interface OntologyRepositoryService
Parameters:
namespaceName - The name of the namespace in the Jena format
Returns:
Set of properties names in the Jena format
Throws:
UnknownNamespaceException - if namespaceName is unknown for the ontology repository
DirectoryFailure

invokeKAoSExtensionComponentMethod

public java.lang.Object invokeKAoSExtensionComponentMethod(java.lang.String repType,
                                                           java.lang.String associatedOntType,
                                                           java.lang.String methodName,
                                                           java.util.Vector args,
                                                           java.lang.String guardId)
                                                    throws java.lang.Exception
Throws:
java.lang.Exception

getRepositoryTableInformation

public java.util.Hashtable getRepositoryTableInformation(java.lang.String repType,
                                                         java.lang.String guardRepMgrID)
                                                  throws java.lang.Exception
Throws:
java.lang.Exception

getResourcesWithValueForProperty

public java.util.Set getResourcesWithValueForProperty(java.lang.String property,
                                                      java.lang.String value)
                                               throws QueryFailure,
                                                      DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get values of the variable satisfying the KIF query: (property ?subject value).

Specified by:
getResourcesWithValueForProperty in interface OntologyRepositoryService
Parameters:
property - the name of the property in the Jena format
value - the value as a string in th Jena format
Returns:
a set with name of subjects (in the Jena format) which have the specified value for the given property
Throws:
QueryFailure - if reasoning failed.
DirectoryFailure

getRootDomains

public java.util.Vector getRootDomains()
                                throws DirectoryFailure
Description copied from interface: DomainDirectoryService
Obtain a Vector of the names of the root domains (domains with no parent)

Specified by:
getRootDomains in interface DomainDirectoryService
Returns:
Vector of Strings of the names of root domains
Throws:
DirectoryFailure

getSpecifiedLogs

public java.util.Vector getSpecifiedLogs(java.lang.String actionType,
                                         java.lang.String actorID,
                                         java.lang.String startTime,
                                         java.lang.String endTime,
                                         java.lang.Boolean latest,
                                         java.lang.String historyMonitorID)
                                  throws DirectoryFailure
Throws:
DirectoryFailure

harmonizePolicy

public java.util.List harmonizePolicy(java.lang.String harmonizedPolicy,
                                      java.lang.String harmonizingPolicy)
                               throws DirectoryFailure
Description copied from interface: PolicyModification
Method deconflicting the added policy with policies currently in the Policy Directory

Specified by:
harmonizePolicy in interface PolicyModification
Parameters:
harmonizedPolicy - id of the policy to be harmonized.
harmonizingPolicy - id of the policy harmonizing the first policy
Returns:
List containing ids of policies representing the result of harmonization
Throws:
DirectoryFailure

isEntityInDomain

public boolean isEntityInDomain(java.lang.String domainName,
                                java.lang.String id)
Description copied from interface: DomainDirectoryService
Search for the domain entity with the specified id.

Specified by:
isEntityInDomain in interface DomainDirectoryService
Parameters:
domainName - The name of the domain to query
id - The id of an entity to be searched in this domain's directory.
Returns:
true if the entity whose id is specified is found; otherwise return false.

isFullyOverlappedBySecondPolicy

public boolean isFullyOverlappedBySecondPolicy(java.lang.String firstPolicyId,
                                               java.lang.String secondPolicyId)
                                        throws DirectoryFailure,
                                               PolicyAnalyzes.PriorityConditionNotMet
Description copied from interface: PolicyAnalyzes
Method finds out if the specified policy is fully overlapped by the second specified policy, the necessary condition is that the two policies have the same modality

Specified by:
isFullyOverlappedBySecondPolicy in interface PolicyAnalyzes
Parameters:
firstPolicyId - id of the policy
secondPolicyId - id of the policy
Returns:
true if fully covered, false is not
Throws:
DirectoryFailure
PolicyAnalyzes.PriorityConditionNotMet

isFullyOverlappedByUnionOfPolicies

public boolean isFullyOverlappedByUnionOfPolicies(java.lang.String firstPolicyId,
                                                  java.util.List<java.lang.String> listOfPolicies)
                                           throws DirectoryFailure,
                                                  PolicyAnalyzes.PriorityConditionNotMet
Description copied from interface: PolicyAnalyzes
Method finds out if the specified policy is fully overlapped by the union of specified policies, the necessary condition is that the all policies have the same modality

Specified by:
isFullyOverlappedByUnionOfPolicies in interface PolicyAnalyzes
Parameters:
firstPolicyId - id of the policy
listOfPolicies - list of policies
Returns:
true if fully covered, false is not
Throws:
DirectoryFailure
PolicyAnalyzes.PriorityConditionNotMet

isGuardLoggingActive

public java.lang.Boolean isGuardLoggingActive(java.lang.String historyMonitorID)
                                       throws DirectoryFailure
Throws:
DirectoryFailure

isMadeFullyRedundantByPolicyUnion

public boolean isMadeFullyRedundantByPolicyUnion(java.lang.String firstPolicyId,
                                                 java.util.List<java.lang.String> listOfPolicies)
                                          throws DirectoryFailure,
                                                 PolicyAnalyzes.PriorityConditionNotMet
Description copied from interface: PolicyAnalyzes
Method finds out if the specified policy is being made redundant (fully covered) by the union of specified policies with higher priority in the repository

Specified by:
isMadeFullyRedundantByPolicyUnion in interface PolicyAnalyzes
Parameters:
firstPolicyId - id of the policy
listOfPolicies - list of policies
Returns:
true if redundant, false is not
Throws:
DirectoryFailure
PolicyAnalyzes.PriorityConditionNotMet

isMadeFullyRedundantBySecond

public boolean isMadeFullyRedundantBySecond(java.lang.String firstPolicyId,
                                            java.lang.String secondPolicyId)
                                     throws DirectoryFailure,
                                            PolicyAnalyzes.PriorityConditionNotMet
Description copied from interface: PolicyAnalyzes
Method finds out if the specified policy is being made redundant (fully covered) by the second specified policy with higher priority in the repository

Specified by:
isMadeFullyRedundantBySecond in interface PolicyAnalyzes
Parameters:
firstPolicyId - id of the policy
secondPolicyId - id of the policy
Returns:
true if redundant, false is not
Throws:
DirectoryFailure
PolicyAnalyzes.PriorityConditionNotMet

isMadeParitallyRedundantBySecond

public boolean isMadeParitallyRedundantBySecond(java.lang.String firstPolicyId,
                                                java.lang.String secondPolicyId)
                                         throws DirectoryFailure,
                                                PolicyAnalyzes.PriorityConditionNotMet
Description copied from interface: PolicyAnalyzes
Method finds out if the specified policy is being made partially redundant (partially covered) by the second specified policy with higher priority in the repository

Specified by:
isMadeParitallyRedundantBySecond in interface PolicyAnalyzes
Parameters:
firstPolicyId - id of the policy
secondPolicyId - id of the policy
Returns:
true if redundant, false is not
Throws:
DirectoryFailure
PolicyAnalyzes.PriorityConditionNotMet

isPartiallyOverlappedBySecondPolicy

public boolean isPartiallyOverlappedBySecondPolicy(java.lang.String firstPolicyId,
                                                   java.lang.String secondPolicyId)
                                            throws DirectoryFailure,
                                                   PolicyAnalyzes.PriorityConditionNotMet
Description copied from interface: PolicyAnalyzes
Method finds out if the specified policy is partially overlapped by the second specified policy, the necessary condition is that the two policies have the same modality

Specified by:
isPartiallyOverlappedBySecondPolicy in interface PolicyAnalyzes
Parameters:
firstPolicyId - id of the policy
secondPolicyId - id of the policy
Returns:
true if fully covered, false is not
Throws:
DirectoryFailure
PolicyAnalyzes.PriorityConditionNotMet

isPolicyInConflict

public boolean isPolicyInConflict(java.lang.String policyId)
                           throws DirectoryFailure
Specified by:
isPolicyInConflict in interface PolicyAnalyzes
Throws:
DirectoryFailure

isPolicyMakingRedundantSomeOtherPolicy

public boolean isPolicyMakingRedundantSomeOtherPolicy(java.lang.String policyId)
                                               throws DirectoryFailure
Description copied from interface: PolicyAnalyzes
Method finds out if the specified policy makes redundant (fully or partially) some policies with lower priority in the repository

Specified by:
isPolicyMakingRedundantSomeOtherPolicy in interface PolicyAnalyzes
Parameters:
policyId - id of the policy
Returns:
true if redundant, false is not
Throws:
DirectoryFailure

isPolicyRedundant

public boolean isPolicyRedundant(java.lang.String policyId)
                          throws DirectoryFailure
Description copied from interface: PolicyAnalyzes
Method finds out if the specified policy is being made redundant (fully or partially) by some policies with higher priority in the repository

Specified by:
isPolicyRedundant in interface PolicyAnalyzes
Parameters:
policyId - id of the policy
Returns:
true if redundant, false is not
Throws:
DirectoryFailure

loadSchema

public void loadSchema(java.lang.String fileName)
                throws DirectoryFailure
Description copied from interface: XMLRepository
Load schema definitions of data types from a file.

Specified by:
loadSchema in interface XMLRepository
Parameters:
fileName - the name of the file or the url that stores schema definitions
Throws:
DirectoryFailure

putConstructedOntologyStructures

public void putConstructedOntologyStructures(java.util.List<SerializableOntModelImpl> ontologyStructureList)
                                      throws OntologyRepository.ReasoningException,
                                             java.io.IOException,
                                             DirectoryFailure
Description copied from interface: OntologyRepositoryService
This method stores multiple ontology structures in the repository.

Specified by:
putConstructedOntologyStructures in interface OntologyRepositoryService
Parameters:
ontologyStructureList - a list containing SerializableOntModelImpl objects.
Throws:
OntologyRepository.ReasoningException
java.io.IOException
DirectoryFailure

putMultipleSchema

public void putMultipleSchema(java.util.List<XMLSchemaContainer> schemaList)
                       throws DirectoryFailure
Description copied from interface: XMLRepository
Store multiple schemas in the repository.

Specified by:
putMultipleSchema in interface XMLRepository
Parameters:
schemaList - a list containing XMLSchemaContainer objects.
Throws:
DirectoryFailure

putSchema

public void putSchema(java.lang.String dataName,
                      java.lang.String dataSchema)
               throws DirectoryFailure
Description copied from interface: OntologyService
Add an XML schema for the given concept

Specified by:
putSchema in interface OntologyService
Specified by:
putSchema in interface XMLRepository
Parameters:
dataName - uri name of the concept
Throws:
DirectoryFailure

removeExecEnv

public void removeExecEnv(java.lang.String execEnvID)
Description copied from interface: DomainDirectoryService
Remove ExecutionEnvironment with the specified ID from the domain structure.

Specified by:
removeExecEnv in interface DomainDirectoryService

removeFilteredNamespace

public void removeFilteredNamespace(java.lang.String namespace)
                             throws DirectoryFailure
Description copied from interface: OntologyRepositoryService
This method remove a namespace from the set of urls depicting ontology namespaces concept of which are filtered out when returned by methods of this repository.

Specified by:
removeFilteredNamespace in interface OntologyRepositoryService
Parameters:
namespace - The name of the namespace
Throws:
DirectoryFailure

removePolicyInformation

public PolicyInformation removePolicyInformation(java.lang.String policyID,
                                                 java.lang.String policyDBManagerID)
                                          throws DirectoryFailure
Throws:
DirectoryFailure

removePolicySet

public void removePolicySet(PolicySetMsg policySet)
                     throws DirectoryFailure
Specified by:
removePolicySet in interface PolicySetDirectory
Throws:
DirectoryFailure

removePolicySets

public void removePolicySets(java.util.List<PolicySetMsg> policySets)
                      throws DirectoryFailure
Specified by:
removePolicySets in interface PolicySetDirectory
Throws:
DirectoryFailure

removeSchema

public void removeSchema(java.lang.String dataName)
                  throws DirectoryFailure
Description copied from interface: XMLRepository
Remove the schema for the given data type from this repository.

Specified by:
removeSchema in interface XMLRepository
Parameters:
dataName - the name of the data type to be removed.
Throws:
DirectoryFailure

setGuardLoggingState

public void setGuardLoggingState(java.lang.Boolean logging,
                                 java.lang.String historyMonitorID)
                          throws DirectoryFailure
Throws:
DirectoryFailure

splitPolicy

public java.util.List splitPolicy(java.lang.String splitPolicy,
                                  java.lang.String secondPolicy)
                           throws DirectoryFailure
Description copied from interface: PolicyModification
Method splitting the controlled action of the selected policy one part that overlaps with the second policy and the other part which does not. Then the priorities of these parts can be modified independently

Specified by:
splitPolicy in interface PolicyModification
Parameters:
splitPolicy - id of the policy to be split.
secondPolicy - id of the policy splitting the first policy
Returns:
List containing ids of policies representing the result of process
Throws:
DirectoryFailure

analyzeWorkflow

public java.lang.String analyzeWorkflow(java.lang.String owlsWorkflow)
                                 throws KAoSSecurityException,
                                        java.lang.NullPointerException,
                                        ServiceFailure
Throws:
KAoSSecurityException
java.lang.NullPointerException
ServiceFailure

analyzeWorkflow

public java.lang.String analyzeWorkflow(java.net.URL owlsWorkflow)
                                 throws KAoSSecurityException,
                                        java.lang.NullPointerException,
                                        ServiceFailure
Throws:
KAoSSecurityException
java.lang.NullPointerException
ServiceFailure

askQuery

public java.util.Set askQuery(java.lang.String variableName,
                              java.lang.String multiplyVariablesQuery)
                       throws QueryFailure,
                              DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get values of the selected variable satisfying the KIF query with possibly many variable.

Specified by:
askQuery in interface OntologyRepositoryService
Parameters:
variableName - the name of the selected variable
multiplyVariablesQuery - the query
Returns:
a set with values satisfying the query
Throws:
QueryFailure - if reasoning failed.
DirectoryFailure

checkPermission

public void checkPermission(ActionInstanceDescription aid,
                            PolicyDecisionObserver observer)
                     throws KAoSSecurityException,
                            java.lang.NullPointerException,
                            ServiceFailure
Specified by:
checkPermission in interface PolicyChecking
Throws:
KAoSSecurityException
java.lang.NullPointerException
ServiceFailure

getActions

public java.util.Set<ActionClassDescription> getActions(java.lang.String forActor)
                                                 throws UnknownConceptException,
                                                        DirectoryFailure
Description copied from interface: QueryKAoSOntologyService
Get descriptions of the Action classes the specified Actor class or instance can perfom based on its class.

Specified by:
getActions in interface QueryKAoSOntologyService
Parameters:
forActor - The name of the Actor class or instance
Returns:
Set of ActionClassDescription
Throws:
UnknownConceptException - if forActor is unknown for the ontology repository
DirectoryFailure

getAllAgentsInDirectory

public java.util.List getAllAgentsInDirectory()
                                       throws DirectoryFailure
Description copied from interface: DomainDirectoryService
Get a Vector of descriptions of all agents in the directory.

Specified by:
getAllAgentsInDirectory in interface DomainDirectoryService
Returns:
Vector of AgentDescriptions of all agents in the directory.
Throws:
DirectoryFailure

getClassesOfActors

public java.util.Set getClassesOfActors(java.lang.String baseActorClass)
                                 throws UnknownConceptException,
                                        DirectoryFailure
Description copied from interface: QueryKAoSOntologyService
Get names of the Actors classes known to the ontology repository being a subclass of the specified base class.

Specified by:
getClassesOfActors in interface QueryKAoSOntologyService
Parameters:
baseActorClass - The name of the Actor class which the return classes have to be a subclass of If the name is empty uses Actor as a base class
Returns:
Set of names of Actor subclasses
Throws:
UnknownConceptException - if baseActorClass is unknown for the ontology repository
DirectoryFailure

getClassesOfActorsCapableOfPerformingActions

public java.util.Set getClassesOfActorsCapableOfPerformingActions(java.lang.String actionClass)
                                                           throws UnknownConceptException,
                                                                  DirectoryFailure
Description copied from interface: QueryKAoSOntologyService
Get names of Actor classes capable to perform a given action, without taking into consideration policy restrictions

Specified by:
getClassesOfActorsCapableOfPerformingActions in interface QueryKAoSOntologyService
Parameters:
actionClass - The name of the Action class
Returns:
Set of Strings containing names of Actor classes
Throws:
UnknownConceptException - if actionClass is unknown for the ontology repository
DirectoryFailure

getClassesOfGroups

public java.util.Set getClassesOfGroups(java.lang.String baseGroupClass)
                                 throws UnknownConceptException,
                                        DirectoryFailure
Description copied from interface: QueryKAoSOntologyService
Get names of the Group classes known to the ontology repository being a subclass of the specified base class.

Specified by:
getClassesOfGroups in interface QueryKAoSOntologyService
Parameters:
baseGroupClass - The name of the Group class which the return elements have to be an instance of If the name is empty uses Group as a base class
Returns:
Set of names of individual Groups
Throws:
UnknownConceptException - if baseGroupClass is unknown for the ontology repository
DirectoryFailure

getClassesOfPlaces

public java.util.Set getClassesOfPlaces(java.lang.String basePlaceClass)
                                 throws UnknownConceptException,
                                        DirectoryFailure
Description copied from interface: QueryKAoSOntologyService
Get names of the Places classes known to the ontology repository being a subclass of the specified base class.

Specified by:
getClassesOfPlaces in interface QueryKAoSOntologyService
Parameters:
basePlaceClass - The name of the Place class which the return classes have to be a subclass of If the name is empty uses Place as a base class
Returns:
Set of names of Place subclasses
Throws:
UnknownConceptException - if basePlaceClass is unknow for the ontology repository
DirectoryFailure

getClassesOfTargets

public java.util.Set getClassesOfTargets(java.lang.String baseTargetClass)
                                  throws UnknownConceptException,
                                         DirectoryFailure
Description copied from interface: QueryKAoSOntologyService
Get names of the targets (Actors or Entities) classes known to the ontology repository being a subclass of the specified base class.

Specified by:
getClassesOfTargets in interface QueryKAoSOntologyService
Parameters:
baseTargetClass - The name of the targets (Actor or Entity) class which the return classes have to be a subclass of
Returns:
Set of names of targets (Actors or Entities) subclasses
Throws:
UnknownConceptException - if baseTargetClass is unknown for the ontology repository
DirectoryFailure

getConstructedOntologyStructures

public java.util.List getConstructedOntologyStructures()
                                                throws DirectoryFailure
Description copied from interface: OntologyRepositoryService
This method retrieves all user defined ontology structures in the repository.

Specified by:
getConstructedOntologyStructures in interface OntologyService
Specified by:
getConstructedOntologyStructures in interface OntologyRepositoryService
Returns:
list containing SerializableOntModelImpl objects
Throws:
DirectoryFailure

removeConstructedOntologyStructure

public void removeConstructedOntologyStructure(java.lang.String structureId)
                                        throws DirectoryFailure
Description copied from interface: OntologyService
This method removes a user defined ontology structure identified by the id from the repository.

Specified by:
removeConstructedOntologyStructure in interface OntologyService
Throws:
DirectoryFailure

removeConstructedOntologyStructures

public void removeConstructedOntologyStructures(java.util.List<java.lang.String> structureIds)
                                         throws DirectoryFailure
Description copied from interface: OntologyService
This method removes multiple user defined ontology structure identified by the id from the repository.

Specified by:
removeConstructedOntologyStructures in interface OntologyService
Throws:
DirectoryFailure

getDomainDescription

public DomainDescription getDomainDescription(java.lang.String domainName)
                                       throws DirectoryFailure
Description copied from interface: DomainDirectoryService
Get the description of a domain

Specified by:
getDomainDescription in interface DomainDirectoryService
Parameters:
domainName - the name of the domain
Throws:
DirectoryFailure

getIndividualActors

public java.util.Set getIndividualActors(java.lang.String baseActorClass)
                                  throws UnknownConceptException,
                                         DirectoryFailure
Description copied from interface: QueryKAoSOntologyService
Get names of the individual Actors known to the ontology repository being an instance of the specified base class.

Specified by:
getIndividualActors in interface QueryKAoSOntologyService
Parameters:
baseActorClass - The name of the Actor class which the return elements have to be an instance of If the name is empty uses Actor as a base class
Returns:
Set of names of individual Actors
Throws:
UnknownConceptException - if baseActorClass is unknown for the ontology repository
DirectoryFailure

getIndividualGroups

public java.util.Set getIndividualGroups(java.lang.String baseGroupClass)
                                  throws UnknownConceptException,
                                         DirectoryFailure
Description copied from interface: QueryKAoSOntologyService
Get names of the individual Groups known to the ontology repository being an instance of the specified base class.

Specified by:
getIndividualGroups in interface QueryKAoSOntologyService
Parameters:
baseGroupClass - The name of the Group class which the return elements have to be an instance of If the name is empty uses Group as a base class
Returns:
Set of names of individual Groups
Throws:
UnknownConceptException - if baseGroupClass is unknown for the ontology repository
DirectoryFailure

getIndividualPlaces

public java.util.Set getIndividualPlaces(java.lang.String basePlaceClass)
                                  throws UnknownConceptException,
                                         DirectoryFailure
Description copied from interface: QueryKAoSOntologyService
Get names of the individual Places known to the ontology repository being an instance of the specified base class.

Specified by:
getIndividualPlaces in interface QueryKAoSOntologyService
Parameters:
basePlaceClass - The name of the Place class which the return elements have to be an instance of If the name is empty uses Place as a base class
Returns:
Set of names of individual Places
Throws:
UnknownConceptException - if basePlaceClass is unknown for the ontology repository
DirectoryFailure

getIndividualTargets

public java.util.Set getIndividualTargets(java.lang.String baseTargetClass)
                                   throws UnknownConceptException,
                                          DirectoryFailure
Description copied from interface: QueryKAoSOntologyService
Get names of the individual targets (Actors or Entities) known to the ontology repository being an instance of the specified base class.

Specified by:
getIndividualTargets in interface QueryKAoSOntologyService
Parameters:
baseTargetClass - The name of the targets (Actor or Entity) class which the return classes have to be a subclass of
Returns:
Set of names of individual targets (Actors or Entities)
Throws:
UnknownConceptException - if baseTargetClass is unknown for the ontology repository
DirectoryFailure

getInstancesOf

public java.util.Set getInstancesOf(java.lang.String conceptName)
                             throws UnknownConceptException,
                                    DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get set of instances of the given concept; if the concept is an instance itself the set contains just this instance.

Specified by:
getInstancesOf in interface OntologyService
Specified by:
getInstancesOf in interface OntologyRepositoryService
Parameters:
conceptName - The name of the concept in the Jena format
Returns:
Set of instance ids in the Jena format
Throws:
UnknownConceptException - if conceptName is unknown for the ontology repository
DirectoryFailure

getOntologyDefinitionForConcept

public java.util.Set getOntologyDefinitionForConcept(java.lang.String conceptName)
                                              throws DirectoryFailure
Description copied from interface: OntologyService
Get set of urls for the given short concept name. Currently it tries to match the concept name with the local name of the ontology definitions url

Specified by:
getOntologyDefinitionForConcept in interface OntologyService
Parameters:
conceptName - A short name of concept, e.g. "Actor"
Returns:
Set of url containing the short concept name
Throws:
DirectoryFailure

getPolicies

public java.util.List getPolicies()
                           throws DirectoryFailure
Specified by:
getPolicies in interface PolicyManagement
Throws:
DirectoryFailure

getDirectPoliciesFor

public java.util.Vector getDirectPoliciesFor(java.lang.String entityId)
                                      throws DirectoryFailure
Specified by:
getDirectPoliciesFor in interface PolicyManagement
Throws:
DirectoryFailure

getPolicy

public PolicyMsg getPolicy(java.lang.String policyId)
                    throws DirectoryFailure
Specified by:
getPolicy in interface PolicyManagement
Throws:
DirectoryFailure

getRangeOnPropertyForClass

public java.lang.String getRangeOnPropertyForClass(java.lang.String className,
                                                   java.lang.String propertyName)
                                            throws UnknownConceptException,
                                                   QueryFailure,
                                                   DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get the name of the class defining the range of the specified property for the given class.

Specified by:
getRangeOnPropertyForClass in interface OntologyService
Specified by:
getRangeOnPropertyForClass in interface OntologyRepositoryService
Parameters:
className - the name of the class
propertyName - the name of the property
Returns:
the name of the class defining the range
Throws:
UnknownConceptException - if reasoning failed.
QueryFailure
DirectoryFailure

getSchema

public java.util.List<java.lang.String> getSchema(java.lang.String dataName)
                                           throws DirectoryFailure
Description copied from interface: OntologyService
Get XML schema of the given concept if such a schema is available

Specified by:
getSchema in interface OntologyService
Specified by:
getSchema in interface XMLRepository
Parameters:
dataName - uri name of the concept
Returns:
A List containing Strings that define the XML schema of the given concept. The reason it is a vector of strings and not just one string is that the definition can be complex, i.e. derived from multiple more primitive schemas, hence this vector contains definitions for all those schemas too.
Throws:
DirectoryFailure

getSubClassesOf

public java.util.Set getSubClassesOf(java.lang.String className)
                              throws UnknownConceptException,
                                     DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get set of subclasses of the given class.

Specified by:
getSubClassesOf in interface OntologyService
Specified by:
getSubClassesOf in interface OntologyRepositoryService
Parameters:
className - The name of the class in Jena format
Returns:
Set of subclasses names in Jena format
Throws:
UnknownConceptException - if className is unknown for the ontology repository
DirectoryFailure

getImmediateSubClassesOf

public java.util.Set getImmediateSubClassesOf(java.lang.String className)
                                       throws UnknownConceptException,
                                              DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get set of immediate subclasses of the given class.

Specified by:
getImmediateSubClassesOf in interface OntologyService
Specified by:
getImmediateSubClassesOf in interface OntologyRepositoryService
Parameters:
className - The name of the class in Jena format
Returns:
Set of subclasses names in Jena format
Throws:
UnknownConceptException - if className is unknown for the ontology repository
DirectoryFailure

getSubPropertiesOf

public java.util.Set getSubPropertiesOf(java.lang.String propertyName)
                                 throws UnknownConceptException,
                                        DirectoryFailure
Description copied from interface: OntologyService
Get set of subproperties of the given property.

Specified by:
getSubPropertiesOf in interface OntologyService
Parameters:
propertyName - The name of the property
Returns:
Set of subproperties names
Throws:
UnknownConceptException
DirectoryFailure

getSubdomains

public java.util.Vector getSubdomains(java.lang.String domainName)
                               throws DirectoryFailure
Description copied from interface: DomainDirectoryService
Obtain a Vector of the names of subdomains of a particular domain (returns immediate children only)

Specified by:
getSubdomains in interface DomainDirectoryService
Returns:
Vector of Strings of the names of domains
Throws:
DirectoryFailure

getSuperClassesOf

public java.util.Set getSuperClassesOf(java.lang.String className)
                                throws UnknownConceptException,
                                       DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get set of superclasses of the given class.

Specified by:
getSuperClassesOf in interface OntologyRepositoryService
Parameters:
className - The name of the class in the Jena format
Returns:
Set of superclasses names in the Jena format
Throws:
UnknownConceptException - if className is unknown for the ontology repository
DirectoryFailure

getSuperPropertiesOf

public java.util.Set getSuperPropertiesOf(java.lang.String propertyName)
                                   throws UnknownConceptException,
                                          DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get set of superproperties of the given property.

Specified by:
getSuperPropertiesOf in interface OntologyService
Specified by:
getSuperPropertiesOf in interface OntologyRepositoryService
Parameters:
propertyName - The name of the property in Jena format
Returns:
Set of superproperties names in Jena format
Throws:
UnknownConceptException
DirectoryFailure

initiateActionClassTargets

public java.util.Vector initiateActionClassTargets(java.lang.String actionClassName,
                                                   java.lang.String actorClassName)
                                            throws DirectoryFailure
Description copied from interface: OntologyService
Get properties applicable to the action class

Specified by:
initiateActionClassTargets in interface OntologyService
Parameters:
actionClassName - the name of the action class performing
actorClassName - the name of the actor class performing the action
Returns:
vector of TargetClassDescription
Throws:
DirectoryFailure

getUniqueValueForProperty

public java.lang.String getUniqueValueForProperty(java.lang.String property,
                                                  java.lang.String subject)
                                           throws QueryFailure,
                                                  DirectoryFailure
Description copied from interface: OntologyRepositoryService
Get a single value of the variable satisfying the KIF query: (property subject ?val).

Specified by:
getUniqueValueForProperty in interface OntologyRepositoryService
Parameters:
property - the name of the property in the Jena format
subject - the name of the subject in the Jena format
Returns:
a single value (as string in the Jena format) for the property on this subject
Throws:
QueryFailure - if reasoning failed.
DirectoryFailure

getUltimateOntologyTypesOfIndividual

public java.util.Set getUltimateOntologyTypesOfIndividual(java.lang.String individualName)
                                                   throws DirectoryFailure,
                                                          UnknownConceptException
Description copied from interface: OntologyRepositoryService
Finds the ultimate Ontology type of the provided individual

Specified by:
getUltimateOntologyTypesOfIndividual in interface OntologyService
Specified by:
getUltimateOntologyTypesOfIndividual in interface OntologyRepositoryService
Parameters:
individualName - the name of the individual
Returns:
the set of names of the Ontology classes being the most narrow ones for the given individual
Throws:
DirectoryFailure
UnknownConceptException - if concept unknown or any problem with JTP approached

loadOntology

public void loadOntology(SerializableOntModelImpl myDAMLModel,
                         boolean recursiveLoad)
                  throws OntologyRepository.ReasoningException,
                         java.io.IOException
Description copied from interface: OntologyRepositoryService
Adds ontology included in the provide objects into the ontology repository.

Specified by:
loadOntology in interface OntologyService
Specified by:
loadOntology in interface OntologyRepositoryService
Parameters:
myDAMLModel - The object of type SerializableOntModelImpl containing the added ontology
recursiveLoad - Indicates if the imported ontologies (by the ontology contained in myOntModel) should also be recursively loaded.
Throws:
OntologyRepository.ReasoningException
java.io.IOException

loadOntologies

public void loadOntologies(java.util.List<SerializableOntModelImpl> myDAMLModels,
                           boolean recursiveLoad)
                    throws OntologyRepository.ReasoningException,
                           java.io.IOException
Description copied from interface: OntologyRepositoryService
Adds ontology included in the provide objects into the ontology repository.

Specified by:
loadOntologies in interface OntologyService
Specified by:
loadOntologies in interface OntologyRepositoryService
recursiveLoad - Indicates if the imported ontologies (by the ontology contained in myOntModel) should also be recursively loaded.
Throws:
OntologyRepository.ReasoningException
java.io.IOException

loadOntology

public void loadOntology(java.lang.String myURL,
                         boolean recursiveLoad)
                  throws OntologyRepository.ReasoningException,
                         java.io.IOException,
                         DirectoryFailure
Description copied from interface: OntologyRepositoryService
Loads ontology from the provided url.

Specified by:
loadOntology in interface OntologyService
Specified by:
loadOntology in interface OntologyRepositoryService
Parameters:
myURL - The url to the ontology
recursiveLoad - Indicates if the imported ontologies (by the ontology depicted by myURL) should also be recursively loaded.
Throws:
OntologyRepository.ReasoningException - when loading of the ontology failed.
java.io.IOException
DirectoryFailure

loadOntology

public void loadOntology(java.lang.String loadedOWL)
                  throws OntologyRepository.ReasoningException,
                         DirectoryFailure
Description copied from interface: OntologyService
Loads ontology in OWL into the repository of the Ontology Service

Specified by:
loadOntology in interface OntologyService
Parameters:
loadedOWL - string containing a syntactically correctly OWL
Throws:
OntologyRepository.ReasoningException - when loading of the ontology failed.
DirectoryFailure

search

public AgentDescription[] search(AgentDescription desc,
                                 int maxResults)
                          throws SearchException,
                                 DirectoryFailure
Throws:
SearchException
DirectoryFailure

testTrue

public boolean testTrue(java.lang.String statement)
                 throws QueryFailure,
                        DirectoryFailure
Description copied from interface: OntologyRepositoryService
Test if the KIF statemant is true according to the ontologies in the ontology repository.

Specified by:
testTrue in interface OntologyService
Specified by:
testTrue in interface OntologyRepositoryService
Parameters:
statement - to test
Returns:
true if the statement is true and false in the opposite case
Throws:
QueryFailure - if reasoning failed.
DirectoryFailure

updatePolicies

public void updatePolicies(java.util.List<PolicyMsg> addedPolicies,
                           java.util.List<PolicyMsg> changedPolicies,
                           java.util.List<PolicyMsg> removedPolicies)
                    throws PolicyManagement.OntologyPolicyIncorrect,
                           PoliciesHarmonizedException,
                           PolicyManagement.PrecedenceUndeterminedException,
                           DirectoryFailure
Specified by:
updatePolicies in interface PolicyManagement
Throws:
PolicyManagement.OntologyPolicyIncorrect
PoliciesHarmonizedException
PolicyManagement.PrecedenceUndeterminedException
DirectoryFailure

addAuthenticationObject

public void addAuthenticationObject(KAoSAuthenticationObject kao)
                             throws DirectoryFailure
Description copied from interface: AuthenticationInterface
Allows to add an authentication object to the Directory Service database.

Specified by:
addAuthenticationObject in interface AuthenticationInterface
Parameters:
kao - the authentication object
Throws:
DirectoryFailure

editAuthenticationObject

public void editAuthenticationObject(KAoSAuthenticationObject kao)
                              throws DirectoryFailure
Description copied from interface: AuthenticationInterface
Allows to edit an authentication object at the Directory Service database.

Specified by:
editAuthenticationObject in interface AuthenticationInterface
Parameters:
kao - the authentication object
Throws:
DirectoryFailure

removeAuthenticationObject

public void removeAuthenticationObject(KAoSAuthenticationObject kao)
                                throws DirectoryFailure
Description copied from interface: AuthenticationInterface
Allows to remove an authentication object from the Directory Service database.

Specified by:
removeAuthenticationObject in interface AuthenticationInterface
Parameters:
kao - the authentication object
Throws:
DirectoryFailure

isUsernameRegistered

public boolean isUsernameRegistered(java.lang.String userid,
                                    java.lang.String password)
                             throws DirectoryFailure
Description copied from interface: AuthenticationInterface
Checks if the username is in the Directory Service database.

Specified by:
isUsernameRegistered in interface AuthenticationInterface
Parameters:
userid - the user name
password - the user password
Throws:
DirectoryFailure

getAllAuthenticationObjects

public java.util.Hashtable getAllAuthenticationObjects()
                                                throws DirectoryFailure
Description copied from interface: AuthenticationInterface
Allows to get all the authentication objects from the Directory Service database.

Specified by:
getAllAuthenticationObjects in interface AuthenticationInterface
Throws:
DirectoryFailure

addDefinedPolicyTemplate

public void addDefinedPolicyTemplate(PolicyTemplate definedTemplate)
                              throws DirectoryFailure
Specified by:
addDefinedPolicyTemplate in interface DefinedPolicyTemplateInterface
Throws:
DirectoryFailure

editDefinedPolicyTemplate

public void editDefinedPolicyTemplate(PolicyTemplate definedTemplate)
                               throws DirectoryFailure
Specified by:
editDefinedPolicyTemplate in interface DefinedPolicyTemplateInterface
Throws:
DirectoryFailure

removeDefinedPolicyTemplate

public void removeDefinedPolicyTemplate(PolicyTemplate definedTemplate)
                                 throws DirectoryFailure
Specified by:
removeDefinedPolicyTemplate in interface DefinedPolicyTemplateInterface
Throws:
DirectoryFailure

getAllDefinedPolicyTemplate

public java.util.Map<java.lang.String,PolicyTemplate> getAllDefinedPolicyTemplate()
                                                                           throws DirectoryFailure
Specified by:
getAllDefinedPolicyTemplate in interface DefinedPolicyTemplateInterface
Throws:
DirectoryFailure

createMessageToSend

protected MethodCallRequestMsg createMessageToSend(AgentDescription adesc,
                                                   java.lang.String requestedOperation,
                                                   int parameterValue)
Return an instance of the MethodCallRequestMsg specifying the requested Directory operation and the AgentDescription argument.


checkSearchResult

protected AgentDescription[] checkSearchResult(MethodCallResultMsg result)
                                        throws SearchException,
                                               DirectoryFailure
The Exception may be one of the following: SearchException DirectoryFailure IllegalArgumentexception

Throws:
SearchException
DirectoryFailure

checkRegisterResult

protected void checkRegisterResult(MethodCallResultMsg result,
                                   AgentDescription desc)
                            throws AlreadyRegisteredException,
                                   DirectoryFailure
Throws:
AlreadyRegisteredException
DirectoryFailure

checkDeregisterResult

protected void checkDeregisterResult(MethodCallResultMsg result,
                                     AgentDescription desc)
                              throws NotRegisteredException,
                                     DirectoryFailure
DirectoryFailure - as a result of registration, deregistration or modify request NotRegisteredException - as a result of deregistration or modify request IllegalArgumentexception - as a result of registration, deregistration or modify request

Throws:
NotRegisteredException
DirectoryFailure

checkModifyResult

protected void checkModifyResult(MethodCallResultMsg result)
                          throws NotRegisteredException,
                                 DirectoryFailure
NotRegisteredException - as a result of deregistration or modify request IllegalArgumentexception - as a result of registration, deregistration or modify request

Throws:
NotRegisteredException
DirectoryFailure

invokeMethod

protected java.lang.Object invokeMethod(java.lang.String methodName,
                                        java.util.Vector args)
                                 throws java.lang.Exception
Throws:
java.lang.Exception

init

public void init(MsgSender msgSender)
Overrides:
init in class MethodCallProxy

addEventListener

public void addEventListener(DirectoryEventListener listener)
                      throws DirectoryFailure
Specified by:
addEventListener in interface DirectoryEventNotifier
Throws:
DirectoryFailure

addRemoteEventListener

public void addRemoteEventListener(Locator l)
                            throws DirectoryFailure
Specified by:
addRemoteEventListener in interface DirectoryEventNotifier
Throws:
DirectoryFailure

removeEventListener

public void removeEventListener(DirectoryEventListener listener)
                         throws DirectoryFailure
Specified by:
removeEventListener in interface DirectoryEventNotifier
Throws:
DirectoryFailure

removeRemoteEventListener

public void removeRemoteEventListener(Locator l)
                               throws DirectoryFailure
Specified by:
removeRemoteEventListener in interface DirectoryEventNotifier
Throws:
DirectoryFailure