以上软件请访问
http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuseQuickStart_zh
根据相关提示下载
同时对以上变量，都设置相关的HOME变量及路径。

下面开始一步步操作完成appfuse的布署工作

1，解压appfuse1.8.2（或更高版本），会产生一个appfuse的目录。
2，打开eclipse3.0或eclipse3.1，选择菜单，“新建工程”-->"Java Project"---->工程名"appfuse"后，指定一个工程目录后，完成。
3，先复制第一步中appfuse目录下所有文件，然后右键点击"appfuse"工程名，选择“粘贴”，把appfuse的所有的文件导入到appfuse工程中。
4，在eclipse下选择"windows"菜单--->"Preference"菜单--->"ant"--->"Runtime"---->点“ant      home”按钮,设备ant-home目录，同时复制junit.jar到ant安装目录下的lib目录里
5,在安装mysql服务器后，如果设置了密码的话，要点，windows菜单--->show views---> ant 。出现ant工具界面，在界面上，点add buildfiles图标，把appfuse工程根目录下的build.xml文件中附加进来，然后再打开properties.xml文件，修改里面的root用户的密码为你的mysql数据库访问时的密码。然后在ant菜单界面中展开target列表，选择，setup目录安装所有装备工作，
详细ant任务可以参照http://www.kingbit.com/appfuse/index.php上所描述的ant任务详解。
运行ant setup-tomcat 然后再运行，ant start-tomcat
然后在浏览器中打http://localhost:8080/appfuse
看看有没有出现界面
操作用户名及密码是tomcat tomcat
6,当上面都配置正确后，我们就来开始写一个新的操作了，先写个dao类下的model类
在eclipse下，展开src/dao文档结构，在org.appfuse.model下面，建个Person.java文件，
内容如下图：

/*
 * Created on 2006-5-22
 *
 * TODO To change the template for this generated file go to
 * Window - Preferences - Java - Code Style - Code Templates
 */
package org.appfuse.model;

/**
 * @author Administrator
 *
 * TODO To change the template for this generated type comment go to
 * Window - Preferences - Java - Code Style - Code Templates
 * @hibernate.class table="person"
 */
public class Person  extends BaseObject{
 private Long id;
 private String first_name;
 
 /**
  * @return Returns the id.
  * @hibernate.id column="id"  generator-class="increment"
     *              
  */
 public Long getId() {
  return id;
 }
 /**
  * @param id The id to set.
  */
 public void setId(Long id) {
  this.id = id;
 }
 /* (non-Javadoc)
  * @see org.appfuse.model.BaseObject#toString()
  */
 
 public String toString() {
  // TODO Auto-generated method stub
  return null;
 }
 /* (non-Javadoc)
  * @see org.appfuse.model.BaseObject#equals(java.lang.Object)
  */
 public boolean equals(Object o) {
  // TODO Auto-generated method stub
  return false;
 }
 /* (non-Javadoc)
  * @see org.appfuse.model.BaseObject#hashCode()
  */
 public int hashCode() {
  // TODO Auto-generated method stub
  return 0;
 }
 
 /**
  * @return Returns the first_name.
  * @hibernate.property column="first_name" not-null="true"
  */
 public String getFirst_name() {
  return first_name;
 }
 /**
  * @param first_name The first_name to set.
  * @spring.validator type="required" //该字段需要验证，用Spring的校验机制
  */
 public void setFirst_name(String first_name) {
  this.first_name = first_name;
 }
}

在以上代码中注释javadoc区域中添加上xdoclet在生成hibernate所用到的XML文件的一些O/R映射信息。

建好上以Person.java后，我们就开始利用xdoclet工具，配合ant任务，生成我们所需用到了数据库表结构了，
点ant db-create 后，可以在控制台下看到一系列建表的语句，同时可以到mysql控制台查看到相关信息.
表建好后，我们就开始利用appgen自动生成appfuse所需要的其它dao操作类，manage业务类，controller控制器类及Person.hbm.xml等相关文件
。操作过程如下，到dos命令行模式下，找到工程所在的根目录下\extras\appgen目录，点运行ant install-detailed
会根据提示，建Person及person相关文件。Build成功后，再回到eclipse下，右键点工程文件名appfuse,选择Refresh ,再运行ant deploy命令，再重新启TOMCAT,这样一个Person的添加，删除操作功能模块就完成了，开发就是这么easy and fast!!^_^
@spring.validator type="required" 是另外附

appgen生成的类文件如下：

PersonDAO接口类
PersonDAOHibernate接口实现类
PersonManager业务接口类
PersonManagerImpl.java业务接口实现类
PersonController.java控制器类(根据客户端提交的请求，显示的是信息列表)
PersonFormController页面控制器类（根据客户端提交的请求，修改，添加，删除操作控制类）

注意在生成dao接口类的时候，appgen会根据Person类中的hibernate的注释标记，生成对应的Person.hbm.xml文件
修改org.appfuse.dao.hibernate.applicationContext-hibernate.xml文件，
追加
 <bean id="sessionFactory" class="org.springframework.orm.hibernate3.LocalSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <property name="mappingResources">
            <list>
                <value>org/appfuse/model/Role.hbm.xml</value>
                <value>org/appfuse/model/User.hbm.xml</value>
                <value>org/appfuse/model/UserCookie.hbm.xml</value>
                <value>org/appfuse/model/Person.hbm.xml</value>
  <value>org/appfuse/model/Book.hbm.xml</value>    
            </list>
        </property>
        <!-- The property below is commented out b/c it doesn't work when run via
             Ant in Eclipse.  It works fine for individual JUnit tests and in IDEA ??
        <property name="mappingJarLocations">
            <list><value>file:dist/appfuse-dao.jar</value></list>
        </property>
        -->
        <property name="hibernateProperties">
        <props>
            <prop key="hibernate.dialect">@HIBERNATE-DIALECT@</prop>
            <!-- Create/update the database tables automatically when the JVM starts up
            <prop key="hibernate.hbm2ddl.auto">update</prop> -->
            <!-- Turn batching off for better error messages under PostgreSQL
            <prop key="hibernate.jdbc.batch_size">0</prop> -->
        </props>
        </property>
    </bean>
    同时指定动态指定接口的实现类
<!--Person-START-->
    <bean id="personDAO" class="org.appfuse.dao.hibernate.PersonDAOHibernate" autowire="byName"/>
    <!--Person-END-->
注意在业务接口类操作时，要运用SPRING的IOC进行对业务逻辑的处理，
修改org.appfuse.service目录下的，applicationContext-service.xml文件

追加以下配置

<!--Person-START-->
    <bean id="personManager" parent="txProxyTemplate">
        <property name="target">
            <bean class="org.appfuse.service.impl.PersonManagerImpl" autowire="byName"/>
        </property>
    </bean>
    <!--Person-END-->
在personManagerImpl.java文件中装PersonDao接口的Instance注入到personManager容器中。

PersonDAO接口类

package org.appfuse.dao;

import java.util.List;

import org.appfuse.model.Person;

public interface PersonDAO extends DAO {

    /**
     * Retrieves all of the persons
     */
    public List getPersons(Person person);

    /**
     * Gets person's information based on primary key. An
     * ObjectRetrievalFailureException Runtime Exception is thrown if
     * nothing is found.
     *
     * @param id the person's id
     * @return person populated person object
     */
    public Person getPerson(final Long id);

    /**
     * Saves a person's information
     * @param person the object to be saved
     */ 
    public void savePerson(Person person);

 /**
     * Removes a person from the database by id
     * @param id the person's id
     */
    public void removePerson(final Long id);
}

PersonDAOHibernate接口实现类

package org.appfuse.dao.hibernate;

import java.util.List;

import org.appfuse.model.Person;
import org.appfuse.dao.PersonDAO;

import org.springframework.orm.ObjectRetrievalFailureException;

public class PersonDAOHibernate extends BaseDAOHibernate implements PersonDAO {

    /**
     * @see org.appfuse.dao.PersonDAO#getPersons(org.appfuse.model.Person)
     */
    public List getPersons(final Person person) {
        return getHibernateTemplate().find("from Person");

        /* Remove the line above and uncomment this code block if you want
           to use Hibernate's Query by Example API.
        if (person == null) {
            return getHibernateTemplate().find("from Person");
        } else {
            // filter on properties set in the person
            HibernateCallback callback = new HibernateCallback() {
                public Object doInHibernate(Session session) throws HibernateException {
                    Example ex = Example.create(person).ignoreCase().enableLike(MatchMode.ANYWHERE);
                    return session.createCriteria(Person.class).add(ex).list();
                }
            };
            return (List) getHibernateTemplate().execute(callback);
        }*/
    }

    /**
     * @see org.appfuse.dao.PersonDAO#getPerson(Long id)
     */
    public Person getPerson(final Long id) {
        Person person = (Person) getHibernateTemplate().get(Person.class, id);
        if (person == null) {
            log.warn("uh oh, person with id '" + id + "' not found...");
            throw new ObjectRetrievalFailureException(Person.class, id);
        }

        return person;
    }

    /**
     * @see org.appfuse.dao.PersonDAO#savePerson(Person person)
     */   
    public void savePerson(final Person person) {
        getHibernateTemplate().saveOrUpdate(person);
    }

    /**
     * @see org.appfuse.dao.PersonDAO#removePerson(Long id)
     */
    public void removePerson(final Long id) {
        getHibernateTemplate().delete(getPerson(id));
    }
}

PersonManager业务接口类

package org.appfuse.service;

import java.util.List;

import org.appfuse.model.Person;
import org.appfuse.dao.PersonDAO;

public interface PersonManager extends Manager {

    /**
     * Setter for DAO, convenient for unit testing
     */
    public void setPersonDAO(PersonDAO personDAO);

    /**
     * Retrieves all of the persons
     */
    public List getPersons(Person person);

    /**
     * Gets person's information based on id.
     * @param id the person's id
     * @return person populated person object
     */
    public Person getPerson(final String id);

    /**
     * Saves a person's information
     * @param person the object to be saved
     */
    public void savePerson(Person person);

    /**
     * Removes a person from the database by id
     * @param id the person's id
     */
    public void removePerson(final String id);
}

PersonManagerImpl业务接口实现类

package org.appfuse.service.impl;

import java.util.List;

import org.appfuse.model.Person;
import org.appfuse.dao.PersonDAO;
import org.appfuse.service.PersonManager;

public class PersonManagerImpl extends BaseManager implements PersonManager {
    private PersonDAO dao;

    /**
     * Set the DAO for communication with the data layer.
     * @param dao
     */
    public void setPersonDAO(PersonDAO dao) {
        this.dao = dao;
    }

    /**
     * @see org.appfuse.service.PersonManager#getPersons(org.appfuse.model.Person)
     */
    public List getPersons(final Person person) {
        return dao.getPersons(person);
    }

    /**
     * @see org.appfuse.service.PersonManager#getPerson(String id)
     */
    public Person getPerson(final String id) {
        return dao.getPerson(new Long(id));
    }

    /**
     * @see org.appfuse.service.PersonManager#savePerson(Person person)
     */
    public void savePerson(Person person) {
        dao.savePerson(person);
    }

    /**
     * @see org.appfuse.service.PersonManager#removePerson(String id)
     */
    public void removePerson(final String id) {
        dao.removePerson(new Long(id));
    }
}

PersonController控制器类
注意在产生这个控制器类的作用是为了将PersonManager接口通过IOC注入并Instance
能够调用dao类取得的数据结果集返回给客户浏览器的请求。请求的mappingUrl地址又是在WEB/WEB-INF目录下action-servlet.xml
文件下进行配置的
<!--Person-BEAN-START-->
  <bean id="personController" class="org.appfuse.webapp.action.PersonController" autowire="byName"/>

    <bean id="personFormController" class="org.appfuse.webapp.action.PersonFormController" autowire="byName">
        <property name="commandName" value="person"/>
        <property name="commandClass" value="org.appfuse.model.Person"/>
        <property name="validator" ref="beanValidator"/>
        <property name="formView" value="personForm"/>
        <property name="successView" value="redirect:persons.html"/>
    </bean>
    <!--Person-BEAN-END-->

    <!--Person-URL-START-->
                <prop key="/persons.html">personController</prop>
                <prop key="/editPerson.html">personFormController</prop>
                <!--Person-URL-END-->
package org.appfuse.webapp.action;

import java.util.List;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.commons.beanutils.BeanUtils;

import org.appfuse.Constants;
import org.appfuse.model.Person;
import org.appfuse.service.PersonManager;

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

public class PersonController implements Controller {
    private final Log log = LogFactory.getLog(PersonController.class);
    private PersonManager personManager = null;

    public void setPersonManager(PersonManager personManager) {
        this.personManager = personManager;
    }

    public ModelAndView handleRequest(HttpServletRequest request,
                                      HttpServletResponse response)
    throws Exception {
        if (log.isDebugEnabled()) {
            log.debug("entering 'handleRequest' method...");
        }

        Person person = new Person();
        // populate object with request parameters
        BeanUtils.populate(person, request.getParameterMap());

        List persons = personManager.getPersons(person);

        return new ModelAndView("personList", Constants.PERSON_LIST, persons);
    }
}

PersonFormController添加修改删除操作控制器类。

package org.appfuse.webapp.action;

import java.util.Locale;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.commons.lang.StringUtils;
import org.appfuse.model.Person;
import org.appfuse.service.PersonManager;
import org.springframework.validation.BindException;
import org.springframework.web.servlet.ModelAndView;

public class PersonFormController extends BaseFormController {
    private PersonManager personManager = null;

    public void setPersonManager(PersonManager personManager) {
        this.personManager = personManager;
    }

    protected Object formBackingObject(HttpServletRequest request)
    throws Exception {
        String id = request.getParameter("id");
        Person person = null;

        if (!StringUtils.isEmpty(id)) {
            person = personManager.getPerson(id);
        } else {
            person = new Person();
        }

        return person;
    }

    public ModelAndView onSubmit(HttpServletRequest request,
                                 HttpServletResponse response, Object command,
                                 BindException errors)
    throws Exception {
        if (log.isDebugEnabled()) {
            log.debug("entering 'onSubmit' method...");
        }

        Person person = (Person) command;
        boolean isNew = (person.getId() == null);
        Locale locale = request.getLocale();

        if (request.getParameter("delete") != null) {
            personManager.removePerson(person.getId().toString());

            saveMessage(request, getText("person.deleted", locale));
        } else {
            personManager.savePerson(person);

            String key = (isNew) ? "person.added" : "person.updated";
            saveMessage(request, getText(key, locale));

            if (!isNew) {
             return new ModelAndView("redirect:editPerson.html", "id", person.getId());
            }
        }

        return new ModelAndView(getSuccessView());
    }
}

在布署公司的产品过程中，mine的WAR应用，在执行ant compile-dao过程中，会报一个，找不到org.eclipse.jta的错误，
这是由于ant找不到eclipse的关于jta的插件的原因！解决办法是，在ant架包中，把eclipse 安装目录下的plugns目录下的org.eclipse.jdt.core_3.0.
（E:\eclipse\plugins\org.eclipse.jdt.core_3.0.0\）目录中两个jar文件加入到ant的lib目录下！

xdoclet在执行ant的deploy的任务时，有时候生成的XML文件格式会出现小小的问题，解决的办法是修改相关的JAVA文件，然后运行deploy脚本重新利用
xdoclet来生成相关的xml文件！直至成功！

首页登录在调用loginServlet时候，login.jsp页面能正确显示出来，但是提交到服务器的/authorize的action映射找不到，也就是找不到服务，
这是由于tomcat是启动在8080端口的服务，而程序中，用户登录的校验是根据properties.xml文件中，配置的
<property name="http.port" value="8080"/>这个端口号，默认的是80端口，可以通过把TOMCAT启动时监听80端口或，修改properties.xml文件中
http.port的value="8080",就可以找到服务器响应。注意，这里/authorize的映射,不是通过spring的IOC操作的，而是通过在web.xml文件中加入一个
 <filter>
  <filter-name>securityFilter</filter-name>
  <filter-class>net.sf.acegisecurity.util.FilterToBeanProxy</filter-class>
- <init-param>
  <param-name>targetClass</param-name>
  <param-value>net.sf.acegisecurity.util.FilterChainProxy</param-value>
  </init-param>
  </filter>
<filter-mapping>
  <filter-name>securityFilter</filter-name>
  <url-pattern>/j_security_check</url-pattern>
  </filter-mapping>

来实现的

但是一定要记得，文件net.sf.acegisecurity.util.FilterChainProxy是在acegi-security-x.x.x.jar包里面的，调用前一定要记得放在应用的WEB-INF/lib/目录下才能正常使用。

当系统启动时会自动加载spring配置文件中所声明的类，在appfuse中这一声明是放在action-servlet.xml中的，因此必须将这个文件同其他的applicationContext.xml一起在web.xml中声明为contextConfigLocation的内容，如下：

   <context-param>
  <param-name>contextConfigLocation</param-name>
  <param-value>classpath*:META-INF/applicationContext-*.xml /WEB-INF/applicationContext-*.xml /WEB-INF/schedulingContext-timer.xml</param-value>
  </context-param>

在action-servlet.xml中定义如下（这个文件必须符合spring-beans.dtd的规范）：

<beans>   
   
    <bean id="userAction" class="com.mywap.webwork.action.UserAction" singleton="false">
        <property name="userManager"><ref bean="userManager"/></property>
    </bean>
   
    <!-- Add additional actions here -->
</beans>

acegi出了0.8,改动还真不少，原先0.7的应用，改了一个多小时才完全升级成功。备忘一下：

1 最贴心的改变莫过于 filter chains可以放在spring 容器中加载了，再也不用在Web.XML中声明长长的一串filter了。例如：

 <bean id="filterChainProxy" class="net.sf.aceGISecurity.util.FilterChainProxy">
      <property name="filterInvocationDefinitionSource">
         <value>
         CONVERT_URL_TO_LOWERCASE_BEFORE_COMPARISON
          PATTERN_TYPE_APACHE_ANT
            /**=httpSessionContextIntegrationFilter,authenticationProcessingFilter,......
         </value>
      </property>
    </bean>

2 HttpSessionIntegrationFilter 已经消失，使用net.sf.acegisecurity.context.HttpSessionContextIntegrationFilter取而代之，如：
    <bean id="httpSessionContextIntegrationFilter" class="net.sf.acegisecurity.context.HttpSessionContextIntegrationFilter">
      <property name="context"><value>net.sf.acegisecurity.context.security.SecureContextImpl</value></property>
    </bean>

这个"context"属性不可不设哟。

3 新增了一个功能，可以在web.xml中声明一个HttpSessionEventPublisher context listener,想想Spring的现在还不很成熟的消息发布机制(AOP),主要是用来记日志。我暂时还没用到这个功能。

mine在通过ant deploy任务到TOMCAT下,会把hibernate的表映射文件,连同持久化的类文件,打包成一个,mine-dao.jar架包,放到web-inf/lib私有目录下

本文并不是想介绍Web服务的原理、系统架构等，我们假设您已经了解了关于Web服务的一些基本的概念、原理等知识。本文主要是针对那些已经了解Web服务概念，但是还没有亲身体会Web服务所带来令人欢欣鼓舞的特征的开发人员。在此我们认为你已经具备了Java、XML等基础知识，如果你还有其他开发环境的经验例如VB、VC那是再好不过的了。

1．Web服务

虽然我们并不想详细讲述Web服务的体系结构，但是大概的介绍一下还是有必要的。Web服务是一种新型的Web应用程序。不同于其他Web应用程序，它是自适应、自我描述、模块化的应用程序，并可以跨越Web进行发布、定位以及调用。简单的Web服务可以提供例如天气预报或者航班信息的服务。一旦部署了Web服务，其他的应用程序就可以发现和调用所部署的服务。

2．AXIS项目

Axis框架来自 Apache 开放源代码组织，它是基于JAVA语言的最新的 SOAP 规范（SOAP 1.2）和 SOAP with Attachments 规范（来自 Apache Group ）的开放源代码实现。有很多流行的开发工具都使用AXIS作为其实现支持Web服务的功能，例如JBuilder以及著名的Eclipse J2EE插件Lomboz。AXIS的最新版本是1.1，可以从 http://ws.apache.org/axis/index.html下载。下图是AXIS核心引擎的体系结构图：

图1

整个AXIS项目包括以下几个部分：

1. 消息流子系统
   消息流子系统提供了灵活的消息传递框架，这个消息传递框架包括处理程序、链、序列化程序和反序列化程序。处理程序是一个处理请求、响应和故障流的对象。处理程序可被组合在一起成为链，而且可以使用一个灵活的部署描述符来配置这些处理程序的顺序。
2. 传输框架子系统
   提供了一个传输框架，这个传输框架可以帮助您创建自己的可插式传输发送器和传输侦听器。
3. 数据编码子系统
   AXIS完全按照 XML Schema 规范提供各种数据类型的自动序列化，并且提供功能扩展接口来使用您自己定制的序列化器和反序列化器。
4. 其他
   AXIS完全支持 WSDL 以及日志记录、出错以及故障处理机制。它同时提供一些工具用来讲WSDL文档转换成客户端的调用框架以及根据类来产生WSDL定义文档。

AXIS目前版本支持的标准是：W3C SOAP 1.1 和 1.2；WSDL 1.1；SAAJ 1.1（SUN公司：SOAP with Attachments API for Java）；JAX-RPC（SUN公司：Java API for XML-Based RPC）1.0。

除了前面介绍的AXIS外，本文中还将会用到TOMCAT，这里不再另行介绍。另外为了演示Web服务真正与开发环境无关以及AXIS产生的是标准的、符合规范的Web服务，我们还将用到微软公司的SOAP TOOLKIT以及微软的开发环境VB和VC来做为Web服务的客户端。

回页首

二. 环境搭建

由于AXIS本身是基于JAVA语言开发的项目，并且是以Web应用形式发布的，因此它运行时需要一个应用服务器作为支撑。为了方便我们这里选用的是Tomcat。由于AXIS本身需要用到处理XML信息的包，所以我们建议使用JDK1.4并安装Tomcat 4.1.24。下面是环境搭建步骤，读取根据自身情况进行安装。

1. 安装JDK1.4.1
2. 安装Tomcat 4.1.24到C:\Tomcat并验证安装是否成功
3. 下载AXIS项目打包文件axis-1_1.zip解压缩后将目录中的webapps目录下的axis子目录拷贝到C:\Tomcat\webapps下。
4. 验证AXIS的安装：重新启动Tomcat服务器后打开浏览器输入网址http://localhost:8080/axis 后应该出现如下图所示页面，点击链接"Validate"来验证Axis所需的几个JAVA包是否齐全。

图2

点击超链接Validate后，AXIS会自动检查所需的每一个JAVA组件，这协组件分为：必需组件以及可选组件，必须保证所有必需组件都存在，如下图所示即为验证成功。

图3

回页首

三． Web Service服务端开发

经过了前两步之后我们就可以开始Web服务之旅了！大多数人在学习一种编程语言的第一步都是从Hello world程序开始的，我们也不例外。我们将提供这样一个Web服务，通过给它传入姓名，服务返回：你好[姓名]，欢迎来到Web服务的世界。这就是我们的需求。我们将马上根据AXIS的要求完成我们的需求，你就会发现原来Web服务可以这么简单！

编写JAVA类Hello.java，内容如下：

												
														public class Hello{
 public String hello(String name){
  if(name==null)
   name = "";
  return "你好"+name+"，欢迎来到Web服务的世界！";
}
}

												
										

仅此而已，无需编译，将该文件改名为Hello.jws并拷贝到AXIS应用目录C:\Tomcat\webapps\axis下。

下面我们就可以测试该Web服务了，打开浏览器并输入刚刚创建的文件名对应的URL地址 http://localhost:8080/axis/Hello.jws 浏览器显示如下结果：

												
														There is a Web Service here

        
        
														
																Click to see the WSDL 
														
														
														
												
										

点击页面上的链接查看该Web服务对应的WSDL信息如下所示（我们将在下一小节简单介绍WSDL）

												
														<?xml version="1.0" encoding="UTF-8" ?>
-<wsdl:definitions
 targetNamespace="http://localhost:8080/axis/Hello.jws"
 xmlns="http://schemas.xmlsoap.org/wsdl/"
 xmlns="http://www.w3.org/2000/xmlns/"
 xmlns:apachesoap="http://xml.apache.org/xml-soap" 
 xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
 xmlns:impl="http://localhost:8080/axis/Hello.jws" 
 xmlns:intf="http://localhost:8080/axis/Hello.jws"
 xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" 
 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
 - <wsdl:message name="helloRequest">
 <wsdl:part name="name" type="xsd:string" /> 
 </wsdl:message>
 + <wsdl:message name="helloResponse">
 - <wsdl:portType name="Hello">
 - <wsdl:operation name="hello" parameterOrder="name">
 <wsdl:input name="helloRequest" message="intf:helloRequest" /> 
 <wsdl:output name="helloResponse" message="intf:helloResponse" />
 </wsdl:operation> 
 </wsdl:portType>
 - <wsdl:binding name="HelloSoapBinding" type="intf:Hello"> 
 <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http" />
 - <wsdl:operation name="hello"> 
 <wsdlsoap:operation soapAction="" />
 - <wsdl:input name="helloRequest">
 <wsdlsoap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
  namespace="http://DefaultNamespace" />  
 </wsdl:input>- <wsdl:output name="helloResponse">  
 <wsdlsoap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
  namespace="http://localhost:8080/axis/Hello.jws" />   
 </wsdl:output> 
 </wsdl:operation> 
 </wsdl:binding>
 - <wsdl:service name="HelloService">
 - <wsdl:port name="Hello" binding="intf:HelloSoapBinding">
 <wsdlsoap:address location="http://localhost:8080/axis/Hello.jws" /> 
 </wsdl:port>  
 </wsdl:service> 
 </wsdl:definitions>

												
										

到此我们已经完成了hello的Web服务了，那我们怎么告诉用户如何来使用该服务呢？我们只需要告诉用户我们的Web服务的URL地址： http://localhost:8080/axis/Hello.jws?wsdl 就可以了！下一节我们将介绍如何通过这个地址来访问对应的Web服务。

回页首

四． Web Service客户端开发

在这一节中我们将使用三种不同的语言来访问刚刚创建的Web服务，分别是JAVA、VB、VC。为了使用VB和VC访问Web服务，我们需要安装微软公司的Soap Toolkit 开发工具包，这个工具包可以从微软公司的主页

http://download.microsoft.com/download/xml/soap/2.0/W98NT42KMe/EN-US/SoapToolkit20.exe

下载，下载该软件包并使用默认方式安装即可。

在开始客户端开发之前有两个概念我们必须先粗略的介绍一下。

SOAP：简单对象访问协议。这是一种在松散的、分布的环境中使用XML对等地交换结构化的和类型化的信息提供了一个简单且轻量级的机制，它是一个基于XML的协议。它包括四个部分：SOAP封装（envelop），封装定义了一个描述消息中的内容是什么，是谁发送的，谁应当接受并处理它以及如何处理它们的框架；SOAP编码规则（encoding rules），用于表示应用程序需要使用的数据类型的实例; SOAP RPC表示(RPC representation)，表示远程过程调用和应答的协定;SOAP绑定（binding），使用底层协议交换信息。

虽然这四个部分都作为SOAP的一部分，作为一个整体定义的，但他们在功能上是相交的、彼此独立的。特别的，信封和编码规则是被定义在不同的XML命名空间(namespace)中，这样使得定义更加简单。

SOAP的主要设计目标是简明性和可扩展性。这就意味着有一些传统消息系统或分布式对象系统中的特性将不包含在SOAP的核心规范中。这些特性包括：分布式垃圾收集；批量消息传输/处理；对象引用；对象激活。

WSDL：Web Service描述语言。使用了WSDL，我们就可以通过这种跨平台和跨语言的方法使Web Service代理的产生自动化。就像COM和CORBA的IDL文件，WSDL文件由客户和服务器约定。由于WSDL设计成可以绑定除SOAP以外的其他协议，这里我们主要关注WSDL在HTTP上和SOAP的关系。同样，由于SOAP目前主要用来调用远程的过程和函数，WSDL支持SOAP传输的文档规范。

WSDL文档可以分为两部分。顶部分由抽象定义组成，而底部分则由具体描述组成。抽象部分以独立于平台和语言的方式定义SOAP消息，它们并不包含任何随机器或语言而变的元素。这就定义了一系列服务，截然不同的网站都可以实现。

1. JAVA客户端

使用AXIS的工具将使Web服务的访问和我们之前介绍的创建一个Web服务一样的简单。我们前面安装的AXIS环境中已经包含着这样的工具，它是一个JAVA类，类名为：org.apache.axis.wsdl.WSDL2Java。打开命令行窗口，转到AXIS目录下的WEB-INF子目录。确保Tomcat服务已经处于启动状态，键入命令 ：

												
														Java -Djava.ext.dirs=lib org.apache.axis.wsdl.WSDL2Java http://localhost:8080/axis/Hello.jws?wsdl

												
										

该命令执行的结果是在当前所在目录下产生一个子目录 localhost/axis/Hello_jws，该目录下有四个JAVA源文件，它们分别是：

Hello.java 定义了Web服务接口，此例中只有一个hello方法。

HelloService.java 定义了用于获取Web服务接口的方法。

HelloServiceLocator.java 接口HelloService的具体实现。

HelloSoapBindingStub.java Web服务客户端桩，通过该类与服务器交互。

这四个JAVA类帮我们处理了大部分的逻辑，我们需要的仅仅是把这些类加到我们的项目然后创建一个我们自己的类来调用它们即可。为此我们新加一个类Main.java，为了方便，让这个类与刚产生的四个类都在同一个包下。内容如下：

												
														//Main.java
package localhost.axis.Hello_jws;
public class Main{
public static void main(String[] args) throws Exception{
 HelloService service = new HelloServiceLocator();
 Hello hello = service.getHello(); 
 System.out.println("Response:"+hello.hello("罐头")); 
 }
}

												
										

使用以下命令进行编译：

												
														javac -classpath lib\axis.jar;lib\jaxrpc.jar localhost\axis\Hello_jws\*.java

												
										

如果编译没有问题的话执行该测试程序：

												
														java -Djava.ext.dirs=lib -cp . localhost.axis.Hello_jws.Main//运行结果：Response:你好罐头，欢迎来到Web服务的世界！

												
										

在WSDL2Java工具自动产生的几个类中，类HelloServiceLocator中保存这一些跟服务器相关的信息，例如URL地址等，当服务器的地址更改后但是服务并没有改动的时候直接修改该文件中的字符串定义，而无需重新生成这几个类。具体需要修改的内容，打开该文件便可一目了然。

2. VB客户端

有了微软SOAP toolkit，用VB调用Web服务也是一件令人愉快的事情。

打开VB开发环境新建一个标准EXE项目，打开工程(Project)菜单并选择引用打开组件引用对话框如下图所示：找到并选中Microsoft Soap Type Library。

图 4

新建并编辑窗体如下图所示：

图 5

编辑按钮Call的点击事件处理程序如下：（注意窗体的控件名称要与程序中的名称对应）

												
														Private Sub callBtn_Click()    
'这种做法需要在工程中引用Soap Type Library  
'Dim soap As MSSOAPLib.SoapClient  
'Set soap = New MSSOAPLib.SoapClient
Dim soap  
Set soap = CreateObject("MSSOAP.SoapClient")   
On Error Resume Next
'soap.mssoapinit urlText.Text 
Call soap.mssoapinit(urlText.Text)   
If Err <> 0 Then   
 MsgBox "初始化SOAP失败： " + Err.Description       
 urlText.SetFocus 
Else       
 If Len(Trim(nameText.Text)) = 0 Then       
  MsgBox "请输入您的姓名！"          
  nameText.SetFocus    
 Else          
  responseText.Text = soap.hello(nameText.Text) 
 End If 
 End If
End Sub

												
										

保存项目并运行，输入姓名并点击按钮Call。

3. VC客户端

打开VC开发环境，新建项目HelloClient，项目类型为 Win32 Console Application的空项目。新建C++ Source File文件名为：HelloSoap.cpp，编辑文件内容如下：

												
														//#include "stdafx.h"
#include <stdio.h>
#import "msxml3.dll"
using namespace MSXML2;
//根据自己机器的情况修改下面语句中指定的路径

#import "C:\Program Files\Common Files\MSSoap\Binaries\mssoap1.dll" \ 
 exclude("IStream", "ISequentialStream", "_LARGE_INTEGER", \ 
 "_ULARGE_INTEGER", "tagSTATSTG", "_FILETIME")
using namespace MSSOAPLib;

void Hello(){ 
 ISoapSerializerPtr Serializer;
 ISoapReaderPtr Reader; 
 ISoapConnectorPtr Connector;
 // Connect to the service 
 Connector.CreateInstance(__uuidof(HttpConnector));
 Connector->Property["EndPointURL"] = "http://localhost:8080/axis/Hello.jws?wsdl";
 Connector->Connect(); 
 // Begin message
 Connector->BeginMessage(); 
 // Create the SoapSerializer 
 Serializer.CreateInstance(__uuidof(SoapSerializer)); 
 // Connect the serializer to the input stream of the connector
 Serializer->Init(_variant_t((IUnknown*)Connector->InputStream)); 

 // Build the SOAP Message 

 Serializer->startEnvelope("","",""); 
 Serializer->startBody(""); 
 Serializer->startElement("hello","","",""); 
 Serializer->startElement("name","","","");
 Serializer->writeString("罐头"); 
 Serializer->endElement(); 
 Serializer->endElement();
 Serializer->endBody(); 
 Serializer->endEnvelope();  
 
 // Send the message to the web service 
 Connector->EndMessage();   
 
 // Let us read the response
 Reader.CreateInstance(__uuidof(SoapReader)); 
 // Connect the reader to the output stream of the connector
 Reader->Load(_variant_t((IUnknown*)Connector->OutputStream), ""); 

 // Display the result 
 printf("Response: %s\n", (const char*)Reader->RPCResult->text);  
}

int main()
{
 CoInitialize(NULL);
 Hello(); 
 CoUninitialize(); 
 
 return 0; 
}

												
										

编译并运行该项目。

本节只是为了演示如果通过VC来访问使用AXIS创建的Web服务，至于Soap toolkit的具体使用请参照soap toolkit的帮助手册，其他语言的访问请查阅相关的文档。

回页首

五. AXIS集成

为了让我们的WEB应用程序支持Web服务功能，我们需要将AXIS集成到我们的应用程序中。集成AXIS很简单，首先需要拷贝AXIS用到的几个JAR包文件，这些文件都在[AXIS]\WEB-INF\lib目录下，将这些文件拷贝到我们自己的应用目录下的WEB-INF\lib。另外如果你用的不是TOMCAT服务器那就需要拷贝activation.jar，这个JAR文件可以在[TOMCAT]\common\lib目录下找到！

拷贝完JAR文件后就是web.xml的配置了，只需要把AXIS中的web.xml中的配置信息添加到我们自己应用程序中的web.xml中即可。最重要的是下面的内容：

												
														<servlet>  
 <servlet-name>AxisServlet</servlet-name>  
 <display-name>Apache-Axis Servlet</display-name>   
 <servlet-class> 
  org.apache.axis.transport.http.AxisServlet  
 </servlet-class>
</servlet>

<servlet-mapping>   
 <servlet-name>AxisServlet</servlet-name>  
 <url-pattern>*.jws</url-pattern>
</servlet-mapping>

<mime-mapping>    
 <extension>wsdl</extension>  
 <mime-type>text/xml</mime-type>
</mime-mapping>

<mime-mapping>   
 <extension>xsd</extension>   
 <mime-type>text/xml</mime-type>
</mime-mapping>

												
										

回页首

六 总结

到此文章告一段落，通过以上的演练，我相信你已经对Web服务有一个感性的认识，但是这个仅仅是开始，我们也只是很简单的介绍了Web服务的一些基本概念并演示了一个无法再简单的例子。Web服务还有很多其他高级的内容例如复杂类型、数据安全等没有涉及到，不过没有关系，万事开头难，希望本文能够促进大家理解和应用下一代的应用模式并给还没有动手试验的开发人员开一个好头。

1. 软件下载
2. 服务器和客户端安装
   
3. 建立版本库（Repository）
4. 配置用户和权限
   
5. 运行独立服务器
6. 初始化导入
7. 基本客户端操作

• 下载Subversion服务器程序。

• 下载Subversion的Windows客户端TortoiseSVN。

• 服务器安装，直接运行svn-1.2.3-setup.exe，根据提示安装即可，这样我们就有了一套服务器可以运行的环境。
• 安装TortoiseSVN，同样直接运行TortoiseSVN-1.2.4.4479-svn-1.2.3.msi按照提示安装即可，不过最后完成后会提示是否重启，其实重启只是使svn工作拷贝在windows中的特殊样式生效，与所有的实际功能无关，这里为了立刻看到好的效果，还是重新启动机器。

svnadmin create E:\svndemo\repository

就会在目录E:\svndemo\repository下创建一个版本库。

我们也可以使用TortoiseSVN图形化的完成这一步：

# [general]
# password-db = passwd

[general]
password-db = passwd

# [users]
# harry = harryssecret
# sally = sallyssecret

[users]
harry = harryssecret
sally = sallyssecret

svnserve -d -r E:\svndemo\repository

1. 右键->TortoiseSVN->Import...
2. URL of repository输入“svn://localhost/trunk”
3. ok

来到任意空目录下，在本例中是E:\svndemo\wc1，运行右键->Checkout，在URL of repository中输入svn://localhost/trunk，这样我们就得到了一份工作拷贝。

打开readme.txt，作出修改，然后右键->Commit...，这样我们就把修改提交到了版本库，我们可以运行。

readme.txt上右键->TortoiseSVN->Show Log，这样我们就可以看到我们对这个文件所有的提交。在版本1上右键->Compare with working copy，我们可以比较工作拷贝的文件和版本1的区别。

1．背景

2．iText简介

3．如何利用iText在java程序中生成PDF报表

4．如何通过JSP生成PDF报表

5．结束