Web Service入门
本文由 ImportNew - will 翻译自 javacodegeeks。欢迎加入Java小组。转载请参见文章末尾的要求。
为了学习更多web service知识,让我们首先理解面向服务架构的概念。
什么是面向服务的架构?
面向服务的架构(Service Oriented Architecture,SOA)是表示所谓服务的自包含功能单元的一种软件设计原则和架构设计模式。SOA推崇松耦合、复用性和粗粒度的服务设计原则。在企业架构方面,SOA带来的好处包括对业务需求的敏捷交付和迅速反应,通过降低集成成本提高投资回报率,通过复用组件降低开放成本。企业架构一般使用企业服务总线(ESB)作为大型企业线上应用的集成层。
什么是WebService
Web Service是面向服务架构的一种实现形式,它能够以一种平台无关的方式在不同系统之间进行交互。服务提供方定义由WSDL描述的接口,并使用SOAP消息与服务使用方进行消息交互。这些消息能够通过HTTP、FTP或者SMTP协议进行传输。WebService可以是基于SOAP或者REST的。
在今天的逐步向导中我们将探索如何创建基于SOAP的web 服务和使用web服务的使用者。我们将使用JAX-WS(Java API for XML Web Services)创建web服务。
使用软件:
Weblogic Application Server 12c
Eclipse Oepe 12c
Weblogic Webservice Tool – 这个工具将自动创建所有需要的代码和WSDL文件,让开发者专注于业务逻辑。
第一步:
在你的Eclipse中创建一个新的Dynamic Web Project。
![](https://i-blog.csdnimg.cn/blog_migrate/8167362cbd1e6028f54ecdb057407a84.png)
点击modify,增加Weblogic Webservice组件的Facets。
第二步:
点击复选框,以确保所有依赖的模块被包含进来,如截屏中所示
![](https://i-blog.csdnimg.cn/blog_migrate/72e73213c3a82b495f8f95dd7bee0fe3.png)
第三步:
Default Context根节点是CalculatorService, web模块的内容目录是WebContent,点击Finish。
第四步:
此刻点击新建的项目,在你的项目上增加Weblogic Web Service模块。
![](https://i-blog.csdnimg.cn/blog_migrate/b6527b67acb31c2abbae4a59350c9f81.png)
第五步:
创建一个新的web service。给webservice添加名称和包详情
![](https://i-blog.csdnimg.cn/blog_migrate/4d38348b310420cda921a5711b8dba68.png)
第六步:
Eclipse的webservice工具将创建一个带有默认hello()方法的服务端点接口(约定)。我们可以用方法add()来代替这个默认方法。最好的实践是创建一个接口,接口中声明的方法都被映射为网络服务操作。这个接口被称为服务端点接口(SEI,Service Endpoint Interface)。只要我们看到@WebService注解,它标示该接口即为一个SEI。
![](https://i-blog.csdnimg.cn/blog_migrate/9562315afa42e43c9c036ae06a6efb1b.png)
第七步:
创建CalculatorImpl.java作为JWS类(Java Web服务)
替代CalculatorImpl.java的现有默认代码,增加add()方法的具体实现。
![](https://i-blog.csdnimg.cn/blog_migrate/968d3057b08f9d4e35d8223cb07f835b.png)
第八步:
下图解释了@webService注解的webservice实现和wsdl之间的映射。Javax.jws.WebService告诉应用服务器这个类需要被看作webservice。Javax.jws.WebService的属性包括:
- name —— webservice的名称,对应WSDL文件的元素
- targetNameSpace —— 从该Web服务生成的WSDL和XML元素使用的XML命名空间
- serviceName —— web服务的服务名称。默认值为jws文件名加上后缀‘service’
- wsdlLocation —— wsdl文件的URL
- endpointInterface —— 这个属性基于存在的webservice服务端点
上图中Calculator接口的webservice名称被映射为WSDL中portType元素提及的webservice名称。
Calculator.java中的portName,serviceName,targetNameSpace和服务端点接口(SEI)被映射为CalculatorService.wsdl文件
第九步:
现在是时候在Weblogic 12c Server上来运行webservice了。右键点击项目,选择Run on Server,添加CalculatorService项目到Weblogic服务器并配置它们。
![](https://i-blog.csdnimg.cn/blog_migrate/7f09e8b5729f12a79aa6ee8239244785.png)
第十步:
现在webservice已经部署到服务器上,并暴露给使用的用户。可以通过weblogic服务器控制台使用和控制它。
![](https://i-blog.csdnimg.cn/blog_migrate/de6b2465f433118ff48a57abbcd641fd.png)
可以从截屏所示的位置查看和测试wsdl文件。
第十一步:
远程地址的wsdl文件。http://10.0.2.15:7001/CalculatorServiceServer/CalculatorServer?WSDL
![](https://i-blog.csdnimg.cn/blog_migrate/c5ccce277b74b46752dc05e19e57635f.png)
第十二步:
下图展示了CalculatorService.wsdl文件,并解释了WSDL文件的主要元素。WSDL是客户端和服务提供者的服务约定。
Definition —— WSDL文件最外层的元素是,它是wsdl文档中定义的所有其他元素的容器,总之,它就是根元素。
- types —— 描述客户端和服务端交互的消息所用到和关联的所有数据类型。它是一个可选字段,types部分引用了定义数据类型的XSD(XML schema definition)。如果这部分为空,则该web服务仅适用简单数据类型。
- message —— 定义了webservice服务方和使用方交换的数据。创建的消息都属于上面的数据类型。
- portType —— 表示称为operations的web服务,每个operation可以有一个或多个消息。
- binding —— 定义了消息如何传输。它可以使用HTTP GET,HTTP POST,SOAP(HTTP协议的上层)。从binding部分WSDL定义从抽象走向具体,提供了关于web服务的具体详情。binding元素必须说明在portType中抽象定义的webservice的实现详情。
- service —— 指定端点,客户端可以从这个路径访问web服务。
第十三步:
我们可以在Weblogic Test客户端的帮助下测试webservice。
![](https://i-blog.csdnimg.cn/blog_migrate/27a5e294a794d1f0bc3f28074dabf62a.png)
第十四步:
Weblogic测试客户端能够显示出add操作的成功结果,并给出请求和回复的SOAP消息。
![](https://i-blog.csdnimg.cn/blog_migrate/aeb28180f2df1af1b8fe51a5c9e564e2.png)
第十五步:
现在我想要创建一个servlet作为webservice客户端,来使用我们上一步创建的Calculator服务。创建一个新的动态Web工程 ——CalculatorServiceClient,增加Oracle WebLogic Web Service Clients切面。
![](https://i-blog.csdnimg.cn/blog_migrate/bcee398cce4eab051ef96c5e2d6f9263.png)
第十六步:
右键点击CalculatorServiceClient工程,依循project->Select New -> Select other -> Search Weblogic Web Service Client向导来创建一个新的web服务客户端。现在输入WSDL文件的引用,在这个例子里我们将使用WSDL文件的远程定义。点击前请确保验证过WSDL文件。
![](https://i-blog.csdnimg.cn/blog_migrate/84f1571344b9bc661f9775d16f83fb06.png)
点击下一步将CalculatorServiceServer代码输出到CalculatorService.jar。再点击下一步指定运行时WSDL文件的位置。这里我已经使用了Copy WSDL into client jar(将WSDL复制到客户端的jar包)的选项
![](https://i-blog.csdnimg.cn/blog_migrate/af81be386e682877a8e8e922b7af739e.png)
第十七步:
现在创建一个用来关联WebService的Servlet类
![](https://i-blog.csdnimg.cn/blog_migrate/bf39f075046046dfdea375f7bcf50b74.png)
第十八步:
让我们看一下客户端Servlet的代码:
1
2
3
4
5
6
7
8
9
|
protected
void
doGet(HttpServletRequest request, HttpServletResponse response)
throws
ServletException, IOException {
CalculatorService service =
new
CalculatorService();
Calculator addservice = service.getCalculatorPort();
int
sum = addservice.add(
1
,
6
);
response.setContentType(
"text/html"
);
PrintWriter out = response.getWriter();
out.println(
"<h1> SUM="
+ sum +
"</h1>"
);
System.out.println(
"result sum-"
+ sum);
}
|
servlet的输出显示了add操作的结果。
![](https://i-blog.csdnimg.cn/blog_migrate/896dba8a65d3d3b6d674ea2e9a235034.png)
Java Web Services面试问题集锦
Q. 应用集成方式有哪些?
A. 应用可以采用以下方式集成:
1. 共享数据库
2. 批量文件传输
3. 远程过程调用(RPC)
4. 通过消息中间件来交换异步信息(MOM)
![](https://i-blog.csdnimg.cn/blog_migrate/135108746932b5acc5d3e586f2e5f1ff.png)
Q. 应用集成可以采用的Web服务方式有什么?
A. SOAP WS(Simple Object Access Protocal) 和RESTful Web Service(REpresentational State Transfer)
Q. SOAP WS 和RESTful Web Service之间有什么不同呢?
A.
- SOAP WS支持既远程过程调用(例如,RPC)又支持消息中间件(MOM)方式进行应用集成。而Restful Web Service仅支持RPC集成方式。
- SOAP WS是传输协议无关的。它支持多种协议,比如,HTTP(S)、 Messaging、TCP、UDP SMTP等等。而REST是协议相关的,只支持HTTP或者HTTPS协议。
- SOAP WS仅允许使用XML数据格式。定义的操作通过POST请求发送。其重点是通过操作名来获取服务,并将应用逻辑封装为服务。而REST方式则允许多种数据格式,例如,XML、JSON、文本、HTML等等。而且由于REST方式采用标准GET、PUT、PSOT和DELETE 方法,因此所有的浏览器都可以支持。其重点是通过资源名来获取服务,并将数据封装为服务。AJAX支持REST方式,它可以使用XMLHttpRequest对象。无状态CRUD操作(创建、读、更新和删除)更加适合这种方式。
GET – represent()
POST – acceptRepresention()
PUT – storeRepresention()
DELETE – removeRepresention()
- 无法缓存SOAP方式读取的内容。而REST方式的则可以,而且性能和可扩展性都更好一些。
- SOAP WS支持SSL和WS-security,针对企业级应用可以有更多的安全保障,例如按需提升安全指数、通过第三方来保证身份认证信息的安全性、除了点到点SSL(point to point SSL)之外,更针对消息的不同部分来提供不同的保密算法等等。而REST只支持点到点SSL。而且无论是不是敏感消息,SSL都会加密整条消息。
- SOAP对于基于ACID的短寿命事务管理以及基于补偿事务管理的长寿命事务有深入的支持。同时,SOAP也支持分布式事务(译者:在一个分布式环境中涉及到多个资源管理器的事务)的两阶段提交(two-phase commit)方式。而REST由于基于HTTP协议,因此对于事务处理既不兼容ACID方式也不提供分布式事务的两阶段提交方式。
- 即便是要通过SOAP的第三方程序,SOAP通过内置的重试逻辑也可以提供端到端可靠性。REST没有一个标准的消息系统,因而寄希望于客户通过重连去解决通信失败问题。
Q.如何选择采用哪种Web service?SOAP WS还是REST?
A.一般而言,基于REST的Web service的优势在于其简单、性能不错、可扩展性好,并且也支持多种数据格式。而SOAP则适用于安全性和事务处理可靠性方面要求比较高的服务中。
对于这个问题的答案,更多的考虑依据是设计者对功能性和非功能性需求的要求。通过回答下列问题可以帮助你做出选择:
- 所提供的服务会暴露数据或者业务逻辑吗?(如果会暴露数据的话可以选择REST方式,如果会暴露业务逻辑的话可以选择SOAP WS)。客户或者服务提供商需要一个正式的契约(contract)吗?(SOAP可以通过WSDL(Web Service Description Language)提供一个正式契约)
- 需要支持多种数据格式吗?
- 需要进行AJAX调用吗?(REST可以采用XMLHttpRequest来发送AJAX调用)
- 同步调用还是异步调用?
- 有状态调用还是无状态调用?(REST适合无状态CRUD操作)
- 对于安全性的要求?(SOAP WS对于安全性的支持更好些)
- 对于事务处理的要求?(SOAP WS这方面更有优势)
- 有带宽限制吗?(SOAP消息比较冗长)
- 哪种方式更适合开发者呢呢?(REST更好实现,也更好测试和维护)
Q.有什么可以用来测试Web Service的工具吗?
A.测试SOAP WS可以使用SoapUI,测试RESTFul service可以采用Firefox的“poster”插件。
Q. SOA和Web service的区别是什么?
A. SOA是一种软件设计准则,一种实现松耦合,高可复用性和粗粒度的web服务的设计模式。开发者可以选择任意协议实现SOA,例如,HTTP、HTTPS、JMS、SMTP、RMI、IIOP(例如,采用IIOP的EJB)、RPC等。消息可以采用XML或者数据传输对象(Data Transfer Objects,DTOs)。
Web Service是实现SOA的技术之一。也可以不用Web service来实现SOA应用:例如,用一些传统的技术,像Java RMI,EJB,JMS消息等。但是Web service提供的是标准的平台无关的服务,这些服务采用HTTP、XML、SOAP、WSDL和UDDI技术,因此可以带来J2EE和.NET这些异构技术(heterogeneous technologies)之间的互操作性。
Q.如果可以使用传统的中间件方式,例如,RPC、CORBA、RMI和DCOM,为什么还要选择Web service?
A. 传统的中间件跟应用关系紧密,对应用的任何修改都可能会引起对应中间件的修改。因此这种方式下应用不好维护,复用性也比较差。一般情况下也无法支持异质系统(heterogeneity)。另外,采用这种方式应尽量避免互联网访问应用。还有,这种方式代价更高并且可用性差。
Web service采用松耦合连接,即在客户端和服务器端之间提供了一个抽象层。这种松耦合应用可以减少维护成本并增加可复用性。Web service提供了一种基于XML和Web的新的中间件形式。Web service是语言和平台无关的,任何语言都可以用来开发一个Web service,并且部署到任何平台上,包括小型设备到大型超级计算机。Web service采用语言无关协议,例如HTTP,并且通过Web API来在不同的应用程序之间传输XML消息。Web service可以通过互联网访问,开销少并且可用性好。
Q.开发基于SOAP的Web service有哪些方式呢?
A.有两种方式;
- 契约先行(也称为自顶向下,contract-first)方式:通过XSD和WSDL来定义contract,然后根据contract生成Java类;
- 契约后行(也称为自底向上,contract-last)方式:先定义Java类,然后生成约定,也就是从Java类得到WSDL文件。
注意:WSDL描述这样一些信息:服务所提供的所有用户操作、终端位置信息(例如,调用服务的URL),请求和响应中的简单或者复杂元素等。
Q. 上面两种方式各有什么优缺点吗?你更推荐哪种?
A.
契约先行方式的Web service
优点:
- 客户端程序和服务器端程序分离,因此重构服务器端代码不会影响到客户端。
- 由于遵守相同的规范,因此客户端和服务器端的开发可以并行进行。
- 开发者可以控制请求\响应消息的结构:例如,“status”应该是作为消息的一个元素还是一个属性?契约规定的非常明确。因此开发者可以大胆的去修改OXM(Object to XML Mapping)库,而不用担心是否会导致“status”从元素变成“属性”。不仅如此,甚至Web service框架和工具箱都可以更换,比如从Apache Axis变成Apache CXF等等。
缺点:
- 开发前期需要额外的一些搭建XSD和WSDL的工作。使用XML Spy、OxygenXM等工具可以简化这些工作。另外,还需要开发对象模型。
- 开发者需要除了Java之外,还需要去学习XSD和WSDL。
契约后行方式的Web service
优点:
- 开发者不用去学习XSD、WSDL和SOAP相关知识。可以通过框架或者工具集利用已有服务来快速构建新的服务。例如,通过基于IDE向导快速构建应用。
- 学习曲线和开发时间会比契约先行方式小。
缺点:
- 项目初始的开发时间会缩短,但是一旦contract发生变化或者需要加入新的元素,那么随之而来的维护和扩展应用所带来的开发时间会是怎样呢?采用这种方式,由于客户端和服务器端之间紧密耦合,因此未来潜在的变化可能破坏客户端的contract,导致所有的客户都会受到影响,为了避免这中情况的发生,项目开发时需要很小心的开发和管理未来要发布的服务。
- XML的有效负载(payload)无法控制。这也就是说修改应用的OXM库会导致某个元素错误的变成了属性。
那么,你会选择哪一种方式呢?
最好的方式是“契约先行”(contract-first),这里有篇文章(ontract-first versus contract-last web services )用一些例子来解释为什么。总的来说,契约先行方式比契约后行方式开发出来的应用更加强壮。当然,选择哪种方式是跟需求和工具等等有关的,需要综合这些因素考虑决定。
使用Java创建RESTful Web Service
本文由 ImportNew - 陈洁 翻译自 eviac。欢迎加入Java小组。转载请参见文章末尾的要求。
REST是REpresentational State Transfer的缩写(一般中文翻译为表述性状态转移)。2000年Roy Fielding博士在他的博士论文“Architectural Styles and the Design of Network-based Software Architectures”《体系结构与基于网络的软件架构设计》中提出了REST。
REST是一种体系结构。而HTTP是一种包含了REST架构属性的协议。
REST基础概念
- 在REST中所有东西都被看作资源。每一个资源都有一个URI和它对应。
- 在REST中使用统一接口处理资源。与数据库CRUD操作(Create、Read、Update 和 Delete)一样,可以用POST、GET、PUT和DELETE处理REST资源。
- 每个REST请求都是孤立的,请求中包含了所需的全部信息。REST服务端不存储状态。
- REST支持不同的通信数据格式,比如XML、JSON。
RESTful Web Services
RESTful Web Services因其简单性被广泛使用,它比SOAP要更简单。本文将重点介绍如何使用Jersey框架创建RESTful Web Services。Jersey框架实现了JAX-RS接口。本文示例代码使用Eclipse和Java SE 6编写。
创建RESTful Web Service服务端
- 在Eclipse中创建一个“dynamic web project”(动态web工程) ,项目名设为 “RESTfulWS”。
![](https://i-blog.csdnimg.cn/blog_migrate/6622627ee54a7a547d3531255b2e80c7.png)
- 从这里下载Jersey。示例代码使用的是Jersey 1.17.1。首先解压Jersey到“jersey-archive-1.17.1”文件夹。接着将里面lib文件夹下的jar文件拷贝到工程目录的WEB-INF -> lib。然后将它们添加到build path。
- asm-3.1.jar
- jersey-client-1.17.1.jar
- jersey-core-1.17.1.jar
- jersey-server-1.17.1.jar
- jersey-servlet-1.17.1.jar
- jsr311-api-1.1.1.jar
- 在工程Java Resources -> src中创建“com.eviac.blog.restws”包,并在其中创建“UserInfo”类。最后把web.xml拷贝到WEB-INF目录下。
![](https://i-blog.csdnimg.cn/blog_migrate/8982549ae9e34a383dca80c8bb35fd7c.png)
![](https://i-blog.csdnimg.cn/blog_migrate/3dc1302a20620224dea9c5a44e838f46.png)
UserInfo.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
package
com.eviac.blog.restws;
import
javax.ws.rs.GET;
import
javax.ws.rs.Path;
import
javax.ws.rs.PathParam;
import
javax.ws.rs.Produces;
import
javax.ws.rs.core.MediaType;
/**
*
* @author pavithra
*
*/
// 这里@Path定义了类的层次路径。
// 指定了资源类提供服务的URI路径。
@Path
(
"UserInfoService"
)
public
class
UserInfo {
// @GET表示方法会处理HTTP GET请求
@GET
// 这里@Path定义了类的层次路径。指定了资源类提供服务的URI路径。
@Path
(
"/name/{i}"
)
// @Produces定义了资源类方法会生成的媒体类型。
@Produces
(MediaType.TEXT_XML)
// @PathParam向@Path定义的表达式注入URI参数值。
public
String userName(
@PathParam
(
"i"
) String i) {
String name = i;
return
"<User>"
+
"<Name>"
+ name +
"</Name>"
+
"</User>"
;
}
@GET
@Path
(
"/age/{j}"
)
@Produces
(MediaType.TEXT_XML)
public
String userAge(
@PathParam
(
"j"
)
int
j) {
int
age = j;
return
"<User>"
+
"<Age>"
+ age +
"</Age>"
+
"</User>"
;
}
}
|
web.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
<?
xml
version
=
"1.0"
encoding
=
"UTF-8"
?>
<
web-app
xmlns:xsi
=
"http://www.w3.org/2001/XMLSchema-instance"
xmlns
=
"http://java.sun.com/xml/ns/javaee"
xmlns:web
=
"http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
xsi:schemaLocation
=
"http://java.sun.com/xml/ns/javaee <a href="
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"</
a
> id="WebApp_ID" version="2.5">
<
display-name
>RESTfulWS</
display-name
>
<
servlet
>
<
servlet-name
>Jersey REST Service</
servlet-name
>
<
servlet-class
>com.sun.jersey.spi.container.servlet.ServletContainer</
servlet-class
>
<
init-param
>
<
param-name
>com.sun.jersey.config.property.packages</
param-name
>
<
param-value
>com.eviac.blog.restws</
param-value
>
</
init-param
>
<
load-on-startup
>1</
load-on-startup
>
</
servlet
>
<
servlet-mapping
>
<
servlet-name
>Jersey REST Service</
servlet-name
>
<
url-pattern
>/rest/*</
url-pattern
>
</
servlet-mapping
>
</
web-app
>
|
- 将此URL拷贝到浏览器地址栏中运行:
- http://localhost:8080/RESTfulWS/rest/UserInfoService/name/Pavithra
![](https://i-blog.csdnimg.cn/blog_migrate/051aaab053d130a0183408780b85d88b.png)
输出结果如下:
![](https://i-blog.csdnimg.cn/blog_migrate/83d993f932086e344a14bc96ef05e910.png)
创建客户端
创建一个“com.eviac.blog.restclient”包,然后新建“UserInfoClient”类。
UserInfoClient.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
package
com.eviac.blog.restclient;
import
javax.ws.rs.core.MediaType;
import
com.sun.jersey.api.client.Client;
import
com.sun.jersey.api.client.ClientResponse;
import
com.sun.jersey.api.client.WebResource;
import
com.sun.jersey.api.client.config.ClientConfig;
import
com.sun.jersey.api.client.config.DefaultClientConfig;
/**
*
* @author pavithra
*
*/
public
class
UserInfoClient {
public
static
final
String BASE_URI =
"http://localhost:8080/RESTfulWS"
;
public
static
final
String PATH_NAME =
"/UserInfoService/name/"
;
public
static
final
String PATH_AGE =
"/UserInfoService/age/"
;
public
static
void
main(String[] args) {
String name =
"Pavithra"
;
int
age =
25
;
ClientConfig config =
new
DefaultClientConfig();
Client client = Client.create(config);
WebResource resource = client.resource(BASE_URI);
WebResource nameResource = resource.path(
"rest"
).path(PATH_NAME + name);
System.out.println(
"Client Response \n"
+ getClientResponse(nameResource));
System.out.println(
"Response \n"
+ getResponse(nameResource) +
"\n\n"
);
WebResource ageResource = resource.path(
"rest"
).path(PATH_AGE + age);
System.out.println(
"Client Response \n"
+ getClientResponse(ageResource));
System.out.println(
"Response \n"
+ getResponse(ageResource));
}
/**
* 返回客户端请求。
* 例如:
* GET http://localhost:8080/RESTfulWS/rest/UserInfoService/name/Pavithra
* 返回请求结果状态“200 OK”。
*
* @param service
* @return
*/
private
static
String getClientResponse(WebResource resource) {
return
resource.accept(MediaType.TEXT_XML).get(ClientResponse.
class
)
.toString();
}
/**
* 返回请求结果XML
* 例如:<User><Name>Pavithra</Name></User>
*
* @param service
* @return
*/
private
static
String getResponse(WebResource resource) {
return
resource.accept(MediaType.TEXT_XML).get(String.
class
);
}
}
|
- 运行客户端程序后,可以看到以下输出:
1
2
3
4
5
6
7
8
9
|
Client Response
GET http://localhost:8080/RESTfulWS/rest/UserInfoService/name/Pavithra returned a response status of 200 OK
Response
<
User
><
Name
>Pavithra</
Name
></
User
>
Client Response
GET http://localhost:8080/RESTfulWS/rest/UserInfoService/age/25 returned a response status of 200 OK
Response
<
User
><
Age
>25</
Age
></
User
>
|
试试吧 :)
原文链接: eviac 翻译: ImportNew.com - 陈洁
译文链接: http://www.importnew.com/7336.html
[ 转载请保留原文出处、译者和译文链接。]
使用Spring框架实现RESTful
本文由 ImportNew - 唐尤华 翻译自 igorartamonov.com。欢迎加入Java小组。转载请参见文章末尾的要求。
RESTful web服务最近有多流行已经无需我多评价。是的,你的确需要它,但如何选择呢?我尝试了不同的Java REST框架,基本上都是Jersey和Spring MVC。我认为大多数情况下Spring是构建RESTful应用程序的首选。
如果你已经有了一个Spring app,接下来不需要做任何复杂的配置就可以用Spring开始实现RESTful API了。只要使用标准的注解配置向下面这样配置JSON视图解析器(view resolver ):
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
//这个示例使用了Groovy,相信你能够理解
@Constoller
@RequestMapping('/api/user')
class UserApi {
@RequestMapping(value = '/{id}', method = RequestMethod.GET)
User get(@PathVariable long id) {
//... load user, etc
}
@RequestMapping(value = '/{id}', method = RequestMethod.POST)
User update(@PathVariable long id, @RequestModel User updated) {
//... load user, update values, etc
}
}
|
当然,你可以不用JSON转而XML或者使用ProtoBuf以及其他什么。这很简单而且不会因为修改造成代码错误,比起Jersey要简单很多。
通常你的应用程序除了RESTful API还会有其他东西,比如标准的HTML页面、文件下载/上传、复杂的API请需求数据流处理、重要的后台处理、数据库访问、复杂的认证和授权与外部服务集成等等。Spring框架可以将这些完成得很好。同时我最喜欢的就是,通常会有两种办法达成目标:“应急办法”和常规办法:)
实际上我是Grails web的粉丝,我真的很喜欢它并且为Grails写了一些插件。我相信构建传统 web应用方面Grails是最好的框架。但是当我看见采用RESTful构建和一些现代应用之后(大多数是“单页面App”)——我总是会建议使用Spring MVC (+ Groovy,这又是另外一个话题)。
一些有用的链接:
- Spring – http://www.springsource.org/spring-framework
- Spring安全项目,如果你需要使用认证–http://www.springsource.org/spring-security
- 所有Spring项目 – http://www.springsource.org/projects
- 如果真的打算做一个好的RESTful应用,你需要Spring HATEOAS –https://github.com/SpringSource/spring-hateoas
- Spring MVC文档 –http://static.springsource.org/spring/docs/3.1.x/spring-framework-reference/html/mvc.html
- 一篇使用Spring进行内容交互的好文 –http://blog.springsource.org/2013/05/11/content-negotiation-using-spring-mvc/