源代码下载（三个样例工程Maven版本） xfire-src.zip

相关lib文件请到XFire官方网站（见参考） 下载发布版本。

PDF版本下载

目录
实现功能与特点 2

运行环境 2

开发平台 2

实施步骤 2

概述 2

新建Java Project 3

新建WTP动态WEB工程 4

实现服务 6

利用Spring、XFire装配与暴露服务 7

测试并访问服务 7

利用XFire实现客户端 10

扩展主题 11

利用MTOM传输二进制对象（文件） 11

附录 12

XFire在WebLogic 8.1中的配置 12

参考 12

实现功能与特点

• 基于J2EE平台的Web Service服务
• 开发方便，配置简单
  • 设计接口
  • 实现服务
  • 配置暴露接口
  • XFire将自动生成对应的wsdl
  • 支持高级详细配置
• 与Spring无缝集成

运行环境

• JDK 1.4+
• Tomcat 4.0+ / WebLogic 8.1 （需要特殊配置，见附录）未测试其他环境
• 其他包依赖参看 http://xfire.codehaus.org/Dependency+Guide

开发平台

• Eclipse WTP 1.5 平台IDE：www.eclipse.org/webtools/
  
• XFire 1.2.6 http://xfire.codehaus.org/Home
• 可以选择安装XFire for Eclipse插件，可以添加XFire相关类库，根据WSDL生成代码。http://xfire.codehaus.org/Eclipse+Plugin
• JDK 1.4.2 http://java.sun.com/products/archive/
• Tomcat 5.0.28 http://tomcat.apache.org/download-55.cgi#5.0.28

实施步骤

概述

1. 建立一个Java Project用于Domain实体和Web Service接口，这个工程的输出是一个jar包，为Web Service工程和Web Service Client共享。
2. 建立WTP动态WEB工程部署Web Service
3. 建立Java Project使用Web Service (Web Service Client)

新建Java Project

1. 建立普通Java Project 以下称为common工程
2. 如果使用Maven，项目依赖

<dependency>

<groupId>javax.mail</groupId>

<artifactId>mail</artifactId>

<version>1.4</version>

</dependency>

1. 普通情况需要加入如下lib

activation-1.1.jar

mail-1.4.jar

1. 编写类 org.ave7.xfire.domain.User

org.ave7.xfire.domain.User.java

1. 编写接口 org.ave7.xfire.ws.UserService

新建WTP动态WEB工程

1. 配置WTP加入Tomcat Server Runtime
   1. 选择Windows -> Preference
   2. 在左侧选择Server->Installed Runtime 添加Tomcat
      
2. 新建工程，选择Dynamic Web Project 输入Project Name: XFireService
   
3. 设置运行环境为Dynamic Web Module 2.3 , JDK 1.4
   
4. 如果需要结合Maven，请如下配置，否则使用默认即可
   
5. 如果使用Maven请注入如下依赖以及之前的Common工程，否则根据后面的列表复制lib文件到对应目录

<dependency>

<groupId>org.codehaus.xfire</groupId>

<artifactId>xfire-aegis</artifactId>

<version>1.2.4</version>

</dependency>

<dependency>

<groupId>org.codehaus.xfire</groupId>

<artifactId>xfire-spring</artifactId>

<version>1.2.4</version>

<dependency>

<groupId>xalan</groupId>

<artifactId>xalan</artifactId>

<version>2.7.0</version>

</dependency>

Lib文件列表

xbean-2.2.0.jar

qdox-1.5.jar

commons-attributes-api-2.1.jar

ant-1.5.jar

wstx-asl-3.2.0.jar

stax-utils-20040917.jar

commons-httpclient-3.0.jar

spring-1.2.6.jar

XmlSchema-1.1.jar

stax-api-1.0.1.jar

jaxen-1.1-beta-9.jar

xfire-annotations-1.2.4.jar

xfire-aegis-1.2.4.jar

xfire-core-1.2.4.jar

xfire-spring-1.2.4.jar

xfire-xmlbeans-1.2.4.jar

jdom-1.0.jar

xbean-spring-2.7.jar

wsdl4j-1.6.1.jar

commons-beanutils-1.7.0.jar

activation-1.1.jar

mail-1.4.jar

commons-codec-1.3.jar

xmlParserAPIs-2.6.2.jar

xercesImpl-2.6.2.jar

junit-3.8.1.jar

commons-logging-1.0.4.jar
xalan-2.7.0.jar

实现服务

org.ave7.xfire.ws.UserServiceImpl.java

利用Spring、XFire装配与暴露服务

1. 在web.xml配置相关组件

1. 在applicationContext.xml配置相关服务

测试并访问服务

1. 检查lib文件夹，Maven用户注意添加对common工程的依赖，其他情况请把common工程导出的jar包复制到web-inf/lib目录
2. 在WTP中添加服务器，部署应用
   
3. 在浏览器中输入类似 http://localhost:8080/XFireService/service 应看到
   
4. 点击wsdl http://localhost:8080/XFireService/service/UserService?wsdl 看到
   
   如果这一步出现500错误，请检查是否有xalan.jar包
5. 在WTP中利用Web Service Explore测试SOAP方式，在WTP工具栏选择 最右侧按钮
6. 点击右上角进入WSDL page
   
7. 点击WSDL Main节点输入服务wsdl地址，点击
   
8. 列出所有的可用服务，选择服务测试
   
9. 测试queryUserByAccountId
   
10. 点击结果中的Source可以看到SOAP报文
    

利用XFire实现客户端

1. 新建一个普通Java工程，lib中引用XFire相关包

如果使用Maven添加如下依赖以及对common工程的引用

<dependency>

<groupId>org.codehaus.xfire</groupId>

<artifactId>xfire-aegis</artifactId>

<version>1.2.4</version>

</dependency>

普通Java工程添加如下lib以及对common工程的引用

activation-1.1.jar

commons-codec-1.3.jar

commons-httpclient-3.0.jar

commons-logging-1.0.4.jar

jaxen-1.1-beta-9.jar

jdom-1.0.jar

junit-3.8.1.jar

mail-1.4.jar

stax-api-1.0.1.jar

stax-utils-20040917.jar

wsdl4j-1.6.1.jar

wstx-asl-3.2.0.jar

xercesImpl-2.6.2.jar

xfire-aegis-1.2.4.jar

xfire-core-1.2.4.jar

xmlParserAPIs-2.6.2.jar

XmlSchema-1.1.jar

1. 编写客户端程序

org.ave7.xfire.client.MyClient.java

1. 运行。控制台打印输出

扩展主题

利用MTOM传输二进制对象（文件）

MTOM是XFire的一个组件，可以协助利用压缩等手段更快的在网络上传输base64的SOAP对象

MTOM以及aegis默认支持如下几种java对象的数据

• byte[]
• javax.activation.DataHandler
• javax.activation.DataSource

1. 配置启用MTOM

在Spring配置文件中需要MTOM的服务中加入如下配置

1. 在客户端编写传输程序

附录

XFire在WebLogic 8.1中的配置

1. Add the QName JAR file (qname.jar) into the WEB-INF/lib folder in your WAR file
2. Add a file weblogic.xml into the WEB-INF folder in your WAR file

QName JAR file (qname.jar) http://docs.codehaus.org/download/attachments/27836/qname.jar?version=1

参考

• File Transfers using SOAP XFire http://blogs.opensymphony.com/plightbo/2006/04/file_transfers_using_soap_xfir.html
• XFire生火指南
  http://wiki.springside.org.cn/display/springside/XFire
• XFire官方网站
  http://xfire.codehaus.org/Home

XFire On WebLogic 8.1
http://docs.codehaus.org/display/XFIRE/XFire+on+WebLogic+8.1

• explore the DOM tree and find elements on the page
• disable IE settings, view information
• outline elements,
• control images
• resize pages to common screen resolutions
• validate against existing standards and provides pointers to World Wide Web Consortium
  12/6/2004 10:45:25 PM - dmarsh
  W3C specs

• A variable holds a value, while an object reference variable points to the memory that holds the object.
• The short-circuit logical operators && and || operate only on boolean operands. For example, the expression
  9&&7 will not compile. Understand the difference between short-circuit logical operators and bitwise
  operators.
• If the first expression of a && operator is false, the second expression is not evaluated, and if the first
  expression of a || operator is true, the second expression is not evaluated.

Look Out

• Be on guard for words that are only slightly different from the Java keywords, such as synchronize instead of synchronized, implement instead of implements, and protect instead of protected.
• Whether an array stores primitive variables or object references, the array itself is always an object.
• It is illegal to include the array size in the array declaration.
• Division by zero generates a runtime ArithmeticException only if the operands are integers. In case of float and double, the result of division by zero is infinity.
• The result of the modulo operator always carries the sign of the first operand (i.e. the one before the operator);
  you can ignore the sign of the second operand.
• You cannot instantiate an enum by using the new operator.

Memorize

• Know the Java language keywords.
• Know the range of values for all primitive data types.
• All primitive data types except boolean and char are signed.
• The first character of an identifier must be a letter, a dollar sign ($), or an underscore (_). Characters other than the first character in an identifier may be a letter, a dollar sign, an underscore, or a digit.

• The method name and return type are mandatory in a method declaration. Even though you are not required to specify a modifier in a method declaration, the default modifier is assigned to the method, if you don’t declare one.
• A static variable belongs to the class and not to a particular instance of the class, and therefore is initialized when the class is loaded, and before the class is instantiated.
• Because a static method belongs to a class and not to a particular instance of the class, it cannot access the nonstatic methods and variables of the class in which it is defined.
• An instance of an inner class can only exist in an instance of the outer class, and has direct access to all the instance variables and methods of the outer instance.
• If you make a super call or a this call, it must be in the beginning of a constructor. That means you can make either a super call or a this call, but not both.

Look Out

• The variable-length parameters list must appear last in the parentheses of a method and it consists of a data type, three dots, and a name, in that order.
• A Java class cannot inherit from more than one class, but it can inherit from one class and one or more interfaces.
• The class that inherits from an interface must provide implementation for all the methods that are declared in the interface if the class is not abstract.
• An interface can extend another interface but it cannot implement another interface or a class.

Memorize

• If you do not provide any constructor for a class you write, the compiler provides the default constructor for that class. If you write at least one constructor for the class, the compiler provides no constructor.
• If you don not make a this or a super call in the beginning of a constructor, the compiler places a super() call there.
• You use the keyword extends to write a derived class that inherits from a parent class, and use the keyword implements to write a class that inherits from an interface.
• The methods in an interface are inherently public and abstract, and the variables in the interface are inherently public, final, and static.

1. Plan an agenda.
2. Define key business drivers.
3. Define key success facts.
4. Work out persona.
5. Work out Scenario.
6. High level architecture
7. High level design
8. Development
9. QA
10. Deployment

也许你已经学会了一门计算机语言，也许你会写一段不错的程序。

也许你在嘈杂的环境用不费力的就可以用熟悉的IDE完成一个项目。

不过，你还在用+ - * /和%做所有的计算么？

这个笔记就是为了写出更加正确的程序，小小的一个学习过程。

我不总结复杂的道理，只记录用得上的方案。

出现的一切代码都使用Java语言。

正确的计算过程导致错误的计算结果

关于基本数值计算中的一些陷阱

浮点数和实数

当早期的Fortran和algol创造出real这个关键字时，你还真以为那么是实数，不过说真的，你被骗了。

所以到了C，我们拥有了float。

那么他们到底有什么不同呢？

简单地说

System.out.println(”Value of 1/3: ” + (1/3f))

将输出

Value of 1/3: 0.33333334

很简单，这是很早之前您就知道的四舍五入。当时我们只是那无法写完的循环在纸上划下一个”≈”，然后非常开心可以少写几个字符。如果你有一个负责任的数学老师，他（她）就会反复的叮咛你，要小心，计算时候要保留结果精度往后一位的数值。

当这一切轮到了计算机，我们叫它：

舍入误差

舍入误差有时相当惊人。对1/3连加840次，你会得到279.9915（本应当为280），如何惊人，我们会在下面看到。

不过有意思的事情，和小时候的情形不一样，舍入误差并不是由于不能除尽或者是无理数造成的，类似于1/5的数字连加之后也有误差。这是因为绝大多数 计算机是基于2进制体系的，所以IBM有用于商业计算的10进制计算机。简单的事实是利用float表达的2的幂次，在精度范围是没有舍入误差的。

给出常用定义：

作如下计算，你会期待怎样的结果呢？

别偷懒，用你久远的口算能力，很容易就可以得出，它本来应该是0。而事实上，我们伟大的计算机的答案是3222784.0

为什么？

因为，10000001/20000000的时候，答案本应该是0.50000005，由于舍入误差，我们得到了0.5000006。

接下来我们减去0.5的时候，得到的应当是0.00000006，这样，我们就丢失了所有的正确的数。

更糟糕的是，计算机中实际得到的值是5.9604645e-8。

因此，您的存款户头上可能会平白无故减少3222784元。只因为银行决定向你支付利息之后，调整了汇率。

呃，这一次，我们叫它：

相消误差——两个非常相近的值相减时，如果消去了绝大多数有效数值，那么就会发生相消误差。
舍入误差——是精确值和其可表达值之间的差值。

如果还有什么要说的，那就是：

Double比float 更接近实数，貌似不需要我说。
浮点运算不遵守代数定理

比如：a = 1.0, b = 3.0e-8, c = 4.0e-8

那么：    (a+b)+c = 1.0

    a+(b+c) = 1.0000001

不过加法和乘法还是满足交换律的。

下一次：轮到了整数。

呃，好吧，我只写过三个JavaMail的程序。

都是批量邮件守护程序。决定总结一下，希望非常幸运找到这篇文章的人不会再对这个困惑。

必须明白的基础知识

1. STMP协议是如何工作的
   协议的标准在这里 http://www.ietf.org/rfc/rfc2821.txt?number=2821
   下面是扼要说明（http://www.freesoft.org/CIE/Topics/94.htm ）：

   Simple Mail Transfer Protocol (SMTP), documented in RFC 821, is Internet’s standard host-to-host mail transport protocol and traditionally operates over TCP, port 25. In other words, a UNIX user can type telnet hostname 25 and connect with an SMTP server, if one is present.

   SMTP uses a style of asymmetric request-response protocol popular in the early 1980s, and still seen occasionally, most often in mail protocols. The protocol is designed to be equally useful to either a computer or a human, though not too forgiving of the human. From the server’s viewpoint, a clear set of commands is provided and well-documented in the RFC. For the human, all the commands are clearly terminated by newlines and a HELP command lists all of them. From the sender’s viewpoint, the command replies always take the form of text lines, each starting with a three-digit code identifying the result of the operation, a continuation character to indicate another lines following, and then arbitrary text information designed to be informative to a human.

   事实上，你可以像使用DOS命令一样发送电子邮件。http://bbs.stcore.com/archiver/tid-8024.htm 当然因为各种原因，你的尝试不可能成功。事实上SMTP工作的时候就是简单的发送命令。取得认证，发送数据。得到反馈。确认退出这么简单。

2. SMTP中用于发送的数据
   SMTP中发送的数据，遵从Multipurpose Internet Mail Extensions (MIME)标准，呃，我不得不说，这是这个星球上最重要的标准之一。所有的互联网通信基本都是基于这个标准的演化。除了电子邮件，常见的应用还包括HTTP报文等（也就是所有网页了），另外即使在20年后发展的XML，其2进制数据发送仍然实用的MIME中的编码方式。
   恩，这里就涉及到邮件附件如何处理的问题。恩，简单地说就是BASE64编码

Table 1: The Base64 Alphabet

Value Encoding  Value Encoding  Value Encoding  Value Encoding

0 A            17 R            34 i            51 z

1 B            18 S            35 j            52 0

2 C            19 T            36 k            53 1

3 D            20 U            37 l            54 2

4 E            21 V            38 m            55 3

5 F            22 W            39 n            56 4

6 G            23 X            40 o            57 5

7 H            24 Y            41 p            58 6

8 I            25 Z            42 q            59 7

9 J            26 a            43 r            60 8

10 K            27 b            44 s            61 9

11 L            28 c            45 t            62 +

12 M            29 d            46 u            63 /

13 N            30 e            47 v

14 O            31 f            48 w         (pad) =

15 P            32 g            49 x

16 Q            33 h            50 y

在这种编码中，我们将字符或者二进制编码以6个比特位为一组，替换成相应的字符形式。比如

100110111010001011101001

转换结果就是

100110 -> 38

111010 -> 58

001011 -> 11

101001 -> 41

38 -> m

58 -> 6

11 -> L

41 -> p

m6Lp

于是，我们就可以以文本的方式编码二进制流以及扩展ASCII字符，比如中文字符。

基础知识完毕，下面是FAQ

Java发送电子邮件需要哪些软件包

mail.jar 通常还会需要 activation.jar

下载地址
http://java.sun.com/products/javabeans/jaf/downloads/index.html
https://maven-repository.dev.java.net/nonav/repository/javax.mail/

如何发送邮件

关于：

• 如何发送邮件
• 如何发送带有附件的邮件
• 如何发送中文邮件
• 邮件中文标题乱码怎么办
• 邮件附件乱码怎么办等等问题

请查看以下代码

	public static synchronized void sendMail(Properties settings)
 
 		throws Exception {
 
 	Properties props = new Properties();
 
 	props.put("mail.smtp.host", settings.get(StartCore.MAIL_SERVER));
 
 	props.put("mail.smtp.user", settings.get(StartCore.USER_NAME));
 
 	props.put("mail.smtp.auth", "true");
 
//SMTP服务器用户验证
 
 	Authenticator auth = new SMTPAuthenticator((String) settings
 
 		.get(StartCore.USER_NAME), (String) settings
 
 		.get(StartCore.PASSWORD));
 
 	Session session = Session.getDefaultInstance(props, auth);
 
if ("true".compareToIgnoreCase((String) settings.get("DEBUG")) == 0) {
 
 		session.setDebug(true);
 
 	}
 
//创建消息体
 
 	MimeMessage msg = new MimeMessage(session);
 
//设置发送人邮件
 
 	msg.setFrom(new InternetAddress((String) settings
 
 		.get(StartCore.USER_MAIL)));
 
//设置接收人邮件
 
 	address = new InternetAddress[] { new InternetAddress(rs
 
 		.getString("GRE_mail")) };
 
 	msg.setRecipients(Message.RecipientType.TO, address);
 
//设置主题，中文编码
 
 	msg.setSubject(subject, "gbk");
 
 	msg.setSentDate(new Date());
 
String content = "邮件正文";
 
 	MimeBodyPart mbp1 = new MimeBodyPart();
 
 	mbp1.setText(content, "gbk");
 
//邮件附件
 
MimeBodyPart attachFilePart = new MimeBodyPart();
 
File file = new File("中文附件.txt");
 
FileDataSource fds = new FileDataSource(file.getName());
 
attachFilePart.setDataHandler(new DataHandler(fds));
 
 	sun.misc.BASE64Encoder enc = new sun.misc.BASE64Encoder();
 
 	//解决中文附件名称
 
 	attachFilePart.setFileName("=?gbk?B?"
 
 		+ enc.encode(file.getName().getBytes("gbk")) + "?=");
 
Multipart mp = new MimeMultipart();
 
 	mp.addBodyPart(mbp1);
 
 	mp.addBodyPart(attachFilePart);
 
msg.setContent(mp);
 
// send the message
 
 	msg.saveChanges();
 
 	Transport.send(msg);
 
}

这是上面用户验证用到的类

class SMTPAuthenticator extends javax.mail.Authenticator {

	private String username;
 
	private String password;
 
	/**
 
  	* @param username
 
 	* @param password
 
  	*/
 
 	public SMTPAuthenticator(String username, String password) {
 
 		this.username = username;
 
 		this.password = password;
 
	}
 
	public PasswordAuthentication getPasswordAuthentication() {
 
 		return new PasswordAuthentication(username, password);
 
 	}
 
}

邮件发送出错

What causes an “javax.activation.UnsupportedDataTypeException: no object DCH for MIME type xxx/xxxx javax.mail.MessagingException: IOException while sending message;” to be sent and how do I fix this? [This happens for known MIME types like text/htm

事实上这个是邮件发送时验证组件设置不当引起的，这个组件配置方法如下

(http://java.sun.com/j2ee/1.4/docs/api/javax/activation/MailcapCommandMap.html)

The MailcapCommandMap looks in various places in the user’s system for mailcap file entries. When requests are made to search for commands in the MailcapCommandMap, it searches mailcap files in the following order:

1) Programatically added entries to the MailcapCommandMap instance.
2) The file .mailcap in the user’s home directory.
3) The file /lib/mailcap.
4) The file or resources named META-INF/mailcap.
5) The file or resource named META-INF/mailcap.default (usually found only in the activation.jar file).

我选用了第四种方法，在生成的Jar文件中加入了 META-INF/mailcap.

#
# This is a very simple 'mailcap' file
#
image/gif;;		x-java-view=com.sun.activation.viewers.ImageViewer
image/jpeg;;		x-java-view=com.sun.activation.viewers.ImageViewer
text/*;;		x-java-view=com.sun.activation.viewers.TextViewer
text/*;;		x-java-edit=com.sun.activation.viewers.TextEditor
text/html;; 	x-java-content-handler=com.sun.mail.handlers.text_html
text/xml;; 		x-java-content-handler=com.sun.mail.handlers.text_xml
text/plain;; 	x-java-content-handler=com.sun.mail.handlers.text_plain
multipart/*;; 	x-java-content-handler=com.sun.mail.handlers.multipart_mixed
message/rfc822;; x-java-content-handler=com.sun.mail.handlers.message_rfc822

因为要还换空间了，终于可以为自己的网站写Java程序了，刚好老师要我总结一下，提供一个即插即用的Ajax JAVA环境。

汗~~不过简单美，我就开心的说一下吧。

框架选择汇总

• Ajax toolkit: Dojo http://dojotoolkit.org/
• Communication: DWR http://getahead.ltd.uk/dwr/
• Presentation: Struts 2 http://struts.apache.org/2.x/ / WebWork http://www.opensymphony.com/webwork/
• IoC: Spring http://www.springframework.org/
• Persistence: Hibernate http://www.hibernate.org/ or iBatis http://ibatis.apache.org/

选择理由

Dojo

我最爱的就是Dojo。Dojo提供了丰富的Widget和不断增加的教程文档。拥有了IBM和SUN的官方支持。更重要的是，Dojo不止为Java设计，Dojo是一个通用的平台，这意味着，所有最新的技术都可以移植到Dojo上面来，而你并不需要重新学习。

Dojo最大的弱点是，启动缓慢，官方网站在网络质量不好的时候会有死机的感觉。不过依然记得0.3到0.4的巨大惊喜。我相信随着Dojo的成熟，对其的学习是一种保值的投资。

DWR

这是目前几个框架中，我唯一没有在实际项目中使用过的。之前用Dojo和WW写程序的时候，使用JSON作为数据 媒介（没有用RPC）。写了很多代码来负责同步JSON与JAVA对象。目前看来DWR可以很好的解决这个问题。而且，随着Annotation的流行，连配置都不用了。

Struts2 / WW

目前没有用过Struts 2不过从前身WW的表现来看，绝对是开发速度之选。丰富的扩展支持，良好的接口设计，为易变的Web环境提供了舒适的开发体验。再加上Apache的大名，那就素质量的保证啊。虽然有Ajax支持的鸡肋（T_T原谅我，我是真的不会用那个）。Struts2同样开始支持Annotation配置，真是为我省心啊。

Spring

Spring is coming…..

没有理由，只要不用EJB，那么只有Spring才是J2EE的选择，良好的扩展性，无所不在的简洁。总书记怎么说来着？和谐美啊。Spring就是和谐，让那一片一片菱角分明的框架结合的天衣无缝。总而言之一句话，Spring就是端午节的糯米啊。（那谁是粽子叶呢？）

Hibernate 与 iBatis

其实持久层的选择就要省重一点了。

Hibernate很方便，方便到太容易犯错误。所以我把iBatis列进去，这是性能和健壮性的考虑。

我明白Hibernate有多么方便，如果两三个月就要交付一个项目，Hibernate能够让你忘掉SQL的存在。但是要做一个逻辑复杂的SNS站点，iBatis无疑更轻巧更考验才智。

以上，再加上Acegi和axis2（暂时没打算用），开心的玩Java AJAX吧