net.handle.api
Interface HSAdapter

public interface HSAdapter

Method Summary

void	addHandleValues(java.lang.String handle, HandleValue[] values) Adds new handle records.
HandleValue	createAdminValue(java.lang.String adminHandle, int keyIndex, int index) Creates an administrative record with the adminHandle and adminIndex at the index.
void	createHandle(java.lang.String handle, HandleValue[] values) Creates a new handle.
HandleValue	createHandleValue(int index, java.lang.String type, java.lang.String data) Creates a new handle value.
void	deleteHandle(java.lang.String handle) Deletes an existing Handle from the handle system.
void	deleteHandleValues(java.lang.String handle, HandleValue[] values) Deletes a specific set of handle values in a Handle.
HandleValue[]	resolveHandle(java.lang.String handle, java.lang.String[] types, int[] indexes) Resolves a handle and returns a set of handle values that satisfy the type filter specified.
void	setUseUDP(boolean useUDP) Adds and prioritizes the UDP for communication with the Handle server.
void	updateHandleValues(java.lang.String handle, HandleValue[] values) Updates the specified data handle values.

Method Detail

addHandleValues

void addHandleValues(java.lang.String handle,
                     HandleValue[] values)
                     throws HandleException

Adds new handle records.
Note:

The administrative priveleges have to be valid for this method to perform without any exception

Parameters:

handle - The handle into which new values are to be added

values - The array of handle values to deposit

Throws:

HandleException

createAdminValue

HandleValue createAdminValue(java.lang.String adminHandle,
                             int keyIndex,
                             int index)
                             throws HandleException

Creates an administrative record with the adminHandle and adminIndex at the index. Note this does not get added to any handle. Also, the administrator has complete permissions. For the types of permissions, please refer to the Handle System Manual.

Parameters:

adminHandle - The admin handle for this handle value

keyIndex - The index of the public key in the admin Handle

index - Which index to put this information at.

Returns:

Throws:

HandleException

createHandle

void createHandle(java.lang.String handle,
                  HandleValue[] values)
                  throws HandleException

Creates a new handle. If the handle already exists, the method will throw an exception. The proper course of action is then to delete the handle and call the method again.

Parameters:

handle - The handle to create

values - An array of handle values to add to the handle. Note: Note:

It is important to add admin handle value in order to administer this handle at a later point.

The administrative priveleges have to be valid for this method to perform without any exception

Throws:

Describes - the error that occured in the process of creating the handle.

HandleException

createHandleValue

HandleValue createHandleValue(int index,
                              java.lang.String type,
                              java.lang.String data)
                              throws HandleException

Creates a new handle value. Note this does not get added to any handle. The default permissions are adminRead=true, adminWrite=true, publicRead=true, and publicWrite=false. Override the permissions once the HandleValue is created for enforcing different permissions.

Parameters:

index - Which index to put this information at.

type - The type of the handle value

data - The data for this handle value Otherwise not.

Throws:

HandleException

deleteHandle

void deleteHandle(java.lang.String handle)
                  throws HandleException

Deletes an existing Handle from the handle system.
Note:

The administrative priveleges have to be valid for this method to perform without any exception

Parameters:

handle - The handle to delete.

Throws:

HandleException

deleteHandleValues

void deleteHandleValues(java.lang.String handle,
                        HandleValue[] values)
                        throws HandleException

Deletes a specific set of handle values in a Handle.
Note:

The administrative priveleges have to be valid for this method to perform without any exception

Parameters:

handle - The Handle that we want to delete values from

values - An array of handle values to delete.

Throws:

Describes - the error that occured while executing the method.

HandleException

resolveHandle

HandleValue[] resolveHandle(java.lang.String handle,
                            java.lang.String[] types,
                            int[] indexes)
                            throws HandleException

Resolves a handle and returns a set of handle values that satisfy the type filter specified. If the resolution is to retrieve all handle values, specify null for both filter and indexes. If the administrative priveleges are applicable, the restricted values will also be returned. Also, the resolution request is not authoritative.

Parameters:

handle - The value of the handle to resolve

types - The types of the handle values that we are looking for.

Throws:

Describes - the error in resolution

HandleException

setUseUDP

void setUseUDP(boolean useUDP)

Adds and prioritizes the UDP for communication with the Handle server.

Parameters:

useUDP - The boolean flag that specifies the use of UDP.

updateHandleValues

void updateHandleValues(java.lang.String handle,
                        HandleValue[] values)
                        throws HandleException

Updates the specified data handle values.
Note:

Make sure that the index value is specified in the array of handle values or else this method will not work well.

The administrative priveleges have to be valid for this method to perform without any exception

Parameters:

handle -

values -

Throws:

HandleException