# SwaggerAndAbpJavaClient

**Repository Path**: yiyiooo/swagger-and-abp-java-client

## Basic Information

- **Project Name**: SwaggerAndAbpJavaClient
- **Description**: swagger生成abp的API客户端代码
脚本和http拦截器以及一些工具
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-04-06
- **Last Updated**: 2022-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

创建这个仓库的原因是在写安卓的时候后端使用了abp，使用swagger生成webApi客户端后依然需要写很多内容才能使用，特别是返回的数据格式与swagger生成的格式不一致的问题。 
加上不是很会用swagger，就只能绕点弯路了

##### 标记一下需要注意的几个点
- 执行swagger.jar的bat文件里面需要写上后端地址
    1. 生成的客户端代码默认是eclipse项目，在android里面用起来很麻烦，所以使用了系统链接把代码链接到了项目里面
    2. 如果使用了git等代码管理工具，记得排除客户端代码的文件夹，因为文件是真的多
- 生成的客户端代码需要设置baseUrl
    1. 一般的做法是修改生成的 ApiClient.java,但是我这里懒人做法是在项目初始化的时候设置
```
Configuration.getDefaultApiClient().setBasePath("http://127.0.0.1:8888"); // 后面不能有 "/"
```
    2. 因为这是安卓项目，所以AppBootstrap.java这个类继承了Application 在manifest文件里面application加一个name属性，内容是com.yiyiooo.Abp.AppBootstrap 即可
```
 <application
        android:name="com.yiyiooo.Abp.AppBootstrap"
```
    3. 不是安卓项目，项目启动第一个或第一个接口调用前设置都可以
- 因为WebApi实际返回数据格式与生成的客户端代码有区别（返回的数据多包裹了一层）类型是AbpResultDto
- 因为原版的callback需要重写4个类，嫌麻烦自定义了一个 AbpApiCallback

    4. gradle加入一下依赖
```
    implementation 'io.swagger.core.v3:swagger-annotations:2.0.0'
    implementation 'com.squareup.okhttp:okhttp:2.7.5'
    implementation 'com.squareup.okhttp:logging-interceptor:2.7.5'
    implementation 'com.google.code.gson:gson:2.8.5'
    implementation 'io.gsonfire:gson-fire:1.8.3'
    implementation 'org.threeten:threetenbp:1.3.5'
    testImplementation 'junit:junit:4.12'
    implementation 'javax.annotation:jsr250-api:1.0'
```