帮助中心 > 技术文档 > 服务端SDK > Java SDK > SDK配置

Java SDK接入流程主要分为两个步骤(两个文档)

1、SDK配置:将对应的SDK集成到您的产品项目中,然后进行初始化代码处理;
2、SDK接入:将需要上报的业务数据,按照SDK中对应的的方法进行数据上送。


注意:

  1. 目前支持离线包集成,和maven,Gradle集成
  2. 目前Java SDK ( jar 格式) 大小约为 24KB

1. 配置依赖

1、下载SDK离线包(zip包),详见【资源下载】;

  • 请使用hina-java-sdk-6.1.0.jar

2、下载zip包并解压,使用maven命令安装在本地仓库,以HinaCloudSDK-6.1.0.jarr示例

mvn install:install-file \
    -Dfile=D:\HinaCloudSDK-6.1.0.jar \
    -DgroupId=com.hinadt.hicloud.java \
    -DartifactId=HinaCloudSDK \
    -Dversion=6.1.0 \
    -Dpackaging=jar

3、Maven项目中使用

<dependency>
    <groupId>com.hinadt.hicloud.java</groupId>
    <artifactId>HinaCloudSDK</artifactId>
    <version>6.1.0</version>
</dependency>

4、Gradle项目中使用

dependencies {
    implementation 'com.hinadt.hicloud.java:HinaCloudSDK:6.1.0'
}

2. 获取数据接收地址

如果使用cloud服务,数据接收地址如:

参考文档: 数据上报地址获取

3. 初始化

由于 SDK 初始化操作,会创建一个与之对应的内存缓存队列,所以请谨慎创建 SDK 实例对象,推荐在应用程序启动时全局初始化一次,然后进行全局调用。避免在方法内部进行初始化操作,程序运行过程中创建多个实例对象,导致 OOM 现象

3.1 在普通 Java 程序中初始化 SDK

// SERVER_URL需要在网站上获取
String SERVER_URL="数据接收地址";
HinaSdk hinaSdk = HinaSdk.initWithBatch(SERVER_URL, BATCH_NUM);

注意:
1、“数据接收地址”获取方式,请参考【采集上报地址获取
2、initWithNet方法参数,详见【SDK接入
3、BATCH_NUM 是一批上报的条数,一次最多上传200条

3.2 在Spring项目中初始化SDK

如果您的项目使用 Spring 框架,推荐将初始化操作装配成 Bean,交给 Spring 容器来管理。在使用的类中注入即可使用。


@Configuration
public class HinaConfig {

    private static final String SERVER_URL="数据接收地址";

    @Bean
    public HinaSdk init() throws IOException {
        HinaSdk hinaSdk = HinaSdk.initWithBatch(SERVER_URL, BATCH_NUM);
        return hinaSdk;
    }
}

注意:
1、采集上报地址URL获取方式,请参考【采集上报地址获取】;
2、initWithNet方法参数,详见【SDK接入

4. 参数解释

初始化方法

HinaSdk hinaSdk = HinaSdk.initWithBatch(SERVER_URL, BATCH_NUM,MAX_LENGTH);

参数解释

参数 默认值 说明
SERVER_URL String 数据接收地址
BATCH_NUM int 一批上报的条数,一次最多上传200条
MAX_LENGTH int 默认值1024,最大设置不能超过5120
作者:邓昊  创建时间:2023-02-26 22:57
最后编辑:涂泽  更新时间:2024-11-22 16:31