MindSphere SDK V2 for Java - 入门指南¶

env:
HOST_ENVIRONMENT:eu1

``` header tab="Service Modules"
com\siemens\mindsphere\{service_name}-sdk\{x.y}\{service_name}-sdk-{x.y}.jar
com\siemens\mindsphere\{service_name}-sdk\{x.y}\{service_name}-sdk-{x.y}-javadoc.jar
com\siemens\mindsphere\{service_name}-sdk\{x.y}\{service_name}-sdk-{x.y}.pom

 其中 `$PATH` 为：

 * 在 Mac 中：`~/.m2/repository`
 * 在 Windows 中：`C:\Users\{user_name}\.m2\repository`
 * 在 Linux 中：`/home/{user_name}/.m2/repository`

2. 注册仓库并在项目的构建配置文件中加入相关项。

    ``` header tab="Maven"
    <!-- Modify the following sections of the pom.xml file -->
    <!-- 1. Register the repository in the repositories section -->
    <repositories>
          <repository>
              <id>maven-repository</id>
              <url>file:///{absolute_path_of_the_repository_folder}</url>
          </repository>
      </repositories>

    <!-- 2. Add Core dependency in the dependencies section (optional) -->
    <dependency>
        <groupId>com.siemens.mindsphere</groupId>
        <artifactId>mindsphere-sdk-java-core</artifactId>
        <version>{x.y.z}</version>
    </dependency>

    <!-- 3. Add Service dependency in the dependencies section -->
    <dependency>
        <groupId>com.siemens.mindsphere</groupId>
        <artifactId>{service_name}-sdk</artifactId>
        <version>{x.y}</version>
    </dependency>
    ```

    ``` javascript tab="Gradle"
    // Modify the following sections of the build.gradle file
    // 1. Register the repository in the repositories section
    repositories {
            maven {
              url file('{Absolute_path_of_the_created_repository_folder}')
            }
            mavenLocal()
            mavenCentral()
    }

    // 2. Add Core dependency in the dependencies section (optional)
    compile 'com.siemens.mindsphere:mindsphere-sdk-java-core:{x.y.z}'

    // 3. Add Service dependency in the dependencies section
    compile 'com.siemens.mindsphere:{service_name}-sdk:{x.y}'
    ```

!!! note "说明" 
    所有 MindSphere 服务模块都对核心模块具有隐式相关性，因此添加核心模块相关项是可选操作。

## API 客户端和凭证配置

API 的最低级别构建块为 <a href="./javadocs-v2/html/com/siemens/mindsphere/sdk/core/RestClientConfig.html" target="_blank">`RestClientConfig`</a> 和 <a href="./javadocs-v2/html/com/siemens/mindsphere/sdk/core/MindsphereCredentials.html" target="_blank">`MindsphereCredentials`</a>。这些对象使用构建器模式进行实例化，并在客户端实例之间共享。

### 客户端配置

以下代码块显示了如何构建 <a href="./javadocs-v2/html/com/siemens/mindsphere/sdk/core/RestClientConfig.html" target="_blank">`RestClientConfig`</a> 对象的示例：

```java
RestClientConfig config = RestClientConfig.builder()
 .connectionTimeoutInSeconds(100)
 .proxyHost("host")
 .proxyPort(8080)
 .build();

@RequestMapping(method = RequestMethod.GET, value = "/{entity}/{propertySetName}")
public Timeseries getTimeSeriesAsObject(@PathVariable("entity") String entity,
    @PathVariable("propertySetName") String property_set_name,
    @RequestHeader("Authorization") String token) throws MindsphereException
{

    //Construct MindsphereCredentials object
    MindsphereCredentials credentials = MindsphereCredentials.userTokenBuilder()
                                            .authorization(token)
                                            .build();

    //Construct RestClientConfig object
    RestClientConfig config = RestClientConfig.builder()
                                  .connectionTimeoutInSeconds(100)
                                  .proxyHost("my.proxy.host")
                                  .proxyPort("1.2.3.4")
                                  .hostEnvironment("eu1")
                                  .build();

    //Construct TimeSeriesClient object
    TimeSeriesClient timeseries_client = TimeSeriesClient.builder()
                                            .mindsphereCredentials(credentials)
                                            .restClientConfig(config)
                                            .build();

    //Construct GetTimeseriesRequest object
    GetTimeseriesRequest request_object = new GetTimeseriesRequest();
    request_object.setEntity(entity);
    request_object.setPropertysetname(propertySetName);
    request_object.setFrom(<from_time>);
    request_object.setTo(<to_time>);

    List<TimeseriesData> timeseries_data_list = null;
    try {
        timeseries_data_list = timeseries_client.getTimeseries(request_object);
    } catch (MindsphereException e) {
        // Exception handling
    }

    return timeseries_data_list;
}