net.handle.api

Interface HSAdapter

public interface HSAdapter

Method Summary

Modifier and Type	Method and Description
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 server.
void	deleteHandleValues(java.lang.String handle, HandleValue[] values) Deletes a specific set of handle values in a Handle.
int	getTcpTimeout() Get how long to wait for responses to TCP and HTTP requests.
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.
HandleValue[]	resolveHandle(java.lang.String handle, java.lang.String[] types, int[] indexes, boolean auth) Resolves a handle and returns a set of handle values that satisfy the type filter specified.
void	setTcpTimeout(int newTcpTimeout) Set how long to wait for responses to TCP and HTTP requests.
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.net Technical 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:

A new HandleValue containing the admin value

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:

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

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 server.
Note:

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