上网的本质目的
:通过互联网的形式来获取和消费资源
上网过程中,负责存放和对外提供资源
的电脑,叫做服务器。
服务器的本质:就是一台电脑,只不过它的性能要比个人电脑高很多
上网过程中,负责获取和消费资源
的电脑,叫做客户端。
URL(全称是UniformResourceLocator)中文叫统一资源定位符,用于标识互联网上每个资源的唯一存放位置。浏览器只有通过URL地址,才能正确定位资源的存放位置,从而成功访问到对应的资源。
常见的URL举例:
http://www.baidu.com
http://www.taobao.com
http://www.cnblogs.com/
URL地址一般由三部分组成:
注意:
请求–处理–响应
三个步骤。请求–处理–响应
的方式从服务器获取回来的。文字内容、Image图片、Audio音频、Video视频等等
网页中的数据,也是服务器对外提供的一种资源
。例如股票数据、各行业排行榜等。
HTML
是网页的骨架
CSS
是网页的颜值
Javascript
是网页的行为
数据
,则是网页的灵魂
骨架、颜值、行为皆为数据服务数据
,在网页中无处不在
数据,也是服务器对外提供的一种资源。只要是资源,必然要通过请求–处理–响应
的方式进行获取。
如果要在网页中请求服务器上的数据资源,则需要用到 XMLHttpRequest 对象。
XMLHttpRequest(简称xhr)是浏览器提供的js成员,通过它,可以请求服务器上的数据资源。
最简单的用法var xhrObj = new XMLHttpRequest()
客户端请求服务器时,请求的方式有很多种,最常见的两种请求方式分别为 get
和 post
请求。
获取服务端资源
(向服务器要资源)例如:根据 URL 地址,从服务器获取 HTML 文件、css 文件、js文件、图片文件、数据资源等
向服务器提交数据
(往服务器发送资源)例如:登录时向服务器提交的登录信息、注册时向服务器提交的注册信息、添加用户时向服务器提交的用户信息等各种数据提交操作
Ajax的全称是Asynchronous Javascript And XML(异步JavaScript和XML)。
通俗的理解:在网页中利用 XMLHttpRequest 对象和服务器进行数据交互的方式,就是Ajax。
Ajax能让我们轻松实现网页与服务器
之间的数据交互
。
用户名检测:注册用户时,通过Ajax的形式,动态
检测用户名是否被占用
搜索提示:当输入搜索关键词时,通过ajax的形式,
动态加载搜索提示列表
数据分页显示,当点击页码值的时候,通过ajax的形式,
根据页码值动态刷新表格的数据
数据的增删改查:数据的添加、删除、修改、查询操作,都需要通过ajax的形式,来实现数据的交互
浏览器中提供的XMLHttpRequest
用法比较复杂,所以 jQuery 对 XMLHttpRequest 进行了封装,提供了一系列 Ajax 相关的函数,极大地降低了 Ajax 的使用难度
。
jQuery中发起Ajax请求最常用的三个方法如下:
jQuery中$.get()函数的功能单一,专门用来发起get请求,从而将服务器上的资源请求到客户端来进行使用。
$.get() 函数的语法如下:
$.get(url, [data], [callback])
不带参数
的请求使用 $.get() 函数发起不带参数的请求时,直接提供请求的URL地址
和请求成功之后的回调函数
即可,示例代码如下:
$.get('http://www.liulongbin.top:3006/api/getbooks', function(res) {
console.log(res) // 这里的 res 是服务器返回的数据
})
eg:
DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Documenttitle>
<script src="./lib/jquery.js">script>
head>
<body>
<button id="btnGET">发起不带参数的GET请求button>
<script>
$('#btnGET').on('click', function() {
$.get('http://www.liulongbin.top:3006/api/getbooks', function(res) {
console.log(res);
});
})
script>
body>
html>
使用 $.get() 函数发起带参数的请求时,示例代码如下:
$.get('http://www.liulongbin.top:3006/api/getbooks', { id: 1 }, function(res) {
console.log(res)
})
eg:
DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Documenttitle>
<script src="./lib/jquery.js">script>
head>
<body>
<button id="btnGETINFO">发起带参数的GET请求button>
<script>
$(function() {
$('#btnGETINFO').on('click', function() {
$.get('http://www.liulongbin.top:3006/api/getbooks', {id: 1}, function(res) {
console.log(res);
})
})
})
script>
body>
html>
jQuery 中 $.post() 函数的功能单一,专门用来发起 post 请求,从而向服务器提交数据。
$.post() 函数的语法如下:
$.post(url, [data], [callback])
其中,三个参数各自代表的含义如下:
使用$.post()向服务器提交数据的实例代码如下:
$.post(
'http://www.liulongbin.top:3006/api/addbook', // 请求的URL地址
{ bookname: '水浒传', author: '施耐庵', publisher: '上海图书出版社' }, // 提交的数据
function(res) { // 回调函数
console.log(res)
}
)
eg:
DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Documenttitle>
<script src="./lib/jquery.js">script>
head>
<body>
<button id="btnPOST">发起POST请求button>
<script>
$(function() {
$('#btnPOST').on('click', function() {
$.post('http://www.liulongbin.top:3006/api/addbook', {bookname: '水浒传', author: '施耐庵', publisher: '天津图书出版社'}, function(res) {
console.log(res);
})
})
})
script>
body>
html>
相比于 $.get() 和 $.post() 函数,jQuery 中提供的 $.ajax() 函数,是一个功能比较综合的函数,它允许我们对 Ajax 请求进行更详细的配置。
$.ajax() 函数的基本语法如下:
$.ajax({
type: '', // 请求的方式,例如 GET 或 POST
url: '', // 请求的 URL 地址
data: { },// 这次请求要携带的数据
success: function(res) { } // 请求成功之后的回调函数
})
使用 $.ajax() 发起 GET 请求时,只需要将 type 属性的值设置为 ‘GET’ 即可:
$.ajax({
type: 'GET', // 请求的方式
url: 'http://www.liulongbin.top:3006/api/getbooks', // 请求的 URL 地址
data: { id: 1 },// 这次请求要携带的数据
success: function(res) { // 请求成功之后的回调函数
console.log(res)
}
})
eg:
DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Documenttitle>
<script src="./lib/jquery.js">script>
head>
<body>
<button id="btnGET">发起GET请求button>
<script>
$(function() {
$('#btnGET').on('click', function() {
$.ajax({
type: 'GET',
url: 'http://www.liulongbin.top:3006/api/getbooks',
data: {
id: 1
},
success: function(res) {
console.log(res);
}
})
})
})
script>
body>
html>
使用$.ajax()发起的POST请求时,只需要将type属性
的值设置为'POST'
即可
$.ajax({
type: 'POST', // 请求的方式
url: 'http://www.liulongbin.top:3006/api/addbook', // 请求的 URL 地址
data: { // 要提交给服务器的数据
bookname: '水浒传',
author: '施耐庵',
publisher: '上海图书出版社'
},
success: function(res) { // 请求成功之后的回调函数
console.log(res)
}
})
使用 Ajax 请求数据时,被请求的 URL 地址,就叫做数据接口(简称接口)。同时,每个接口必须有请求方式。
例如:
http://www.liulongbin.top:3006/api/getbooks 获取图书列表的接口(GET请求)
http://www.liulongbin.top:3006/api/addbook 添加图书的接口(POST请求)
好处
:接口测试工具能让我们在不写任何代码
的情况下,对接口进行调用
和测试
。
VSCode可以安装插件Postcode
3. 了解PostMan界面的组成部分
PostMan界面的组成部分,从上到下,从左到右,分别是:
步骤:
步骤:
eg:向http://www.liulongbin.top:3006/api/addbook发起POST请求添加图书
什么是接口文档
接口文档,顾名思义就是接口的说明文档,它是我们调用接口的依据
。好的接口文档包含了对接口URL
,参数
以及输出内容
的说明,我们参照接口文档就能方便的知道接口的作用,以及接口如何进行调用。
接口文档的组成部分
接口文档可以包含很多信息,也可以按需进行精简,一个合格的接口文档,应该包含以下6项内容,从而为接口的调用提供依据:
接口名称
:用来标识各个接口的简单说明,如登录接口,获取图书列表接口等。
接口URL
:接口的调用地址。
调用方式
:接口的调用方式,如 GET 或 POST。
参数格式
:接口需要传递的参数,每个参数必须包含参数名称、参数类型、是否必选、参数说明这4项内容。
响应格式
:接口的返回值的详细描述,一般包含数据名称、数据类型、说明3项内容。
返回示例(可选):通过对象的形式,例举服务器返回数据的结构。
接口文档示例
用到的css库 bootstrap.css
用到的javascript库 jquery.js
用到的vs code插件 Bootstrap 3 Snippets
function getBookList() {
// 1. 发起 ajax 请求获取图书列表数据
$.get('http://www.liulongbin.top:3006/api/getbooks', function(res) {
// 2. 获取列表数据是否成功
if (res.status !== 200) return alert('获取图书列表失败!')
// 3. 渲染页面结构
var rows = []
$.each(res.data, function(i, item) { // 4. 循环拼接字符串
rows.push('' + item.id + ' ' + item.bookname + ' ' + item.author + ' ' + item.publisher + ' 删除 ')
})
$('#bookBody').empty().append(rows.join('')) // 5. 渲染表格结构
})
}
// 1. 为按钮绑定点击事件处理函数
$('tbody').on('click', '.del', function() {
// 2. 获取要删除的图书的 Id
var id = $(this).attr('data-id')
$.ajax({ // 3. 发起 ajax 请求,根据 id 删除对应的图书
type: 'GET',
url: 'http://www.liulongbin.top:3006/api/delbook',
data: { id: id },
success: function(res) {
if (res.status !== 200) return alert('删除图书失败!')
getBookList() // 4. 删除成功后,重新加载图书列表
}
})
})
// 1. 检测内容是否为空
var bookname = $('#bookname').val()
var author = $('#author').val()
var publisher = $('#publisher').val()
if (bookname === '' || author === '' || publisher === '') {
return alert('请完整填写图书信息!')
}
// 2. 发起 ajax 请求,添加图书信息
$.post(
'http://www.liulongbin.top:3006/api/addbook',
{ bookname: bookname, author: author, publisher: publisher },
function(res) {
// 3. 判断是否添加成功
if (res.status !== 201) return alert('添加图书失败!')
getBookList() // 4. 添加成功后,刷新图书列表
$('input:text').val('') // 5. 清空文本框内容
}
)
DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Documenttitle>
<link rel="stylesheet" href="./lib/bootstrap.css">
<script src="./lib/jquery.js">script>
head>
<body style="padding: 15px;">
<div class="panel panel-primary">
<div class="panel-heading">
<h3 class="panel-title">添加新图书h3>
div>
<div class="panel-body form-inline">
<div class="input-group">
<div class="input-group-addon">书名div>
<input type="text" class="form-control" id="iptBookname" placeholder="请输入书名">
div>
<div class="input-group">
<div class="input-group-addon">作者div>
<input type="text" class="form-control" id="iptAuthor" placeholder="请输入作者">
div>
<div class="input-group">
<div class="input-group-addon">出版社div>
<input type="text" class="form-control" id="iptPublisher" placeholder="请输入出版社">
div>
<button id="btnAdd" class="btn btn-primary">添加button>
div>
div>
<table class="table table-bordered table-hover">
<thead>
<tr>
<th>Idth>
<th>书名th>
<th>作者th>
<th>出版社th>
<th>操作th>
tr>
thead>
<tbody id="tb">
tbody>
table>
<script>
$(function() {
// 获取图书列表的数据
function getBookList() {
$.get('http://www.liulongbin.top:3006/api/getbooks', function(res) {
if (res.status !== 200) return alert('获取数据失败!');
var rows = [];
$.each(res.data, function(i, item) {
rows.push('' + item.id +' ' + item.bookname +' ' + item.author +' ' + item.publisher +' + item.id +'">删除 ')
})
$('#tb').empty().append(rows.join(''));
})
}
getBookList();
// a标签是后来渲染上去的,要用代理
// $('.del').on('click', function() {
// console.log(ok);
// })
// 通过代理的方式为动态添加的元素绑定点击事件
$('tbody').on('click', '.del', function() {
var id = $(this).attr('data-id');
$.get('http://www.liulongbin.top:3006/api/delbook', {id: id}, function(res) {
if (res.status !== 200) return alert('删除图书失败');
getBookList();
})
});
$('#btnAdd').on('click', function() {
var bookname = $('#iptBookname').val().trim();
var author = $('#iptAuthor').val().trim();
var publisher = $('#iptPublisher').val().trim();
if (bookname.length < 0 || author.length <= 0 || publisher.length <= 0) {
return alert('请填写完整的图书信息!');
}
$.post('http://www.liulongbin.top:3006/api/addbook', {
bookname: bookname, author: author, publisher: publisher}, function(res) {
if (res.status != 201) return alert('添加图书失败!');
getBookList();
$('#iptBookname').val('');
$('#iptAuthor').val('');
$('#iptPublisher').val('');
})
})
})
script>
body>
html>
实现步骤:
向聊天区域中追加内容时,调用resetui()就可以让滚动条到最底部的位置
// 为发送按钮绑定点击事件处理函数
$('#btnSend').on('click', function () {
var text = $('#ipt').val().trim() // 获取用户输入的内容
if (text.length <= 0) { // 判断用户输入的内容是否为空
return $('#ipt').val('')
}
// 将用户输入的内容显示到聊天窗口中
$('#talk_list').append(' ' + text + ' ')
resetui() // 重置滚动条的位置
$(‘#ipt’).val('') // 清空输入框的内容
// TODO: 发起请求,获取聊天消息
})
function getMsg(text) {
$.ajax({
method: 'GET',
url: 'http://www.liulongbin.top:3006/api/robot',
data: {
spoken: text
},
success: function (res) {
if (res.message === 'success') {
var msg = res.data.info.text
$('#talk_list').append(' ' + msg + ' ')
resetui()
// TODO: 发起请求,将机器人的聊天消息转为语音格式
}
}
})
}
function getVoice(text) {
$.ajax({
method: 'GET',
url: 'http://www.liulongbin.top:3006/api/synthesize',
data: {
text: text
},
success: function (res) {
// 如果请求成功,则 res.voiceUrl 是服务器返回的音频 URL 地址
if (res.status === 200) {
$('#voice').attr('src', res.voiceUrl)
}
}
})
}
<audio src="" id="voice" autoplay style="display: none;">audio>
// 让文本输入框响应回车事件后,提交消息
$('#ipt').on('keyup', function (e) {
// e.keyCode 可以获取到当前按键的编码
if (e.keyCode === 13) {
// 调用按钮元素的 click 函数,可以通过编程的形式触发按钮的点击事件
$('#btnSend').click()
}
})
最后代码放在资源里面