创建简单Eclipse插件实现Axis WebService客户端

Apache Axis是Apache WebService项目中的子项目，其最初起源于IBM的"SOAP4J"，应该属于最早的一批用于构造基于SOAP应用的Framework。

目前Apache Axis已经发展到了第三代，其核心是一个SOAP处理器，用于开发包括客户端，服务器端，SOAP Gateway等各种应用。事实上Apache Axis在了1.0版后，其发行版本还包括了完整的J2EE服务器插件, WSDL支持和生成，TCP/IP监视器等组件，从这个意义上来说Apahce Axis已不仅仅是个SOAP框架了，它包含了除了UDDI外对整个Web Service协议栈 (Protocol Stack)的支持。

对大多数关心Macromedia产品的人来说，Macromedia是Axis小组的核心成员之一，他们在几乎所有J2EE服务器端的产品线中包含了Axis，也就是说Macromedia对WebService的支持是通过Apache Axis实现的，这其中包括了 JRun, Flex, ColdFusion。即便是Flash Remoting,由于其核心还是SOAP,所以也是使用了Axis的SOAP框架。
和.NET的WS不同，Axis是一个非常易于扩展的体系结构，其设计的核心思想是建立一个数据处理的管道，通过把handler编织成一条处理链从而无限扩展其可能性。打个比方,在输入部分开发人员既可以编写基于HTTP Basic Authentication的用户验证模块也可以插入 SOAP Auth模块用于验证请求，而输出部分既可以通过XML binding把结果输出为SOAP XML也可以象Flash Remoting那样把结果输出成binary格式。

同时Axis也提供了所有的处理模块，使得用户能在最快的时间把服务器组件发布成WS.总的来说Axis有以下几个特点:

速度 - Axis 使用 SAX 而不是 DOM 来处理XML请求,所以速度上有很大的改善。
灵活性 - 刚才也提到了，Axis的体系结构是一个全开放式的处理器，所以扩展模块极为方便。面向组件的发布方式 - 处理链上可重复使用组件来完成类似的操作。
Transport 框架 - Axis的核心和底层的transport完全分离，也就是说不管WS的Transport是HTTP, FTP, MAIL, MESSAGE QUEUE,只要插入对应的Transport模块即可，而不需改动其他部分。
WSDL1.1支持 - 可自动由Java Object生成WSDL

摘要:

本文描述了如果创建一个简单Eclipse插件来实现Axis WebService客户端，包括4个步骤：

1 建立Eclipse插件，修改plugin.xml

2 建立调用Web Service类，该类实现调用Axis的WebService

3 修改Action类的run方法

4 调试

1 建立Eclipse插件

File->New->Project->Plug-in development的Plug-in project->Next，填写Project名,Next, 填写内容，Next，选择Create plug-in using one of the templates，选择Hello，World，Finish。

在视图可看到plugin.xml,在<Runtime>里加上运行调用Web Service所需jar包。内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<?eclipse version="3.0"?>

<plugin

   id="colimas_plugin"

   name="Colimas_plugin Plug-in"

   version="1.0.0"

   provider-name="nova"

   class="colimas_plugin.Colimas_pluginPlugin">



   <runtime>

      <library name="colimas_plugin.jar">

         <export name="*"/>

      </library>

      <library name="lib/activation.jar">

         <export name="*"/>

      </library>

      <library name="lib/axis.jar">

         <export name="*"/>

      </library>

      <library name="lib/commons-beanutils.jar">

         <export name="*"/>

      </library>

      <library name="lib/commons-discovery-0.2.jar">

         <export name="*"/>

      </library>

      <library name="lib/commons-logging-1.0.4.jar">

         <export name="*"/>

      </library>

      <library name="lib/jaxrpc.jar">

         <export name="*"/>

      </library>

      <library name="lib/xalan.jar">

         <export name="*"/>

      </library>

      <library name="lib/xerces.jar">

         <export name="*"/>

      </library>

      <library name="lib/saaj.jar">

         <export name="*"/>

      </library>

      <library name="lib/mail.jar">

         <export name="*"/>

      </library>

   </runtime>



   <requires>

      <import plugin="org.eclipse.ui"/>

      <import plugin="org.eclipse.core.runtime"/>

   </requires>



   <extension

         point="org.eclipse.ui.actionSets">

      <actionSet

            label="Sample Action Set"

            visible="true"

            id="colimas_plugin.actionSet">

         <menu

               label="Sample &amp;Menu"

               id="sampleMenu">

            <separator

                  name="sampleGroup">

            </separator>

         </menu>

         <action

               label="&amp;Sample Action"

               icon="icons/sample.gif"

               class="colimas_plugin.actions.SampleAction"

               tooltip="Hello, Eclipse world"

               menubarPath="sampleMenu/sampleGroup"

               toolbarPath="sampleGroup"

               id="colimas_plugin.actions.SampleAction">

         </action>

      </actionSet>

   </extension>



</plugin>

2 建立调用Web Service类，该类实现调用Axis的WebService

/*

* Created on 2005/07/30

*

* TODO To change the template for this generated file go to

* Window - Preferences - Java - Code Style - Code Templates

*/

package com.nova.colimas.plugin.eclipse;

import org.apache.axis.client.Call;

import org.apache.axis.client.Service;

import javax.xml.namespace.QName;

import java.io.*;

/**

* @author tyrone

*

* TODO To change the template for this generated type comment go to

* Window - Preferences - Java - Code Style - Code Templates

*/

public class SendFileClient {



private Call call;

/**

  * The constructor.

  */

public SendFileClient() {

  try{

   Service  service= new Service();

   call    = (Call) service.createCall();

  }catch(Exception ex){

   System.out.println(ex.getMessage());

  }

}





public void saveFile(){

  try {

   String endpoint =

    "http://localhost:8080/axis/services/DocumentFileManagement";

   System.out.println("start web service");

   call.setTargetEndpointAddress( new java.net.URL(endpoint) );

   call.setOperationName(new QName("http://soapinterop.org/", "saveFile"));

   File fp=new File("D:\\MyProject\\colimas\\colimas_plugin\\lib\\mail.jar");

   BufferedInputStream in=new BufferedInputStream(new FileInputStream(fp));

   int len=in.available();

   byte[] contents=new byte[len];

   in.read(contents,0,len);

   System.out.println("begin run");



//开始调用Web Service：DocumentFileManagement的saveFile方法



   String ret = (String) call.invoke( new Object[] {fp.getName(),contents} );

   in.close();

  } catch (Exception e) {

   System.err.println("error"+e.toString());

  }

}



}

3 修改Action类的run方法

Action类的run方法里的内容是Eclipse插件真正要做到事

package colimas_plugin.actions;



import org.eclipse.jface.action.IAction;

import org.eclipse.jface.viewers.ISelection;

import org.eclipse.ui.IWorkbenchWindow;

import org.eclipse.ui.IWorkbenchWindowActionDelegate;

import org.eclipse.jface.dialogs.MessageDialog;



import com.nova.colimas.plugin.eclipse.*;

/**

* Our sample action implements workbench action delegate.

* The action proxy will be created by the workbench and

* shown in the UI. When the user tries to use the action,

* this delegate will be created and execution will be 

* delegated to it.

* @see IWorkbenchWindowActionDelegate

*/

public class SampleAction implements IWorkbenchWindowActionDelegate {

private IWorkbenchWindow window;

/**

  * The constructor.

  */

public SampleAction() {

}



/**

  * The action has been activated. The argument of the

  * method represents the 'real' action sitting

  * in the workbench UI.

  * @see IWorkbenchWindowActionDelegate#run

  */

public void run(IAction action) {

  SendFileClient client=new SendFileClient();

  client.saveFile();

  MessageDialog.openInformation(

    window.getShell(),

    "Colimas_plugin Plug-in",

    "Colimas Connected");

}



/**

  * Selection in the workbench has been changed. We 

  * can change the state of the 'real' action here

  * if we want, but this can only happen after 

  * the delegate has been created.

  * @see IWorkbenchWindowActionDelegate#selectionChanged

  */

public void selectionChanged(IAction action, ISelection selection) {

}



/**

  * We can use this method to dispose of any system

  * resources we previously allocated.

  * @see IWorkbenchWindowActionDelegate#dispose

  */

public void dispose() {

}



/**

  * We will cache window object in order to

  * be able to provide parent shell for the message dialog.

  * @see IWorkbenchWindowActionDelegate#init

  */

public void init(IWorkbenchWindow window) {

  this.window = window;

}

}

4 调试

首先启动Axis服务器，然后选择Eclipse的Run菜单的Run As -〉Run time workbench。

这样会启动另一个Eclipse workbench，在这个workbench里你会看到toolbar里新增了一个按钮，

点击按钮就会调用Webservice并返回控制台结果。

发表于 2009-03-04 20:55 两颗番茄阅读(1741) 评论(0) 编辑收藏举报

刷新页面返回顶部

创建简单Eclipse插件实现Axis WebService客户端

公告