• Home
• com.arm.mbed.cloud.sdk
• mbed-cloud-sdk
• 2.2.1
• source code
• AbstractApi.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

com.arm.mbed.cloud.sdk.common.AbstractApi Maven / Gradle / Ivy

package com.arm.mbed.cloud.sdk.common;

import java.util.Map;

import com.arm.mbed.cloud.sdk.annotations.API;
import com.arm.mbed.cloud.sdk.annotations.Internal;
import com.arm.mbed.cloud.sdk.annotations.Preamble;

@Preamble(description = "Generic SDK module definition")
@Internal
public abstract class AbstractApi {

    protected final ApiClientWrapper client;
    protected final ServiceStore serviceStore;

    protected final SdkLogger logger;
    protected final ApiMetadataCache metadataCache;

    /**
     * Constructor.
     *
     * @param options
     *            connection options @see {@link ConnectionOptions}
     */
    public AbstractApi(ConnectionOptions options) {
        this(options, null);
    }

    /**
     * Constructor.
     *
     * @param options
     *            connection options @see {@link ConnectionOptions}
     * @param userAgentExtension
     *            extension list for the user agent: module name - module version
     */
    public AbstractApi(ConnectionOptions options, Map userAgentExtension) {
        super();
        this.client = new ApiClientWrapper(options, userAgentExtension);
        serviceStore = new ServiceStore(client);
        logger = new SdkLogger();
        metadataCache = new ApiMetadataCache();
    }

    public void checkNotNull(Object arg, String argName) throws MbedCloudException {
        clearApiMetadata();
        ApiUtils.checkNotNull(logger, arg, argName);
    }

    public void checkModelValidity(SdkModel model, String argName) throws MbedCloudException {
        clearApiMetadata();
        ApiUtils.checkModelValidity(logger, model, argName);
    }

    /**
     * Gets SDK logger.
     *
     * @see SdkLogger
     * @return the logger.
     */
    public SdkLogger getLogger() {
        return logger;
    }

    /**
     * Gets meta data for the last Arm Mbed Cloud API call.
     *
     * @see ApiMetadata
     * @return metadata
     */
    @API
    public ApiMetadata getLastApiMetadata() {
        return metadataCache.getLastApiMetadata();
    }

    /**
     * Clears API metadata cache.
     * 

     * This is for internal purposes only.
     */
    @Internal
    public void clearApiMetadata() {
        metadataCache.clearMetadata();
    }

    /**
     *
     * Gets a service.
     *
     * @param serviceClass
     *            class of the service.
     * @param 
     *            service type
     * @return corresponding service.
     * @throws MbedCloudException
     *             if a problem occurred during the process.
     */
    public  S getService(Class serviceClass) throws MbedCloudException {
        return serviceStore.getService(serviceClass);
    }

    /**
     * Gets the SDK module name.
     *
     * @return module name.
     */
    public abstract String getModuleName();

}