设计好接口的方法总结:全栈程序员如何把一个接口设计好?

博主猫头虎的技术世界

🌟 欢迎来到猫头虎的博客 — 探索技术的无限可能!

专栏链接

🔗 精选专栏

领域矩阵

🌐 猫头虎技术领域矩阵
深入探索各技术领域,发现知识的交汇点。了解更多,请访问:

在这里插入图片描述

设计好接口的方法总结

我们做后端开发工程师,主要工作就是:如何把一个接口设计好。所以,今天就给大家介绍,设计好接口的36个锦囊。本文就是后端思想专栏的第一篇哈。

文章目录

1. 接口参数校验

入参出参校验是每个程序员必备的基本素养。你设计的接口,必须先校验参数。比如入参是否允许为空,入参长度是否符合你的预期长度。这个要养成习惯哈,日常开发中,很多低级bug都是不校验参数导致的。

比如你的数据库表字段设置为varchar(16),对方传了一个32位的字符串过来,如果你不校验参数,插入数据库直接异常了

出参也是,比如你定义的接口报文,参数是不为空的,但是你的接口返回参数,没有做校验,因为程序某些原因,直返回别人一个null值。。。

图片

2. 修改老接口时,注意接口的兼容性

很多bug都是因为修改了对外旧接口,但是却不做兼容导致的。关键这个问题多数是比较严重的,可能直接导致系统发版失败的。新手程序员很容易犯这个错误哦~

图片

所以,如果你的需求是在原来接口上修改,尤其这个接口是对外提供服务的话,一定要考虑接口兼容。举个例子吧,比如dubbo接口,原本是只接收A,B参数,现在你加了一个参数C,就可以考虑这样处理:

//老接口
void oldService(A,B){
  //兼容新接口,传个null代替C
  newService(A,B,null);
}

//新接口,暂时不能删掉老接口,需要做兼容。
void newService(A,B,C){
  ...
}

3. 设计接口时,充分考虑接口的可扩展性

要根据实际业务场景设计接口,充分考虑接口的可扩展性。

比如你接到一个需求:是用户添加或者修改员工时,需要刷脸。那你是反手提供一个员工管理的提交刷脸信息接口?还是先思考:提交刷脸是不是通用流程呢?比如转账或者一键贴现需要接入刷脸的话,你是否需要重新实现一个接口呢?还是当前按业务类型划分模块,复用这个接口就好,保留接口的可扩展性。

如果按模块划分的话,未来如果其他场景比如一键贴现接入刷脸的话,不用再搞一套新的接口,只需要新增枚举,然后复用刷脸通过流程接口,实现一键贴现刷脸的差异化即可。

图片

4.接口考虑是否需要防重处理

如果前端重复请求,你的逻辑如何处理?是不是考虑接口去重处理。

当然,如果是查询类的请求,其实不用防重。如果是更新修改类的话,尤其金融转账类的,就要过滤重复请求了。简单点,你可以使用Redis防重复请求,同样的请求方,一定时间间隔内的相同请求,考虑是否过滤。当然,转账类接口,并发不高的话,推荐使用数据库防重表,以唯一流水号作为主键或者唯一索引

图片

5. 重点接口,考虑线程池隔离。

一些登陆、转账交易、下单等重要接口,考虑线程池隔离哈。如果你所有业务都共用一个线程池,有些业务出bug导致线程池阻塞打满的话,那就杯具了,所有业务都影响了。因此进行线程池隔离,重要业务分配多一点的核心线程,就更好保护重要业务。

图片

6. 调用第三方接口要考虑异常和超时处理

如果你调用第三方接口,或者分布式远程服务的的话,需要考虑:

  • 异常处理

比如,你调别人的接口,如果异常了,怎么处理,是重试还是当做失败还是告警处理。

  • 接口超时

没法预估对方接口一般多久返回,一般设置个超时断开时间,以保护你的接口。之前见过一个生产问题,就是http调用不设置超时时间,最后响应方进程假死,请求一直占着线程不释放,拖垮线程池。

  • 重试次数

你的接口调失败,需不需要重试?重试几次?需要站在业务上角度思考这个问题

图片

7. 接口实现考虑熔断和降级

当前互联网系统一般都是分布式部署的。而分布式系统中经常会出现某个基础服务不可用,最终导致整个系统不可用的情况, 这种现象被称为服务雪崩效应

比如分布式调用链路A->B->C....,下图所示:

图片

如果服务C出现问题,比如是因为慢SQL导致调用缓慢,那将导致B也会延迟,从而A也会延迟。堵住的A请求会消耗占用系统的线程、IO等资源。当请求A的服务越来越多,占用计算机的资源也越来越多,最终会导致系统瓶颈出现,造成其他的请求同样不可用,最后导致业务系统崩溃。

为了应对服务雪崩, 常见的做法是熔断和降级。最简单是加开关控制,当下游系统出问题时,开关降级,不再调用下游系统。还可以选用开源组件Hystrix

8. 日志打印好,接口的关键代码,要有日志保驾护航。

关键业务代码无论身处何地,都应该有足够的日志保驾护航。比如:你实现转账业务,转个几百万,然后转失败了,接着客户投诉,然后你还没有打印到日志,想想那种水深火热的困境下,你却毫无办法。。。

那么,你的转账业务都需要哪些日志信息呢?至少,方法调用前,入参需要打印需要吧,接口调用后,需要捕获一下异常吧,同时打印异常相关日志吧,如下:

public void transfer(TransferDTO transferDTO){
    log.info("invoke tranfer begin");
    //打印入参
    log.info("invoke tranfer,paramters:{}",transferDTO);
    try {
      res=  transferService.transfer(transferDTO);
    }catch(Exception e){
     log.error("transfer fail,account:{}",
     transferDTO.getAccount())
     log.error("transfer fail,exception:{}",e);
    }
    log.info("invoke tranfer end");
    }

9. 接口的功能定义要具备单一性

单一性是指接口做的事情比较单一、专一。比如一个登陆接口,它做的事情就只是校验账户名密码,然后返回登陆成功以及userId即可。但是如果你为了减少接口交互,把一些注册、一些配置查询等全放到登陆接口,就不太妥。

其实这也是微服务一些思想,接口的功能单一、明确。比如订单服务、积分、商品信息相关的接口都是划分开的。将来拆分微服务的话,是不是就比较简便啦。

10.接口有些场景,使用异步更合理

举个简单的例子,比如你实现一个用户注册的接口。用户注册成功时,发个邮件或者短信去通知用户。这个邮件或者发短信,就更适合异步处理。因为总不能一个通知类的失败,导致注册失败吧。

至于做异步的方式,简单的就是用线程池。还可以使用消息队列,就是用户注册成功后,生产者产生一个注册成功的消息,消费者拉到注册成功的消息,就发送通知。

图片

不是所有的接口都适合设计为同步接口。比如你要做一个转账的功能,如果你是单笔的转账,你是可以把接口设计同步。用户发起转账时,客户端在静静等待转账结果就好。如果你是批量转账,一个批次一千笔,甚至一万笔的,你则可以把接口设计为异步。就是用户发起批量转账时,持久化成功就先返回受理成功。然后用户隔十分钟或者十五分钟等再来查转账结果就好。又或者,批量转账成功后,再回调上游系统。

图片

11. 优化接口耗时,远程串行考虑改并行调用

假设我们设计一个APP首页的接口,它需要查用户信息、需要查banner信息、需要查弹窗信息等等。那你是一个一个接口串行调,还是并行调用呢?

图片

如果是串行一个一个查,比如查用户信息200ms,查banner信息100ms、查弹窗信息50ms,那一共就耗时350ms了,如果还查其他信息,那耗时就更大了。这种场景是可以改为并行调用的。也就是说查用户信息、查banner信息、查弹窗信息,可以同时发起。

图片

在Java中有个异步编程利器:CompletableFuture,就可以很好实现这个功能。

12. 接口合并或者说考虑批量处理思想

数据库操作或或者是远程调用时,能批量操作就不要for循环调用。图片

一个简单例子,我们平时一个列表明细数据插入数据库时,不要在for循环一条一条插入,建议一个批次几百条,进行批量插入。同理远程调用也类似想法,比如你查询营销标签是否命中,可以一个标签一个标签去查,也可以批量标签去查,那批量进行,效率就更高嘛。

//反例
for(int i=0;i<n;i++){
  remoteSingleQuery(param)
}

//正例
remoteBatchQuery(param);

小伙伴们是否了解过kafka为什么这么快呢?其实其中一点原因,就是kafka使用批量消息提升服务端处理能力。

13. 接口实现过程中,恰当使用缓存

哪些场景适合使用缓存?读多写少且数据时效要求越低的场景

缓存用得好,可以承载更多的请求,提升查询效率,减少数据库的压力。

比如一些平时变动很小或者说几乎不会变的商品信息,可以放到缓存,请求过来时,先查询缓存,如果没有再查数据库,并且把数据库的数据更新到缓存。但是,使用缓存增加了需要考虑这些点:缓存和数据库一致性如何保证、集群、缓存击穿、缓存雪崩、缓存穿透等问题。

  • 保证数据库和缓存一致性:缓存延时双删、删除缓存重试机制、读取biglog异步删除缓存
  • 缓存击穿:设置数据永不过期
  • 缓存雪崩:Redis集群高可用、均匀设置过期时间
  • 缓存穿透:接口层校验、查询为空设置个默认空值标记、布隆过滤器。

一般用Redis分布式缓存,当然有些时候也可以考虑使用本地缓存,如Guava Cache、Caffeine等。使用本地缓存有些缺点,就是无法进行大数据存储,并且应用进程的重启,缓存会失效。

14. 接口考虑热点数据隔离性

瞬时间的高并发,可能会打垮你的系统。可以做一些热点数据的隔离。比如业务隔离、系统隔离、用户隔离、数据隔离等。

  • 业务隔离性,比如12306的分时段售票,将热点数据分散处理,降低系统负载压力。
  • 系统隔离:比如把系统分成了用户、商品、社区三个板块。这三个块分别使用不同的域名、服务器和数据库,做到从接入层到应用层再到数据层三层完全隔离。
  • 用户隔离:重点用户请求到配置更好的机器。
  • 数据隔离:使用单独的缓存集群或者数据库服务热点数据。

15. 可变参数配置化,比如红包皮肤切换等

假如产品经理提了个红包需求,圣诞节的时候,红包皮肤为圣诞节相关的,春节的时候,为春节红包皮肤等。

如果在代码写死控制,可有类似以下代码:

if(duringChristmas){
   img = redPacketChristmasSkin;
}else if(duringSpringFestival){
   img =  redSpringFestivalSkin;
}

如果到了元宵节的时候,运营小姐姐突然又有想法,红包皮肤换成灯笼相关的,这时候,是不是要去修改代码了,重新发布了?

从一开始接口设计时,可以实现一张红包皮肤的配置表,将红包皮肤做成配置化呢?更换红包皮肤,只需修改一下表数据就好了。

当然,还有一些场景适合一些配置化的参数:一个分页多少数量控制、某个抢红包多久时间过期这些,都可以搞到参数配置化表里面。这也是扩展性思想的一种体现。

16.接口考虑幂等性

接口是需要考虑幂等性的,尤其抢红包、转账这些重要接口。最直观的业务场景,就是用户连着点击两次,你的接口有没有hold住。或者消息队列出现重复消费的情况,你的业务逻辑怎么控制?

回忆下,什么是幂等?

计算机科学中,幂等表示一次和多次请求某一个资源应该具有同样的副作用,或者说,多次请求所产生的影响与一次请求执行的影响效果相同。

大家别搞混哈,防重和幂等设计其实是有区别的。防重主要为了避免产生重复数据,把重复请求拦截下来即可。而幂等设计除了拦截已经处理的请求,还要求每次相同的请求都返回一样的效果。不过呢,很多时候,它们的处理流程、方案是类似的哈。

图片

接口幂等实现方案主要有8种:

  • select+insert+主键/唯一索引冲突
  • 直接insert + 主键/唯一索引冲突
  • 状态机幂等
  • 抽取防重表
  • token令牌
  • 悲观锁
  • 乐观锁
  • 分布式锁

17. 读写分离,优先考虑读从库,注意主从延迟问题

我们的数据库都是集群部署的,有主库也有从库,当前一般都是读写分离的。比如你写入数据,肯定是写入主库,但是对于读取实时性要求不高的数据,则优先考虑读从库,因为可以分担主库的压力。

如果读取从库的话,需要考虑主从延迟的问题。

18.接口注意返回的数据量,如果数据量大需要分页

一个接口返回报文,不应该包含过多的数据量。过多的数据量不仅处理复杂,并且数据量传输的压力也非常大。因此数量实在是比较大,可以分页返回,如果是功能不相关的报文,那应该考虑接口拆分。

19. 好的接口实现,离不开SQL优化

我们做后端的,写好一个接口,离不开SQL优化。

SQL优化从这几个维度思考:

  • explain 分析SQL查询计划(重点关注type、extra、filtered字段)
  • show profile分析,了解SQL执行的线程的状态以及消耗的时间
  • 索引优化 (覆盖索引、最左前缀原则、隐式转换、order by以及group by的优化、join优化)
  • 大分页问题优化(延迟关联、记录上一页最大ID)
  • 数据量太大(分库分表、同步到es,用es查询)

20.代码锁的粒度控制好

什么是加锁粒度呢?

其实就是就是你要锁住的范围是多大。比如你在家上卫生间,你只要锁住卫生间就可以了吧,不需要将整个家都锁起来不让家人进门吧,卫生间就是你的加锁粒度。

我们写代码时,如果不涉及到共享资源,就没有必要锁住的。这就好像你上卫生间,不用把整个家都锁住,锁住卫生间门就可以了。

比如,在业务代码中,有一个ArrayList因为涉及到多线程操作,所以需要加锁操作,假设刚好又有一段比较耗时的操作(代码中的slowNotShare方法)不涉及线程安全问题,你会如何加锁呢?

反例:

//不涉及共享资源的慢方法
private void slowNotShare() {
    try {
        TimeUnit.MILLISECONDS.sleep(100);
    } catch (InterruptedException e) {
    }
}

//错误的加锁方法
public int wrong() {
    long beginTime = System.currentTimeMillis();
    IntStream.rangeClosed(1, 10000).parallel().forEach(i -> {
        //加锁粒度太粗了,slowNotShare其实不涉及共享资源
        synchronized (this) {
            slowNotShare();
            data.add(i);
        }
    });
    log.info("cosume time:{}", System.currentTimeMillis() - beginTime);
    return data.size();
}

正例:

public int right() {
    long beginTime = System.currentTimeMillis();
    IntStream.rangeClosed(1, 10000).parallel().forEach(i -> {
        slowNotShare();//可以不加锁
        //只对List这部分加锁
        synchronized (data) {
            data.add(i);
        }
    });
    log.info("cosume time:{}", System.currentTimeMillis() - beginTime);
    return data.size();
}

21.接口状态和错误需要统一明确

提供必要的接口调用状态信息。比如你的一个转账接口调用是成功、失败、处理中还是受理成功等,需要明确告诉客户端。如果接口失败,那么具体失败的原因是什么。这些必要的信息都必须要告诉给客户端,因此需要定义明确的错误码和对应的描述。同时,尽量对报错信息封装一下,不要把后端的异常信息完全抛出到客户端。

图片

22.接口要考虑异常处理

实现一个好的接口,离不开优雅的异常处理。对于异常处理,提十个小建议吧:

  • 尽量不要使用e.printStackTrace(),而是使用log打印。因为e.printStackTrace()语句可能会导致内存占满。
  • catch住异常时,建议打印出具体的exception,利于更好定位问题
  • 不要用一个Exception捕捉所有可能的异常
  • 记得使用finally关闭流资源或者直接使用try-with-resource
  • 捕获异常与抛出异常必须是完全匹配,或者捕获异常是抛异常的父类
  • 捕获到的异常,不能忽略它,至少打点日志吧
  • 注意异常对你的代码层次结构的侵染
  • 自定义封装异常,不要丢弃原始异常的信息Throwable cause
  • 运行时异常RuntimeException ,不应该通过catch的方式来处理,而是先预检查,比如:NullPointerException处理
  • 注意异常匹配的顺序,优先捕获具体的异常

23. 优化程序逻辑

优化程序逻辑这块还是挺重要的,也就是说,你实现的业务代码,如果是比较复杂的话,建议把注释写清楚。还有,代码逻辑尽量清晰,代码尽量高效。

比如,你要使用用户信息的属性,你根据session已经获取到userId了,然后就把用户信息从数据库查询出来,使用完后,后面可能又要用到用户信息的属性,有些小伙伴没想太多,反手就把userId再传进去,再查一次数据库。。。我在项目中,见过这种代码。。。直接把用户对象传下来不好嘛。。

反例伪代码:

public Response test(Session session){
    UserInfo user = UserDao.queryByUserId(session.getUserId());
    
    if(user==null){
       reutrn new Response();
    }
    
    return do(session.getUserId());
}

public Response do(String UserId){
  //多查了一次数据库
  UserInfo user = UserDao.queryByUserId(session.getUserId());
  ......
  return new Response(); 
}

正例:

public Response test(Session session){
    UserInfo user = UserDao.queryByUserId(session.getUserId());
    
    if(user==null){
       reutrn new Response();
    }
    
    return do(session.getUserId());
}

//直接传UserInfo对象过来即可,不用再多查一次数据库
public Response do(UserInfo user){
  ......
  return new Response(); 
}

当然,这只是一些很小的一个例子,还有很多类似的例子,需要大家开发过程中,多点思考的哈。

24. 接口实现过程中,注意大文件、大事务、大对象

  • 读取大文件时,不要Files.readAllBytes直接读取到内存,这样会OOM的,建议使用BufferedReader一行一行来。
  • 大事务可能导致死锁、回滚时间长、主从延迟等问题,开发中尽量避免大事务。
  • 注意一些大对象的使用,因为大对象是直接进入老年代的,可能会触发fullGC

25. 你的接口,需要考虑限流

如果你的系统每秒扛住的请求是1000,如果一秒钟来了十万请求呢?换个角度就是说,高并发的时候,流量洪峰来了,超过系统的承载能力,怎么办呢?

如果不采取措施,所有的请求打过来,系统CPU、内存、Load负载飚的很高,最后请求处理不过来,所有的请求无法正常响应。

针对这种场景,我们可以采用限流方案。就是为了保护系统,多余的请求,直接丢弃。

限流定义:

在计算机网络中,限流就是控制网络接口发送或接收请求的速率,它可防止DoS攻击和限制Web爬虫。限流,也称流量控制。是指系统在面临高并发,或者大流量请求的情况下,限制新的请求对系统的访问,从而保证系统的稳定性。

可以使用Guava的RateLimiter单机版限流,也可以使用Redis分布式限流,还可以使用阿里开源组件sentinel限流

26.代码实现时,注意运行时异常(比如空指针、下标越界等)

日常开发中,我们需要采取措施规避数组边界溢出,被零整除,空指针等运行时错误。类似代码比较常见:

String name = list.get(1).getName(); //list可能越界,因为不一定有2个元素哈

应该采取措施,预防一下数组边界溢出。正例如下:

if(CollectionsUtil.isNotEmpty(list)&& list.size()>1){
  String name = list.get(1).getName(); 
}

图片

27.保证接口安全性

如果你的API接口是对外提供的,需要保证接口的安全性。保证接口的安全性有token机制和接口签名

token机制身份验证方案还比较简单的,就是

图片

  1. 客户端发起请求,申请获取token。
  2. 服务端生成全局唯一的token,保存到redis中(一般会设置一个过期时间),然后返回给客户端。
  3. 客户端带着token,发起请求。
  4. 服务端去redis确认token是否存在,一般用 redis.del(token)的方式,如果存在会删除成功,即处理业务逻辑,如果删除失败不处理业务逻辑,直接返回结果。

接口签名的方式,就是把接口请求相关信息(请求报文,包括请求时间戳、版本号、appid等),客户端私钥加签,然后服务端用公钥验签,验证通过才认为是合法的、没有被篡改过的请求。

除了加签验签和token机制,接口报文一般是要加密的。当然,用https协议是会对报文加密的。如果是我们服务层的话,如何加解密呢?

可以参考HTTPS的原理,就是服务端把公钥给客户端,然后客户端生成对称密钥,接着客户端用服务端的公钥加密对称密钥,再发到服务端,服务端用自己的私钥解密,得到客户端的对称密钥。这时候就可以愉快传输报文啦,客户端用对称密钥加密请求报文服务端用对应的对称密钥解密报文

有时候,接口的安全性,还包括手机号、身份证等信息的脱敏。就是说,用户的隐私数据,不能随便暴露

28.分布式事务,如何保证

分布式事务:就是指事务的参与者、支持事务的服务器、资源服务器以及事务管理器分别位于不同的分布式系统的不同节点之上。简单来说,分布式事务指的就是分布式系统中的事务,它的存在就是为了保证不同数据库节点的数据一致性。

分布式事务的几种解决方案:

  • 2PC(二阶段提交)方案、3PC
  • TCC(Try、Confirm、Cancel)
  • 本地消息表
  • 最大努力通知
  • seata

29. 事务失效的一些经典场景

我们的接口开发过程中,经常需要使用到事务。所以需要避开事务失效的一些经典场景。

  • 方法的访问权限必须是public,其他private等权限,事务失效
  • 方法被定义成了final的,这样会导致事务失效。
  • 在同一个类中的方法直接内部调用,会导致事务失效。
  • 一个方法如果没交给spring管理,就不会生成spring事务。
  • 多线程调用,两个方法不在同一个线程中,获取到的数据库连接不一样的。
  • 表的存储引擎不支持事务
  • 如果自己try…catch误吞了异常,事务失效。
  • 错误的传播特性

30. 掌握常用的设计模式

把代码写好,还是需要熟练常用的设计模式,比如策略模式、工厂模式、模板方法模式、观察者模式等等。设计模式,是代码设计经验的总结。使用设计模式可以可重用代码、让代码更容易被他人理解、保证代码可靠性。

31. 写代码时,考虑线性安全问题

高并发情况下,HashMap可能会出现死循环。因为它是非线性安全的,可以考虑使用ConcurrentHashMap。所以这个也尽量养成习惯,不要上来反手就是一个new HashMap();

  • Hashmap、Arraylist、LinkedList、TreeMap等都是线性不安全的;
  • Vector、Hashtable、ConcurrentHashMap等都是线性安全的

图片

32.接口定义清晰易懂,命名规范。

我们写代码,不仅仅是为了实现当前的功能,也要有利于后面的维护。说到维护,代码不仅仅是写给自己看的,也是给别人看的。所以接口定义要清晰易懂,命名规范。

33. 接口的版本控制

接口要做好版本控制。就是说,请求基础报文,应该包含version接口版本号字段,方便未来做接口兼容。其实这个点也算接口扩展性的一个体现点吧。

比如客户端APP某个功能优化了,新老版本会共存,这时候我们的version版本号就派上用场了,对version做升级,做好版本控制。

34. 注意代码规范问题

注意一些常见的代码坏味道:

  • 大量重复代码(抽共用方法,设计模式)
  • 方法参数过多(可封装成一个DTO对象)
  • 方法过长(抽小函数)
  • 判断条件太多(优化if…else)
  • 不处理没用的代码
  • 不注重代码格式
  • 避免过度设计

35.保证接口正确性,其实就是保证更少的bug

保证接口的正确性,换个角度讲,就是保证更少的bug,甚至是没有bug。所以接口开发完后,一般需要开发自测一下。然后的话,接口的正确还体现在,多线程并发的时候,保证数据的正确性,等等。比如你做一笔转账交易,扣减余额的时候,可以通过CAS乐观锁的方式保证余额扣减正确吧。

如果你是实现秒杀接口,得防止超卖问题吧。你可以使用Redis分布式锁防止超卖问题。使用Redis分布式锁,有几个注意要点,

36.学会沟通,跟前端沟通,跟产品沟通

我把这一点放到最后,学会沟通是非常非常重要的。比如你开发定义接口时,一定不能上来就自己埋头把接口定义完了需要跟客户端先对齐接口。遇到一些难点时,跟技术leader对齐方案。实现需求的过程中,有什么问题,及时跟产品沟通。

总之就是,开发接口过程中,一定要沟通好~

最后(求关注,别白嫖我)

在这里插入图片描述

👉 更多信息:有任何疑问或者需要进一步探讨的内容,欢迎点击下方文末名片获取更多信息。我是猫头虎博主,期待与您的交流! 🦉💬

🚀 技术栈推荐
GoLang, Git, Docker, Kubernetes, CI/CD, Testing, SQL/NoSQL, gRPC, Cloud, Prometheus, ELK Stack

💡 联系与版权声明

📩 联系方式

  • 微信: Libin9iOak
  • 公众号: 猫头虎技术团队

⚠️ 版权声明
本文为原创文章,版权归作者所有。未经许可,禁止转载。更多内容请访问猫头虎的博客首页

点击下方名片,加入猫头虎领域社群矩阵。一起探索科技的未来,共同成长。

  • 10
    点赞
  • 66
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
中国移动无线城市集中运营服务平台系统项目 详细设计说明书 文档标识: 当前版本: 1.0 当前状态: 草稿 发布日期: 2012-8-28 发布  修改历史 日期 版本 作者 修改内容 评审号 变更控制号 2012-8-28 1.0 拓维 新建 目 录 1 总则 2 1.1 编目的 2 1.2 读者对象 2 1.3 参考文档 2 1.4 术语与缩 2 2 系统概述 2 2.1 模块结构 2 2.2 采用技术 3 3 模块设计 4 3.1 模块1 4 3.2 模块2…… 9 4 模块详细设计 9 4.1 模块1 9 4.2 模块2…… 12 1 总则 1.1 编目的 明确任务和需求,使得软件开发人员知道软件开发流程,软件测试时更有条理 1.2 读者对象 描述该文档的阅读对象。 1.3 参考文档 描述该文档的参考文档。 1.4 术语与缩 描述该文档的术语及解释。 2 系统概述 2.1 模块结构 描述软件系统的总体结构,可以使用结构图、层次分解图或包图来描述,并应说明系统结构划分的原则(例如,基于标准、协议所规定的体系结构,来自于分析模型的方案,或者基于原有体系结构的限制)。 示例: 2.2 采用技术 描述该系统所采用的技术。 示例: 数据ETL采用C++编程技术,经过FtpMain从外围系统抽取数据,Transfer_Main对数据进行清洗,load_data对清洗后的数据进行加载,完成ETL处理过程;前台流程配置界面采用JAVA编程技术,流程调度通过调度控件完成调度控制。 数据处理层(存储层、应用层、访问层)通过DB2存储过程技术实现对数据流的规则定义,通过调度程序完成数据流的流向控制。 最终展现,通过JAVA、JSP、HTML、GIS,视频监控等编程技术完成代码开发,并部署到WEB应用服务器(WebSphere等),主题采用BRIO工具结合WEB页面,地图技术,视频技术进行多维展现。 3 模块设计 按照需求进行模块分析和设计。 3.1 模块1 3.1.1 模块说明 描述该模块的功能,对该模块进行说明。 示例: 实体渠道:提供渠道发展用户分析、业务受理分析、渠道构成分析、资源分析、考核分析,监控和评估渠道的运营状况和管理能力。 如果采用面向对象的设计模式,则可以使用用例图等来说明这些设计类之间如何交互,实现本模块的典型功能。 示例: 用例主要包括购卡支付、购卡冲正、折扣查询、购卡历史记录查询等, 由于采用异步通信方式将支付、冲正分为请求和响应两个子用例。 用例说明: 购卡支付请求:该用例说明用户通过短消息、wap、web等通信接入手段购买卡系统提供的各种卡,以短信为例,用户通过短消息向系统提交购卡指令,系统查询卡类型及金额,如卡类型正确则生成订单消息,并向用户的银行帐号扣款的支付请求。 购卡支付响应:若支付请求返回正确响应,系统查询原订单和交易记录,返回相应的卡号和密码,以短消息形式通知用户;如出现超时或数据库操作异常,系统自动发起冲正请求 3.1.2 模块设计 描述模块设计。可以用流程图表示。 示例: 也可以用类图体现。 【利用Rose工具给出系统的主要类框图,描述系统的静态行为】 示例: 主要类说明 MpcpParseChainBean 包名 com.talkweb.card.buzi 类名 MpcpParseChainBean 父类名 ChainBean 责任描述  XML解析  短信指令解析  消息协议转换(MPCP2SpDeliverMsg->TradeInfo) 协同类 使用MPCP2SpDeliverMsg的unmarshal进行XML的解析; 使用TradeInfo作为内部交易协议; 使用DefaultDAO读取数据库中操作; 使用Log提供日志服务 属性 类型 描述 Logger Log 日志管理器 方法说明 方法名 process() 类型 protected Description 解析MPCP2SpDeliverMsg消息的XMLString转换为内部TradeInfo消息 Input InputMsg Output InputMsg Process  进行XML解析  调用MPCP2Trade()进行消息转换 方法名 MPCP2Trade() 类型 private Description MPCP2SpDeliverMsg消息转换TradeInfo Input MPCP2SpDeliverMsg(MPCP短消息) Output TradeInfo(本地交易报文) Process  调用parseCommand()解析短消息内容  将MPCP短消息转换为本地交易报文 方法名 parseCommand() 类型 private Description 解析短信内容为功能码 Input String(短信内容) Output Int(功能码) BUY_CARD= 100; QUERY_MONEY= 110; QUERY_FACE= 111; QUERY_HIS = 120; REPORT= 130; HELP = 140; UNKNOW_COMMAND= 0; Process 根据短信息内容产生功能码 3.1.3 数据结构 描述该模块对应的数据模型。 3.2 模块2…… 同3.1章节。 4 模块详细设计 4.1 模块1 4.1.1 功能点1 4.1.1.1 功能说明 对该功能点进行描述(比如:新增,修改,删除,查询等功能); 或者对该功能点的具体信息进行描述。 示例: 渠道发展用户日分析: 通过时间、地域、品牌、地理位置类型、排他性等角度分析各类渠道每日新增及离网用户的情况,实现对渠道的整体分析和监控。 支持切片、钻取,旋转等分析操作,以图表形式展现, 能够打印图表,并且能将图,表分别以图片格式,excel格式导出. 4.1.1.2 数据设计 描述后台的数据设计(存储过程)。 A示例(功能点): 存 储 过 程 名: CHLDW.ETL2_CUB_COUNTY_ADD_USER_DAY 分 析 类 型: 主题 结 果 表: CHLWI.CUB_CHL_ADD_USER_DAY 运 行 周 期: 日 调 用 方 式: CALL CHLDW.ETL2_CUB_COUNTY_ADD_USER_DAY (YYYYMMDD,0,999,?); 前 驱: 版 本: 1.0 设 计 人: 需 求 分 析 章 节: 1.5.1 需 求 编 码: WCMN000000001M 变 更 情 况: 统计步骤: 1) 开号用户数:取基础层的用户信息表(CHLODS.ODS_USR_INFO)与基本信息表(chlwi.t_channel_basicinfo)用渠道标志(CHANNEL_ID)关联,根据状态标志STS_ID=18,统计开号用户数量. 2) 销号用户数: 取基础层的用户信息表(CHLODS.ODS_USR_INFO)与基本信息表(chlwi.t_channel_basicinfo)用渠道标志(CHANNEL_ID)关联,根据状态标志STS_ID = 20,统计开号用户数量. 3) 预销号用户数:取基础层的用户信息表(CHLODS.ODS_USR_INFO)与基本信息表(chlwi.t_channel_basicinfo)用渠道标志(CHANNEL_ID)关联,根据状态标志STS_ID IN (19,21),统计开号用户数量. 或采用Sequence图来表示。 示例: 4.1.1.3 界面设计 示例: 主界面: 新增修改界面: 4.1.1.4 接口设计 描述接口。 4.1.2 功能点2….. 同4.1.1章节。 4.2 模块2…… 同4.1章节。
### 回答1: 全栈程序员的成长历程通常包括以下几个步骤: 1. 基础知识学习:包括计算机基础知识、编程语言基础知识、数据结构和算法等。 2. 实践经验积累:通过完成一些小项目或参与开源项目,积累实际开发经验,提升编程能力。 3. 选择一个关注领域:全栈程序员是指能够涉及前端、后端、数据库、运维等多个领域的程序员,因此可以选择一个感兴趣的领域进行深入学习。 4. 加强软件工程和系统设计能力:包括代码规范、版本控制、测试、自动化部署、性能优化等方面的知识和技能。 5. 不断学习和提升:全栈程序员的技术领域非常广泛,因此要不断学习新技术和理解新范式,提升自己的综合能力。 ### 回答2: 一个全栈程序员的成长历程可以说是一个不断学习和成长的过程。 一开始,全栈程序员的技能可能还比较单一,只懂得某一种编程语言或者某一种技术领域。但是随着时间的推移和经验的积累,他们逐渐开始接触到更广泛的技术领域和编程语言。 在成长过程中,全栈程序员开始了解和学习不同的编程语言,如Java、Python、JavaScript等。他们学会了如何使用这些语言开发不同的应用程序,无论是前端还是后端。 同时,全栈程序员也开始了解多种技术框架和开发工具,如Spring、React、Vue等。他们学会了如何使用这些框架来提高开发效率和优化代码结构。 除了编程语言和技术框架,全栈程序员还需要学习其他相关的技能,如数据库管理、网络安全等。他们需要了解如何设计和管理数据库,如何保护应用程序的安全性。 在实践中,全栈程序员也需要积极参与不同的项目,与团队成员合作。通过与其他开发人员的合作,他们可以学到更多的技术知识和项目管理经验。 总结起来,一个全栈程序员的成长历程是一个不断学习和拓展技能的过程。他们从单一的技术领域逐渐扩展到多个领域,从而成为可以独立完成整个应用程序开发的专业人员。通过不断学习和实践,全栈程序员可以不断提升自己的技术水平和职业能力。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

猫头虎

一分也是爱,打赏博主成就未来!

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值