功能介绍:提供WebService的接口,供其他人调用。
知识点:
-
WebService 的使用
-
XML文档操作
-
spring + jdbc 链接数据库 数据库的注入
-
数据库操作 使用 jdbcTemplate 操作
系统:Win7
准备工具:eclipse,下图是我的IDE,自己在eclilpse的官网上下载的。
http://www.eclipse.org/
数据库:MyQSL 5.6
项目用的是Oracle,这个Demo是在我的电脑上搭建的,主要是用来总结和回忆。
由于对oracle不熟悉(以后用到的主要是oracle),现在先MySQL代替。
在mysql官网下载解压版的,数据库的安装就不多介绍了,网上一大堆。
Tomcat:apache-tomcat-7.0.64
环境搭建
- 因为是用eclipse开发(相对与MyEclipse来说比较轻,很多功能需要自己下载插件和配置),所以还是先讲讲配置吧。
- 下载好tomcat放在一个目录下。在这里要说明的是,存放的目录最好是英文目录且不要带空格,以防之后出现莫名其妙的问题。我的tomcat目录:D:\tomcat\apache-tomcat-7.0.64
-
在eclipse中配置tomcat
-
step1:打开eclipse->Window->Preferences->Server-Runtime Environments如图
-
Step2: 因为我配置好了,所以已经存在3个Apcache Tomcat。点击 Add 选择一个
版本(不知道有啥用),对应你下载的tomcat,然后 next
- Step3:点击Browse 在路径中找到 Directory
,点击Finish就ok了。在这里说一句,我使用的JRE版本是1.7。查看自己的 JRE:按 win+r 输入cmd回车,进入命令行界面
输入java -version
下图中是刚刚配置的Tomcat
-
创建一个web项目
选择刚刚配置的Tomcat,一路next。
这里需要注意下,Eclipse和MyEclilpse有点区别,Eclipse创建的Web项目默认使用的路径是WebContent,而MyEclipse默认使用的是WebRoot
如果从MyEclipse中导出的项目,在Eclipse中跑,需要改动一个配置。就是当前项目的配置文件。
在工作空间中找到当前的项目 WebServiceDemo->.settings->org.eclipse.wst.common.component
下图中的绿色部分
客户端测试代码
-
首先明确目的,即需要得到什么结果。
远程客户端调用WebService接口,传入一个参数,返回想要的结果。 -
客户端调用方式:
使用xfire方式。需要xfire的jar包。
把需要的jar包直接复制到WebContent/WEB-INF/lib目录下,再在测试类中引入即可
代码如下
<code class="hljs java has-numbering"><span class="hljs-keyword">package</span> com.test; <span class="hljs-keyword">import</span> java.net.MalformedURLException; <span class="hljs-keyword">import</span> java.net.URL; <span class="hljs-keyword">import</span> org.codehaus.xfire.client.Client; <span class="hljs-keyword">public</span> <span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">WebServiceTest</span> {</span> <span class="hljs-keyword">public</span> <span class="hljs-keyword">static</span> <span class="hljs-keyword">void</span> <span class="hljs-title">main</span>(String[] args) <span class="hljs-keyword">throws</span> MalformedURLException, Exception { <span class="hljs-comment">// TODO Auto-generated method stub</span> String url = <span class="hljs-string">"http://localhost:8080/WebServiceDemo/services/queryPeople?wsdl"</span> ; String xml = <span class="hljs-string">"<?xml version='1.0' encoding='utf-8'?><body><properties><name>xiaoming</name></properties></body>"</span> ; Client c = <span class="hljs-keyword">new</span> Client(<span class="hljs-keyword">new</span> URL(url)); Object[] o = c.invoke( <span class="hljs-string">"queryPeopleInfo"</span>, <span class="hljs-keyword">new</span> Object[]{xml}); <span class="hljs-comment">//目的是通过queryPeopleInfo方法查询这个人的信息,xml为传入的参数。</span> <span class="hljs-comment">//如果成功,o为返回的值;失败,则为空。因为WebService没有创建,此处肯定返回失败。</span> <span class="hljs-keyword">if</span>(o !=<span class="hljs-keyword">null</span>){ String result = o [<span class="hljs-number">0</span>].toString(); System. out.println(result ); } <span class="hljs-keyword">else</span>{ System. out.println(<span class="hljs-string">"没有找到"</span> ); } } }</code><ul style="" class="pre-numbering"><li>1</li><li>2</li><li>3</li><li>4</li><li>5</li><li>6</li><li>7</li><li>8</li><li>9</li><li>10</li><li>11</li><li>12</li><li>13</li><li>14</li><li>15</li><li>16</li><li>17</li><li>18</li><li>19</li><li>20</li><li>21</li><li>22</li><li>23</li><li>24</li><li>25</li><li>26</li><li>27</li><li>28</li><li>29</li></ul><ul style="" class="pre-numbering"><li>1</li><li>2</li><li>3</li><li>4</li><li>5</li><li>6</li><li>7</li><li>8</li><li>9</li><li>10</li><li>11</li><li>12</li><li>13</li><li>14</li><li>15</li><li>16</li><li>17</li><li>18</li><li>19</li><li>20</li><li>21</li><li>22</li><li>23</li><li>24</li><li>25</li><li>26</li><li>27</li><li>28</li><li>29</li></ul>
由于WebService服务还没有搭建、所有执行后结果为: 没有找到
WebService的创建
First、把项目需要的jar包 都copy到 WebContent/WEB-INF/lib里 。 本Demo中需要的 jar包在代码中都有
-
编写代码
在src目录下创建3个包,分别是com.service、com.service.impl、com.test
其中com.test是客户端测试程序(当然也可以单独建立一个项目进行测试)
com.service为定义的WebService接口、com.service.impl为具体实现的类包 -
接口定义:通过name查询到该人的相关信息
<code class="hljs cs has-numbering">package com.service; <span class="hljs-keyword">public</span> <span class="hljs-keyword">interface</span> QueryPeople { <span class="hljs-keyword">public</span> String <span class="hljs-title">queryPeopleInfo</span>(String name ); } </code><ul style="" class="pre-numbering"><li>1</li><li>2</li><li>3</li><li>4</li><li>5</li><li>6</li><li>7</li></ul><ul style="" class="pre-numbering"><li>1</li><li>2</li><li>3</li><li>4</li><li>5</li><li>6</li><li>7</li></ul>
- 实现:
<code class="hljs java has-numbering"><span class="hljs-keyword">package</span> com.service.impl; <span class="hljs-keyword">import</span> com.service.QueryPeople; <span class="hljs-keyword">public</span> <span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">QueryPeopleImpl</span> <span class="hljs-keyword">implements</span> <span class="hljs-title">QueryPeople</span>{</span> <span class="hljs-annotation">@Override</span> <span class="hljs-keyword">public</span> String <span class="hljs-title">queryPeopleInfo</span>(String name ) { <span class="hljs-comment">// TODO Auto-generated method stub</span> <span class="hljs-comment">//具体在数据库查询的一些处理</span> <span class="hljs-keyword">return</span> <span class="hljs-string">"查询 "</span> + name + <span class="hljs-string">" 成功"</span>; } } </code><ul style="" class="pre-numbering"><li>1</li><li>2</li><li>3</li><li>4</li><li>5</li><li>6</li><li>7</li><li>8</li><li>9</li><li>10</li><li>11</li><li>12</li><li>13</li><li>14</li><li>15</li><li>16</li></ul><ul style="" class="pre-numbering"><li>1</li><li>2</li><li>3</li><li>4</li><li>5</li><li>6</li><li>7</li><li>8</li><li>9</li><li>10</li><li>11</li><li>12</li><li>13</li><li>14</li><li>15</li><li>16</li></ul>
配置文件
- 在WebContent/WEB-INF下创建一个 文件
web.xml。内容如下:(如果代码目录和名称没有改变则直接把下面的内容copy过去就行)
<code class="hljs xml has-numbering"><span class="hljs-pi"><?xml version="1.0" encoding= "UTF-8"?></span> <span class="hljs-tag"><<span class="hljs-title">web-app</span> <span class="hljs-attribute">xmlns</span>=<span class="hljs-value">"http://java.sun.com/xml/ns/j2ee"</span> <span class="hljs-attribute">xmlns:xsi</span>=<span class="hljs-value">"http://www.w3.org/2001/XMLSchema-instance"</span> <span class="hljs-attribute">version</span>=<span class="hljs-value">"2.4"</span> <span class="hljs-attribute">xsi:schemaLocation</span>=<span class="hljs-value">"http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"</span>></span> <span class="hljs-tag"><<span class="hljs-title">servlet</span>></span> <span class="hljs-tag"><<span class="hljs-title">servlet-name</span>></span> XFireServlet<span class="hljs-tag"></<span class="hljs-title">servlet-name</span> ></span> <span class="hljs-tag"><<span class="hljs-title">servlet-class</span>></span> org.codehaus.xfire.transport.http.XFireConfigurableServlet <span class="hljs-tag"></<span class="hljs-title">servlet-class</span>></span> <span class="hljs-tag"><<span class="hljs-title">init-param</span>></span> <span class="hljs-tag"><<span class="hljs-title">param-name</span>></span> config<span class="hljs-tag"></<span class="hljs-title">param-name</span> ></span> <span class="hljs-tag"><<span class="hljs-title">param-value</span>></span> services.xml<span class="hljs-tag"></<span class="hljs-title">param-value</span> ></span> <span class="hljs-tag"></<span class="hljs-title">init-param</span>></span> <span class="hljs-tag"><<span class="hljs-title">load-on-startup</span>></span> 0<span class="hljs-tag"></ <span class="hljs-attribute">load-on-startup</span>></span> <span class="hljs-tag"></<span class="hljs-title">servlet</span>></span> <span class="hljs-tag"><<span class="hljs-title">servlet-mapping</span>></span> <span class="hljs-tag"><<span class="hljs-title">servlet-name</span>></span> XFireServlet<span class="hljs-tag"></<span class="hljs-title">servlet-name</span> ></span> <span class="hljs-tag"><<span class="hljs-title">url-pattern</span>></span> /services/*<span class="hljs-tag"></<span class="hljs-title">url-pattern</span> ></span> <span class="hljs-tag"></<span class="hljs-title">servlet-mapping</span>></span> <span class="hljs-tag"><<span class="hljs-title">welcome-file-list</span>></span> <span class="hljs-tag"><<span class="hljs-title">welcome-file</span>></span> index.jsp<span class="hljs-tag"></<span class="hljs-title">welcome-file</span> ></span> <span class="hljs-tag"></<span class="hljs-title">welcome-file-list</span>></span> <span class="hljs-tag"></<span class="hljs-title">web-app</span>></span> </code><ul style="" class="pre-numbering"><li>1</li><li>2</li><li>3</li><li>4</li><li>5</li><li>6</li><li>7</li><li>8</li><li>9</li><li>10</li><li>11</li><li>12</li><li>13</li><li>14</li><li>15</li><li>16</li><li>17</li><li>18</li><li>19</li><li>20</li><li>21</li><li>22</li><li>23</li><li>24</li></ul><ul style="" class="pre-numbering"><li>1</li><li>2</li><li>3</li><li>4</li><li>5</li><li>6</li><li>7</li><li>8</li><li>9</li><li>10</li><li>11</li><li>12</li><li>13</li><li>14</li><li>15</li><li>16</li><li>17</li><li>18</li><li>19</li><li>20</li><li>21</li><li>22</li><li>23</li><li>24</li></ul>
配置说明:标签中的< init-param> 如果不配置的话,默认的services.xml路径为WebContent/WEB-INF/META-INF/xfire/services.xml( 具体是哪里配置的这个路径不清楚,知道的小伙伴可以告诉我)
- 在相同目录下创建文件 services.xml 该文件为WebService的主要配置文件,提供的接口和具体实现的类都是在这里面配置。
<code class="hljs xml has-numbering"><span class="hljs-pi"><?xml version="1.0" encoding= "UTF-8"?></span> <span class="hljs-tag"><<span class="hljs-title">beans</span> <span class="hljs-attribute">xmlns</span>=<span class="hljs-value">"http://xfire.codehaus.org/config/1.0"</span> ></span> <span class="hljs-comment"><!-- 查询人的信息 --></span> <span class="hljs-tag"><<span class="hljs-title">service</span>></span> <span class="hljs-tag"><<span class="hljs-title">name</span>></span> queryPeople<span class="hljs-tag"></<span class="hljs-title">name</span> ></span> <span class="hljs-tag"><<span class="hljs-title">serviceClass</span>></span> com.service.QueryPeople<span class="hljs-tag"></<span class="hljs-title">serviceClass</span> ></span> <span class="hljs-tag"><<span class="hljs-title">implementationClass</span>></span> com.service.impl.QueryPeopleImpl <span class="hljs-tag"></<span class="hljs-title">implementationClass</span>></span> <span class="hljs-tag"><<span class="hljs-title">style</span>></span><span class="css"> <span class="hljs-tag">wrapped</span></<span class="hljs-tag">style</span> > <<span class="hljs-tag">use</span>> <span class="hljs-tag">literal</span></<span class="hljs-tag">use</span> > <<span class="hljs-tag">scope</span>> <span class="hljs-tag">application</span></<span class="hljs-tag">scope</span> > </<span class="hljs-tag">service</span>> </<span class="hljs-tag">beans</span>> </span></code><ul style="" class="pre-numbering"><li>1</li><li>2</li><li>3</li><li>4</li><li>5</li><li>6</li><li>7</li><li>8</li><li>9</li><li>10</li><li>11</li><li>12</li><li>13</li><li>14</li><li>15</li><li>16</li><li>17</li></ul><ul style="" class="pre-numbering"><li>1</li><li>2</li><li>3</li><li>4</li><li>5</li><li>6</li><li>7</li><li>8</li><li>9</li><li>10</li><li>11</li><li>12</li><li>13</li><li>14</li><li>15</li><li>16</li><li>17</li></ul>
每个就是一个服务、name 为提供的服务名、serviceClass为服务的接口、implementationClass为具体实现的类
到此为止,一个WebService的框架基本搭建完成了。
下面把项目运行起来,来测试吧!
运行项目
- 右键项目 Run AS–>Run on server
把要运行的项目移动到右侧的Configured中—->finish
就启动了Tomcat 。
检查下Console控制台的日志有没有报错,如果有错再根据错误找出问题。
运行后的界面如下图:
似乎不是我们想要的结果。
这里注意下浏览器里的路劲:只是tomcat服务+项目名称, 我们需要的是WebService服务
so
后面还要加上services加 真正的路径为:http://localhost:8080/WebServiceDemo/services最开始我一直疑惑services的由来,找找配置文件才明白 services 就是在web.xml 中配置的XFireServlet名称,再在浏览器中输入回车
界面就出来了,到这步已经说明配置成功了。点击[wsdl] 可以查看具体的接口信息,如下
OK,再返回到最初的客户端测试代码中去。
运行代码、预期得到的结果为 : ” 查询 (传入的值) 成功”
结果: 查询 <?xml version='1.0' encoding='utf-8'?><body><properties><name>xiaoming</name></properties></body> 成功
测试成功!
下篇将会在这个代码的基础上进行完善,使用Spring 注入方式进行数据库查询。
下载链接:http://download.csdn.net/detail/crazycodings/9224379