com.hds.hcpaw.fss.api

Interface ApiVersionedAction<T>

public interface ApiVersionedAction<T>

This interface along with the static run(AnywhereConnector, ApiVersionedAction) method are used to perform - and possibly retry - an action that supports multiple FssApiVersions.

Method Summary

Modifier and Type	Method and Description
static <T> T	run(AnywhereConnector conn, ApiVersionedAction<T> action) Performs the specified action with the specified AnywhereConnector's current API version.
T	run(FssApiVersion apiVersion) Perform the action, using the specified apiVersion.

Method Detail

run

T run(FssApiVersion apiVersion)
throws java.io.IOException,
      AnywhereException

Perform the action, using the specified apiVersion.

Parameters:

apiVersion - the FssApiVersion that should be used when executing the command

Returns:

the result of the action

Throws:

java.io.IOException

AnywhereException

run

static <T> T run(AnywhereConnector conn,
                 ApiVersionedAction<T> action)
          throws AwUnsupportedApiVersionException,
                 java.io.IOException,
                 AnywhereException

Performs the specified action with the specified AnywhereConnector's current API version. If that fails due to an AwUnsupportedApiVersionException, then if possible, it retries the action with the new (but different) AnywhereConnector's current API version.

Parameters:

conn - the AnywhereConnector that will be used by the action, and that holds the FssApiVersion to use

action - the action to perform. This action should use the specified AnywhereConnector.

Returns:

the result of calling run(com.hds.hcpaw.fss.api.version.FssApiVersion) on the specified action. If the action initially throws an AwUnsupportedApiVersionException and the action is retried, then the result of the second call to run(com.hds.hcpaw.fss.api.version.FssApiVersion) is returned. If the action cannot be retried or any other exception is thrown from the initial call to run(com.hds.hcpaw.fss.api.version.FssApiVersion), then the initial exception is thrown. If the action is retried, then any exception thrown from that call is thrown.

Throws:

AwUnsupportedApiVersionException

java.io.IOException

AnywhereException

See Also:

AnywhereConnector.getLatestCommonApiVersion()