海纳嗨数-帮助中心
SDK配置
帮助中心 > 技术文档 > 服务端SDK > Java SDK > SDK配置
Java SDK接入流程主要分为两个步骤(两个文档):
1、SDK配置:将对应的SDK集成到您的产品项目中,然后进行初始化代码处理;
2、SDK接入:将需要上报的业务数据,按照SDK中对应的的方法进行数据上送。
注意:
- 目前支持离线包集成,和maven,Gradle集成
- 目前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
最后编辑:涂泽 更新时间:2024-11-22 16:31