kaos.policy.guard
Interface GuardSynchronization

All Known Implementing Classes:

CorbaAgentDirectoryServiceProxy, CougaarAgentDirectoryServiceProxy, DirectoryServiceProxy, GridAgentDirectoryServiceProxy, GridDirectoryServicePolicyCert, KAoSAgentDirectoryServiceProxy, KAoSDirectoryService, TCPAgentDirectoryServiceProxy, TunnelClient

public interface GuardSynchronization

This interface defines a method implemented by KAoS Directory Service allowing for synchronization of guard databases anc caches. $Revision: 1.3 $

Method Summary

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.
boolean	isSynchronizationNeeded(java.lang.Long myLastUpdateTimeStamp) Check with DS if synchronization is needed by providing the timestamp of the last update.
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	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.

Method Detail

policiesSynchronizationRequest

void policiesSynchronizationRequest(java.util.List<java.lang.String> myCurrentPoliciesIds,
                                    java.util.List<java.lang.Long> myCurrentPoliciesTimeStamps)
                                    throws DirectoryFailure

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.

Parameters:

myCurrentPoliciesIds - The List of the current policies ids.

myCurrentPoliciesTimeStamps - The List of the current policies timestamps.

Throws:

DirectoryFailure

instancesSetSynchronizationRequest

void instancesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentInstancesClassesURL,
                                        java.util.List<java.lang.Long> myCurrentInstancesSetsTimeStamps)
                                        throws DirectoryFailure

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.

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

subclassesSetSynchronizationRequest

void subclassesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSubclassesClassesURL,
                                         java.util.List<java.lang.Long> myCurrentSubclassesSetsTimeStamps)
                                         throws DirectoryFailure

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.

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

superclassesSetSynchronizationRequest

void superclassesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSuperclassesClassesURL,
                                           java.util.List<java.lang.Long> myCurrentSuperclassesSetsTimeStamps)
                                           throws DirectoryFailure

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.

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

subpropertiesSetSynchronizationRequest

void subpropertiesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSubpropertiesPropertyURL,
                                            java.util.List<java.lang.Long> myCurrentSubpropertiesSetsTimeStamps)
                                            throws DirectoryFailure

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.

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

superpropertiesSetSynchronizationRequest

void superpropertiesSetSynchronizationRequest(java.util.List<java.lang.String> myCurrentSuperpropertiesPropertyURL,
                                              java.util.List<java.lang.Long> myCurrentSuperpropertiesSetsTimeStamps)
                                              throws DirectoryFailure

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.

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

isSynchronizationNeeded

boolean isSynchronizationNeeded(java.lang.Long myLastUpdateTimeStamp)
                                throws DirectoryFailure

Check with DS if synchronization is needed by providing the timestamp of the last update.

Parameters:

myLastUpdateTimeStamp - The timestamp of the last update

Throws:

DirectoryFailure