{"id":23404794,"url":"https://github.com/yop-platform/yop-java-sdk","last_synced_at":"2025-04-11T21:22:29.366Z","repository":{"id":38201703,"uuid":"312456945","full_name":"yop-platform/yop-java-sdk","owner":"yop-platform","description":"Yeepay openapi SDK for Java","archived":false,"fork":false,"pushed_at":"2025-03-20T06:51:54.000Z","size":2387,"stargazers_count":16,"open_issues_count":9,"forks_count":12,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2025-03-23T09:20:01.886Z","etag":null,"topics":["gradle","java","sdk","yop"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yop-platform.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-13T02:55:01.000Z","updated_at":"2025-02-19T03:36:10.000Z","dependencies_parsed_at":"2024-04-10T10:25:06.865Z","dependency_job_id":"b2d72625-8975-477f-becd-3e99159e2cef","html_url":"https://github.com/yop-platform/yop-java-sdk","commit_stats":null,"previous_names":[],"tags_count":73,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yop-platform%2Fyop-java-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yop-platform%2Fyop-java-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yop-platform%2Fyop-java-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yop-platform%2Fyop-java-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yop-platform","download_url":"https://codeload.github.com/yop-platform/yop-java-sdk/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248480747,"owners_count":21111001,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gradle","java","sdk","yop"],"created_at":"2024-12-22T13:15:45.875Z","updated_at":"2025-04-11T21:22:29.325Z","avatar_url":"https://github.com/yop-platform.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# yop-java-sdk\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fyop-platform%2Fyop-java-sdk.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fyop-platform%2Fyop-java-sdk?ref=badge_shield)\n\n## 项目结构\n\n本项目使用maven构建，各模块划分如下\n\n### 1. yop-java-sdk:jar\n\n商户可直接引入该包，改包等同于yop-java-sdk-apache，默认采用apache实现与易宝服务的http通信，内置加解密、签名验签等接口，方便商户对接加密机实现，具体请参考在线文档[基于SDK对接加密机](https://open.yeepay.com/docs/open/platform-doc/sdk_guide-sm/encryptor-support)\n\n### 2. yop-java-sdk-apache:jar\n\n同上。\n\n### 3. yop-java-sdk-okhttp:jar\n\n该模块提供okhttp实现与易宝服务的http通信，商户可以根据需要进行选择\n\n### 4. yop-java-sdk-base:jar\n\n该模块提供YopRequest等参数封装、YopRequestConfig请求配置等非加解密相关类，将组装报文，拆解报文等逻辑进行抽象，并提供一些基础工具类，方便商户扩展凭证存储加载器、加密器、签名器等基础接口\n\n### 5. yop-java-sdk-crypto-api:jar\n\n该模块定义了加密器、签名器等基础接口\n\n### 6. yop-java-sdk-crypto-gm-base:jar\n\n该模块提供了国密相关的基础工具类，商户在使用加密机时，可以减少一部分开发量\n\n### 7. yop-java-sdk-crypto-gm:jar\n\n该模块提供了国密加解密与签名的软实现，商户在对接加密机时，可以作为参考\n\n### 8. yop-java-sdk-crypto-inter:jar:国际加解密签名软实现\n\n该模块提供了国际(RSA/AES等)加解密与签名的软实现，目前为国外商户使用\n\n### 9. yop-java-sdk-test:jar\n\n该模块提供了为sdk自身功能、性能测试代码，以及商户可参考的调用示例\n\n## 使用说明\n\n本项目用于对接 YOP 上面的 API。详细说明请参考[**_使用JavaSDK_**](https://open.yeepay.com/docs/platform/sdk_guide/java-sdk-guide)\n\n### 单商编推荐配置\n\nSDK 默认从路径(相对 classPath) /config/yop_sdk_config_default.json 读取配置文件。\n只需要修改该配置文件中的app_key、isv_private_key等参数后保存到对应目录即可。\n\n如需修改读取路径可以在 VM arguments 中指定配置文件路径，示例如下：\n\n````\nmac/linux:-Dyop.sdk.config.file=file:///home/app/yop_sdk_config_default.json\nwindows:-Dyop.sdk.config.file=file:///D:\\workspace..\\config\\yop_sdk_config_default.json\n````\n\n常见容器修改 JVM 参数的方式如下，仅供参考：\n\n````\ntomcat: 两种方式\n在 $CATALINA_HOME/bin/目录下添加 setenv.sh，在 set env.sh 中添加 JAVA_OPTS=\"$JAVA_OPTS -Dyop.sdk.config.file=file:///home/app/yop_sdk_config_default.json\"\n在 $CATALINA_HOME/bin/catalina.sh 中直接添加 JAVA_OPTS=\"$JAVA_OPTS -Dyop.sdk.config.file=file:///home/app/yop_sdk_config_default.json\"\n\njetty: 在 $jetty_home/bin/jetty.sh 中添加 JAVA_OPTIONS=\"-Dyop.sdk.config.file=file:///home/app/yop_sdk_config_default.json\"\n\nweblogic: 修改 user_projects\\domains\\base_domain\\bin 下的 startWebLogic.cmd 文件，添加 set JAVA_OPTIONS=% JAVA_OPTIONS % -Dyop.sdk.config.file=file:///home/app/yop_sdk_config_default.json\n````\n\n### 多商编（平台商、系统商等）配置方式\n\n可以自行实现凭证提供方（例如继承：YopCachedCredentialsProvider、YopFixedCredentialsProvider）来加载 appkey、私钥的对应关系。\n\n## Requirements\n\nBuilding the API client library requires:\n1. Java 1.8+\n2. Maven/Gradle\n\n## Installation\n\nTo install the API client library to your local Maven repository, simply execute:\n\n```shell\nmvn clean install\n```\n\nTo deploy it to a remote Maven repository instead, configure the settings of the repository and execute:\n\n```shell\nmvn clean deploy\n```\n\n### Maven users\n\nAdd this dependency to your project's POM:\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.yeepay.yop.sdk\u003c/groupId\u003e\n  \u003cartifactId\u003eyop-java-sdk\u003c/artifactId\u003e\n  \u003cversion\u003e4.4.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### Gradle users\n\nAdd this dependency to your project's build file:\n\n```groovy\ncompile group: 'com.yeepay.yop.sdk', name: 'yop-java-sdk', version: '4.4.0'\n```\n\n## 发版\n\n```\nmvn clean -DskipTests release:prepare -Prelease\nmvn release:perform -Prelease\n```\n\n## License\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fyop-platform%2Fyop-java-sdk.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fyop-platform%2Fyop-java-sdk?ref=badge_large)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyop-platform%2Fyop-java-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyop-platform%2Fyop-java-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyop-platform%2Fyop-java-sdk/lists"}