# opengemini-client-java-2

**Repository Path**: gepengjun/opengemini-client-java-2

## Basic Information

- **Project Name**: opengemini-client-java-2
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-14
- **Last Updated**: 2024-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# opengemini-client-java

![License](https://img.shields.io/badge/开源许可证-Apache2.0-green) ![language](https://img.shields.io/badge/语言-Java-blue.svg) [![version](https://img.shields.io/github/v/tag/opengemini/opengemini-client-java?label=%e5%8f%91%e8%a1%8c%e7%89%88%e6%9c%ac&color=blue)](https://github.com/opengemini/opengemini-client-java/releases)

[English](README.md) | 简体中文  

`opengemini-client-java`是一个用 Python 语言编写的 OpenGemini 客户端

## 设计文档

[OpenGemini Client 设计文档](https://github.com/openGemini/openGemini.github.io/blob/main/src/zh/guide/develop/client_design.md)

## 关于 OpenGemini

OpenGemini 是一款云原生分布式时序数据库。获取更多信息，请点击[这里](https://github.com/openGemini/openGemini)

## 特点

- 本项目由多个组件独立实现，可根据不同的诉求单独引用
- 本项目与opengemini-client-go、opengemini-client-python等其他sdk实现，在API层的理念一致，对不同的使用者而言，使用体验非常相似

| 组件                              | 运行依赖最低OpenJDK版本 | 推荐场景                             | 说明                                                         |
| --------------------------------- | ----------------------- | ------------------------------------ | ------------------------------------------------------------ |
| opengemini-client-jdk             | OpenJDK 17              | 最小依赖场景                         | jdk原生的httpclient是在OpenJDK 9引入的，但由于OpenJDK 9等版本即将不再受支持，推荐升级到更高的OpenJDK 17版本 |
| opengemini-client-reactor         | OpenJDK 8(1.8)          | 响应式范式框架                       | 敬请期待                                                     |
| opengemini-client-okhttp          | OpenJDK 8(1.8)          | 业界最流行的okhttp组件，安卓场景首选 | 敬请期待                                                     |
| opengemini-client-asynchttpclient | OpenJDK 11              | 追求性能的异步编程框架场景           | 敬请期待                                                     |
| opengemini-client-kotlin/scala    | -                       | 对应开发语言的首选                   | 敬请期待                                                     |


## 要求

- 编译本项目至少需要OpenJDK 17
- 运行本项目时，各组件依赖的jdk版本不同，如上个章节表格中所示


## 用法

### 构建

使用常见的maven构建语法即可

```shell
mvn install -Dmaven.test.skip=true
```

若要使用```mvn test``` 请先本地运行一个opengemini的server，推荐使用官方容器镜像版本，如：

```
docker run -p 8086:8086 --name opengemini --rm opengeminidb/opengemini-server
```

### maven引用

```xml
<dependency>
    <groupId>io.opengemini</groupId>
    <artifactId>opengemini-client-jdk</artifactId>
    <version>${latest.version}</version>
</dependency>
```