json入门 如何写好API接口文档?
如何写好API接口文档?
日常项目开发的过程中,接口文档是必不可少的。后端工程师与前端工程师之间需要接口文档来定义数据传输协议、系统对外暴露接口需要文档来说明、系统之间相互调用需要文档来记录接口协议等等。对于一个完整的项目,接口文档是至关重要的。那我们如何写好一份接口文档呢?今天就让我们说一说接口文档几个重要的要素。
1、接口概述接口概述主要说明本接口文档涉及到的业务功能点,面向的阅读对象以及接口文档主要包括哪些业务的接口,可以让读者有一个直观的认识。如:本文档定义了中台系统面向外部接入方的数据协议接口,主要包括:用户注册接口、同步用户、授权认证等接口。适合阅读的对象为接入中台开发者或者外部合作方…。这样的一段描述,对于阅读者来说可以对整个接口文档有一个大概的认识。
2、权限说明有的接口调用需要授权认证,在这部分需要进行说明。如果接口只是基于分配的tok
你是如何学习Java的?
给您推荐Java学习路线图,是菊厂童鞋做开发经常使用的一些技术和工具,希望能帮助到您~
前端部分:
1)HTML:网页的核心语言,构成网页的基础
2)CSS:使网页更加丰富多彩灿烂的利器
3)JavaScript:使网页动起来的根本,加强了网页和用户之间的交互
4)HTML DOM:换一种更加形象化的角度来看待网页,让我们更方便的控制网页
5)HTML BOM:与浏览器交互不可或缺的工具。
6)JavaScript库,主要有:jQuery及其插件,YUI及其插件,这是一个让编写网页更加方便、快捷、健壮的强大工具。
AJAX:异步提交增强了用户体验。;在使用网页方面有很好的交互体验。
8)JSON:比XML更小、更快、更容易解析的数据传输工具。
9)FLEX:提供丰富多彩的动画效果。
10)通用工作流:帮助用户更清晰地处理业务流程之上的工作。
11)JSP:servlet的显示层,将网页逻辑的显示与网页设计分开。
12)JSTL:加强和简化了JSP页面的开发。
13)EL:让JSP页面更容易编写。
背景部分:
1)Java编程基础部分:丰富的内容是Java知识架构的核心和基础。
2)JDBC:提供了一个基准,通过它可以构建更高级的工具和接口,使Java开发人员能够编写数据库应用程序。
3)JavaMail:用于电子邮件的相关编程工作。
4)JUnit:单元测试,整个工作测试的地位总是很重要的。
5)Log4j:它使我们能够更详细地控制日志生成过程。
6)servlet:Java web的核心
7)Struts 2:Java Web编程中的星级框架,有很多优点,让编程更简单,主要用于控制跳转。
8)Spring:Java Web编程中的星级框架,同样具有优势,通用性强,编程更简单,主要用于管理对象。
9)ibatis:Java web编程中的星级框架,同样具有通用性强的优点,让编程变得更简单。它主要用于程序和数据库之间的交互。
10)SQL:与数据库交互编程的必备工具。
版本控制:
1)SVN:版本控制,便于团队协同工作。
WEB服务器:
1)Tomcat:优秀的免费中小型WEB服务器。
2)WEBlogic:强大的Web服务器。
开发工具:
1)Eclipse:开源的强大的Java编程工具。
2)Myeclipse:基于eclipse及其自带插件的强大企业级集成开发环境。
数据库:
1)Oracle:数据库行业老大,这个共同点当然是只是一些常用的功能,需要加强。
2)MySQL:最好的关系数据库之一。
3)SqlServer:最好的关系数据库之一。
数据库客户端:
1)Toad:出色的数据库客户端软件。
操作系统:
1)Windows
2)Linux
远程登录的会话工具:
1)SSH:一直用,不是。往往还不错
其他:
各种种类和版本的浏览器(推荐FireFox),办公软件系列,各种文字编辑器(推荐Sublime),各种阅读器等等。
下面是在网上找到的三张图,更好的说明了作为Java程序员的学习路线图。作为自我提醒的工具,时不时看看,快速修复自己的知识树!
的知识架构
开发的基础学习路线图。
开发的成长路线图
第一部分:Java高级学习课程大纲
1、项目。
我们的工程项目有五大内容:Maven、Nexus、jenkins、代码评审、Git/SVN。
总共需要一个月。
2.源代码分析专题
源代码分析主要有三个内容:spring源代码分析,包括FactoryBean和MVC,Spring源代码中的事务处理和设计模式分析;持久层;企业级发展前瞻,总共耗时2个月。
3.高并发和高性能
高并发高性能有四大内容:并发编程,包括有线程序安全和NIO、AIO。异步通信,包含本地队列和消息中间件。分布式协调技术,包括Zookeeper和服务锁。NoSqI:包含MongoDB和Redis和Memcached。一共花了2个月。
4.高可用性和可扩展性
高可用性和可扩展性有两大内容:分布式架构介绍,包括分流技术、服务设计和存储设计。服务调用,包含WebService和Dubbo。一共花了2个月。
5.性能优化
性能优化有四大内容:优化技巧和如何发现性能瓶颈。JVM优化。数据库优化。服务器优化。一共花了2个月。
以上五个话题是几位大牛用十几年的时间写的。;工作经验。根据自己的工作经验和前几年的经验以及科技发展的实际情况,花了几个月的时间来编写。换句话说,以上五个题目是他们对过去十年精华的总结。现在只要按照上面的题目去学习,只需要七个多月的时间,就能学会和理解几个大牛十几年总结出来的精髓。得知这些,你还怕公司老板不给你加薪升职吗?
第二部分:分阶段学习
学什么都一样,相信大家都一样。在学习东西的时候,我们总会安排好自己的阶段性学习,从而有效的提升自己,有效的理解和认知所学的东西。合理的安排可以事半功倍。
第一阶段:
第二阶段:
第三阶段:
第四阶段:
第五阶段:
版权声明:本文内容由互联网用户自发贡献,本站不承担相关法律责任.如有侵权/违法内容,本站将立刻删除。