https://github.com/ktrader-tech/jctp
CTP 的 Java 封装
https://github.com/ktrader-tech/jctp
ctp futures java linux maven-central quant swig
Last synced: 26 days ago
JSON representation
CTP 的 Java 封装
- Host: GitHub
- URL: https://github.com/ktrader-tech/jctp
- Owner: ktrader-tech
- License: apache-2.0
- Created: 2020-08-09T06:39:41.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-12-18T14:13:33.000Z (about 1 year ago)
- Last Synced: 2025-06-13T11:55:46.597Z (8 months ago)
- Topics: ctp, futures, java, linux, maven-central, quant, swig
- Language: C
- Homepage:
- Size: 20.4 MB
- Stars: 36
- Watchers: 7
- Forks: 18
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# JCTP
[](https://search.maven.org/search?q=g:%22org.rationalityfrontline%22%20AND%20a:%22jctp%22)
[](https://github.com/ktrader-tech/jctp/blob/master/LICENSE)
基于 [SWIG](http://www.swig.org/) 实现的对[上期技术](http://www.sfit.com.cn/) CTP 的封装。支持 64 位的 Windows 及 Linux 操作系统，动态链接库已被包含至 jar 包内，并在类加载时自动 loadLibrary，只需添加 jar 包即可直接使用。
> 如果你试图直接基于 CTP 开发交易策略程序，那么相比于繁琐、异步且充满各种坑的 CTP 原生接口，经过良好封装的 [KTrader-Broker-CTP](https://github.com/ktrader-tech/ktrader-broker-ctp) 会是一个更好的选择
[当前已封装的 CTP 版本](https://search.maven.org/artifact/org.rationalityfrontline/jctp) ：
```
6.7.8-1.0.5
6.7.8_CP-1.0.5
6.7.2-1.0.5
6.7.2_CP-1.0.5
6.6.9-1.0.5
6.6.9_CP-1.0.5
6.6.1_P1-1.0.5
6.6.1_P1_CP-1.0.5
6.3.19_P1-1.0.5
6.3.19_T1-1.0.5
```
## Usage
API 及使用方法同上期技术官方提供的 C++ 版 CTP SDK，另外使用前可以通过以下方法判断动态链接库是否已被成功加载：
```kotlin
import org.rationalityfrontline.jctp.*
fun main() {
if (jctpJNI.libraryLoaded()) {
// do something with CTP, here we print its sdk version
println(CThostFtdcTraderApi.GetApiVersion())
// release native gc root in jni, jctp will be unavailable after doing this
jctpJNI.release()
} else {
System.err.println("Library load failed!")
}
}
```
如果在 Linux 环境下使用，则需要确保已安装 zh_CN.GB18030 字符集：
```
sudo locale-gen zh_CN.GB18030
```
否则会报以下异常：
```text
locale::facet::_S_create_c_locale name not valid
```
## Download
**Gradle Kotlin DSL:**
```kotlin
repositories {
mavenCentral()
}
dependencies {
implementation("org.rationalityfrontline:jctp:6.7.8-1.0.5")
}
```
**Maven:**
```xml
org.rationalityfrontline
jctp
6.7.8-1.0.5
```
**Jar:**
[Maven Repository](https://repo1.maven.org/maven2/org/rationalityfrontline/jctp/)
使用 Jar 包前请先添加 [native-lib-loader](https://github.com/scijava/native-lib-loader) 依赖：
```kotlin
dependencies {
implementation("org.scijava:native-lib-loader:2.5.0")
}
```
## Build
**前提要求（版本信息仅供参考，非必要）：**
1. 安装 [SWIG](http://www.swig.org/download.html) 4.0.2 并将其添加至环境变量中
2. 安装 [CMake](https://cmake.org/download/) > 3.16 并将其添加至环境变量中
3. 安装 C++ 编译器（ Windows 下是 [msvc](https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/)，Linux 下是 [gcc/g++](https://gcc.gnu.org/)）
4. 安装 JDK 11 或以上的版本，并将其添加至环境变量中
**Windows**
```powershell
build.cmd
```
**Linux**
```bash
./build.sh
```
以上为单平台版本编译，如需编译跨平台版本，则需要在两个平台下各编译一次（顺序随意）。
build 完毕后，生成的 jar 包在 java/build/libs 目录下。
## Reference
https://blog.csdn.net/pjjing/article/details/53186394
http://www.swig.org/Doc4.0/Contents.html#Contents
https://github.com/scijava/native-lib-loader
## License
JCTP is released under the [Apache 2.0 license](https://github.com/ktrader-tech/jctp/blob/master/LICENSE).
```
Copyright 2020-2024 RationalityFrontline
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```