Update RESTfulAPI简明教程.md

DONTWANTTOSLEEP · web-flow · commit 8a49b4d92125 · 2021-01-29T11:29:40.000+08:00
URI Uniform Resource Identifier &#32479;&#19968;&#36164;&#28304;&#26631;&#35782;&#31526;
URL Uniform Resource Locator   &#32479;&#19968;&#36164;&#28304;&#23450;&#20301;&#31526;
diff --git a/docs/system-design/coding-way/RESTfulAPI&#31616;&#26126;&#25945;&#31243;.md b/docs/system-design/coding-way/RESTfulAPI&#31616;&#26126;&#25945;&#31243;.md
@@ -21,7 +21,7 @@ REST,&#21363; **REpresentational State Transfer** &#30340;&#32553;&#20889;&#12290;&#36825;&#20010;&#35789;&#32452;&#30340;&#32763;&#35793;
 
 &#25105;&#20204;&#20998;&#21035;&#23545;&#19978;&#38754;&#28041;&#21450;&#21040;&#30340;&#27010;&#24565;&#36827;&#34892;&#35299;&#35835;&#65292;&#20197;&#20415;&#21152;&#28145;&#29702;&#35299;&#65292;&#19981;&#36807;&#23454;&#38469;&#19978;&#20320;&#19981;&#38656;&#35201;&#25630;&#25026;&#19979;&#38754;&#36825;&#20123;&#27010;&#24565;&#65292;&#20063;&#33021;&#30475;&#25026;&#25105;&#19979;&#19968;&#37096;&#20998;&#35201;&#20171;&#32461;&#21040;&#30340;&#20869;&#23481;&#12290;&#19981;&#36807;&#65292;&#20026;&#20102;&#26356;&#22909;&#22320;&#33021;&#36319;&#21035;&#20154;&#25199;&#25199; &ldquo;RESTful API&rdquo;&#25105;&#24314;&#35758;&#20320;&#36824;&#26159;&#35201;&#22909;&#22909;&#29702;&#35299;&#19968;&#19979;&#65281;
 
-- **&#36164;&#28304;&#65288;Resource&#65289;** &#65306;&#25105;&#20204;&#21487;&#20197;&#25226;&#30495;&#23454;&#30340;&#23545;&#35937;&#25968;&#25454;&#31216;&#20026;&#36164;&#28304;&#12290;&#19968;&#20010;&#36164;&#28304;&#26082;&#21487;&#20197;&#26159;&#19968;&#20010;&#38598;&#21512;&#65292;&#20063;&#21487;&#20197;&#26159;&#21333;&#20010;&#20010;&#20307;&#12290;&#27604;&#22914;&#25105;&#20204;&#30340;&#29677;&#32423; classes &#26159;&#20195;&#34920;&#19968;&#20010;&#38598;&#21512;&#24418;&#24335;&#30340;&#36164;&#28304;&#65292;&#32780;&#29305;&#23450;&#30340; class &#20195;&#34920;&#21333;&#20010;&#20010;&#20307;&#36164;&#28304;&#12290;&#27599;&#19968;&#31181;&#36164;&#28304;&#37117;&#26377;&#29305;&#23450;&#30340; URI&#65288;&#32479;&#19968;&#36164;&#28304;&#23450;&#20301;&#31526;&#65289;&#19982;&#20043;&#23545;&#24212;&#65292;&#22914;&#26524;&#25105;&#20204;&#38656;&#35201;&#33719;&#21462;&#36825;&#20010;&#36164;&#28304;&#65292;&#35775;&#38382;&#36825;&#20010; URI &#23601;&#21487;&#20197;&#20102;&#65292;&#27604;&#22914;&#33719;&#21462;&#29305;&#23450;&#30340;&#29677;&#32423;&#65306;`/class/12`&#12290;&#21478;&#22806;&#65292;&#36164;&#28304;&#20063;&#21487;&#20197;&#21253;&#21547;&#23376;&#36164;&#28304;&#65292;&#27604;&#22914; `/classes/classId/teachers`&#65306;&#21015;&#20986;&#26576;&#20010;&#25351;&#23450;&#29677;&#32423;&#30340;&#25152;&#26377;&#32769;&#24072;&#30340;&#20449;&#24687;
+- **&#36164;&#28304;&#65288;Resource&#65289;** &#65306;&#25105;&#20204;&#21487;&#20197;&#25226;&#30495;&#23454;&#30340;&#23545;&#35937;&#25968;&#25454;&#31216;&#20026;&#36164;&#28304;&#12290;&#19968;&#20010;&#36164;&#28304;&#26082;&#21487;&#20197;&#26159;&#19968;&#20010;&#38598;&#21512;&#65292;&#20063;&#21487;&#20197;&#26159;&#21333;&#20010;&#20010;&#20307;&#12290;&#27604;&#22914;&#25105;&#20204;&#30340;&#29677;&#32423; classes &#26159;&#20195;&#34920;&#19968;&#20010;&#38598;&#21512;&#24418;&#24335;&#30340;&#36164;&#28304;&#65292;&#32780;&#29305;&#23450;&#30340; class &#20195;&#34920;&#21333;&#20010;&#20010;&#20307;&#36164;&#28304;&#12290;&#27599;&#19968;&#31181;&#36164;&#28304;&#37117;&#26377;&#29305;&#23450;&#30340; URI&#65288;&#32479;&#19968;&#36164;&#28304;&#26631;&#35782;&#31526;&#65289;&#19982;&#20043;&#23545;&#24212;&#65292;&#22914;&#26524;&#25105;&#20204;&#38656;&#35201;&#33719;&#21462;&#36825;&#20010;&#36164;&#28304;&#65292;&#35775;&#38382;&#36825;&#20010; URI &#23601;&#21487;&#20197;&#20102;&#65292;&#27604;&#22914;&#33719;&#21462;&#29305;&#23450;&#30340;&#29677;&#32423;&#65306;`/class/12`&#12290;&#21478;&#22806;&#65292;&#36164;&#28304;&#20063;&#21487;&#20197;&#21253;&#21547;&#23376;&#36164;&#28304;&#65292;&#27604;&#22914; `/classes/classId/teachers`&#65306;&#21015;&#20986;&#26576;&#20010;&#25351;&#23450;&#29677;&#32423;&#30340;&#25152;&#26377;&#32769;&#24072;&#30340;&#20449;&#24687;
 - **&#34920;&#29616;&#24418;&#24335;&#65288;Representational&#65289;**&#65306;"&#36164;&#28304;"&#26159;&#19968;&#31181;&#20449;&#24687;&#23454;&#20307;&#65292;&#23427;&#21487;&#20197;&#26377;&#22810;&#31181;&#22806;&#22312;&#34920;&#29616;&#24418;&#24335;&#12290;&#25105;&#20204;&#25226;"&#36164;&#28304;"&#20855;&#20307;&#21576;&#29616;&#20986;&#26469;&#30340;&#24418;&#24335;&#27604;&#22914; json&#65292;xml&#65292;image,txt &#31561;&#31561;&#21483;&#20570;&#23427;&#30340;"&#34920;&#29616;&#23618;/&#34920;&#29616;&#24418;&#24335;"&#12290;
 - **&#29366;&#24577;&#36716;&#31227;&#65288;State Transfer&#65289;** &#65306;&#22823;&#23478;&#31532;&#19968;&#30524;&#30475;&#21040;&#36825;&#20010;&#35789;&#35821;&#19968;&#23450;&#20250;&#24456;&#25077;&#36924;&#65311;&#20869;&#24515; BB&#65306;&#36825;&#23612;&#29595;&#26159;&#21861;&#21834;&#65311; &#22823;&#30333;&#35805;&#26469;&#35828; REST &#20013;&#30340;&#29366;&#24577;&#36716;&#31227;&#26356;&#22810;&#22320;&#25551;&#36848;&#30340;&#26381;&#21153;&#22120;&#31471;&#36164;&#28304;&#30340;&#29366;&#24577;&#65292;&#27604;&#22914;&#20320;&#36890;&#36807;&#22686;&#21024;&#25913;&#26597;&#65288;&#36890;&#36807; HTTP &#21160;&#35789;&#23454;&#29616;&#65289;&#24341;&#36215;&#36164;&#28304;&#29366;&#24577;&#30340;&#25913;&#21464;&#12290;ps:&#20114;&#32852;&#32593;&#36890;&#20449;&#21327;&#35758; HTTP &#21327;&#35758;&#65292;&#26159;&#19968;&#20010;&#26080;&#29366;&#24577;&#21327;&#35758;&#65292;&#25152;&#26377;&#30340;&#36164;&#28304;&#29366;&#24577;&#37117;&#20445;&#23384;&#22312;&#26381;&#21153;&#22120;&#31471;&#12290;
 
@@ -138,4 +138,4 @@ GET    /classes?page=1&size=10 //&#25351;&#23450;&#31532;1&#39029;&#65292;&#27599;&#39029;10&#20010;&#25968;&#25454;
 - [Building REST services with Spring](https://spring.io/guides/tutorials/classmarks/) (Spring &#23448;&#32593; )
 - [An Intro to Spring HATEOAS](https://www.baeldung.com/spring-hateoas-tutorial) &#65288;by [baeldung](https://www.baeldung.com/author/baeldung/)&#65289;
 - [spring-hateoas-examples](https://github.com/spring-projects/spring-hateoas-examples/tree/master/hypermedia)
-- [Spring HATEOAS](https://spring.io/projects/spring-hateoas#learn) (Spring &#23448;&#32593; )
+- [Spring HATEOAS](https://spring.io/projects/spring-hateoas#learn) (Spring &#23448;&#32593; )

-Original file line number
+Diff line change
 我们分别对上面涉及到的概念进行解读，以便加深理解，不过实际上你不需要搞懂下面这些概念，也能看懂我下一部分要介绍到的内容。不过，为了更好地能跟别人扯扯 “RESTful API”我建议你还是要好好理解一下！
 -- **资源（Resource）** ：我们可以把真实的对象数据称为资源。一个资源既可以是一个集合，也可以是单个个体。比如我们的班级 classes 是代表一个集合形式的资源，而特定的 class 代表单个个体资源。每一种资源都有特定的 URI（统一资源定位符）与之对应，如果我们需要获取这个资源，访问这个 URI 就可以了，比如获取特定的班级：`/class/12`。另外，资源也可以包含子资源，比如 `/classes/classId/teachers`：列出某个指定班级的所有老师的信息
 +- **资源（Resource）** ：我们可以把真实的对象数据称为资源。一个资源既可以是一个集合，也可以是单个个体。比如我们的班级 classes 是代表一个集合形式的资源，而特定的 class 代表单个个体资源。每一种资源都有特定的 URI（统一资源标识符）与之对应，如果我们需要获取这个资源，访问这个 URI 就可以了，比如获取特定的班级：`/class/12`。另外，资源也可以包含子资源，比如 `/classes/classId/teachers`：列出某个指定班级的所有老师的信息
 - **表现形式（Representational）**："资源"是一种信息实体，它可以有多种外在表现形式。我们把"资源"具体呈现出来的形式比如 json，xml，image,txt 等等叫做它的"表现层/表现形式"。
 - **状态转移（State Transfer）** ：大家第一眼看到这个词语一定会很懵逼？内心 BB：这尼玛是啥啊？ 大白话来说 REST 中的状态转移更多地描述的服务器端资源的状态，比如你通过增删改查（通过 HTTP 动词实现）引起资源状态的改变。ps:互联网通信协议 HTTP 协议，是一个无状态协议，所有的资源状态都保存在服务器端。
 - [Building REST services with Spring](https://spring.io/guides/tutorials/classmarks/) (Spring 官网 )
 - [An Intro to Spring HATEOAS](https://www.baeldung.com/spring-hateoas-tutorial) （by [baeldung](https://www.baeldung.com/author/baeldung/)）
 - [spring-hateoas-examples](https://github.com/spring-projects/spring-hateoas-examples/tree/master/hypermedia)
 -- [Spring HATEOAS](https://spring.io/projects/spring-hateoas#learn) (Spring 官网 )
 +- [Spring HATEOAS](https://spring.io/projects/spring-hateoas#learn) (Spring 官网 )