API接口与resftul API区别 api接口和接口的区别

转载

互联网小墨风 2024-04-19 16:11:16

文章标签 API接口与resftul API区别接口 java HTTP 服务器 文章分类 架构后端开发

一、前言：

API作为应用程序编程接口，（API：Application Program Interface），可以使用不同的编程语言进行API的开发
API 与图形用户接口（GUI）或命令接口有着鲜明的差别：API 接口属于一种操作系统或程序接口，而后两者都属于直接用户接口。

二、按照接口表现形式，分类

API接口与resftul API区别 api接口和接口的区别_java

三、其他区别：

（1）把socket和http、webservices等等放在一起对比不是很合适，所谓http等的都是对socket进行了一次包装而已，socket更加底层。

（2）不过Web Service接口和HTTP接口存在一些细小区别就是，Web Service接口支持更复杂的对象，而HTTP接口更多的就是传输字符串或者JSON文本。

四、四种类型：

API接口与resftul API区别 api接口和接口的区别_接口_02

五、按照接口访问形式，分类：

API接口与resftul API区别 api接口和接口的区别_API接口与resftul API区别_03

六、http接口、api接口、RPC接口、RMI、webservice、Restful等概念

1. http接口:基于HTTP协议的开发接口.这个并不能排除没有使用其他的协议。

特点

Http协议是建立在TCP协议基础之上的，当浏览器需要从服务器获取网页数据的时候，会发出一次Http请求。Http会通过TCP建立起一个到服务器的连接通道，当本次请求需要的数据完毕后，Http会立即将TCP连接断开，这个过程是很短的。所以Http连接是一种短连接，是一种无状态的连接。

HTTP协议的主要特点可概括如下：
	1.支持客户/服务器模式。
	2.简单快速：客户向服务器请求服务时，只需传送请求方法和路径。请求方法常用的有GET、HEAD、POST。每种方法规定了客户与服务器联系的类型不同。由于HTTP协议简单，使得HTTP服务器的程序规模小，因而通信速度很快。
	3.灵活：HTTP允许传输任意类型的数据对象。正在传输的类型由Content-Type加以标记。
	4.无连接：无连接的含义是限制每次连接只处理一个请求。服务器处理完客户的请求，并收到客户的应答后，即断开连接。采用这种方式可以节省传输时间。
	5.无状态：HTTP协议是无状态协议。无状态是指协议对于事务处理没有记忆能力。缺少状态意味着如果后续处理需要前面的信息，则它必须重传，这样可能导致每次连接传送的数据量增大。另一方面，在服务器不需要先前信息时它的应答就较快。

url 格式

在WWW上，每一信息资源都有统一的且在网上唯一的地址，该地址就叫URL（Uniform Resource Locator,统一资源定位符），它是WWW的统一资源定位标志，就是指网络地址。HTTP协议工作于客户端-服务端架构之上。浏览器作为HTTP客户端通过URL向HTTP服务端即WEB服务器发送所有请求。Web服务器根据接收到的请求后，向客户端发送响应信息。

URL由三部分组成：资源类型、存放资源的主机域名、资源文件名。
URL的一般语法格式为(带方括号[]的为可选项)：
	protocol :// hostname[:port] / path / [;parameters][?query]#fragment

http://blog.sina.com.cn/s/blog_537ad6610102xtb1.html?tj=hist
1、协议部分，代表页面使用的是http协议，在Internet中可以使用多种协议，如HTTP，FTP等等。在"HTTP"后面的“//”为分隔符；
2、域名部分，blog.sina.com.cn，也可以使用IP地址作为域名使用如：192.168.55.14:8080，其中8080为端口，域名和端口之间使用“:”作为分隔符。端口不是一个URL必须的部分，如果省略端口部分，将采用默认端口80/tcp；
3、虚拟目录部分，从域名后的第一个“/”开始到最后一个“/”为止，是虚拟目录部分。虚拟目录也不是一个URL必须的部分。本例中的虚拟目录是“/s/”
4、文件名部分：从域名后的最后一个“/”开始到“？”为止，是文件名部分，如果没有“?”,则是从域名后的最后一个“/”开始到“#”为止，是文件部分，如果没有“？”和“#”，那么从域名后的最后一个“/”开始到结束，都是文件名部分。本例中的文件名是“blog_537ad6610102xtb1.html”。文件名部分也不是一个URL必须的部分，如果省略该部分，则使用默认的文件名
5、锚部分：从“#”开始到最后，都是锚部分。锚部分也不是一个URL必须的部分（可以理解为定位）
6、参数部分：从“？”开始到“#”为止之间的部分为参数部分，又称搜索部分、查询部分。本例中的参数部分为“7.参数部分：从“？”开始到“#”为止之间的部分为参数部分，又称搜索部分、查询部分。本例中的参数部分为“boardID=5&ID=24618&page=1”。参数可以允许有多个参数，参数与参数之间用“&”作为分隔符。”。参数可以允许有多个参数，参数与参数之间用“&”作为分隔符。

2.api接口:API（Application Programming Interface）应用程序编程接口，应用也包括网络应用程序，就像api文档基本上就是使用说明书，API接口可以简单理解成“应用程序使用接口”。

3. RPC接口：Remote Procedure Calls 远程过程调用 (RPC) 是一种协议，程序可使用这种协议向网络中的另一台计算机上的程序请求服务。由于使用 RPC 的程序不必了解支持通信的网络协议的情况，因此 RPC 提高了程序的互操作性。在 RPC 中，发出请求的程序是客户程序，而提供服务的程序是服务器。 RPC（远程过程调用）是一项广泛用于支持分布式应用程序（不同组件分布在不同计算机上的应用程序）的技术。RPC 的主要目的是为组件提供一种相互通信的方式，使这些组件之间能够相互发出请求并传递这些请求的结果。没有语言限制。

4. RMI：RMI（Remote Method Invocation，远程方法调用）RMI是针对于java语言的， RMI 允许您使用Java编写分布式对象

5.Webservice接口：Webservice是系统对外的接口，比如你要从别的网站或服务器上获取资源或信息，别人肯定不会把数据库共享给你，他只能给你提供一个他们写好的方法来获取数据，你引用他提供的接口就能使用他写好的方法，从而达到数据共享的目的。

发送报文：
<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:web=“http://WebXml.com.cn/”>
< soapenv:Header/>
< soapenv:Body >
< web:getSupportCity >
< !–Optional: -->
< web:byProvinceName >北京</web:byProvinceName>
</web:getSupportCity>
</soapenv:Body>
</soapenv:Envelope>

返回报文：
<soap:Envelope xmlns:soap=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=“http://www.w3.org/2001/XMLSchema”>
< soap:Body >
< getSupportCityResponse xmlns=“http://WebXml.com.cn/”>
< getSupportCityResult>
< string>北京 (54511)
< string>上海 (58367)
< string>天津 (54517)
< string>重庆 (57516)
< /getSupportCityResult>
< /getSupportCityResponse>
< /soap:Body>
< /soap:Envelope>

1、根元素：Envelope。

2、Header元素：:不是强制出现，由程序员控制，主要用于携带一些额外的信息，比如用户名、密码

3、Body:调用正确，body元素内容应该遵守WSDL要求的格式。

6.RESTful ： 简称 REST,是描述了一个架构样式的网络系统，其核心是面向资源，REST专门针对网络应用设计和开发方式，以降低开发的复杂性，提高系统的可伸缩性。

6.1REST提出设计概念和准则为：

1.网络上的所有事物都可以被抽象为资源(resource)

2.每一个资源都有唯一的资源标识(resource identifier)，对资源的操作不会改变这些标识

3.所有的操作都是无状态的

6.2 如果记录数量很多，服务器不可能都将它们返回给用户，API会提供参数，过滤返回结果，常见的参数有：

(1). ?limit=20：指定返回记录的数量为20；

(2). ?offset=8：指定返回记录的开始位置为8；

(3). ?page=1&per_page=50：指定第1页，以及每页的记录数为50；

(4). ?sortby=name&order=asc：指定返回结果按照name属性进行升序排序；

(5). ?animal_type_id=2：指定筛选条件。

6.3 格式：1、/模块/资源/{标示}/集合1/..