java开发api接口如何编写 后端开发完接口才给出接口文档,合理吗?你怎么看?
后端开发完接口才给出接口文档,合理吗?你怎么看?
一个非常好的问题。我是一个web应用程序架构师,多年来一直致力于回答这个问题。欢迎跟我来了解更多。
后端提供接口文档为时已晚,这是合理和不合理的。根据具体情况,总有解决办法。让我谈谈我的观点。
不合理:成熟的技术团队重视功能设计,在编写代码之前有完整的技术文档和功能定义。即使在TDD测试驱动的开发模式下,测试数据已经准备好了,那么接口逻辑就已经确定了接口文档是否编写好了,理清它们是很自然的。
-第一,主观原因。原因是多方面的,比如赶进度,没有时间,不懒得写,甚至在开发前没有仔细设计,在做的时候也有变化。真的没有好办法。
-客观原因:需求在变化,功能在变化,接口也在变化。所以,如果你写了一个文件,它的自然更新和维护?天哪?
有解决方案吗?建议尝试:[1]swagger接口文档,将文档集成到代码中,集成维护文档和修改代码,在修改代码逻辑的同时方便修改文档描述。
2、邮递员界面测试工具,导入导出JSON文件,高效的团队合作。Postman支持各种请求方法和配置环境变量,对返回的结果进行测试和验证,支持批量自动操作,可与自动构建系统集成。
java业务逻辑,写在哪里比较好?
现在很多公司的开发人员都应该采用MVC架构。
MVC是所谓的模型、视图、控制器。
每一层都有明确的分工。
对于简单的项目,不管nignx如何,网关通常都会将请求从前端发送到后端,首先发送到控制器,然后发送到服务层,然后发送到Dao层。
这里的服务层就是所谓的业务层,专门负责业务处理操作,而Dao层则负责处理数据库,将数据库中的数据带回服务,经过服务处理后返回控制器层。控制器通过视图解析器解析页面,并通过浏览器呈现页面。
基本上,我认为答案是显而易见的。也就是说,Java业务逻辑是在服务层编写的。
事实上,服务层涉及接口和接口实现。
在编写代码时,我们通常为控制器定义一个调用接口。
实际上,服务接口的实现类应该是编写业务逻辑的地方。
当然,许多公司可能有多个服务层,例如,有一个管理层继续对数据进行特殊的业务处理。这里只是一个简单的概述。
每个公司的每个项目根据其自身业务可能有不同的体系结构。但本质是一样的。
综上所述,业务逻辑必须作为一个独立的层来处理,这样便于扩展和维护。记住不要在控制器中编写所有业务逻辑。
每一层都有自己的分工,是捏合在一起的。代码不仅冗长,而且杂乱无章。
好吧,我希望我的回答能帮助你
!如果你有兴趣,可以关注一下,一起学习交流!
java开发api接口如何编写 java编写webapi接口 java开发rest接口实例
版权声明:本文内容由互联网用户自发贡献,本站不承担相关法律责任.如有侵权/违法内容,本站将立刻删除。