通过生成Api sdk提升开发体验和效率（让bug飞一会儿）

最新推荐文章于 2023-04-06 10:30:15 发布
最新推荐文章于 2023-04-06 10:30:15 发布
阅读量419 收藏
点赞数
分类专栏： 开发协作工具（让BUG飞一会儿） 文章标签： 代码生成 接口联调 api sdk
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u014739462/article/details/112061021
版权

本文概述：

  1. 通过声明式简化接口请求的使用。
  2. 通过代码生成降低开发者的重复的工作。
  3. 提高开发者的开发体验，效率，Happy Coding。

在日常的开发中，不论是web项目，移动端/服务端，或者是微服务，总是会涉及到多人协作或者跨团队甚至跨部门的配合，如何高效的联调接口就会很大程度的上影响项目的进度和总体质量。

痛点（针对http接口）
  1. 由于文档描述不够准确或者看文档的人不够细心引起的问题
   1.1：参数是否必填、字段类型
   1.2：http 请求方法、 请求头(content-type)、路径（有路径参数）
   1.3：响应字段格式类型，例如：枚举
   1.4：低效的沟通导致相互扯皮的问题
  1. 由于接口变更引起的问题
由于在开发阶段因为设计或者需求的变更导致接口变更，对接接口的人在变更接口调用的时候可能会遗漏
  1. 效率问题，如果接口有上百个甚至更多，就单纯些接口的模型对象就是一个很大的工作量

从上面列的几点可以发现这些问题：

  1. 对接接口的人需要关系太多的细节，例如：请求url，请求头，Content-Type，请求方法等
  2. 需要而外的工作，编写接口的模型对象，定义请求方法等

除了这些，如果是js端，还要面对多个运行是环境的问题，例如：浏览器、小程序（多个平台）、weex、react nateive，这无疑又是一个很重复的工作量（当然开源社区有提供跨可以js平台的请求库，例如：umi-request、axios等）。

一种解决思路
  1. 通过提供声明式的请求工具，屏蔽接口的一些细节，让开发员专注业务。
  2. 通过代码生成，减少接口对接人员的工作
  3. 这条针对js：使用typescript，增强接口方法的可用性和安全性typescirpt中文网
声明式的接口请求

引用一段百度百科上对声明式编程的定义

声明式编程（英语：Declarative programming）是一种编程范式，与命令式编程相对立。它描述目标的性质，让计算机明白目标，而非流程。声明式编程不用告诉计算机问题领域，从而避免随之而来的副作用。而命令式编程则需要用算法来明确的指出每一步该怎么做

简单的说就是只需要定义要做什么，而不是怎么做。

社区开源的库

  1. feign
  2. spring-cloud-openfeign
  3. retrofit

来一例子

@FeigenCleint(url="http://example.com/api")
public interface ExampleFeignClient{

   @GetMapping(value="/example/{id}",consumes={"application/json"})
   Example getExample(@PathVariable("id") Long id);

   @PostMapping(value="/example",produces={"application/json"})
   void createExample(@RequestBody CreateExampleReq req);
}

这样对于使用的人只需要关心方法的入参和返回值，而不需要关心其他的，就像调用一个普通的方法一样，最大程度的简单了接口调用了复杂度（当然事物都是两面性，当我们解决了一个问题以后，很可能会来带来新的问题，例如上面这个例子，会带来而外的学习成本和一些配置等）。

来typescript的基于fetch的原始请求方式的一个对比

const getExample=(id:number):Promise<Example>=>{
   
   return fetch(`http://example.com/api/example/${id}`,{
        method:'GET',
    }).then((response)=>{
        if(response.status>=200 && response.status<300){
           return response.json();
        }
        return Promise.reject(response);
    })
}

const createExample=(req:CreateExampleReq):Promise<void>=>{
   return fetch(`http://example.com/api/example`,{
        method:'POST',
        headers:{
          'Content-Type': 'application/json'
        },
        body:JSON.stringify(req)
    })
}

可以看到第二种方式开发者需要关心更多的细节，例如，参数的序列化，返回值的状态、类型（Content-Type）处理等，这些应该交由框架去处理。

另外，即使我们用上了声明式的接口请求处理，上面这些代码如果都让开发者手写的话，接口数量一多工作量还是很大，而且容易由于手误而导致出错，这个时候就可以考虑祭出代码生成工具了。

来一个参照spring cloud openfeign设计思路的typescript feign client的例子

@Feign({
    value: '/v1/example',
})
class ExampleService {

    /**
     * 1:接口方法：POST
     * 2:描述的文字
     * 3:返回值在java中的类型为：ApiResp
     * 4:返回值在java中的类型为：Long
     **/
    @PostMapping({
        value: '/create',
        produces: [HttpMediaType.FORM_DATA],
    })
    create: (req: CreateExampleEntityReq, option?: FeignRequestOptions) => Promise<number>;
    /**
     * 1:接口方法：PUT
     * 2:描述的文字
     * 3:返回值在java中的类型为：ApiResp
     * 4:返回值在java中的类型为：Void
     **/
    @PutMapping({
        value: '/edit',
        produces: [HttpMediaType.FORM_DATA],
    })
    edit: (req: EditExampleEntityReq, option?: FeignRequestOptions) => Promise<void>;
    /**
     * 1:接口方法：GET
     * 2:描述的文字
     * 3:返回值在java中的类型为：ApiResp
     * 4:返回值在java中的类型为：Void
     **/
    @GetMapping({
        value: '/delete',
        produces: [HttpMediaType.FORM_DATA],
    })
    delete: (req: DeleteExampleEntityReq, option?: FeignRequestOptions) => Promise<void>;
    /**
     * 1:接口方法：GET
     * 2:描述的文字
     * 3:返回值在java中的类型为：ApiResp
     * 4:返回值在java中的类型为：Pagination
     * 5:返回值在java中的类型为：ExampleEntityInfo
     **/
    @GetMapping({
        value: '/query',
        produces: [HttpMediaType.FORM_DATA],
    })
    query: (req: QueryExampleEntityReq, option?: FeignRequestOptions) => Promise<PageInfo<ExampleEntityInfo>>;
    /**
     * 1:接口方法：GET
     * 2:描述的文字
     * 3:返回值在java中的类型为：ApiResp
     * 4:返回值在java中的类型为：ExampleEntityInfo
     **/
    @GetMapping({
        value: '/{id}',
        produces: [HttpMediaType.FORM_DATA],
    })
    detail: (req: ExampleServiceDetailReq, option?: FeignRequestOptions) => Promise<ExampleEntityInfo>;
}

export default new ExampleService();

dart的例子

import 'dart:io';
import 'package:built_collection/built_collection.dart';
import 'package:built_value/built_value.dart';
import 'package:built_value/serializer.dart';
import 'package:fengwuxp_dart_basic/index.dart';
import 'package:fengwuxp_dart_openfeign/index.dart';

import '../domain/order.dart';
import '../resp/page_info.dart';
import '../evt/query_order_evt.dart';
import '../evt/create_order_evt.dart';
import '../../../../../serializers.dart';


/// 订单服务
/// 接口：GET
@Feign
@FeignClient(value: "/order",)
class OrderFeignClient extends FeignProxyClient {

  OrderFeignClient() : super() {

  }


  /// 1:获取订单列表
  /// 2:接口方法：GET
  /// 3:返回值在java中的类型为：List
  /// 4:返回值在java中的类型为：Order
  @GetMapping(value: "get_order",)
  Future<BuiltList<Order>> getOrder(List<String> names,
      List<int> ids,
      Set<Order> moneys,
      [UIOptions feignOptions]) {
    return this.delegateInvoke<BuiltList<Order>>("getOrder",
        [names, ids, moneys,],
        feignOptions: feignOptions,
        serializer: BuiltValueSerializable(
            specifiedType: FullType(BuiltList, [FullType(Order)])
        )
    );
  }

  /// 1:获取订单列表
  /// 2:接口方法：POST
  /// 3:返回值在java中的类型为：PageInfo
  /// 4:返回值在java中的类型为：Order
  @PostMapping()
  Future<PageInfo<Order>> queryOrder(@RequestBody(true) QueryOrderEvt evt,
      [UIOptions feignOptions]) {
    return this.delegateInvoke<PageInfo<Order>>("queryOrder",
        [evt,],
        feignOptions: feignOptions,
        serializer: BuiltValueSerializable(
            serializer: PageInfo.serializer,
            specifiedType: FullType(PageInfo, [FullType(Order)])
        )
    );
  }

  /// 1:获取订单列表
  /// 2:接口方法：POST
  /// 3:返回值在java中的类型为：ServiceQueryResponse
  /// 4:返回值在java中的类型为：Order
  @PostMapping(produces: [HttpMediaType.MULTIPART_FORM_DATA],)
  Future<PageInfo<Order>> queryOrder2(@RequestParam("order_id") int oderId,
      String sn,
      [UIOptions feignOptions]) {
    return this.delegateInvoke<PageInfo<Order>>("queryOrder2",
        [oderId, sn,],
        feignOptions: feignOptions,
        serializer: BuiltValueSerializable(
            serializer: PageInfo.serializer,
            specifiedType: FullType(PageInfo, [FullType(Order)])
        )
    );
  }

  /// 1:查询分页
  /// 2:接口方法：POST
  /// 3:<pre> 
  ///参数列表：
  ///参数名称：id，参数说明：属性名称：id，属性说明：订单，示例输入：
  ///</pre>
  /// 4:返回值在java中的类型为：ServiceResponse
  /// 5:返回值在java中的类型为：PageInfo
  /// 6:返回值在java中的类型为：Order
  @PostMapping()
  Future<PageInfo<Order>> queryPage(String id,
      [UIOptions feignOptions]) {
    return this.delegateInvoke<PageInfo<Order>>("queryPage",
        [id,],
        feignOptions: feignOptions,
        serializer: BuiltValueSerializable(
            serializer: PageInfo.serializer,
            specifiedType: FullType(PageInfo, [FullType(Order)])
        )
    );
  }

  /// 1:创建订单
  /// 2:接口方法：GET
  /// 3:返回值在java中的类型为：ServiceResponse
  /// 4:返回值在java中的类型为：Long
  @GetMapping()
  Future<int> createOrder(CreateOrderEvt evt,
      [UIOptions feignOptions]) {
    return this.delegateInvoke<int>("createOrder",
        [evt,],
        feignOptions: feignOptions,
        serializer: BuiltValueSerializable(
            specifiedType: FullType(int)
        )
    );
  }

  /// 1:test hello
  /// 2:接口方法：POST
  /// 3:返回值在java中的类型为：ServiceResponse
  @PostMapping()
  Future<dynamic> hello([UIOptions feignOptions]) {
    return this.delegateInvoke<dynamic>("hello",
      [],
      feignOptions: feignOptions,
    );
  }
}


final orderFeignClient = OrderFeignClient();

以上的代码是通过代码生成codegen工具生成的，结合typescript-feign、 flutter-feign这个2个http请求库，从加强接口调用的准确性和易用性以及减少开发者工作量2个维度协助开发人员降低接口对接的难度、出错率，提高开发体验。

spring cloud openfeign的生成例子：

import io.reactivex.Observable;
import org.springframework.cloud.openfeign.*;
import org.springframework.web.bind.annotation.*;

import java.util.List;

import com.wuxp.codegen.swagger2.domain.Order;
import com.wuxp.codegen.swagger2.resp.PageInfo;
import com.wuxp.codegen.swagger2.resp.ServiceResponse;
import com.wuxp.codegen.swagger2.evt.CreateOrderEvt;
import com.wuxp.codegen.swagger2.example.evt.QueryOrderEvt;

import java.util.Date;
import java.util.Map;

/**
 * 订单服务
 * 接口：GET
 **/

@FeignClient(
        decode404 = false,
        name = "exampleService",
        path = "/order",
        url = "${test.feign.url}"
)
public interface OrderFeignClient {

    /**
     * 1:获取订单列表
     * 2:接口方法：GET
     * 3:返回值在java中的类型为：List
     * 4:返回值在java中的类型为：Order
     **/
    @GetMapping(value = "get_order")
    List<Order> getOrder(
            String[] names,
            List<Integer> ids,
            Set<Order> moneys
    );

    /**
     * 1:获取订单列表
     * 2:接口方法：GET
     * 3:返回值在java中的类型为：PageInfo
     * 4:返回值在java中的类型为：Order
     **/
    @GetMapping()
    PageInfo<Order> queryOrder(
            @SpringQueryMap(value = true) QueryOrderEvt evt
    );

    /**
     * 1:获取订单列表
     * 2:接口方法：POST
     * 3:返回值在java中的类型为：ServiceQueryResponse
     * 4:返回值在java中的类型为：Order
     **/
    @PostMapping(produces = {MediaType.MULTIPART_FORM_DATA_VALUE})
    ServiceResponse<PageInfo<Order>> queryOrder2(
            @RequestParam(name = "order_id") Long oderId,
            String sn
    );

    /**
     * 1:查询分页
     * 2:接口方法：POST
     * 3:<pre>
     * 参数列表：
     * 参数名称：id，参数说明：属性名称：id，属性说明：订单，示例输入：
     * </pre>
     * 4:返回值在java中的类型为：ServiceResponse
     * 5:返回值在java中的类型为：PageInfo
     * 6:返回值在java中的类型为：Order
     **/
    @PostMapping()
    ServiceResponse<PageInfo<Order>> queryPage(
            String id
    );

    /**
     * 1:创建订单
     * 2:接口方法：POST
     * 3:<pre>
     * 参数列表：
     * 参数名称：evt，参数说明：属性名称：evt，属性说明：创建订单，示例输入：
     * </pre>
     * 4:返回值在java中的类型为：ServiceResponse
     * 5:返回值在java中的类型为：Long
     **/
    @PostMapping()
    ServiceResponse<Long> createOrder(
            @RequestBody(required = true) CreateOrderEvt evt
    );

    /**
     * 1:test hello
     * 2:接口方法：POST
     * 3:返回值在java中的类型为：ServiceResponse
     **/
    @PostMapping()
    ServiceResponse<Object> hello(
    );
}

retrofit的生成例子

import io.reactivex.Observable;
import retrofit2.http.*;

import java.util.List;

import com.wuxp.codegen.swagger2.domain.Order;
import com.wuxp.codegen.swagger2.resp.PageInfo;
import com.wuxp.codegen.swagger2.resp.ServiceResponse;
import com.wuxp.codegen.swagger2.evt.CreateOrderEvt;
import com.wuxp.codegen.swagger2.evt.QueryOrderEvt;

import java.util.Date;
import java.util.Map;

/**
 * 订单服务
 * 接口：GET
 **/

public interface OrderService {

    /**
     * 1:获取订单列表
     * 2:接口方法：GET
     * 3:返回值在java中的类型为：List
     * 4:返回值在java中的类型为：Order
     **/
    @GET(value = "/order/get_order")
    List<Order> getOrder(
            String[] names,
            List<Integer> ids,
            Set<Order> moneys
    );

    /**
     * 1:获取订单列表
     * 2:接口方法：GET
     * 3:返回值在java中的类型为：PageInfo
     * 4:返回值在java中的类型为：Order
     **/
    @GET(value = "/order")
    PageInfo<Order> queryOrder(
            QueryOrderEvt evt
    );

    /**
     * 1:获取订单列表
     * 2:接口方法：POST
     * 3:返回值在java中的类型为：ServiceQueryResponse
     * 4:返回值在java中的类型为：Order
     **/
    @POST(value = "/order/queryOrder2")
    @Headers(value = {"Content-Type: application/json"})
    ServiceResponse<PageInfo<Order>> queryOrder2(
            @Field(value = "order_id") Long oderId,
            String sn
    );

    /**
     * 1:查询分页
     * 2:接口方法：POST
     * 3:<pre>
     * 参数列表：
     * 参数名称：id，参数说明：属性名称：id，属性说明：订单，示例输入：
     * </pre>
     * 4:返回值在java中的类型为：ServiceResponse
     * 5:返回值在java中的类型为：PageInfo
     * 6:返回值在java中的类型为：Order
     **/
    @POST(value = "/order/queryPage")
    @Headers(value = {"Content-Type: application/json"})
    ServiceResponse<PageInfo<Order>> queryPage(
            String id
    );

    /**
     * 1:创建订单
     * 2:接口方法：POST
     * 3:<pre>
     * 参数列表：
     * 参数名称：evt，参数说明：属性名称：evt，属性说明：创建订单，示例输入：
     * </pre>
     * 4:返回值在java中的类型为：ServiceResponse
     * 5:返回值在java中的类型为：Long
     **/
    @POST(value = "/order/createOrder")
    ServiceResponse<Long> createOrder(
            @Body CreateOrderEvt evt
    );

    /**
     * 1:test hello
     * 2:接口方法：POST
     * 3:返回值在java中的类型为：ServiceResponse
     **/
    @POST(value = "/order/hello")
    ServiceResponse<Object> hello(
    );
}

umi-request的生成例子

/* tslint:disable */
import request, {RequestOptionsInit} from 'umi-request';
import {Order} from "../../domain/Order";
import {OrderServiceGetOrderReq} from "../../req/OrderServiceGetOrderReq";
import {QueryOrderEvt} from "../../evt/QueryOrderEvt";
import {PageInfo} from "../../resp/PageInfo";
import {OrderServiceQueryOrder2Req} from "../../req/OrderServiceQueryOrder2Req";
import {OrderServiceQueryPageReq} from "../../req/OrderServiceQueryPageReq";
import {CreateOrderEvt} from "../../evt/CreateOrderEvt";
import {OrderServiceHelloReq} from "../../req/OrderServiceHelloReq";

/**
 * 订单服务
 * 接口：GET
 **/
/*================================================分割线，以下为接口列表===================================================*/


/**
 * 1:获取订单列表
 * 2:接口方法：GET
 * 3:返回值在java中的类型为：List
 * 4:返回值在java中的类型为：Order
 **/
export const getOrder = (req: OrderServiceGetOrderReq, options?: RequestOptionsInit): Promise<Array<Order>> => {
    return request<Array<Order>>(`/order/get_order`, {
        method: 'get',
        params: req,
        ...(options || {} as RequestOptionsInit)
    })
}

/**
 * 1:获取订单列表
 * 2:接口方法：GET
 * 3:返回值在java中的类型为：PageInfo
 * 4:返回值在java中的类型为：Order
 **/
export const queryOrder = (req: QueryOrderEvt, options?: RequestOptionsInit): Promise<PageInfo<Order>> => {
    return request<PageInfo<Order>>(`/order`, {
        method: 'get',
        params: req,
        ...(options || {} as RequestOptionsInit)
    })
}

/**
 * 1:获取订单列表
 * 2:接口方法：POST
 * 3:返回值在java中的类型为：ServiceQueryResponse
 * 4:返回值在java中的类型为：Order
 **/
export const queryOrder2 = (req: OrderServiceQueryOrder2Req, options?: RequestOptionsInit): Promise<PageInfo<Order>> => {
    return request<PageInfo<Order>>(`/order/queryOrder2`, {
        method: 'post',
        requestType: 'json',
        data: req,
        responseType: 'json',
        ...(options || {} as RequestOptionsInit)
    })
}

/**
 * 1:查询分页
 * 2:接口方法：POST
 * 3:<pre>
 *参数列表：
 *参数名称：id，参数说明：属性名称：id，属性说明：订单，示例输入：
 *</pre>
 * 4:返回值在java中的类型为：ServiceResponse
 * 5:返回值在java中的类型为：PageInfo
 * 6:返回值在java中的类型为：Order
 **/
export const queryPage = (req: OrderServiceQueryPageReq, options?: RequestOptionsInit): Promise<PageInfo<Order>> => {
    return request<PageInfo<Order>>(`/order/queryPage`, {
        method: 'post',
        requestType: 'json',
        data: req,
        responseType: 'json',
        ...(options || {} as RequestOptionsInit)
    })
}

/**
 * 1:创建订单
 * 2:接口方法：POST
 * 3:<pre>
 *参数列表：
 *参数名称：evt，参数说明：属性名称：evt，属性说明：创建订单，示例输入：
 *</pre>
 * 4:返回值在java中的类型为：ServiceResponse
 * 5:返回值在java中的类型为：Long
 **/
export const createOrder = (req: CreateOrderEvt, options?: RequestOptionsInit): Promise<number> => {
    return request<number>(`/order/createOrder`, {
        method: 'post',
        requestType: 'form',
        data: req,
        responseType: 'json',
        ...(options || {} as RequestOptionsInit)
    })
}

/**
 * 1:test hello
 * 2:接口方法：POST
 * 3:返回值在java中的类型为：ServiceResponse
 **/
export const hello = (req: OrderServiceHelloReq, options?: RequestOptionsInit): Promise<any> => {
    return request<any>(`/order/hello`, {
        method: 'post',
        requestType: 'form',
        data: req,
        responseType: 'json',
        ...(options || {} as RequestOptionsInit)
    })
}
  1. common-codegen是一个通过java class生成api sdk的代码生成工具，目前支持spring mvc相关的注解（通过控制器生成sdk，支持扩展其他注解）、默认swagger2和3的注解和部分的javax验证注解。支持生成retrofit\spring cloud openfeign\typescript-feign\umi-request\dart_feign 5种请求工具的代码。
  2. flutter-feign flutter的http请求工具
  3. typescript-feign是一个声明式的跨平台的http请求框架，一套sdk适配所有的js平台
岁月如风丶逝
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
淘宝TOP API PHP SDK 2.2 支持UTF-8 GB2312编码
02-25
2009-12-29 升级API2.0生成sign方式,完美支持官方提出的MD5和HMAC二种方式 2009-12-28 加入错误日志.当关闭错误显示时自动记录到错误日志中 2009-12-25 修正PHP5.3中出现URL拼接不一致的BUG 2009-12-22 发布Taoapi_...
Apifox自动生成接口文档
xixingzhe2的博客
04-22 3528
自动生成接口文档
typescript(七)--ts中接口(函数型接口)
jasnet_u的博客
07-21 8618
如题，本篇我们介绍下ts中函数型接口。 ts中函数型接口，非常类似于java、c#中使用lambda表达式传入匿名函数。因为对象中仅包含一个函数，这个对象的全部意义也仅在于那个可被外部调用的函数，故而称之为函数型接口。 05_interface_func.ts /* * ts中接口 * 函数型接口 ,非常类似于java、c#中使用lambda表达式传入匿名函数 * * */ // // ...
SDK设计心得之接口设计
木牛的博客
05-13 1176
由于SDK的特殊性，所以对于SDK的开发来说，一开始对于SDK的一些通用的整体的元素的设计至关重要。因为SDK（尤其很多平台SDK,使用的应用成百上千）一个及其细微的调整都会影响很多开发者的版本周期。因此前期的设计显得尤为重要。关于这部分内容，我会分两篇来介绍，这篇重点介绍具体接口的设计。另一篇SDK设计心得之架构和资源将重点介绍SDK的架构和一些资源的使用方式。 关于接口设计 设计原则 接口名称、参数名称要足够清晰 一个牛逼的接口名称可以替代无数的注释 一个接口只做一件事 一个接口只做一件事。
亚马逊 spapi — 生成 Java SDK
BASK2311的博客
04-06 425
从下载SPAPI源码。目录下有API SDK（Application Programming Interface，Software Development Kit）共用的依赖，重点关注和。认证授权模块负责鉴权，现成的代码，只需要提供必要的参数；API文档助手模块提供了文档上传下载的代码，文档安全传输相关的加解密操作也是现成的，我们只需要使用里面现成的工具类即可，调用一些API的时候会用到。目录下是各模块的API配置文件（.json），这个在官网的开发文档也可以看到，比如。打开。
一键化生成sdk文档的妙法
weixin_33941350的博客
11-15 740
上一篇文章提到了API和SDK的区别，感觉大家都还挺感兴趣的，虽然没啥人评论，看的人也不多（心头痛中），由于工作的原因，经常要接触到接口，一般接口文档编写完毕，接下来开始写调用接口的代码，我的公司（据我所知很多企业也这样）采用sdk文档的形式来调用接口。使用的过程中----上次说到的eolinker提供一键化生成sdk文档，在接口编辑完后...
Unionpay_PHP_API:银联无跳转支付 PHP SDK【二次封装，修复原SDK bug，简化前端逻辑，RSA加密通信】
05-14
通过运行以下命令生成RSA密钥：（这些密钥用于AJAX加密。） $ openssl genrsa -out rsa_4096_priv.pem 4096 $ openssl rsa -pubout -in rsa_4096_priv.pem -out rsa_4096_pub.pem 将rsa_4096_pub.pem复制到api
twr-sdk:HARDWARIO固件SDK（软件开发套件）
05-18
简而言之，它是一组库和API，可简化嵌入式固件开发工作流程。 所有驱动程序都提供底层硬件的高级抽象，并遵循事件驱动的方法。 整个库使用Doxygen记录，并在上自动生成，每次使用Travis CI提交/合并到master分支...
aws-otel-js:适用于OpenTelemetry JavaScript SDK的AWS Distro
03-20
我们提供了ID生成器和传播器，可以从OpenTelemetry上游API对其进行配置。生成的遥测数据可以以多种格式导出，并且可以通过命令行或环境变量进行配置。此项目的目的是能够使用的从JavaScript应用程序收集遥测数据，...
douchat微信开发框架-PHP
06-20
douchat（豆信）是一个专注于微信公众号开发的开源框架，具备“简洁、高效、优雅、易扩展”等...9、活跃的交流社区，让每一个开发爱好者都能分享自己的看法与见解。 10、集成BUG反馈系统，产品保持高频次更新与迭代。
api:from根据OpenAPI定义自动生成SDK
04-28
:rocket: api 从OpenAPI定义自动生成SDK。 安装 npm install api --save 用法 使用api就像提供它的OpenAPI和使用SDK一样简单，就像您使用其他任何工具一样！ const sdk = require ( 'api' ) ( 'https://raw.githubusercontent.com/readmeio/oas/master/packages/examples/3.0/json/petstore.json' ) ; sdk . listPets ( ) . then ( res => res . json ( ) ) . then ( res => { console . log ( `My pets name is ${ res [ 0 ] . name } !` ) ; } ) ; 该OpenAPI的定义自动下载，缓存，并转化为一个可
openapi-generator,openapi生成器允许自动生成api客户端库（sdk生成）、服务器存根、文档和配置，并给出openapi规范（v2，v3）.zip
09-25
openapi生成器
openapi3生成sdk
weixin_43802117的博客
07-06 384
/** * openapi3转sdk * * @param docsUrl swagger docs路径 * @param jsonContent swagger docs 内容 * @param apiPackage 指定生成的api类的包名 * @param artifactId 指定pom.xml的artifactId的值 * @param artifactVersion 指定pom.x.
【Android SDK 开发】谈谈Sdk迭代开发设计需要考虑的方面
dodod2012的专栏
04-01 1376
原文地址：https://mp.weixin.qq.com/s/mXFBaoRHGnzb3DIlCeeEzA 作者：Trilen 链接： http://blog.csdn.net/u010019468/article/details/75425742 本文由作者投稿推送。 Sdk开发设计与Apk开发不同的地方还是有些明显的不同之处，明显的区别是使用对象不一样，Sdk是基于开发者使用...
sdk开发经验总结
我是黄大仙
04-26 9211
文章目录1. 降低接入成本1.1 接入简单1.2 文档和 demo1.3 api接口设计1. 接口保持精简，不要提供过多的接口2. 每个接口均应当提供详细的接口说明3. 接口参数不应过多4. 接口方法过多，应当提供默认实现5. 接口尽可能和系统或者业内标准保持一致1.4 向后兼容2.稳定性2.1 plan B2.2 监控2.3 错误指引3.其他3.1 易扩展3.2 关注性能3.3 鉴权3.4 合规3.5 sdk接入标准化4. 总结 博主之前做过一些 sdk 的开发，也对接过一些 sdk ，有一些 sdk 设
SDK开发技术规范总结
caizehui的博客
02-03 5385
SDK是Software Development Kit的缩写,译为“软件开发工具包”,通常是为辅助开发某类软件而编写的特定软件包,框架集合等,SDK一般包含相关文档,范例和工具。 SDK可以分为系统SDK和应用SDK.所谓的系统SDK是为特定的软件包,软件框架,硬件平台,操作系统等应用时所使用的开发工具集合.而应用SDK则是基于系统SDK开发的独立于具体业务而具有特定功能的集合. 1.设计原则 优秀设计 SDK 必须要遵从原生、简短、执行迅速、代码干净、易读、可测试的原则。 一个接口尽量只做一件事
自己的sdk
hqw921054的博客
10-06 260
设计sdk的三步思路： ​ 数据传输模块：主要用于传输请求数据，本文使用http协议传输数据 序列化模块：用户序列化和反序列化数据，SDK是给客户使用应该尽可能的去适配客户的意愿，如客户首先的序列化方式为JSON那，作为使用方肯定是会希望SDK能支持JSON序列化和反序列化的 应用模块：主要是协调数据传输、序列化之间的工作，同时对数据做一些校验签名操作 基本功能 数据传输 数据传输协议使用较为通用的http协议，一开始是想是否做一个通用的设计来支持其他的传输方式，如支
基于matlab实现的空间调制通信过程，包含信号调制、天线选择等发送过程，以及采用最大似然估计的检测过程 .rar
最新发布
05-02
基于matlab实现的空间调制通信过程，包含信号调制、天线选择等发送过程，以及采用最大似然估计的检测过程。.rar
基于matlab的关于生猪养殖场经营管理的研究.docx
05-02
本文档是课题研究的研究报告内含调研以及源码设计以及结果分析
Copilot API 二次开发 获取Copilot API SDK
05-17
很抱歉，目前并没有官方发布的 Copilot API SDK，因为 Copilot 目前仍处于封闭测试阶段，只有少数受邀用户可以使用该工具。但是，你可以通过以下步骤进行二次开发： 1. 申请 Copilot 的封闭测试权限，参与 Copilot 的测试和使用。 2. 阅读 Copilot 的文档，了解其基本使用方法和功能。 3. 使用 Copilot 的 API 进行二次开发，实现自己的应用场景。 需要注意的是，Copilot 是由 OpenAI 公司开发，其 API 的使用可能需要缴纳一定的费用。如果需要商业使用，建议先咨询 OpenAI 公司的相关人员，了解具体的费用和使用条款。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值