AXIS1.4 DOC 阅读笔记

说明：这部分只要是Axis1.4Doc的摘要，只截取了我不明白和感兴趣的部分。可以当作一个快速索引和入门资料来看，如有不明白可直接查看Axis1.4的发布文档。
欢迎转载，但是请注明出处，转载地址： http://www.blogjava.net/ponzmd/articles/142045.html

• AXIS1.4 DOC 阅读笔记
• 安装介绍
  • 作为单独WebApplication安装
    • Step1:拷贝AXIS工程/webapps/axis到相应web服务器的部署目录即可
    • Step2:启动web服务器.访问: http://127.0.0.1:8080/axis/ 和 http://localhost:8080/axis/happyaxis.jsp ;如不正常改正错误即可
    • Step3:Test a SOAP Endpoint:http://localhost:8080/axis/services/Version?method=getVersion
    • Step4:Test a JWS Endpoint http://localhost:8080/axis/EchoHeaders.jws?method=list .
  • 集成AXIS
    • 1.Add axis.jar, wsdl.jar, saaj.jar, jaxrpc.jar and the other dependent libraries to your WAR file.
    • 2.Copy all the Axis Servlet declarations and mappings from axis/WEB-INF/web.xml and add them to your own web.xml
    • 3.Build and deploy your webapp.
    • 4.Run the Axis AdminClient against your own webapp, instead of Axis, by changing the URL you invoke it with
  • 遗留问题(没有配置成功)
    •  如何配置使用SOAPMonitor?
  • 注意事项
    • 配置Classpath一定要加入所有的Jar包，少一个都会错
• 用户向导
  • 什么是AXIS
    • AXIS: Apache EXtensible Interaction System
  • AXIS包括什么?
    • a SOAP engine -- a framework for constructing SOAP processors such as clients, servers, gateways
    • a simple stand-alone server
    • a server which plugs into servlet engines such as Tomcat
    • extensive support for the Web Service Description Language (WSDL)
    • emitter tooling that generates Java classes from WSDL
    • some sample programs,anda tool for monitoring TCP/IP packets
  • 使用AXIS
    • 部署WebService
      • 方式1：JWS：将需要部署的WebService的源文件改扩展名.java为.jws,将其至于工程的根目录下面，发布即告完成。需要注意的是：要部署的文件只能使用默认包。
      • 方式2：WSDD：编写WSDD文件，通过执行org.apache.axis.client.AdminClient来部署。也可以通过此类撤销已部署的WebService服务。
      • 配置WSDD，通过org.apache.axis.client.AdminClient来部署
        • WSDD: Web Service Deployment Descriptor
        • 基本配置：
          < deployment  xmlns ="http://xml.apache.org/axis/wsdd/"  xmlns:java ="http://xml.apache.org/axis/wsdd/providers/java" >   < service  name ="MyService"  provider ="java:RPC" >   < parameter  name ="className"  value ="samples.userguide.example3.MyService" />   < parameter  name ="allowedMethods"  value ="*" />   </ service >   </ deployment >   
          
        • 常用配置：配置JavaBean 客户端代码：
          QName qn  =   new  QName(  " urn:BeanService " ,  " Order "  ); call.registerTypeMapping(Order. class , qn,  new  org.apache.axis.encoding.ser.BeanSerializerFactory(Order. class , qn),  new  org.apache.axis.encoding.ser.BeanDeserializerFactory(Order. class , qn)); 
          WSDD文件：
          < beanMapping  qname ="myNS:Order"  xmlns:myNS ="urn:BeanService"  languageSpecificType ="java:samples.userguide.example5.Order" />  
          
          扩展配置：参照《Reference Material 》
    • 访问WebService
      • 编写服务访问客户端，并执行之（必要步骤，example3为例）
        • Step1：获取服务的访问地址：
          String endpointURL ＝ “http: // localhost:8080/axis/services/MyService"; 
           
        •  Step2：构建Service 和 Call对象：
           Service service  =   new  Service(); Call call  =  (Call) service.createCall(); 
        • Step3：确定访问目标：
          call.setTargetEndpointAddress(  new  java.net.URL(endpointURL) ); call.setOperationName(  new  QName( " http://example3.userguide.samples " ,  " serviceMethod " ) ); 
        • Step4：(可选) 配置参数类型：
           call.addParameter(  " arg1 " , XMLType.XSD_STRING, ParameterMode.IN); call.setReturnType( org.apache.axis.encoding.XMLType.XSD_STRING ); 
        • Step5：发起访问，并获取反馈:
          String ret  =  (String) call.invoke(  new  Object[]  { textToSend }  ); 
        • Step6：处理异常:
          try   {//上面那些  } catch (AxisFault fault) {et = "Error : " + fault.toString();} 
      • 通过WSDL来访问WebService（必要步骤，以Example6为例）
        • WSDL： Web Service Description Language Web服务器描述语言是用XML文档来描述Web服务的标准，是Web服务的接口定义语言，由Ariba、Intel、IBM、MS等共同提出，通过WSDL，可描述Web服务的三个基本属性：? 服务做些什么——服务所提供的操作（方法） ?#22914;何访问服务——和服务交互的数据格式以及必要协议 ?#26381;务位于何处——协议相关的地址，如URL
        • Step1：获得WSDL文件
          • 方式1：?WSDL http://<host>/axis/services/<service-name>?wsdl http://<host>/axis/*.jws?wsdl
          • 方式2：JAVA2WSDL工具 % java org.apache.axis.wsdl.Java2WSDL -o wp.wsdl -l"http://localhost:8080/axis/services/WidgetPrice" -n "urn:Example6" -p"samples.userguide.example6" "urn:Example6" samples.userguide.example6.WidgetPrice
            Where: -o indicates the name of the output WSDL file -l indicates the location of the service -n is the target namespace of the WSDL file -p indicates a mapping from the package to a namespace. There may be multiple mappings. the class specified contains the interface of the webservice.
        • Step2：通过WSDL2JAVA工具获得辅助类 % java org.apache.axis.wsdl.WSDL2Java -o . -d Session -s -S true -N urn:Example6 samples.userguide.example6 wp.wsdl
          WidgetPriceSoapBindingImpl.java : Java file containing the default server implementation of the WidgetPrice web service. You will need to modify the *SoapBindingImpl file to add your implementation WidgetPrice.java: 定义了Web服务接口 WidgetPriceService.java: 定义了用于获取Web服务接口的方法。 WidgetPriceServiceLocator.java: 定义了用于获取Web服务接口的方法。 WidgetPriceSoapBindingStub.java:Web服务客户端桩，通过该类与服务器交互。 WidgetPriceSoapBindingSkeleton.java: Server side skeleton. deploy.wsdd: Deployment descriptor undeploy.wsdd: Undeployment descriptor 这几个JAVA类帮我们处理了大部分的逻辑，我们需要的仅仅是把这些类加到我们的项目然后创建一个我们自己的类来调用它们即可
        • Step3：编写客户端代码: 通过***ServiceLocator构造***Service方法，通过***Service对象获得提供服务的类对象，进而调用提供服务类对象上的方法，提供服务。
    • 工具使用
      • the Axis TCP Monitor :java org.apache.axis.utils.tcpmon [listenPort targetHost targetPort]
      • the SOAP Monitor :
• WebService安全
  • 常见攻击方式
    • Denial of Service to a server
    • Interception and manipulation of messages
    • Forged client requests or Forged server responses
    • attempts to read the server file system/database
    • Attempts to write to the server file system/database
  • 判断来访者
    • AXIS不支持判断请求服务的是谁.可以使用 xmlsec.jar来支援它
    • AXIS推荐使用HTTPS来加强这种安全性
    • Axis 不支持HTTP1.1 Digest Authentication,需要the HttpClient libraries配合工作
  • 可考虑的安全措施
    • Disguise:不要让人知道你运行了AXIS
    • Cut down the build: 仅仅保留你需要的部分
    • Rename things:换掉默认的名称,如The AxisServlet, the AdminService, even happyaxis.jsp
    • Stop AxisServlet listing services :axis.enableListQuery =false
    • Keep stack traces out of the responses :axis.development.system =true
    • Edit the .wsdd configuration file, as described in the reference, to return a WSDL resource which is simply an empty <wsdl/> tag.
    • Servlets2.3: use filters for extra authentication
    • Log things
    • Run Axis with reduced Java rights
    • Run the web server with reduced rights
    • Monitor Load
    • Consider 'tripwire' and 'honeypot' endpoints(没明白)
• AXIS ANT Task
  • 在axis-ant.jar中定义
  • 主要任务
    • Creating Java files from WSDL
    • Creating WSDL files from Java
    • Talking to the admin service
    • 具体配置看文档
• 《Reference Material》
  • 其中注意包括了WSDL2JAVA，JAVA2WSDL的具体使用，以及WSDD的配置信息等技术细节

彭俊 2007-09-02 11:51 发表评论