All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class semper.download.RootVmfClass

java.lang.Object
   |
   +----semper.download.RootVmfClass

public class RootVmfClass
extends Object
implements Serializable
RootVmfClass module defines and implements all the necessary methods and data structure in order to keep a level of abstraction of the local stored VMFs and to speeds up the whole download procedure

Version:
$Revision: 1.3 $ $Date: 1998/05/28 15:09:51 $
Author:
Petros Pantis, Kostas Tzelepis

Constructor Index

 o RootVmfClass()
RootVmfClass object constructor, used to create a DCF if no VMF is presented in the local storage device
 o RootVmfClass(Vector[])
RootVmfClass object constructor, a list of certificate blocks are passed on initialisation time

Method Index

 o addClientNotification(String)
Adds the passed client identifier to the DCF.
 o addClientNotification(String, String, Vector)
Method used to insert a list of client identifiers in a specific DCF record
 o addClientNotification(String, Vector)
 o addGlobalClientNotification(Vector)
Adds a list of client identifiers in the global notification list
 o compareDCF(RootVmfClass)
Compares the local DCF structure with a new one
 o getCertIds(String)
Returns all the certificate block identifier contained in the same path
 o getChangedCertificateIds(VmfClass)
Creates a list of changes between the passed VMF and the local stored certificate blocks
 o getDiffs(Vector)
Returns a list of differences between the local and the remote obtained certificate blocks
 o getId()
Returns a unique identifier, that identify a client or server
 o getNews(Vector)
Compares a list of news with the information stored in the DCF structure
 o getPaths()
Returns all the paths that are registered in the DCF
 o getUnnotifiedNames(String)
Returns a list of all unnotified certificate blocks
 o getUnuploadedNews(Vector, String, InetAddress)
Retrieves all the DCF records which haven't been uploaded to the news server
 o insertNewVmfIds(String, String, long)
Creates a new DCF record
 o insertNewVmfIds(VmfClass)
Inserts new DCF records regarding to the certificate block(s) contained in the passed VMF
 o invalidateAll(Vector)
Method used to invalidate all the records contained in the passed list
 o printSelf()
Method for debugging reasons
 o retrieveVersion(String, String)
Retrieve the version number for a specific certificate block
 o sanityCheck(Vector[], String)
Checks the contents of the stored DCF with these stored in the local VMFs
 o setUploadedNews(Vector, String, InetAddress)
Registers the uploaded news in the DCF structure
 o update(VmfClass)
Updates the DCF contents regarding the contents contained in the passed VMF
 o update(VmfClass[])
Updates the DCF contents regarding the contents contained in the passed VMF list
 o updateId(String)
Method used to update the local stored identifier

Constructors

 o RootVmfClass
 public RootVmfClass()
RootVmfClass object constructor, used to create a DCF if no VMF is presented in the local storage device

 o RootVmfClass
 public RootVmfClass(Vector certblocks[]) throws Exception
RootVmfClass object constructor, a list of certificate blocks are passed on initialisation time

Parameters:
certblocks - a list of stored certificate blocks
Throws: Exception
when the passed Vector array is empty or null

Methods

 o sanityCheck
 public boolean sanityCheck(Vector certblocks[],
                            String path)
Checks the contents of the stored DCF with these stored in the local VMFs

Parameters:
certblocks - the local stored certificate blocks
path - the working directory for the download module
Returns:
value true, on success
 o retrieveVersion
 public long retrieveVersion(String dirname,
                             String id)
Retrieve the version number for a specific certificate block

Parameters:
dirname - the package directory name
id - the certificate block identifier
Returns:
value the requested version number
 o update
 public boolean update(VmfClass vmf)
Updates the DCF contents regarding the contents contained in the passed VMF

Parameters:
vmf - the vmf structure
Returns:
value true, if the updating has been completed
 o update
 public boolean update(VmfClass vmfclasses[])
Updates the DCF contents regarding the contents contained in the passed VMF list

Parameters:
vmf - the vmf list
Returns:
value true, if the updating has been completed
 o addClientNotification
 public void addClientNotification(String clientId,
                                   Vector certIds)
 o addClientNotification
 public void addClientNotification(String clientId)
Adds the passed client identifier to the DCF. This meens that the client has the same package versions as the stored ones

Parameters:
clientId - the unique client identifier
 o getUnnotifiedNames
 public Vector getUnnotifiedNames(String clientId)
Returns a list of all unnotified certificate blocks

Parameters:
clientId - the client identifier
Returns:
value the list of unnotified certificate blocks
 o getDiffs
 public Vector getDiffs(Vector rlist)
Returns a list of differences between the local and the remote obtained certificate blocks

Parameters:
rlist - the remote obtained certificate block list
Returns:
value the list of differences between local and the remote certificate blocks
 o insertNewVmfIds
 public boolean insertNewVmfIds(VmfClass vmf)
Inserts new DCF records regarding to the certificate block(s) contained in the passed VMF

Parameters:
vmf - the new/updated vmf
Returns:
value true, on success
 o insertNewVmfIds
 public boolean insertNewVmfIds(String dir,
                                String certid,
                                long ver)
Creates a new DCF record

Parameters:
dir - the package directory name
certid - the certificate block identifier
ver - the version number of the new certificate block
Returns:
value true, on success
 o getId
 public String getId()
Returns a unique identifier, that identify a client or server

Returns:
value a unique identifier
 o printSelf
 public void printSelf()
Method for debugging reasons

 o getChangedCertificateIds
 public Vector getChangedCertificateIds(VmfClass vmf)
Creates a list of changes between the passed VMF and the local stored certificate blocks

Parameters:
vmf - the VMF which should be compared with the DCF records
Returns:
value the list of new/updated certificate blocks identifiers
 o addClientNotification
 public void addClientNotification(String path,
                                   String certid,
                                   Vector clientIds)
Method used to insert a list of client identifiers in a specific DCF record

Parameters:
path - the directory name of the DCF record
certid - the certificate block identifier of the DCF record
clientIds - the list of client identifier which should be added to the notification list of the DCF record
 o addGlobalClientNotification
 public void addGlobalClientNotification(Vector clientIds)
Adds a list of client identifiers in the global notification list

Parameters:
clientIds - the client identifiers
 o updateId
 public void updateId(String newId)
Method used to update the local stored identifier

Parameters:
newId - the new identifier
 o compareDCF
 public boolean compareDCF(RootVmfClass newDCF)
Compares the local DCF structure with a new one

Returns:
value true on success
 o getPaths
 public Vector getPaths()
Returns all the paths that are registered in the DCF

Returns:
value the list of stored paths
 o getCertIds
 public Vector getCertIds(String path)
Returns all the certificate block identifier contained in the same path

Returns:
value the list of stored certificate block identifier
 o invalidateAll
 public void invalidateAll(Vector pathlist)
Method used to invalidate all the records contained in the passed list

Parameters:
pathlist - the list of directory names
 o getUnuploadedNews
 public Vector getUnuploadedNews(Vector pathlist,
                                 String certblockid,
                                 InetAddress hostId)
Retrieves all the DCF records which haven't been uploaded to the news server

Parameters:
pathlist - defines the path name in which the search should begin
certblockid - defines the certificate block identifier
hostId - the current host address
Returns:
the list of changes that bhaven't be uploaded to the news server
 o setUploadedNews
 public void setUploadedNews(Vector pathlist,
                             String certblockid,
                             InetAddress hostId)
Registers the uploaded news in the DCF structure

Parameters:
pathlist - the list of paths
certblockid - the certificate block identifier
hostId - the new local host address
 o getNews
 public Vector getNews(Vector news)
Compares a list of news with the information stored in the DCF structure

Parameters:
news - the list of new/updated certificate blocks sent previously from the news server
Returns:
value a list of changes between the local stored and the remote obtained certificate blocks

All Packages  Class Hierarchy  This Package  Previous  Next  Index