com.ibm.cloud.objectstorage.common

Class SdkCommon

java.lang.Object

com.ibm.cloud.objectstorage.common.SdkCommon

public class SdkCommon
extends java.lang.Object

The purpose of this class is to provide SDK-specific HTTP headers to be included in REST API requests made by the SDK.

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getProjectName() Returns the SDK project's name.
static java.util.Map<java.lang.String,java.lang.String>	getSdkHeaders(java.lang.String serviceName, java.lang.String serviceVersion, java.lang.String operationId) This function is invoked by generated service methods (i.e.
static java.lang.String	getVersion() Returns the SDK project's version.
protected static void	readBuildProperties()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getVersion

public static java.lang.String getVersion()

Returns the SDK project's version.

Returns:

a string containing the version (e.g. "1.2.3")

getProjectName

public static java.lang.String getProjectName()

Returns the SDK project's name.

Returns:

a string containing the name (e.g. "platform-services-java-sdk")

readBuildProperties

protected static void readBuildProperties()

getSdkHeaders

public static java.util.Map<java.lang.String,java.lang.String> getSdkHeaders(java.lang.String serviceName,
                                                                             java.lang.String serviceVersion,
                                                                             java.lang.String operationId)

This function is invoked by generated service methods (i.e. methods which implement the REST API operations defined within the API definition). The purpose of this function is to give the SDK implementor the opportunity to provide SDK-specific HTTP headers that will be sent with an outgoing REST API request.

This function is invoked for each invocation of a generated service method, so the set of HTTP headers could be request-specific. As an optimization, if your SDK will be returning the same set of HTTP headers for each invocation of this function, it is recommended that you initialize the returned map just once (perhaps by using lazy initialization) and simply return it each time the function is invoked, instead of building it each time as in the example below.

Parameters:

serviceName - the name of the service as defined in the API definition (e.g. "objectstorage")

serviceVersion - the version of the service as defined in the API definition (e.g. "V1")

operationId - the operationId as defined in the API definition (e.g. getContext)

Returns:

a Map which contains the set of headers to be included in the REST API request