服务linuxweb服务器

版权所有IBM公司2003商标创建、部署、发布和使用一个简单的Web服务第1页,共17创建、部署、发布和使用一个简单的Web服务Speed-startWebservices简介RonBen-Natan(rbennata@hotmail.
com)首席顾问RobinLissakAssociates2003年7月01日本文从头至尾地介绍了使用WebSphereStudio和WebSphereApplicationServer进行Web服务开发的整个生命周期.
我们将一个由六行代码构成的简单Java类包装成一个Web服务,然后将其发布到IBMUDDI业务测试注册中心(BusinessTestRegistry),这个类报告服务器的系统时钟.
本文包含将Web服务发布到Speed-start社区集合(CommunityCollection)的具体指示信息,Speed-start社区集合是IBMUDDI业务测试注册中心的附属部分,它是为IBMSpeed-startWebservices计划的参与者提供的.
(请参阅参考资料部分以了解如何访问测试注册中心和社区集合.
)本文向您介绍构建和部署的整个过程,包括:使用WebSphereStudio开发简单的Java类使用WebSphereStudio将Java代码包装成Web服务使用WebSphereStudio将Web服务和Java代码打包成企业应用程序将Web服务和Java代码部署到可从公众因特网访问的ApplicationServer上使用WebSphereStudio将服务发布到IBMUDDI业务测试注册中心上的Speed-start社区集合.
使用WebSphereStudio发现并导入在IBMUDDI业务测试注册中心上的Speed-start社区集合发布的服务.
本文假定您使用的WebSphereStudio和ApplicationServer的版本均为5.
0.
如果您运行的是WebSphereApplicationServerV4.
0,那么您需要确保您打包的企业应用程序符合J2EE1.
2(标题为创建Ear的一节中对此有更详细的介绍).
如果您运行的是WebSphereStudioV5.
0(与V5.
0.
1不同),那么您将需要升级至5.
0.
1或采用一个附加的手工操作步骤.
标题为您运行的是WebSphereStudioV5.
0.
1吗这一节介绍了详细的信息.
实现服务您首先将创建一个新的项目和一个类,这个类将实现一个简单的服务:返回服务运行所在服务器的系统日期和时间.
这允许一个远程调用者获取该服务器的日期/时间.
创建新的Web项目developerWorksibm.
com/developerWorks/cn/创建、部署、发布和使用一个简单的Web服务第2页,共17要创建新的Web项目,请从菜单栏选择File>New>Project.
这就打开了NewProject向导.
在左边窗格中选择Web,在右边窗格中选择WebProject,然后单击Next按钮.
这将打开向导中的下一个对话框(如图1所示),您将在其中定义Web项目.
将项目名设置为ServerClock(或您自己使用的名称),然后单击Finish按钮.
您可以通过单击Next按钮,指定将在新的企业应用程序项目中使用该项目,也可以以后将该项目手工添加到企业项目中.
创建RemoteServerClock类现在,您需要构建RemoteServerClock类.
这个类实现返回服务器日期/时间的服务.
在包资源管理器(PackageExplorer)中,在ServerClock文件夹上单击鼠标右键,然后选择New>Class.
这就打开了JavaClass对话框,它允许您创建新的Java类.
输入包名和类名,如图2所示.
ibm.
com/developerWorks/cn/developerWorks创建、部署、发布和使用一个简单的Web服务第3页,共17现在,您需要编写这个类的代码,它是一个返回单个字符串的非常简单的方法:packageedu.
wsspeedstart;publicclassRemoteServerClock{publicStringgetServerClock(){returnjava.
util.
Calendar.
getInstance().
getTime().
toString();}}创建Web服务既然有了将日期/时间作为字符串返回的方法,就可以把它包装成一个Web服务.
选择项目和类从菜单栏选择File>New>Other.
这就打开了一个对话框,在左边窗格中选择WebServices,然后在右边窗格中选择WebService.
单击Next按钮,转至向导的下一页.
选择JavaBeanWebService作为Web服务类型,并且选中复选框以生成Java代理,以便可以在WebSphereStudio测试环境中测试Web服务.
单击Next按钮转至向导的下一步.
保留Web服务部署环境选择中的UseDefaults选项,确保选中了ServerClockWeb项目.
单击Next按钮转至向导的下一步.
在向导的下一个屏中,会让您选择要以Web服务公开的类.
选择RemoteServerClock,然后单击Next按钮(请参阅图3).
developerWorksibm.
com/developerWorks/cn/创建、部署、发布和使用一个简单的Web服务第4页,共17在这个阶段,您已经指定了要将哪个功能包装成Web服务;单击Next按钮以设置URN.
设置服务URN服务URN唯一地标识服务.
因为您正在为现有的一段代码(RemoteServerClock类)构建Web服务包装器,所以需要告诉服务器如何将唯一的服务标识符映射至实现类;运行时将用它标识在收到请求时执行服务的类.
如图4所示,将WebserviceURI域设置成urn:RemoteServerClock,将Scope设置成Session.
单击Finish按钮.
构建代理和测试客户机在将Web服务部署到ApplicationServer之前,应在WebSphereStudio内测试代码.
这很容易做到,因为WebSphereStudio会自动生成一个代理和一个简单的客户机应用程序.
代理是一个Java类,它包装一个code对象,将URN放入该对象,然后调用请求.
在服务器端,URN被抽取出来并用来查找应接收该请求的类.
所有这些都是在服务器端通过一个名为RPC路由器的特殊servlet完成的,该servlet是ApplicationServer运行时的一部分.
通信路径如图5所示.
ibm.
com/developerWorks/cn/developerWorks创建、部署、发布和使用一个简单的Web服务第5页,共17客户机是一个简单的JavaServerPage(JSP)页,它使用代理调用服务器(在本例中,代理和服务器都驻留在WebSphereStudio内).
测试应用程序有三个窗格.
在左边窗格中,选择希望调用的Web服务方法.
单击getServerClock().
右上方的窗格就会包含与服务输入参数(本例中无输入参数)相匹配的表单.
单击Invoke按钮.
右下方的窗格显示服务的输出—运行应用程序的机器的日期/时间.
如果您打开了控制台窗格,您将看到ApplicationServer发出的各种日志消息,如图6所示.
将应用程序打包以进行部署既然您的服务正在运行,您就可以进一步将其打包,以把它部署成ApplicationServer内的一个企业应用程序.
修改WSDL首先要做的是修改WSDL,以便要发现您服务的客户机能在ApplicationServer实例中找到它,而不是在缺省设置的本地主机中找到,只有在WebSphereStudio的WebSphere测试环境中运行时后一种情况才起作用.
服务接口文件(RemoteServerClockService.
wsdl)包括有关服务及WSDL文件所驻留位置的地址信息.
当WebSphereStudio生成这些文件时,它将这些位置指向测试环境.
例如,SOAP地址元素看起来如下所示(假定测试环境在端口9080侦听):这对测试您的代码有用,但一旦您要着手部署应用程序,则应当修改地址信息.
如果您要部署到一个名为xxx.
yyy.
zzz的可从因特网访问的节点(端口为ppp),那么将每个localhost:9080实例改成xxx.
yyy.
zzz:ppp,如在端口80部署,则改成xxx.
yyy.
zzz.
developerWorksibm.
com/developerWorks/cn/创建、部署、发布和使用一个简单的Web服务第6页,共17为了将Web服务作为EAR部署,需要将该服务包含在企业应用程序中.
使用File菜单选择New>Project.
.
.
,然后在左边窗格中选择J2EE,在右边窗格中选择EnterpriseApplicationProject.
单击Next按钮.
然后选择是希望创建J2EE1.
2应用程序,还是希望创建J2EE1.
3应用程序.
如果您将在WebSphereApplicationServerV4.
0上部署,您应当使用J2EE1.
2.
如果您使用的是WebSphereApplicationServerV5.
0,则可以两者任选其一,但选择J2EE1.
3更合适.
单击Next按钮,转至向导的下一步,在其中设置企业应用程序名称.
取消选择任何其它模块,因为您将手工添加Web项目—您的屏幕看起来应当如图7所示,然后您可以单击Finish按钮来创建企业应用程序.
添加WAR在导航窗格中打开enterpriseapplicationproject.
第一项是ApplicationDeploymentDescriptor.
双击部署描述符(deploymentdescriptor),以便在右上方的编辑窗格中打开它.
右上方是该企业应用程序内所有模块的列表;这个列表是空的,因为该企业应用程序还只是一个空壳.
单击Details按钮,在模块编辑器中,单击模块列表正下方的Add.
.
.
按钮.
从列表中选择ServerClock模块,然后单击Finish按钮.
现在,模块列表看起来应当如图8所示.
ibm.
com/developerWorks/cn/developerWorks创建、部署、发布和使用一个简单的Web服务第7页,共17保存应用程序部署描述符以便导出企业应用程序.
导出EAR最后一步是将应用程序打包成EAR.
通过从菜单栏选择Project>RebuildAll,最后一次重新构建项目.
在Navigator窗格中,在企业应用程序项目上单击鼠标右键,然后选择Export.
然后从向导的列表中选择EARFile.
选择文件要导出的目录,然后单击Finish按钮.
WebSphereStudio将创建带嵌入式WAR文件的EAR文件,WAR文件包括所有特定于Web服务的信息以及实现代码.
在WebSphereApplicationServer上部署既然您已经创建了EAR文件,就可以进一步在应用程序服务器上安装企业应用程序.
启动管理员控制台要部署应用程序和Web服务,可使用WebSphere管理员控制台(WebSphereAdministratorConsole).
确保ApplicationServer正在运行,如果没有,则启动HTTP服务器和WebSphereApplicationServer.
通过将浏览器导航至http://localhost:9090/admin,打开管理员控制台.
输入用户标识,然后单击OK按钮.
安装企业应用程序—指定EAR使用左边的Navigator窗格,转至Applications>InstallNewApplication.
输入EAR文件的路径,或使用Browse按钮找到它.
因为正在部署EAR文件,所以不需要指定任何其它内容—所有的应用程序属性都嵌入在EAR中.
向导应当和图9相似.
单击Next按钮.
部署Web模块developerWorksibm.
com/developerWorks/cn/创建、部署、发布和使用一个简单的Web服务第8页,共17因为EAR包含Web模块,所以您需要指定应该在哪台虚拟主机上部署它.
ApplicationInstallation向导中的下一个窗口让您指定虚拟主机.
保留default_host值,然后单击Next按钮.
如果您不想修改缺省部署参数,则再次单击Next.
将所有Web模块映射至缺省主机,如图10所示,然后单击Next按钮.
完成企业应用程序的安装在向导的下一步(请参阅图11)中,选择将要部署Web模块的单元和服务器,然后单击Next.
最后,确认所有的应用程序细节都是正确的,然后单击Finish按钮.
应用程序将得以安装—这可能要花一些时间,请耐心等待.
如果一切顺利,您将在屏幕上看到一组打印输出,其形式如下:ADMA5005I:ApplicationServerClockEAconfiguredinWebSphererepositoryADMA5001I:Applicationbinariessavedinf:\\ProgramFiles\\WebSphere\\AppServer\\wstemp\\admin\\workspace\\cells\\rbn\\applications\\ServerClockEA.
ear\\ServerClockEA.
earADMA5011I:CleanupoftempdirforappServerClockEAdone.
ADMA5013I:ApplicationServerClockEAinstalledsuccessfully.
ApplicationServerClockEAinstalledsuccessfully.
通过单击SavetoMaster配置链接,然后单击Save按钮,将更改保存到主配置中.
现在,当您在Navigator窗格中单击EnterpriseApplications链接时,您应该能看到新的企业应用程序.
重新生成Web服务器插件在启动Web服务之前,需要重新生成Web服务器插件.
插件控制Web服务器和ApplicationServer之间的通信.
Web服务器插件需要知道:必须将前缀为ServerClock的URL转发至WebSphereApplicationServer.
该插件通过使用以下格式的URL来访问服务:http:///ServerClock/servlet/rpcrouter.
最后,重新启动Web服务器和应用程序服务器.
您的服务现在部署到了ApplicationServer上,并且可以从因特网访问它.
现在,通过将Web服务发布到UDDI注册中心,确保其他人知道它.
ibm.
com/developerWorks/cn/developerWorks创建、部署、发布和使用一个简单的Web服务第9页,共17将Web服务发布到UDDI注册中心既然您的Web服务已经部署到ApplicationServer,那么剩下的最后一步就是将该Web服务发布到UDDI测试注册中心;您将需要使用一个特殊的类别以便在Speed-start计划下发布您的Web服务.
但首先要做的是在测试注册中心获得一个注册的用户名.
在IBMUDDI业务测试注册中心上注册为用户IBMUDDI业务测试注册中心是一个公用的UDDI注册中心,它可以用来向公众注册企业和服务.
它最常用于测试Web服务的发布和发现.
在向该注册中心发布Web服务之前,需要设置用户帐户.
打开浏览器,导航至https://uddi.
ibm.
com/testregistry/registry.
html.
然后单击GetanIBMuserIDandpassword链接.
填写注册页;需要记住的最重要的值是标识和密码.
确保电子邮件帐户拼写正确,因为您需要接收一封激活电子邮件.
在接受使用UDDI注册中心的许可证条款并完成注册之后,您将收到一封激活电子邮件,其标题为IBMUDDIRegistrationNotice.
单击该电子邮件中的链接以激活您的帐户.
您正在运行WebSphereStudioV5.
0.
1吗既然您有了测试注册中心的帐户,就可以继续下一步操作:在UDDI注册中心中发布刚在ApplicationServer上安装的Web服务.
您应当检查是否正在运行WebSphereStudioV5.
0.
1;如果正在运行V5.
0,您将需要手工执行一个步骤,以便发布您的服务(请参阅没有升级到V5.
0.
1时的特殊指示信息).
如果正在运行V5.
0并且按正常的过程操作,您将在UDDI资源管理器中接收到一个异常信息,如图12所示,并且将不能发布服务.
developerWorksibm.
com/developerWorks/cn/创建、部署、发布和使用一个简单的Web服务第10页,共17升级到V5.
0.
1就简单多了.
只要您正在使用高速因特网连接,这就是一个简单的步骤.
升级需要两个PTF,大小总共为240MB左右,当您没有高速连接时,这样的大小才会成为问题.
升级到V5.
0.
1很容易—只需遵循在http://www3.
software.
ibm.
com/ibmdl/pub/software/websphere/studiotools/html/501/wsad/install.
html中提供的指示信息,这些信息显示了如何安装5.
0.
1PTF.
打开Web服务资源管理器假定您正在使用V5.
0.
1,要打开Web服务资源管理器(ServicesExplorer),请从菜单栏选择File>Export.
在Export向导中,选择WebService,然后单击Next按钮(请参阅图13).
选中LaunchtheWebServicesExplorer框以将该Web服务发布到UDDI注册中心,并且确保IBMUDDI测试注册中心被选中;单击Finish按钮以启动Web服务资源管理器.
发布企业在将Web服务发布到UDDI注册中心之前,需要发布企业.
在Navigator窗格(左边窗格)中,单击IBMTestRegistry链接.
在Actions窗格(右上方窗格)的工具栏中,单击Publish工具(请参阅图14).
ibm.
com/developerWorks/cn/developerWorks创建、部署、发布和使用一个简单的Web服务第11页,共17确保在Publish下拉菜单中选中Business选项,输入注册时使用的用户标识和密码,以及要发布企业的名称/描述.
单击Go.
在右下方的Status窗格中,您将看到企业已经成功发布.
您现在应当添加一些标识,如电话号码、传真号码和联系人姓名等.
单击Add按钮以添加标识并填写域.
您还应当添加该企业所属的类别(类似于黄页分类模式).
如果您的企业属于多个企业类别,您可以添加多个类别.
完成后,使用Go按钮提交表单.
发布服务一旦您发布了企业,就可以继续下一步:发布服务本身.
您应当还能浏览企业,如果不能,则使用左边的Navigator窗格以选择企业实体.
在右上方窗格的Actions工具栏上,单击PublishBusinessService工具(请参阅图15).
输入指向您WSDL文件的URL.
这是发布过程中最重要的部分,因为WSDL文件服务实现文件定义了服务端点.
使用正确的分类在发布服务之前,您需要指定服务的一个或多个名称、描述和分类.
添加名称和描述以便人们能轻松地搜索您的服务.
注:除了要给服务标记的任何分类之外,您还需要给要在Speed-start社区集合中注册的服务添加一个特殊的类别.
这是用Speed-start计划列出服务所必须完成的最后一步.
如果您升级到5.
0.
1,这项任务非常简单.
在Categories部分中,添加一个类别并且选择dWCommunity类型.
然后单击Browse.
.
.
链接(请参阅图16).
在如图17所示的弹出对话框中,选择SpeedStart选项.
这一特殊类别将把UDDI测试注册中心中发布的服务归为SpeedStart服务.
developerWorksibm.
com/developerWorks/cn/创建、部署、发布和使用一个简单的Web服务第12页,共17没有升级到5.
0.
1时的特殊指示信息如果您选择不升级至V5.
0.
1,不要单击Browse按钮!
而应手工输入SpeedStart键值,然后发布服务.
这将有同样的结果.
验证Speed-start发布为了验证您的服务的确在测试资源库中,并且在Speed-start计划下是可查看的,请转至Speed-start社区集合(请参阅参考资料一节).
您的服务应如图18所示.
ibm.
com/developerWorks/cn/developerWorks创建、部署、发布和使用一个简单的Web服务第13页,共17发现并测试服务既然您知道服务在注册中心上发布,让我们看看使用者如何能发现并使用该服务.