RESTful服务的版本管理经验 (转)

【RESTful服务的版本管理经验 (转)】的更多相关文章

RESTful服务的版本管理经验 (转)

原文:RESTful服务的版本管理经验最近,Howard Dierking将在设计NuGet API的下一个主要修订版(v3)时新学到的经验,与他在大约一年前的观念做了对比,并写道:使用服务器驱动的内容协商,但借助与备选版本和表示格式的链接来提升响应能力,从而让客户端根据其需要选择访问哪个URI. 通过对带有重要扩展需求的真实应用API,以及若干不同客户端进行对比,Howard发现在他最初的想法中,过多地相信了服务器驱动内容协商的保证.而现在他发现,这会把客户端过多地交道了服务器手中:客户端能…

Jersey 2 + Maven + Tomcat + IntelliJ IDEA 搭建RESTful服务

本文参考以下内容: [1] Starting out with Jersey & Apache Tomcat using IntelliJ [2] [Jersey]IntelliJ IDEA + Maven + Jetty + Jersey搭建RESTful服务感谢两位作者. 网上很多文章都是用Jersey 1 搭建的,不能用Jersey 2的新特性,在此我分享一种Jersey 2的搭建方法. 0. 创建新项目在IntelliJ中创建新项目,选择Java Enterprise -> RE…

XData -–无需开发、基于配置的数据库RESTful服务，可作为移动App和ExtJS、WPF/Silverlight、Ajax等应用的服务端

XData -–无需开发.基于配置的数据库RESTful服务,可作为移动App和ExtJS.WPF/Silverlight.Ajax等应用的服务端源起一个App项目,Web服务器就一台,已经装了管理系统(ASP.NET Web MVC),因此要求App的服务端也采用微软.NET技术.经历(小试)了raw SQL.EF.最终采用了XData(斯人云:传来传去都是JSON,搞得那么复杂干嘛). 从Remoting到WCF再到ASP.NET Web API2,从RPC过渡到REST,构建Http…

weblogic 10.x 上开发restful服务

之前已经学习过利用JAX-RS快速开发RESTful 服务,当时是jboss环境,如果原封不动的迁移到weblogic 10.x 版本,会杯具的发现应用启动失败,需要做些小调整: 项目结构如下: 需要在原来的Rest Service(本文中是MyService.java)外,再包装一层,创建一个Application的子类,本例中是 MyApplication.java,代码如下: package yjmyzz.service; import java.util.HashSet; import…

使用Spring Security Oauth2完成RESTful服务password认证的过程

摘要:Spring Security与Oauth2整合步骤中详细描述了使用过程,但它对于入门者有些重量级,比如将用户信息.ClientDetails.token存入数据库而非内存.配置过程比较复杂,经过几天时间试验终于成功,下面我将具体的使用Spring Security Oauth2完成password认证的过程记录下来与大家分享. 关键字: HTTP Authentication, rest, spring security, spring mvc …

应用Spring MVC发布restful服务是怎样的一种体验

摘要:“约定优于配置”这是一个相当棒的经验,SOAP服务性能差.基于配置.紧耦合,restful服务性能好.基于约定.松耦合,现在我就把使用Spring MVC发布restful服务的过程同大家分享.代码之优雅.过程之简单.编码之愉快,不是发布SOAP服务所能匹敌的. 关键字:java, rest, webservice, spring mvc 前提:IntelliJ IDEA (13.1.5 版本), apache maven (3.2.3 版本…

使用多种客户端消费WCF RestFul服务(四)——Jquery篇

Jquery篇互联网开发中少不了各类前端开发框架,其中JQUERY就是最流行之一,本篇我们就采用JQUERY来消费WCF RestFul服务,其中用到JSON基础知识,如果有想了解的朋友,请访问:<使用Jquery解析Json基础知识>. 开发工具:Microsoft Visual Studio 2013(仅仅只是为了F5) 版本:jQuery JavaScript Library v1.4.2 另用到jquery-json 扩展库下载地址在这里:http://code.google.co…

RESTful 服务架构风格 * .NET的RESTful框架 OpenRasta

REST 的约束采用的就是掌控 Web 的基本原则.这些原则是: 用户代理与资源交互,任何可命名和表达的事物都可称为资源.每项资源都有一个唯一的统一资源标识符 (URI). 与资源的交互(通过其唯一的 URI 定位)使用 HTTP 标准动词(GET.POST.PUT 和 DELETE)的统一接口完成.交互中声明资源的媒体类型也很重要,它使用 HTTP 内容类型标头指定.(XHTML.XML.JPG.PNG 和 JSON 就是一些广为人知的媒体类型.) 资源是自我描述的.处理资源请求所需的全部信息…

在ASP.NET Core Web API中为RESTful服务增加对HAL的支持

HAL(Hypertext Application Language,超文本应用语言)是一种RESTful API的数据格式风格,为RESTful API的设计提供了接口规范,同时也降低了客户端与服务端接口的耦合度.很多当今流行的RESTful API开发框架,包括Spring REST,也都默认支持HAL规范,当RESTful API被调用后,服务端就会返回ContentType为application/hal+json的JSON内容,例如: { "_links": { "…

RESTful服务最佳实践

本文主要读者引言 REST是什么统一接口基于资源通过表征来操作资源自描述的信息超媒体即应用状态引擎(HATEOAS) 无状态可缓存 C-S架构分层系统按需编码(可选) REST快速提示使用HTTP动词表示一些含义合理的资源名 XML和JSON 创建适当粒度的资源考虑连通性定义幂等性安全 HTTP动词 GET PUT POST PUT和POST的创建比较 DELETE 资源命名资源URI示例资源命名的反例复数返回表征资源通过链接的可发现性(HATEOAS续)…

jersey2.26+spring5+jpa一步步搭建restful服务

前言首先,为什么想选择Jersey做restful服务呢?我个人比较喜欢它的插件化设计,可以方便的注入自己的全局处理逻辑.再一个就是可以生成wadl描述文件,供查询服务方法.所以在学习spring的过程中,特意抽时间做了jersey+spring集成的验证.在本次搭建的过程中,为了在jersey服务中启动spring事务,从网上查阅了不少.先是看到com.sun.jersey例子,后来发现版本比较低,后转过头去看org.glassfish.jersey.吭吭哧哧服务启动了,却又发现无法通过sp…

我们必须要知道的RESTful服务最佳实践

看过很多RESTful相关的文章总结,参齐不齐,结合工作中的使用,非常有必要归纳一下关于RESTful架构方式了,RESTful只是一种架构方式的约束,给出一种约定的标准,完全严格遵守RESTful标准并不是很多,也没有必要.但是在实际运用中,有RESTful标准可以参考,是十分有必要的. 实际上在工作中对api接口规范.命名规则.返回值.授权验证等进行一定的约束,一般的项目api只要易测试.足够安全.风格一致可读性强.没有歧义调用方便我觉得已经足够了,接口是给开发人员看的,也不是给普通用户去调…

jersey+maven构建restful服务

一.新建一个Maven Web项目 a) 新建一个简单的Maven项目 b) 将简单的Maven项目转成Web项目 (若没出现further configuration available--或里面的内容不是context相关设置,将Dynamic Web Module版本调高一些试试就自动出现了) 二.修改pom文件,添加jersey依赖 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="htt…

用 NetBeans 快速开发 Java JAX-RS RESTful 服务

有很多IDE可以开发Java RESTful服务,Eclipse.NetBeans等,个人偏好使用NetBeans,本文介绍使用NetBeans开发的入门步骤. <理解RESTful架构>.<RESTful API 设计指南>.<RESTful API 设计最佳实践>这三篇文章是介绍RESTful架构比较经典的文章,推荐对RESTful有兴趣的可以读一下. 我也整理的阅读笔记在GitHub上:https://github.com/yulongyz/Reading/blo…

REST，Web 服务，REST-ful 服务

介绍 REpresentational State Transfer (REST) 是一种架构原则,其中将 web 服务视为资源,可以由其 URL 唯一标识.RESTful Web 服务的关键特点是明确使用 HTTP 方法来表示不同的操作的调用. REST 的基本设计原则对典型 CRUD 操作使用 HTTP 协议方法: POST - 创建资源 GET - 检索资源 PUT – 更新资源 DELETE - 删除资源 REST 服务的主要优势在于: 它们是跨平台 (Java..net.PHP 等)高…

[转]移动互联网应用技术架构简介-Restful服务

Restful是基于网络的软件系统架构风格.其优先考虑分布性和扩展性,而不是安全.错误处理.对象映射. 所以Restful架构特别适用的场合为用户快速增长的互联网和移动互联网领域,看起来很容易理解,以资源,资源的表示,资源的状态转移为核心概念. 不过实际在实现Restful服务的时候,仍然有一些应用陷阱,部分是由于Restful本身不是强制性约束,而只是风格建议, 部分是由于开发者对Restful的一知半解乃至曲解所导致. 把一个系统的Restful APIs设计简洁得体,让使用者舒服,并遵循一…

【msdn】RESTful 服务（配备 WCF）介绍

原文地址:http://msdn.microsoft.com/zh-cn/magazine/dd315413.aspx RESTful 服务(配备 WCF)介绍 Jon Flanders 代码下载位置:MSDN 代码库在线浏览代码目录了解 REST 抽象示例您为什么应关注 REST? WCF 和 REST WebGetAttribute 和 WebInvokeAttribute UriTemplate 和 UriTemplateTable WebHttpBinding…

实战SpringCloud响应式微服务系列教程（第八章）构建响应式RESTful服务

本文为实战SpringCloud响应式微服务系列教程第八章,讲解构建响应式RESTful服务.建议没有之前基础的童鞋,先看之前的章节,章节目录放在文末. 1.使用springboot2.1.4构建RESTful风格服务 Springboot的设计是用来简化Spring应用程序的初始搭建和开发过程,为了实现这种简化效果,Springboot继承了众多第三方库,并大量使用约定优于配置的设计理念,通过特定的方式使得开发人员不再需要定义繁杂而且多余的配置内容. 1.1基于Springboot的第一个RE…

Restful服务应不应该在URI中加入版本号

程序员们对于Restful服务应不应该在URI中加入版本信息的问题在stackoverflow上进行了积极的讨论: Best practices for API versioning ,该问题被赞了720次–很少有被赞这么多次的问题. 支持在URI中加入版本信息的一方认为: 1. 保持接口的向后兼容是一件十分困难或者说费精力的事情,而在URI中加入版本信息则避免了向后兼容,另外通过过期提示,重定向,文档等手段也能降低用户迁移到新的接口上的成本. 反对在URI中加入版本信息的一方认为: 1. 不同…

RESTful服务最佳实践(转）

原文:https://www.cnblogs.com/jaxu/p/7908111.html 译文作者:Jaxu 英文原文:https://files-cdn.cnblogs.com/files/jaxu/RESTful_Best_Practices_v1_2.pdf 本文主要读者该最佳实践文档适用于对RESTful Web服务感兴趣的开发人员,该服务为跨多个服务的组件提供了较高的可靠性和一致性.按照本文的指导,可快速.广泛.公开地为内外部客户采用. 本文中的指导原则同样适用于工程师们,他们希…

HTTP RESTful服务开发 spring boot+Maven +Swagger

这周配合第三方平台整合系统,需要提供HTTP REST服务和使用ActiveMQ推送消息,研究了下,做个笔记. 1.使用eclipse创建Spring Boot项目创建Spring Boot项目(HTTP RESTful) 2.SpringBoot部署tomcat 开发好的服务打包成War包部署到 SpringBoot应用War包形式部署到外部Tomcat的方法 3.swagger集成到springBoot 项目中 swagger集成 2.2.2 版本的Swagger UI比较不友好 Sw…

java 利用JAX-RS快速开发RESTful 服务

JAX-RS(Java API for RESTful Web Services)同样也是JSR的一部分,详细规范定义见 https://jcp.org/en/jsr/detail?id=311 .从JAVA EE 6开始,已经内置了该技术,跟.NET中的RESTful WCF类似,只要在常规方法上使用一些简单的注解,就可以对外暴露成RESTful 服务. 注:本文运行环境为Jboss EAP 6.x ,其它容器特别是tomcat,并未自带JAX-RS依赖的jar包,如果采用tomcat,需要自…

atitit.RESTful服务的概览and框架选型

atitit.RESTful服务的概览and框架选型 1. REST基础概念: 1 2. URL说明: 1 3. 1 4. RESTful框架选型 2 1. spring mvc( recomm) 2 2. Jersey 2 5. 参考 3 1. REST基础概念: · 在REST中的一切都被认为是一种资源. · 每个资源由URI标识. · 使用统一的接口.处理资源使用POST,GET,PUT,DELETE操作类似创建,读取,更新和删除(CRUD)操作. · 无状态.每个请求是一个独立的请求…

发布Restful服务时出现IIS 指定了身份验证方案错误时的解决方案(IIS specified authentication schemes)

发布RESTful服务,当访问.svc文件时出现如下错误时: IIS 指定了身份验证方案“IntegratedWindowsAuthentication, Anonymous”,但绑定仅支持一种身份验证的规范.有效的身份验证方案为摘要.协商.NTLM.基本或匿名.请更改 IIS 设置,以便仅使用单一的身份验证方案. (IIS specified authentication schemes 'IntegratedWindowsAuthentication, Anonymous', but the…

java_java 利用JAX-RS快速开发RESTful 服务

JAX-RS(Java API for RESTful Web Services)同样也是JSR的一部分,详细规范定义见 https://jcp.org/en/jsr/detail?id=311 .从JAVA EE 6开始,已经内置了该技术,跟.NET中的RESTful WCF类似,只要在常规方法上使用一些简单的注解,就可以对外暴露成RESTful 服务. 注:本文运行环境为Jboss EAP 6.x ,其它容器特别是tomcat,并未自带JAX-RS依赖的jar包,如果采用tomcat,需要自…