restful优缺点？

一、restful优缺点？

写一下我对restful的理解，最近换工作面试的时候有问到我restful api的东西，工作中以前很多项目也是webapi + js前台控件的形式构建系统。实际上感觉restful太“理想化”,用起来不是特别顺手, 举例说明下：

先看看什么叫restful：

REST的名称"表现层状态转化"中，省略了主语。"表现层"其实指的是"资源"（Resources）的"表现层"。

所谓"资源"，就是网络上的一个实体，或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的实在。你可以用一个URI（统一资源定位符）指向它，每种资源对应一个特定的URI。要获取这个资源，访问它的URI就可以，因此URI就成了每一个资源的地址或独一无二的识别符。

客户端用到的手段，只能是HTTP协议。具体来说，就是HTTP协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。它们分别对应四种基本操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源。

GET /tickets # 获取ticket列表

GET /tickets/12 # 查看某个具体的ticket

POST /tickets # 新建一个ticket

PUT /tickets/12 # 更新ticket 12.

DELETE /tickets/12 #删除ticekt 12

实际上呢，不是所有的东西都是“资源”，尤其是在业务系统中，缺点如下：

有个接口是更新订单状态，你是用上面的GET POST PUT DELETE 哪个呢，看样子应该是PUT，但是路径呢PUT /tickets/12

我有时候多个接口 ，更新订单收款状态，更新订单支款状态，更新订单结算状态；

Restful 的路径明显不友好不够用；

比如，Resuful要求 GET /tickets # 获取ticket列表 。我们曾经有个需求，对方会把不超过1000个订单id传给我们，我们系统过滤其中一部分特殊订单；这也是个查询服务，用GET /tickets # 获取ticket列表的形式，1000个订单id显然是超过GET url长度的，这里也不合适；再者，我想开发多个条件查询列表服务，路径这么浅显然不合适；

实际业务中，我们webapi的路径是这样的：systemAlias/controller/action

总结下规则：

简单查询尽量用GET，好处是可以直接带查询参数copy api路径；

复杂查询和更新用POST，用的最多；

不用PUT和DELETE，原因是增加复杂度，并没有带来什么好处

看看BAT的很多openapi，也是写着restful，实际没有严格遵守，都是get和post，这是也很多人不知道put和delete的原因

二、restful 设计原则？

RESTful设计原则（不同公司具体细节可能不同）：

在接口命名时应该用名词，不应该用动词，因为通过接口操作到是资源。

在url中加入版本号，利于版本迭代管理更加直观

https://www.rgc.com/v1/

对于资源的操作类型应该是通过http动词表示。

GET /zoos：列出所有动物园

POST /zoos：新建一个动物园

GET /zoos/ID：获取某个指定动物园的信息

PUT /zoos/ID：更新某个指定动物园的信息（提供该动物园的全部信息）

DELETE /zoos/ID：删除某个动物园

GET /zoos/ID/animals：列出某个指定动物园的所有动物

DELETE /zoos/ID/animals/ID：删除某个指定动物园的指定动物

排序规则：默认时升序，‘-’为降序;多个排序规则时以逗号间隔组合。使用sort查询参数限制

GET /tickets?sort=-time,created_at

优先以time倒序显示，其次以created_at正序显示

限制返回值的字段域：明确指定输出字段列表，用于控制网络带宽和速度。使用fields查询参数来限制。

GET /tickets?fileds=id,subject,customer_name,time&sort=-time

返回参数列表为id,subject,customer_name,time，并且以time字段倒序显

HTTP Method分别对于资源的CURD操作

GET（SELECT）：从服务器取出资源（一项或多项）。

POST（CREATE）：在服务器新建一个资源。

PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）。

PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性）。

DELETE（DELETE）：从服务器删除资源。

保证 POST，PUT，DELETE,PATCH，GET 操作幂等性。

使用SSL(Secure Sockets Layer 安全套接层)

参数和url采用蛇行命名方式。如：updated_time

服务器请求和返回的数据格式，应该尽量使用JSON，避免使用XML。在 request中的Accept和Response中的Content-Type:application/json

三、restful架构详解？

restful即表象层状态转变。

restful七大原则:

1. C-S架构

数据的存储在Server端，Client端只需使用就行。两端彻底分离的好处使client端代码的可移植性变强，Server端的拓展性变强。两端单独开发，互不干扰。 

2. 无状态

http请求本身就是无状态的，基于C-S架构，客户端的每一次请求带有充分的信息能够让服务端识别。

请求所需的一些信息都包含在URL的查询参数、header、body，服务端能够根据请求的各种参数，无需保存客户端的状态，将响应正确返回给客户端。

无状态的特征大大提高的服务端的健壮性和可拓展性。 

当然这总无状态性的约束也是有缺点的，客户端的每一次请求都必须带上相同重复的信息确定自己的身份和状态，造成传输数据的冗余性，但这种确定对于性能和使用来说，几乎是忽略不计的。 

3.统一的接口

这个才是REST架构的核心，统一的接口对于RESTful服务非常重要。客户端只需要关注实现接口就可以，接口的可读性加强，使用人员方便调用。 

4.一致的数据格式

服务端返回的数据格式要么是XML，要么是Json，或者直接返回状态码，有兴趣的可以看看博客园的开放平台的操作数据的api，post、put、patch都是返回的一个状态码 。 

5.系统分层

客户端通常无法表明自己是直接还是间接与端服务器进行连接，分层时同样要考虑安全策略。 

6.可缓存

在万维网上，客户端可以缓存页面的响应内容。因此响应都应隐式或显式的定义为可缓存的，若不可缓存则要避免客户端在多次请求后用旧数据或脏数据来响应。

管理得当的缓存会部分地或完全地除去客户端和服务端之间的交互，进一步改善性能和延展性。 

7.按需编码、可定制代码（可选）

服务端可选择临时给客户端下发一些功能代码让客户端来执行，从而定制和扩展客户端的某些功能。

比如服务端可以返回一些 Javascript 代码让客户端执行，去实现某些特定的功能。

四、如何使用RESTful接收JSON数据

在Web开发中，RESTful API 的使用越来越普遍。通过RESTful API，客户端可以使用HTTP请求对服务器资源进行操作，而且JSON作为数据交换格式也变得越来越流行。本文将为您介绍如何使用RESTful接收JSON数据。

什么是RESTful API？

RESTful是一种软件架构风格，它是一组架构约束和原则的集合。它利用现有的，可靠的应用层协议，如HTTP，实现了客户端和服务器之间的交互。RESTful API通常使用GET、POST、PUT、DELETE等HTTP方法来实现对资源的操作。

为什么使用JSON作为数据交换格式？

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，易于阅读和编写。它已成为RESTful API中最常用的数据格式之一，因为它能够很好地表示复杂的数据结构，同时在不同编程语言和平台之间的兼容性也很好。

如何在RESTful API中接收JSON数据？

要在RESTful API中接收JSON数据，首先需要确保服务器端的接口已经实现了对应的接收方法。通常来说，一个标准的RESTful API使用POST方法来接收JSON数据，而且请求的Content-Type需要设置为application/json。

在服务端代码中，需要解析HTTP请求中的JSON数据，并根据业务逻辑进行处理。在大多数流行的后端框架中，都有对JSON数据进行解析和处理的相关库或工具，例如在Node.js中可以使用body-parser中间件，而在Java Spring框架中则可以使用@RequestBody注解。

JSON数据接收的最佳实践

为了确保JSON数据在RESTful API中能够被正确接收和处理，有一些最佳实践可以帮助开发者更好地设计和实现接口。

• 验证数据：在接收到JSON数据后，务必进行数据格式和有效性的验证，避免因无效数据导致的错误。
• 错误处理：在接收和处理JSON数据的过程中，要考虑到各种可能出现的错误情况，如数据格式错误、网络中断等，合理处理这些错误。
• API文档：及时更新API文档，明确指明JSON数据的接收格式、字段含义和可能的返回结果，以便客户端开发者正确使用接口。

总结

通过本文的介绍，相信您已经了解了在RESTful API中如何接收JSON数据，并且掌握了一些最佳实践。合理地使用RESTful接收JSON数据，能够使服务端和客户端更好地进行数据交互，提升整体的开发效率和用户体验。

感谢您阅读本文，希望本文能够帮助您更好地理解和应用RESTful接收JSON数据的知识。

五、grpc和restful区别？

grpc和restful的区别在于它们的通信协议和数据传输方式不同。grpc和restful在通信协议和数据传输方式上有所区别。grpc是一种高性能、跨语言的远程过程调用（RPC）框架，它使用了二进制的协议缓冲区（Protocol Buffers）作为数据交换格式，并使用HTTP/2作为底层的传输协议。而restful是一种基于HTTP协议的软件架构风格，它使用了常见的HTTP方法（GET、POST、PUT、DELETE等）和URL来进行数据传输。grpc相比于restful具有更高的性能和更小的数据传输量。由于grpc使用了二进制的协议缓冲区，可以更高效地序列化和反序列化数据，从而减少了网络传输的开销。另外，grpc还支持双向流式传输，可以实现更复杂的通信模式。而restful相对简单易用，更适合于简单的数据传输和对外开放的API接口。因此，在选择通信协议和数据传输方式时，需要根据具体的需求和场景来进行选择。

六、rpc和restful区别？

面对对象不同：

RPC 更侧重于动作。

REST 的主体是资源。

RESTful 是面向资源的设计架构，但在系统中有很多对象不能抽象成资源，比如登录，修改密码等而 RPC 可以通过动作去操作资源。所以在操作的全面性上 RPC 大于 RESTful。

传输效率：

RPC 效率更高。RPC，使用自定义的协议，对传输的数据进行二进制压缩，可以让请求报文体积更小，或者使用 HTTP2 协议，也可以很好的减少报文的体积，提高传输效率。

复杂度：

RPC 实现复杂，流程繁琐。

REST 调用及测试都很方便。

RPC 实现需要实现编码，序列化，网络传输等。而 RESTful 不要关注这些，RESTful 实现更简单。

灵活性：

HTTP 相对更规范，更标准，更通用，无论哪种语言都支持 HTTP 协议。

RPC 可以实现跨语言调用，但整体灵活性不如 RESTful。

总结

RPC 主要用于公司内部的服务调用，性能消耗低，传输效率高，实现复杂。

HTTP 主要用于对外的异构环境，浏览器接口调用，App 接口调用，第三方接口调用等

七、RESTful Web服务支持JSON格式的数据

什么是RESTful Web服务？

RESTful Web服务是一种基于HTTP协议的架构风格，用于在系统之间传输数据。它采用轻量级的JSON（JavaScript Object Notation）格式来传输信息，JSON格式是一种常用的数据交换格式，经常被用于Web应用程序中。

为什么使用JSON格式？

JSON格式具有很多优点，包括：

• 易于阅读和编写：JSON使用简单的键值对结构，易于理解和处理。
• 数据体积小：相对于其他格式，JSON的数据体积较小，可以减少网络传输的负担。
• 与Web前端兼容：JSON格式与JavaScript语言高度兼容，可以轻松地在Web前端应用程序中使用。

如何实现RESTful Web服务支持JSON格式的数据？

要实现RESTful Web服务支持JSON格式的数据，需要遵循以下步骤：

1. 选择合适的编程语言和框架：根据自己的需求和技术栈选择合适的编程语言和框架来开发RESTful Web服务。
2. 定义API端点：确定API的URL和支持的HTTP方法，例如GET、POST、PUT和DELETE。
3. 处理HTTP请求：在Web服务中，根据API端点处理来自客户端的HTTP请求。
4. 使用JSON格式进行数据交换：获取请求参数，处理业务逻辑，并将结果封装为符合JSON格式的数据返回给客户端。

示例：使用Java和Spring Boot创建RESTful Web服务支持JSON格式的数据

以下是一个使用Java和Spring Boot框架创建RESTful Web服务支持JSON格式的数据的示例：

  
  // 定义Controller
  @RestController
  @RequestMapping("/api")
  public class ApiController {
  
    // 处理GET请求
    @GetMapping("/data")
    public ResponseEntity<Object> getData() {
      // 处理业务逻辑，并封装结果为JSON格式的数据
      Object data = ...;
      
      // 返回JSON格式的数据
      return ResponseEntity.ok(data);
    }
  
    // 处理POST请求
    @PostMapping("/data")
    public ResponseEntity<Object> createData(@RequestBody Object requestData) {
      // 处理业务逻辑，并封装结果为JSON格式的数据
      Object data = ...;
      
      // 返回JSON格式的数据
      return ResponseEntity.ok(data);
    }
  
    // 其他HTTP方法的处理类似
  }
  
  

总结

RESTful Web服务可以支持JSON格式的数据，这样可以在系统之间实现快速、轻量级的数据传输。使用JSON格式的数据交换可以提供良好的兼容性和扩展性，同时也可以减少网络传输的负担。通过适当选择编程语言和框架，再结合定义API端点和处理HTTP请求的步骤，我们可以创建出满足需求的RESTful Web服务支持JSON格式的数据。

感谢您阅读本文，希望本文对您理解RESTful Web服务支持JSON格式的数据有所帮助。

八、Java实现RESTful API并处理JSON数据

背景介绍

随着互联网应用的不断发展，RESTful API已经成为构建Web服务的一种重要方式。在Java开发中，我们经常需要处理JSON数据来实现与客户端的数据交互。本文章将介绍如何使用Java构建RESTful API，并对JSON数据进行处理。

什么是RESTful API

RESTful API是一种设计理念，用于构建能够满足客户端需求的可伸缩网络应用程序。它使用HTTP协议的GET、POST、PUT和DELETE方法来进行资源的访问和操作。

Java构建RESTful API

Java提供了多种框架和库，用于构建RESTful API。其中，最常用的是Spring框架。Spring提供了丰富的功能和易于使用的注解，使得构建RESTful API变得简单和高效。

处理JSON数据

在RESTful API的开发中，JSON是一种常用的数据格式。Java提供了多种方式来处理JSON数据，包括手动操作JSON对象和使用第三方库，如Jackson和Gson。

手动操作JSON对象需要我们自己处理JSON的序列化和反序列化过程。这种方式灵活性较高，但也较为繁琐。

相比之下，使用Jackson和Gson等第三方库能够更方便地进行JSON数据的处理。它们提供了丰富的API和注解，能够自动完成对象与JSON的转换，大大简化了开发工作。

使用实例

以下是一个使用Java构建RESTful API并处理JSON数据的简单实例：

@RestController
@RequestMapping("/api")
public class UserController {
    
    @Autowired
    private UserService userService;
    
    @GetMapping("/users")
    public List getUsers() {
        return userService.getUsers();
    }
    
    @PostMapping("/users")
    public User addUser(@RequestBody User user) {
        return userService.addUser(user);
    }
    
    @GetMapping("/users/{id}")
    public User getUser(@PathVariable int id) {
        return userService.getUser(id);
    }
    
    // 其他方法省略...
}
    

在上述示例中，我们使用Spring框架构建了一个UserController，处理与用户相关的请求。通过使用@RestController和@RequestMapping注解，我们将方法映射到相应的URL路径上。

在GET请求的处理方法中，我们通过调用UserService的方法返回用户列表。而在POST请求的处理方法中，我们通过使用@RequestBody注解将请求体中的JSON数据转换为User对象，并将其添加到用户列表中。

在URL路径中包含的{id}，我们可以通过使用@PathVariable注解来获取对应的参数值。

总结

本文介绍了如何使用Java构建RESTful API，并对JSON数据进行处理。通过使用Spring框架和第三方库，我们能够快速实现一个功能完善的API，与客户端进行数据交互。

感谢您阅读本文，希望对您有所帮助。

九、flask restful框架是什么？

flask restful

在flask基础上进行一些封装，主要用于实现restful接口

十、restful和soap的区别？

SOAP(Simple Object Access Protocol)简单对象访问协议，是基于HTTP的一种异构系统通信的协议，说白了就是xml文档传输，之所以会有它，就是在于不同语言C,C++,JAVA等语言开发的系统进行通信，是WebService就是基于SOAP协议的，确实是一种比较传统的SOA解决方案。

REST(Rerepresentational State Transfer)是外国一位博士提出的一种架构风格，从资源状态转换角度看待资源，但也是基于SOAP协议进行通信。rest 是一种风格 restful Webservice 和 soap的区别在于表现形式不一样，如果想深入了解 可以去开开 深入理解Webservice 这本书，restful Webservice 不只是可以用json 也可以用xml 更可以用html做消息返回， rest 风格的Webservice 和传统的soap 主要的表现在于 rest是将资源暴露 soap是暴露操作 。

具体的流程其实和soap是一样的，但是rest更方便，更轻。