边沁与商鞅立法思想之于(二)

前言:两个月无写博客了,我算最便宜了哄。先简单说下我及时半独月开了什么吧。8月26如泣如诉从BIGO离职,回校预备秋招。9月新时常才发觉都错过秋招内推时间,其实秋招内推拿offer是来于生概率的。9月才开上牛客网,平时吧从来不怎么刷题,所以9月投了众多挺商家笔试没了。

三、结论

9月的,学校发生只lianyou科技来开宣讲会,官网也不曾说明实际岗位,直接写IT岗,尼玛,这IT岗也极常见了吧。后来自己要么失去听了,投了前者。一轮子笔试,一轮群面+技术群面(面试官提问题,我们应),最后一轱辘测试(考性格和智慧)。后来去信用社参观了,公司还是发硌国企背景的,一些硬福利真的非常科学。后来坐起重好之offer就非参照lianyou了。拒绝lianyou主要发生少独原因:

(一)边沁与商鞅立法思想的与与差

  1. 工资太没有了,基本工资才6K
  2. 自己实习主要做前端,自己再眷恋干后端,玩玩网站架构啥的(虽然这些本无是充分6)

俺们先行来观察二者立法思想之相同之处。

10月放弃海投了,也达成牛客网刷刷题,开始刷剑指offer。唉,别人都刷完了,我才刚刚开头刷……

第一,边沁和商鞅的琢磨,都是以一如既往种植暴变革的期中出生,并同时回促进了一代改革与进步的沉思。边沁所处之时代,是全人类由于传统社会进步工业社会的很变革时期,而商鞅所处之一代,是中国历史上划时代之“大争之世”,是农奴制度瓦解和中央集权制建立之期。他们之思想,都尽管符合了各自时代的需要。

  10月中旬将到深圳深信服的offer,测试出岗。一轮子技术面,50分钟,聊的坏普遍,简历项目的架构+Linux+python+网络+现场发编程题写代码…..比较重视基础,我现场反响能力或不错的。HR面(刚起还无懂得凡是hr,以为是技术面),就是聊天,我自我感觉超棒的,我归纳能力或得以的。聊了,最后他要和自身握手。

具体来说,边沁和商鞅一样,所处之一世,都是保守势力与改革力量可以斗争的时。边沁看就英国之王法不可知适应时代之需要,既晦涩又蛮,更非吻合安全、平等之求,因而要进行革新,以适应新兴阶级之社会要。他说,旧的法网是适应当下底社会条件要制定的,社会状况都出了变通。旧法律中之多数虽未联合潮流了。1789年,边沁发表著名的《论道与立法的基准》,而当时方法国大革命时代,这为边沁看到了贯彻和谐改革方案的想望。后来,他而于希腊革命者写信抨击君主制,晚年,又帮好友欧文建立新村。他尚收受过相同员勋爵的特邀答应起草一部刑法典。他支持激进派反对辉格党的集会改革方案,成为英国激进派的圣人。边沁以健全阐释功利主义法学的历程被,有力地反驳英国法学家布莱克斯于《英国法释义》中针对英国法制现状所犯的争鸣。此外,由于他多次当团结的做中涉嫌,现有的词汇往往含有比较强的道德评价色彩,很麻烦客观准确地作为立法术语,因此他居然于新生说明了千篇一律效新的法词汇。而以华底春秋战国时期,贵族政治崩坏之结果,一方面为老百姓的解放,一方面也帝的集权。当时切实政治的等同种植倾向,就是由于贵族政治趋于君主专制政治,由人治、礼治趋于法治。因此我们看来,在商君书《更法》篇被,商鞅在秦孝公面前与近旧势力的利害论战,最终商鞅取得了凯。

(内心)我失去,不见面吧,我挂了(春招有个面试官聊完还送我出门,然后就是没然后了……)!?好吧,没打了。最后,他说,老乡。 自我:天呐,真的也!!哈哈。后来作了offer,基本工资9K,一年15w.
9K以深圳竟十分相似的,不过比自己第一只offer多矣3K,也还不易哇。

尽管如此英国底改革在限沁活着的时进行不殊,但当外死去后,英国当19世纪之同多元改革还负他的熏陶。1828年,在讨论刑法改革时,布鲁厄姆告诉下院:“改革时就是是边沁时代。”随之是1832年法规改革草案的颁行,刑法和监狱的改善,济贫法的转移和卫生法的签订……边沁一派对英国普通法的批态度以及针对法典编纂的倡议,促进了英国法例体系之完善,也促进了英国向工业社会之顺风转型。边沁的伦理观和法律观,更为自由民主制度奠定了基础,可以说凡是西欧现代化的前驱。罗巴克在1849年形容道:“边沁的编写引起了平等摆变革。思想习惯焕然一新。整个政论界大都不知激励来自何处,却充满了初精神。”梅因于1875年形容道:“我莫知晓自边沁那时以来实行之法度改革有啊一样码非归功给外的震慑。”[11]及之相呼应之,是商鞅对秦国和后人中国封建社会的丕影响。这当华夏大凡人尽皆知的。前后文已起提及,限于篇幅,对是不再赘述。

  10月之,拿了美图的offer,地点在厦门,岗位是实验室的数码平台支付,基本工资比较深信服高。我打算生个月11月底先过去实习,争取在新春佳节前实习两个月哈哈。因为美图是自我眷恋入职的合作社,所以工资不明说了哈。深圳互联网氛围比厦门好,不过比打测试,我要重新爱好美图的开销岗位。

一样的,正使止沁激烈批评土地贵族把持的上院,指出贵族世袭的议院只象征个别人的功利,违背最酷幸福之功利主义原则,商鞅在他那个时期则抨击世卿世禄的贵族,要求重新制定封爵体制。他们还意味了个别时代之新兴经济势力和社会潮流。

  so,
本渣渣的秋招就此结束啦。接下来一个月份,我来描写一些django
restful相关的博客,目前为时有发生当形容Linux,在服务器这块,一个月份后自己要自己能力应该是一个运维新人,Linux命令基本会awk,shell,grep,sed….也得会多建筑一些劳动django,ngnix….网络来说,目前恰好起看TCP/IP详解,争取实习前看了。数据库这块,之前看了mysql必知必会,最近呢出看高性能mysql,可能会见报个培训班系统深入提高下数据库这块。

以更求证立法意见与经济基础的维系,可以独家选举一个例证。边沁于侵犯国家立即同一近似罪了中,特别规定了贬损人民财富罪。它包括:1、游手好闲。2、违背旨在防止将产业用于不充分盈利而无盈利较多之目的的确定;3、危害富民。而当就底英国,的确通过立法,使用酷刑来严惩失地农民和流浪者。对这无异于状况的详细描述可见于马克思的《资本论》,在部开中不怕分析说,这种立法的目的是为满足工场工业对劳动力的消。同样的,在《商君书》垦令篇中,指出要于重役使那些吃闲饭,不从事生产的人数。这是为为更多的人口失去从事农业生产,增加农业劳动力的由来。

如上,就是自个儿接下的计划!!

边沁看于个体安全限制外,私有财产的护卫是无限中心的。否则,人们的积极就会破产,社会发展会叫阻挡。他认为经济及资产的免一致是免设有的。财产不等同是社会发展之动力,均财会侵犯安全,而同样必须依于安。这就算充分体现了很时期英国新兴资产阶级崛起之渴求。其实英国资产阶级自由主义最先发的星星个理论,就是古典政治经济学与功利主义。由此也堪观看功利主义的秋与阶级性背景。而当华,后期法家也自功利主义出发,认为人既是各“挟自为心”,就应该听那“自为”,使该自由竞争。故反对儒家“平均地权”的力主,认为自由竞争则人全疾作而节用,生产就是见面增多。这虽然体现了即土地私有制的起来。

 

然而咱同样应当认识及,思想会坐一时的成形而深受授予新的解释和内涵。因此不能够停于用边沁的想想简单机械地肯定为随机资本主义的竹签。正如E·博登海默在外的《法理学:法律哲学同法措施》中所说,尽管边沁偏爱经济自由主义,但是他的立宪理论也跟当代社会改革家的考虑中存在着某种联系。A·V·戴西(A·V·Dicey)也已经指出,最可怜幸福原则既好吧那些拥护福利国家之口所运用,也可以吗放任自由主义的崇拜者所动。因此,他的立宪理论也国干预和社会改革开拓了后门。边沁及其徒弟所许的有立法,可以说凡是当这个趋势及翻过了第一步。[12]

理解RESTful架构

愈来愈多之丁起察觉及,网站虽软件,而且是平等栽新颖的软件。

这种”互联网软件”采用客户端/服务器模式,建立以分布式体系上,通过互联网通信,具有高延时(high
latency)、高并发等特征。

网站开发,完全可以软件开发的模式。但是传统上,软件与网络是个别独不等的世界,很少来交集;软件开发主要针对单机环境,网络虽然主要研究体系内的通信。互联网的勃兴,使得这片个世界开始融合,现在我们不能不考虑,如何开发以互联网环境遭受运用的软件。

澳门美高梅手机网站 1

 

RESTful架构,就是当下最盛行的同一种植互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便,所以刚刚获得更为多网站的行使。

不过,到底什么是RESTful架构,并无是一个善说明白的题目。下面,我不怕讨论自己明白的RESTful架构。

下是两岸在实际立法理论及之均等和类。

一、起源

REST这个词,是Roy Thomas
Fielding在他2000年的博士论文备受提出的。

澳门美高梅手机网站 2

Fielding是一个很主要之丁,他是HTTP协议(1.0本及1.1版)的重要设计者、Apache服务器软件的作者有、Apache基金会的率先随便主席。所以,他的当下首论文而刊载,就挑起了关爱,并且这对互联网支付有了远大的影响。

他这么介绍论文的创作目的:

“本文研究计算机是两分外前沿—-软件以及网—-的交叉点。长期以来,软件研究要关注软件设计的归类、设计方的演化,很少客观地评估不同之计划性选择针对性系统作为的影响。而相互反地,网络研究重点关心系统内通信行为的细节、如何改善特定通信机制的见,常常忽视了一个实际,那就算是改应用程序的并行风格比较改变互动协议,对总体表现来重不行之震慑。我当下首文章的创作目的,就是想在合架构原理的前提下,理解以及评估为台网为根基的下软件的架构设计,得到一个效应强、性能好、适宜通信的架。”

(This dissertation explores a junction on the frontiers of two
research disciplines in computer science: software and networking.
Software research has long been concerned with the categorization of
software designs and the development of design methodologies, but has
rarely been able to objectively evaluate the impact of various design
choices on system behavior. Networking research, in contrast, is
focused on the details of generic communication behavior between
systems and improving the performance of particular communication
techniques, often ignoring the fact that changing the interaction
style of an application can have more impact on performance than the
communication protocols used for that interaction. My work is
motivated by the desire to understand and evaluate the architectural
design of network-based application software through principled use of
architectural constraints, thereby obtaining the functional,
performance, and social properties desired of an architecture. )

 

边沁看立法者应当也社会大多数总人口之极其老幸福着想,要分析法律之始末,使之不断改进,以求得人类的惠及。这同商鞅的“治世不齐,便国不法古”可以说凡是不谋而合之。

二、名称

Fielding将他对互联网软件之架构原则,定名为REST,即Representational State
Transfer的缩写。我本着是短语的翻是”表现层状态转化”。

万一一个架构符合REST原则,就称其吧RESTful架构。

设知RESTful架构,最好的计就是是错过了解Representational State
Transfer这个短语到底是呀意思,它的各个一个词代表了啊涵义。如果您将这称谓来明白了,也不怕未难体会REST是千篇一律种植怎样的宏图。

边沁及商鞅的立宪理念,都靠十分显的理性主义作支撑。边沁对英国法的正本清源工作之核心,就是拿普通法“去神秘化”,一如商鞅及门户对先“圣王”等传说所举行的心劲主义的重新诠释。

三、资源(Resources)

REST的名称”表现层状态转化”中,省略了主语。”表现层”其实据的是”资源”(Resources)的”表现层”。

所谓”资源”,就是网络直达的一个实体,或者说是网络上之一个现实信息。它可是一致段落文本、一摆放图、一篇歌、一种植服务,总之就是是一个有血有肉的莫过于。你可据此一个URI(统一资源定位符)指为其,每种资源对应一个一定的URI。要拿走这资源,访问它的URI就可以,因此URI就成为了各个一个资源的地址或独一无二之识别符。

所谓”上网”,就是跟互联网及等同多元之”资源”互动,调用它的URI。

边沁的法典编纂理论,同样与商鞅有着广大共同点。比如边沁主张法典必须备普遍性、严密性,条文要精简明确与联。并道这样的法典,可以使每个人且像律师一样明亮法律。从而使执法变得飞快与简易。而商鞅同样主张法律条文一定要严明而详,一配为非可知损益。同时提出以各种制度向群众普及法律。使法规成为每家每户日常判断是非的科班。

四、表现层(Representation)

“资源”是一模一样种信息实体,它可起多种外在表现形式。我们把”资源”具体表现出的款式,叫做它的”表现层”(Representation)。

依,文本可以用txt格式表现,也堪据此HTML格式、XML格式、JSON格式表现,甚至足以动用二迈入制格式;图片可以为此JPG格式表现,也得以就此PNG格式表现。

URI只代表资源的实体,不意味她的样式。严格地说,有些网址最后的”.html”后缀名是免必要之,因为这个后缀名表示格式,属于”表现层”范畴,而URI应该只是表示”资源”的职位。它的具体表现形式,应该以HTTP请求的条信息中用Accept和Content-Type字段指定,这有限单字段才是本着”表现层”的讲述。

边沁在《法律概要》一写中对法规性的定义,和商鞅也是惊心动魄一致的。边沁说“法律是主权者的如出一辙种命令”,“法律之性与诚的本质得以说凡是错过令,从而法律之言语应该是命令的语言。”[13]此外,边沁主持法律的性能包括普遍性、行为规范性、强制性等。也是简单各项思想下想的相同之处。

五、状态转化(State Transfer)

做客一个网站,就意味着了客户端与服务器的一个互过程。在斯历程遭到,势必涉及到数码及状态的成形。

互联网通信协议HTTP协议,是一个随便状态协议。这意味,所有的状态还保存于服务器端。因此,如果客户端想使操作服务器,必须经某种手段,让服务器端发生”状态转化”(State
Transfer)。而这种转化是起家以表现层以上的,所以就是是”表现层状态转化”。

客户端用到的手段,只能是HTTP协议。具体来说,就是HTTP协议里,四单象征操作方法的动词:GET、POST、PUT、DELETE。它们分别指向承诺季栽基本操作:GET用来博取资源,POST用来新建资源(也堪用来创新资源),PUT用来更新资源,DELETE用来删除资源。

于针对民用伦理的相上,边沁和商鞅都一致,可以给号称“性恶论者”.边下认为人重要是患得患失的,一般倾向于损人利己。并以为人无容许自愿从和团结撞之公共利益,只有借助惩罚才能够好。在就或多或少直达,商鞅也是全然“赞同”的。

六、综述

归纳上面的解释,我们总结一下什么是RESTful架构:

  (1)每一个URI代表一致种资源;

  (2)客户端和服务器之间,传递这种资源的某种表现层;

  (3)客户端通过四独HTTP动词,对劳动器端资源进行操作,实现”表现层状态转化”。

对此作为之分析,法家主张就拘留作用,不看动机,因为于山头看来,人性就是趋利避害,因此动机是不足论的。而功利主义也说,“品行最可怜的口及德最高雅的丁,其行事动机还是如出一辙的。无论什么人且想搭和谐的美满。”

七、误区

RESTful架构有一些超人的筹划误区。

不过广大的一样栽设计不当,就是URI包含动词。因为”资源”表示一致种实体,所以应是名词,URI不应有发生动词,动词应该在HTTP协议被。

举例来说,某个URI是/posts/show/1,其中show是动词,这个URI就设计错了,正确的写法应该是/posts/1,然后用GET方法表示show。

若某些动作是HTTP动词表示未了的,你就该将动作做成一栽资源。比如网上汇款,从账户1向账户2汇款500首先,错误的URI是:

 

1
POST /accounts/1/transfer/500/to/2

科学的写法是拿动词transfer改化名词transaction,资源不克是动词,但是得是千篇一律栽服务:

1
2
3
4
POST /transaction HTTP/1.1
Host: 127.0.0.1
 
from=1&to=2&amount=500.00

其他一个设计误区,就是以URI中加入版本号:

1
2
3
http://www.example.com/app/1.0/foo
http://www.example.com/app/1.1/foo
http://www.example.com/app/2.0/foo

坐不同的本,可以掌握成同一栽资源的不等表现形式,所以应该使用和一个URI。版本号可以于HTTP请求头信息之Accept字段被展开区分(参见Versioning
REST
Services):

1
2
3
Accept: vnd.example-com.foo+json; version=1.0
Accept: vnd.example-com.foo+json; version=1.1
Accept: vnd.example-com.foo+json; version=2.0

*流动,虽说restfull规范建议版本号放在要求头而休是url里,但骨子里为使用方便,大多数开发者还是喜欢拿版本号放在url上,这样好直观区分

  

在犯罪理论上,边沁认为当一个人数作案时,诱惑力决定为诱惑性动机以及偶发性监护动机的出力的于。如果预想得到的裨益超乎危险,诱惑就强。小于危险,诱惑就弱。而商鞅同样觉得,人所以在刑法严厉的情状下为敢于违法,是盖“不必得”,就是勿必然让查获的由来,者长了他的心理预期。

Restful API设计指南

通下自己用介绍RESTful API的筹划细节,探讨如何计划相同模仿合理、好用的API

澳门美高梅手机网站 3

于维系法实践之奖罚理论及,边沁也与商鞅一样,主张少赏,反对滥赏。认为“惩罚可适用于具有人数,应用被有普通场合;奖赏则是以突出目的而用于少数人,且只有行使被突出场合。”而商鞅则提出,重罚轻赏,赏必当其功绩,不妄也。夫重罚则民畏法,轻赏则冀幸之内心绝,故能非常上之业乎。裴松的三国志注引诸葛亮答法正称:“威之以法,法行则知恩。限之以爵,爵加者知荣。”即商君之说呢。

一、协议

API与用户之通信协议,总是采取HTTPs协议。

边沁和商鞅都十分重视“以法为教”的意向。他们大多都觉着惩罚的用意就是标志罪了的辱,鼓励群众对该厌恶之情丝,从而反复灌输相反的惠及习惯与性,为之目的,示众出丑之类的羞辱刑就是不可或缺的。边沁和商鞅还都一律当,道德力量的律是匪确定的、靠不停歇的。因而要兑现法治主义,以法治国。

二、域名

当尽可能以API部署在专用域名之下。

1
https://api.example.com

设确定API很简单,不见面产生更加扩充,可以考虑在主域名下。  

1
https://example.org/api/

刺探了重在的相同之处,我们再度来分析二者的差异。

三、版本(Versioning)

相应将API的版本号放入URL。

1
https://api.example.com/v1/

另一样种做法是,将版本号放在HTTP头信息中,但未苟放入URL方便和直观。Github使这种做法。

边沁及商鞅最酷之例外,在于立法思想及,边沁是私家核心,而商鞅是国中心的。边沁认为社会利益是架空的,是个人利益的总和,个人利益才是唯一现存的益处。如果结合社会之个体是甜美与福的,那么整个国家就幸福和盛之。[14]如商鞅恰好相反,他当只有国家国富民强,民众才能够安全。因此个人是实现方便国强兵的一手。这实质上为是中西方政治哲学的固不同所在。

四、路径(Endpoint)

路线而如”终点”(endpoint),表示API的求实网址。

以RESTful架构中,每个网址代表一律种资源(resource),所以网址中无可知生出动词,只能有名词,而且所用的名词往往与数据库的表格名对应。一般的话,数据库被的表都是同种记录的”集合”(collection),所以API中之名词也理应运用复数。

比方来说,有一个API提供动物园(zoo)的音讯,还连各种动物跟雇员的消息,则它的途径应该设计成为下面这样。

1
2
3
https://api.example.com/v1/zoos
https://api.example.com/v1/animals
https://api.example.com/v1/employees

在立法目的及的从相反,导致在具体立法意见上的好多差距。比如对赏罚的态势,法家认为赏罚是“君之二执掌”。因为人莫不畏诛罚而利庆赏,故君主利用这种思维来治理国家。这体现了派的国家主体。而所谓享受快乐和排除痛苦,边沁和商鞅都觉着是性情之庐山真面目,但边沁认为享受快乐与排痛苦合起来便结成个人的甜。

五、HTTP动词

对资源的具体操作类型,由HTTP动词表示。

常用之HTTP动词有下五单(括号里是应和的SQL命令)。

1
2
3
4
5
GET(SELECT):从服务器取出资源(一项或多项)。
POST(CREATE):在服务器新建一个资源。
PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。
PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性)。
DELETE(DELETE):从服务器删除资源。

再有零星单不常用的HTTP动词。

1
2
HEAD:获取资源的元数据。
OPTIONS:获取信息,关于资源的哪些属性是客户端可以改变的。

脚是有些例。

1
2
3
4
5
6
7
8
GET /zoos:列出所有动物园
POST /zoos:新建一个动物园
GET /zoos/ID:获取某个指定动物园的信息
PUT /zoos/ID:更新某个指定动物园的信息(提供该动物园的全部信息)
PATCH /zoos/ID:更新某个指定动物园的信息(提供该动物园的部分信息)
DELETE /zoos/ID:删除某个动物园
GET /zoos/ID/animals:列出某个指定动物园的所有动物
DELETE /zoos/ID/animals/ID:删除某个指定动物园的指定动物

边沁于对罪过之分类中,也一律体现了外个人核心的立宪思想。他指出侵犯私人的违纪于另地方还承诺遭受世人谴责。就程度而言,甚于半公共罪过,更特别为公共罪过。这种次序,恰好和包括门户在内的华传统观念完全相反。边沁认为个人伦理就是甜美,而立法是吗这个目的服务的。在这基础及外提出了要求立法者恪守本分,不要越界干涉公民自由的力主。一句话,在净土的经文政治伦理中,是因私呢目的,以国家呢手段;而当中国之政伦理中,是坐国家为目的,以私家呢手段。

六、过滤信息(Filtering)

如记录数据很多,服务器无可能都拿其返回给用户。API应该提供参数,过滤返回结果。

下面是局部泛的参数。

1
2
3
4
5
?limit=10:指定返回记录的数量
?offset=10:指定返回记录的开始位置。
?page=2&per_page=100:指定第几页,以及每页的记录数。
?sortby=name&order=asc:指定返回结果按照哪个属性排序,以及排序顺序。
?animal_type_id=1:指定筛选条件

参数的统筹允许在冗余,即许API路径和URL参数偶尔发生更。比如,GET
/zoo/ID/animals 同 GET /animals?zoo_id=ID 的意思是相同的。

边沁和商鞅立法思想的次生异,是用立法学作为对与治术的别。我们明白,商鞅对立法之研讨,及其所有争辩同实行,都是以立法与施法当成君主治理国家的同样栽“治术”,而未是同一帮派有独立性的不错。更讲不达到精确性和体系性了。当然,商鞅早于边沁两千年,我们不能够苛求他当法正确及出差不多异常建树。但事后两千年的华夏,也远非起了审含义及之现代立宪对。这只能说是两栽文化及其学术研究方式的高大差别了。与的异,边沁于1769年得到律师资格后,很快就因为看英国法律缺乏理性基础而厌倦,他欲法律之点规范会起自然科学中得出营养,而未是如18世纪那样吗纯粹的特权、自私和迷信所主宰。边沁的法学研究显示了平栽坚持不懈的现代极力——探求主观现象之量化标准,因而为就是是该“科学”尺度。麦考利都将限沁同伽利略、洛克相提并论,称他吗“使法学从莫名其妙的东西变成对的人口。”[15]布鲁厄姆为曾经针对英国下院说,“在边沁之前,没有任何人可以说凡是管立法当是对待,而这般对待便要的成为了不利。这就是外的卓绝之处在。”[16]边沁还于外的著述中成出一致仿关于他所谓“逻辑虚构”的精细理论,该辩护提出了一样种还原分析法,分析法律权利、责任、义务、信托、权限等等。这居然影响至150年晚罗素勋爵关于逻辑构造、不完全符号和实用主义的主义。

七、状态码(Status Codes)

服务器向用户返回的状态码和提示信息,常见的生以下部分(方括号被凡该状态码对应之HTTP动词)。

1
2
3
4
5
6
7
8
9
10
11
12
200 OK - [GET]:服务器成功返回用户请求的数据,该操作是幂等的(Idempotent)。
201 CREATED - [POST/PUT/PATCH]:用户新建或修改数据成功。
202 Accepted - [*]:表示一个请求已经进入后台排队(异步任务)
204 NO CONTENT - [DELETE]:用户删除数据成功。
400 INVALID REQUEST - [POST/PUT/PATCH]:用户发出的请求有错误,服务器没有进行新建或修改数据的操作,该操作是幂等的。
401 Unauthorized - [*]:表示用户没有权限(令牌、用户名、密码错误)。
403 Forbidden - [*] 表示用户得到授权(与401错误相对),但是访问是被禁止的。
404 NOT FOUND - [*]:用户发出的请求针对的是不存在的记录,服务器没有进行操作,该操作是幂等的。
406 Not Acceptable - [GET]:用户请求的格式不可得(比如用户请求JSON格式,但是只有XML格式)。
410 Gone -[GET]:用户请求的资源被永久删除,且不会再得到的。
422 Unprocesable entity - [POST/PUT/PATCH] 当创建一个对象时,发生一个验证错误。
500 INTERNAL SERVER ERROR - [*]:服务器发生错误,用户将无法判断发出的请求是否成功。

状态码的了列表参见这里。

从想艺术齐吧,二者同发出特别老差异。由于中国的思维相较西方,更富有直觉式的小聪明,而当严密性和体系性上则怀有欠缺。西方对事物更爱好主客二细分,因此对客观也就是钻对象的洞察极尽精致和细腻。而中国更重物我并,从内在而超,因此无以为研究对象啊客体,而重侧重自己经验及智慧之意向。

八、错误处理(Error handling)

假如状态码是4xx,就应有往用户返回出错信息。一般的话,返回的音中将error作为键名,出错信息作键值即可。

1
2
3
{
    error: "Invalid API key"
}

(二)功利主义的评说与针对华底震慑

九、返回结果

对不同操作,服务器向用户返回的结果应抱以下标准。

1
2
3
4
5
6
GET /collection:返回资源对象的列表(数组)
GET /collection/resource:返回单个资源对象
POST /collection:返回新生成的资源对象
PUT /collection/resource:返回完整的资源对象
PATCH /collection/resource:返回完整的资源对象
DELETE /collection/resource:返回一个空文档

第一来说话一讲对功利主义思想之评论。

十、Hypermedia API

RESTful
API最好就Hypermedia,即返结果遭遇提供链接,连于任何API方法,使得用户不查看文档,也了解下一样步该做啊。

本,当用户为api.example.com的绝望目录发出请求,会赢得这么一个文档。

1
2
3
4
5
6
{"link": {
  "rel":   "collection https://www.example.com/zoos",
  "href":  "https://api.example.com/zoos",
  "title""List of zoos",
  "type":  "application/vnd.yourformat+json"
}}

方代码表示,文档中产生一个link属性,用户读取这个特性就掌握下同样步该调用什么API了。rel表示此API与目前网址的涉嫌(collection关系,并受有该collection的网址),href表示API的路子,title表示API的题目,type表示回去路。

Hypermedia
API的筹划被号称HATEOAS。Github的API就是这种规划,访问api.github.com会见获取一个存有可用API的网址列表。

1
2
3
4
5
{
  "current_user_url""https://api.github.com/user",
  "authorizations_url""https://api.github.com/authorizations",
  // ...
}

起者可以看,如果想取得当前用户之信息,应该去做客api.github.com/user,然后就落了脚结果。

1
2
3
4
{
  "message""Requires authentication",
  "documentation_url""https://developer.github.com/v3"
}

点代码表示,服务器被起了提示信息,以及文档的网址。  

功利主义思想在指立法上,的确从至了促进历史前进的企图。但这种思考本身产生没产生缺点和悖论呢?英国名哲学家、逻辑学家罗素以评头论足边沁时说道,“边沁的思想体系中有一致远在明显的落。假如人人总是追求自己之开心,我们怎么能担保立法者要追求一般人的欢快啊?边沁自己之本能的仁慈心使他拘留不显现此题材……他类似是这么想的:通过民主政体,结合适当监督,可以操纵立法者,使得他们只有无自己对一般民众产生因此处才会推进他们之腹心利益。在马上,要给种种民主制度的意图下一个论断,材料是未多的,所以他的乐天也许还情有可原,但是当我们是令人差不多没有感的一代,这种乐观似乎便来硌天真了。”[17]罗素主要的意是报告我们。不同的时日总会对理论本身提出甚至迥然不同之渴求。所以实际的论争但适用于具体的一世,而趁时代的升华变迁,理论就是用发展与转。比如罗素所说的对立法者监督的问题,只是于现代才更换得紧和严重性,假如是当商鞅的不行时代,立法者就是上,君主的裨益就是举国家之补益,那这题目简直连追的必不可少且不曾。

十一、其他

(1)API的身份验证应使用OAuth
2.0框架。

(2)服务器返回的数格式,应该尽量利用JSON,避免采用XML。

  

  

十二、Django rest framework最佳实践

http://www.cnblogs.com/alex3714/articles/7131523.html**   **

  

  

本文转载自 http://www.ruanyifeng.com/blog/2014/05/restful\_api.html   

罗素还当,以边沁为代表的激进主义产生了个别独比其本身更为重要的理论体系,即达尔文主义和社会主义。从边沁到达尔文主义的发展源流是:边沁的政治学与经济学——马尔萨斯人口论——达尔文主义。在达尔文主义的底蕴及,功利主义“本利分析”的德行法,使人们注意让测定个人的社会价值,对社会有比较充分价值的人口,就较其他人得到重新多之功利。这成为社会达尔文主义的滥觞。而社会达尔文主义对中华出了深深的震慑。

有关后者,即罗素认为边沁的功利主义导致社会主义之答辩,笔者觉得是需要谨慎考察的。实际上,功利主义者和社会主义者双方都不以为然这种说法。功利主义思想的意味穆勒就既火爆批评早期社会主义者霍治司金说“他的资产观显得真丑”,甚至是“疯狂之放屁”。而社会主义的高大导师马克思,对边沁的评更看似苛刻。马克思以评头论足边沁及其思想时说,“把社会基金作为一个一定作用程度的固定量……在庸人的鼻祖耶利米·边沁手里,即于十九世纪资产阶级平庸理智的圣哲手里,才建立为机械……效用原则(即功利原则)并无是边沁的发明,他可将爱尔维修和18世纪其他法国丁的谈话重复一下耳。假如我们想知道呀事物对狗发出因此,我们就算必须探索狗的个性。这种本性是匪可知由效益原则被编出来的。”“如果我们怀念把当下无异谱用到肢体上,想冲效益原则来评论人的上上下下行为,运动以及事关等等,就率先使研究人口的相似本性,然后研究于每个时代史地产生了转变的人口的秉性。但是边沁不管这些,他拿现代底市侩,特别是英国的市侩说成是规范的丁。凡是对这种专业的食指与外的社会风气中之事物。本身就是是卓有成效的。他还为此这种规格来评价过去、现在和明天。例如基督教是‘有用之’,因为它们对刑法从法方面所判决的罪过,从宗教方面严格禁止……如果自身出自的朋友亨·海涅那样的胆略,我就是使拿耶利米先生叫资产阶级蠢材中的一个天资。”[18]马克思用如此激烈的言语来评价边沁,并无是为个人偏见或者其他什么来头,而是由他认定边沁是资产阶级思想的意味人,而他要由无产阶级和唯物史观的角度来与批判。马克思主义一般认为,边沁将资产阶级一个阶级之利己本性普遍化为人类的未移本性,把资产阶级一个阶级之生存条件,说成是百分之百社会的生存条件。功利主义伦理把个体追逐私利之竞争作人与人口中间的绝无仅有涉嫌,把自由竞争看作是道的本来面目,以适应英国资本主义自由竞争的社会在方式的要求。这种伦理思想为J·S·密尔直接接轨和提高,19世纪初的空想社会主义者欧文以好几方面也吸取了边沁的道理论,作为他的空想社会主义的德性依据。边沁处在市场经济发展期,市场竞争的重而利益为提升为人口之国王。[19]资产阶级为了履行双重广的自由竞争,把利益原则奉为最高标准,力图将国家制度及追逐私利的任意市场体制协调起来,边沁的要紧志趣和潜移默化是当法网者,而他的伦理思想是也那个法学理论服务的。《立法规则》的要旨,实际上就是是适应市场经济的向上之内需而提出的法度改革的答辩。不管以上意见是否妥善,但最少也有些说明了,即使欧文等丁遭了边沁的必然影响,但为遥谈不齐吃边沁引起与发,而真的具备影响力的马克思的社会主义理论,和边沁更净是简单个不等的系统了。

除去评价之外,更为重要的凡东西方的功利主义对华有的震慑。

华夏家乡的“功利主义者”,即法家学派,他们于战国时期各国改革大潮中奠基的个制度,所行的“以法治国”、郡县制、成文法体系、中央集权制等等,都受新兴中华历代王朝于大势所趋程度上接轨,正使毛泽东所说,“百代表多行秦政法”。当然,法家所行的“法治思维”,本身吗是生良挺局限的。比如法家虽提出保护君权的目的是为执行法治,即“君尊则令行。”但于君权的限制,却绝非提出任何有效之看好。君主不吃法律限制,成为中华社会数千年之弊端。

山头是春秋战国时期反对儒家最为激烈的一个学派,从外表上看,这是“功利主义”与“非功利主义”的创优,但实际,法家认为儒家并非真的的非功利主义,而是同样栽弄虚作假的一干二净高。且又休可知实现富国国强兵这等同乱世最高目标。法家说,在儒家看来,“人全都小口,唯彼君子;术皆贱简,唯彼独尊。学备邪径,唯彼正道。醉心道古,空言欺世,时有急难,束手噤声。深藏毒,竟去以大义,临道乞官,徨若丧家之犬。三日不见君,则该心惴惴,十日非临朝,则拂袖去国。由此观之,私欲利害的心,天下无过儒家为。”
然而不管二者如何拧,“儒法合流”,才是中国两千年的制文化底蕴。由于儒家在政治上主张尊君抑臣,故为专制君主所喜好。但由“治术”手段方法的完善性来说,法家是远远胜给儒家之。能够好皇权实际操作的,是帮派而非儒家。所以,中国历代实际上是“阳儒阴法”或“外儒内法”的。[20]此外,法家的利思想和儒家的正统思想始终以中国底土地及幸存与互相吸收、相互影响,尤其是针对儒家思想本身不同派系的演化起至了要害作用。比如南宋时不时以陈亮、叶适也代表的浙东业绩学派,在当时民族危机之激下,积极倡导研究知识要经世致用,持实用主义立场,反对虚幻的道学和心学,在社会及发十分老影响。在随明末以张溥、张采为首的复社,也一致因为实际尚用,关注社会人生呢号召,而明清关的顾炎武等人,成为经世致用之说的力倡者。及交魏源编纂《皇朝经世文编》,都得见见这种思考的长远。如此重至近代从此的《海国图志》、《天演论》,儒法合流的功利主义成为晚晴中国社会迈向近代化的内在思想动力。

边沁一派之功利主义学说,最早是由戊戌变法之长官人选梁启超介绍及中华底。但是作为西方的功利主义思想以及中国儒法功利主义在中国五洲上之联结,要于19世纪中期,社会达尔文主义传入中华并发出巨大影响到底打。其实以风俗法家看来,一个国度以虚弱而让强国吞并,如同老百姓因为“怠而贫”一样,都是理所当然的工作。这样的观念,加上儒法功利主义的遥远社会影响,使中国格外容易接受斯宾塞的社会达尔文主义。近代以来,在净土功利主义的震慑下,中国考虑本身的转变,简单的话,一凡从经世到富强,二是自义理到时势。其中最为要命之内涵,即凡“注重功利”。冯桂芬就提出“以功利主义为本,以方便国强兵为目的”的口号,东西方功利主义的合流可见一斑。从个体伦理上来说,斯宾塞认为,最美妙之个人应是“快乐人”。追求幸福的最大化,推崇一栽“浮士德精神”。这实际是功利主义在个体伦理方面的初体现和初发展。而当时同一对近代中华出了很深刻的熏陶。

暨了五四时期的中西文化论战,功利主义思想已经于中华社会各个领域产生了全面性的图。彻底颠覆了直以风俗社会面临占有统治地位之“耻谈功利”的正规化儒家思想。所以决定为复兴国粹的杜亚泉《东方杂志》派,就曾经刊登钱智修的《功利主义与学术》等巨额稿子,认为西方文明对中国影响最为老之饶是功利主义,对华夏知识学术事业危害极端酷之也罢是功利主义,故“功利主义不去,则学必无强劲进之望。”[21]

每当五四之后,功利主义在中国想想激进化的过程中居然强烈影响了中华底社会革命。1942年5月,毛泽东在《延安文艺座谈会上的讲话》中即使曾当着之说,人犹是利益的,共产党人同样是功利者。“世界上没有啊超功利主义,在阶级社会里,不是就等同阶级之功利主义,就是那么同样阶级的功利主义。我们是无产阶级的变革之功利主义者。”[22]

总的看,边沁的功利主义学说,不但深刻影响了世道历史之长河,而且深刻影响了华夏之现代化进程。特别是正影响着中国底改造开放,伦理学、法学研究暨思文化建设。

因而程立显先生也《立法法》一修所犯的一律段子序言来开本文的利落吧。当代老牌政治哲学家罗尔斯说,“公正是制度的重大价值。”著名法学家德沃金(Ronald
Dworking)则请求“要认真比权利。”这规范地反映了当代全员意识的着力精神。在追“最酷多数底极致特别幸福”的过程被,如何当立法实践备受落实利益、公正及权利的有机统一?如何使立法原则统一给德原则,以贯彻最佳的社会效果?两百几近年前边下艰苦探索之课题。如今呢突出摆在华夏人面前,要凭咱们的不停揣摩与探索,来谋求一个惬意的答案。

[①]
罗素:《西方哲学史》,上海:商务印书馆,1982年,第357页。

[②]
边沁:《政府片论》,上海:商务印书馆,1995年,第35页。

[③]罗素:《西方哲学史》,上海:商务印书馆,1982年,第361页。

[④]
斯宾诺莎:《神学政治论》,上海:商务印书馆,1982年,第215页。

[⑤]
顾祖禹:《读史方舆纪要》卷一,上海:中华书局,1957年,第116页。

[⑥]
徐爱国:《西方法律思想史》,北京:北京大学出版社,2009年,第256页

[⑦]
Jeremy
Bentham:《论道与立法之标准化》,西安:陕西人民出版社,2008年第1页。

[⑧]
Jeremy
Bentham:《论道和立法之口径》,西安:陕西人民出版社,2008年第58页。

[⑨]
孟德斯鸠:《论法的振奋》,西安:陕西人民出版社,2001年,第105页。

[⑩]
蒋礼鸿:《商君书锥指》,上海:中华书局,1986年,第4页。

[11]
梅为:《宪法早期史讲义》,伦敦:伦敦出版社,1875年,第397页。

[12]
A·V·Dicey,Law and public opinion in England,London,1914,P.303

[13]
边沁:《法律概要》,伦敦:伦敦大学出版社,1970年,第1页。

[14]
E·博登海默:《法理学》,北京:中国政法大学出版社,1998年,第108页。

[15]
特里威廉编:《麦考利全集》,伦敦:伦敦出版社,1860年,第613页。

[16]
布鲁厄姆:《布鲁厄姆演讲集》,伦敦:伦敦出版社,1832年,第291页。

[17]
罗素:《西方哲学史》,上海:商务印书馆,1982年,第362页。

[18]
《马克思恩格斯全集》第二十三卷,北京:人民出版社,1974年第266页。

[19]
《马克思恩格斯全集》第一窝,北京:人民出版社,1972年,第674页。

[20]
冯友兰:《中国哲学史》,重庆:重庆出版社,1930年,第329页。

[21]
郑大华:《民国思想史论》,北京:社会科学文献出版社,2006年,第170页。

[22]
《毛泽东选集》合订本,北京:人民出版社,1994年第866页。

发表评论

电子邮件地址不会被公开。 必填项已用*标注