用于汇总学习日记开发过程中的一些文档,例如:贡献人员名单,具有阶段性意义的各种信件,项目开发计划书,进度报表等。(另外,不便于在此贴出的文档将另作保存)
使用约定:
这个目标下的评论用于开发小组成员交流;
这个目标下的日记用于分类整理各种文档:例如:所有贡献人员名单填在一个名为贡献人员名单的日记的评论中,所有进度报表填在名为进度报表的这个日记的评论中。
实际上,这个日记已不是通常意义的日记了。它完全是一种文档的目录组织结构了。
月份:2004年11月
疑问:raorao写的EmailAuthenticator.java我不懂
Authenticator ,PasswordAuthentication这两个类没有用过,没有见过,学习中。。。
反馈了raorao和zhl提交的程序
收到并反馈了两人提交的程序。raorao的增加邮件系统的预定目标已经完成,给他提了一点小的增加。把raorao的工作成果发给了开发小组成员内部参考。zhl的程序还有待进一步努力。回复了jw的几点建议。
解决learndiaryV0.9的重复提交问题
关于我做改动的说明
1 在common文件夹中增加了一个文件jslib.js 此文件中写公用脚本。
//when form submit chanage the submit button disable
//f form object
//author zhanghongliang
//date 2004-11-30
function checkSubmit(f){
f.submit.disabled = true;
f.reset.disabled = true;
return true;
}
2 在需要验证重复提交的文件头部包含此脚本
<script language="javascript" src="common/jslib.js"></script>
在form 中添加 onsubmit="return checkSubmit(this)"
修改按钮的属性增加name属性 代码是 property="submit" reset 也要写
此修改完成。
我把所有修改过的文件按目录结构放置好了,只要把整个文件夹拷贝覆盖原来的文件即可。
有问题请mail to me!!
zhanghonliang@yoee.com
2004-11-30
今天收到raorao发来的增加邮件系统的程序并且
近期内我将把它集成入现有的www.learndiary.com中。并在基本的功能集成完毕后包装发布。
文档是这样写的吗?
我还没写过文档,请问大家,是这样写的吗?
这就是我写发送邮件的那个程序的文档
位置:package com.learndiary.website.action.sendmail
整体描述:实现Runnable接口,运行在后台发送邮件的线程
成员变量:
private ArrayList userInfoList 订阅了此目标的所有用户
private ArticleInfo articleInfo 需发送的日记
private int goalID 目标goalID
private String userNameOfWriteDiary 写日记用户的用户名
成员方法:
public String getGoalName() 返回目标的Name
局部变量:
goalName = myDB.getGoalNameByID(goalID); 通过goalID返回目标的Name
public void run() 线程里的run方法
局部变量:
EmailAuthenticator mailAuthenticator = new EmailAuthenticator(uername,password); 获得SMTP邮件服务器认证.
Properties props = System.getProperties(); 获得系统属性
props.put("mail.smtp.host",host); 设置邮件服务器
props.put("mail.smtp.auth","true"); 设置邮件服务器
Session session = Session.getInstance(props,(Authenticator)mailAuthenticator); 获得会话
String toMail = userInfo.getEmail(); 获得订阅了此目标用户的邮箱(收信地址)
String userName = userInfo.getUserName(); 获得订阅了此目标用户的用户名
Session session = Session.getInstance(props,(Authenticator)mailAuthenticator); 获得会话
MimeMessage message = new MimeMessage(session); 定义消息
message.setFrom(new InternetAddress(from)); 设置发信人
message.addRecipient(Message.RecipientType.TO,new InternetAddress(toMail)); 设置收信人
message.setSubject("学习日记您订阅的目标日记"); 设置消息主题
message.setText("您好!"+userName+bodyText); 设置消息内容
transport.connect(host,uername,password); 链接SMTP邮件服务器
transport.sendMessage(message,message.getAllRecipients()); 发送消息
transport.close(); 关闭连接
增加订阅邮件功能已完成
我把发送邮件的原代码贴出来
public class ToSendMailOfThread implements Runnable{
private ArrayList userInfoList = null;
private ArticleInfo articleInfo=null;
private int goalID ;
private String userNameOfWriteDiary = null;
ToSendMailOfThread(ArrayList userInfoList,ArticleInfo articleInfo,int goalID,String userNameOfWriteDiary){
this.userInfoList = userInfoList;
this.articleInfo = articleInfo;
this.goalID = goalID;
this.userNameOfWriteDiary = userNameOfWriteDiary;
}
public String getGoalName() {
String goalName =null;
try{
LearnDiaryDB myDB = new LearnDiaryDB();
goalName = myDB.getGoalNameByID(goalID);
}catch (Exception e){
e.printStackTrace();
return goalName;
}
return goalName;
}
public void run(){
String host = "smtp.126.com";
String from = "learndiary@126.com";
String uername = "learndiary";
String password = "123456";
UserInfo userInfo = null;
String goalName = getGoalName();
java.sql.Timestamp now = new java.sql.Timestamp(System.currentTimeMillis());
StringBuffer bodyTextBuffer = new StringBuffer() ;
bodyTextBuffer.append("\n");
bodyTextBuffer.append("关于学习目标:");
bodyTextBuffer.append(goalName);
bodyTextBuffer.append("\n");
bodyTextBuffer.append(userNameOfWriteDiary);
bodyTextBuffer.append(" 在 ");
bodyTextBuffer.append(now);
bodyTextBuffer.append(" 写了如下日记: \n");
bodyTextBuffer.append("---------------------------------------------------------------- \n");
bodyTextBuffer.append("标题: ");
bodyTextBuffer.append(articleInfo.getArticleName());
bodyTextBuffer.append("\n");
bodyTextBuffer.append("内容: ");
bodyTextBuffer.append(articleInfo.getArticleText());
bodyTextBuffer.append("\n");
bodyTextBuffer.append("相关资源: ");
bodyTextBuffer.append(articleInfo.getArticleResource());
bodyTextBuffer.append("\n");
bodyTextBuffer.append("---------------------------------------------------------------- \n");
bodyTextBuffer.append("欢迎常来学习日记! http://www.learndiary.com");
bodyTextBuffer.append("\n");
String bodyText = bodyTextBuffer.toString();
EmailAuthenticator mailAuthenticator = new EmailAuthenticator(uername,password);
Properties props = System.getProperties();
props.put("mail.smtp.host",host);
props.put("mail.smtp.auth","true");
Iterator iterator = userInfoList.iterator();
while(iterator.hasNext()){
userInfo=(UserInfo)iterator.next();
String toMail = userInfo.getEmail();
String userName = userInfo.getUserName();
try{
Session session = Session.getInstance(props,(Authenticator)mailAuthenticator);
MimeMessage message = new MimeMessage(session);
message.setFrom(new InternetAddress(from));
message.addRecipient(Message.RecipientType.TO,new InternetAddress(toMail));
message.setSubject("学习日记您订阅的目标日记");
message.setText("您好!"+userName+bodyText);
message.saveChanges();
Transport transport = session.getTransport("smtp");
transport.connect(host,uername,password);
transport.sendMessage(message,message.getAllRecipients());
transport.close();
//System.out.println("已发送一封邮件:"+toMail);
} catch (Exception e){
e.printStackTrace();
}
}//end of while
}//end of run()
}
导航改进未能如期完成--很抱歉
自接到任务以后,我做了认真的分析和设计。
但是迫于能力有限,--我接触jsp还刚刚到jstl,
我曾于前几天和jw和admin联系反映过我的情况,得到admin的热情回复。
虽然这几天我已经尽力了,但是对于没能完成任务,影响到了整个项目的进度,我很遗憾,向各位成员道歉。
如果有好的人选,我愿意让贤。
[转]Java中四种XML解析技术之不完全测试
本文原始出处:Java中四种XML解析技术之不完全测试: http://www.blogjava.net/rosen/archive/2005/08/12/9950.html
正文:
*******************************************************************************
在平时工作中,难免会遇到把XML作为数据存储格式。面对目前种类繁多的解决方案,哪个最适合我们呢?在这篇文章中,我对这四种主流方案做一个不完全评测,仅仅针对遍历XML这块来测试,因为遍历XML是工作中使用最多的(至少我认为)。
预备
测试环境:
AMD毒龙1.4G OC 1.5G、256M DDR333、Windows2000 Server SP4、Sun JDK 1.4.1+Eclipse 2.1+Resin 2.1.8,在Debug模式下测试。
XML文件格式如下:
<?xml version="1.0" encoding="GB2312"?><RESULT><VALUE>
<NO>A1234</NO>
<ADDR>四川省XX县XX镇XX路X段XX号</ADDR></VALUE><VALUE>
<NO>B1234</NO>
<ADDR>四川省XX市XX乡XX村XX组</ADDR></VALUE></RESULT>
测试方法:
采用JSP端调用Bean(至于为什么采用JSP来调用,请参考:http://blog.csdn.net/rosen/archive/2004/10/15/138324.aspx),让每一种方案分别解析10K、100K、1000K、10000K的XML文件,计算其消耗时间(单位:毫秒)。
JSP文件:
<%@ page contentType="text/html; charset=gb2312" %><%@ page import="com.test.*"%>
<html><body><%String args[]={""};MyXMLReader.main(args);%></body></html>
测试
首先出场的是DOM(JAXP Crimson解析器)
DOM是用与平台和语言无关的方式表示XML文档的官方W3C标准。DOM是以层次结构组织的节点或信息片断的集合。这个层次结构允许开发人员在树中寻找特定信息。分析该结构通常需要加载整个文档和构造层次结构,然后才能做任何工作。由于它是基于信息层次的,因而DOM被认为是基于树或基于对象的。DOM以及广义的基于树的处理具有几个优点。首先,由于树在内存中是持久的,因此可以修改它以便应用程序能对数据和结构作出更改。它还可以在任何时候在树中上下导航,而不是像SAX那样是一次性的处理。DOM使用起来也要简单得多。
另一方面,对于特别大的文档,解析和加载整个文档可能很慢且很耗资源,因此使用其他手段来处理这样的数据会更好。这些基于事件的模型,比如SAX。
Bean文件:
package com.test;
import java.io.*;import java.util.*;import org.w3c.dom.*;import javax.xml.parsers.*;
public class MyXMLReader{
public static void main(String arge[]){
long lasting =System.currentTimeMillis();
try{
File f=new File("data_10k.xml");
DocumentBuilderFactory factory=DocumentBuilderFactory.newInstance();
DocumentBuilder builder=factory.newDocumentBuilder();
Document doc = builder.parse(f);
NodeList nl = doc.getElementsByTagName("VALUE");
for (int i=0;i<nl.getLength();i++){
System.out.print("车牌号码:" + doc.getElementsByTagName("NO").item(i).getFirstChild().getNodeValue());
System.out.println("车主地址:" + doc.getElementsByTagName("ADDR").item(i).getFirstChild().getNodeValue());
}
}catch(Exception e){
e.printStackTrace();
}
System.out.println("运行时间:"+(System.currentTimeMillis() - lasting)+"毫秒");}}
10k消耗时间:265 203 219 172
100k消耗时间:9172 9016 8891 9000
1000k消耗时间:691719 675407 708375 739656
10000k消耗时间:OutOfMemoryError
接着是SAX
这种处理的优点非常类似于流媒体的优点。分析能够立即开始,而不是等待所有的数据被处理。而且,由于应用程序只是在读取数据时检查数据,因此不需要将数据存储在内存中。这对于大型文档来说是个巨大的优点。事实上,应用程序甚至不必解析整个文档;它可以在某个条件得到满足时停止解析。一般来说,SAX还比它的替代者DOM快许多。
选择DOM还是选择SAX?
对于需要自己编写代码来处理XML文档的开发人员来说,
选择DOM还是SAX解析模型是一个非常重要的设计决策。
DOM采用建立树形结构的方式访问XML文档,而SAX采用的事件模型。
DOM解析器把XML文档转化为一个包含其内容的树,并可以对树进行遍历。用DOM解析模型的优点是编程容易,开发人员只需要调用建树的指令,然后利用navigation APIs访问所需的树节点来完成任务。可以很容易的添加和修改树中的元素。然而由于使用DOM解析器的时候需要处理整个XML文档,所以对性能和内存的要求比较高,尤其是遇到很大的XML文件的时候。由于它的遍历能力,DOM解析器常用于XML文档需要频繁的改变的服务中。
SAX解析器采用了基于事件的模型,它在解析XML文档的时候可以触发一系列的事件,当发现给定的tag的时候,它可以激活一个回调方法,告诉该方法制定的标签已经找到。SAX对内存的要求通常会比较低,因为它让开发人员自己来决定所要处理的tag。特别是当开发人员只需要处理文档中所包含的部分数据时,SAX这种扩展能力得到了更好的体现。但用SAX解析器的时候编码工作会比较困难,而且很难同时访问同一个文档中的多处不同数据。
Bean文件:
package com.test;import org.xml.sax.*;import org.xml.sax.helpers.*;import javax.xml.parsers.*;
public class MyXMLReader extends DefaultHandler {
java.util.Stack tags = new java.util.Stack();
public MyXMLReader() {
super();}
public static void main(String args[]) {
long lasting = System.currentTimeMillis();
try {
SAXParserFactory sf = SAXParserFactory.newInstance();
SAXParser sp = sf.newSAXParser();
MyXMLReader reader = new MyXMLReader();
sp.parse(new InputSource("data_10k.xml"), reader);
} catch (Exception e) {
e.printStackTrace();
}
System.out.println("运行时间:" + (System.currentTimeMillis() - lasting) + "毫秒");}
public void characters(char ch[], int start, int length) throws SAXException {
String tag = (String) tags.peek();
if (tag.equals("NO")) {
System.out.print("车牌号码:" + new String(ch, start, length));}if (tag.equals("ADDR")) {
System.out.println("地址:" + new String(ch, start, length));}}
public void startElement(String uri,String localName,String qName,Attributes attrs) {
tags.push(qName);}}
10k消耗时间:110 47 109 78
100k消耗时间:344 406 375 422
1000k消耗时间:3234 3281 3688 3312
10000k消耗时间:32578 34313 31797 31890 30328
然后是JDOM http://www.jdom.org/
JDOM的目的是成为Java特定文档模型,它简化与XML的交互并且比使用DOM实现更快。由于是第一个Java特定模型,JDOM一直得到大力推广和促进。正在考虑通过“Java规范请求JSR-102”将它最终用作“Java标准扩展”。从2000年初就已经开始了JDOM开发。
JDOM与DOM主要有两方面不同。首先,JDOM仅使用具体类而不使用接口。这在某些方面简化了API,但是也限制了灵活性。第二,API大量使用了Collections类,简化了那些已经熟悉这些类的Java开发者的使用。
JDOM文档声明其目的是“使用20%(或更少)的精力解决80%(或更多)Java/XML问题”(根据学习曲线假定为20%)。JDOM对于大多数Java/XML应用程序来说当然是有用的,并且大多数开发者发现API比DOM容易理解得多。JDOM还包括对程序行为的相当广泛检查以防止用户做任何在XML中无意义的事。然而,它仍需要您充分理解XML以便做一些超出基本的工作(或者甚至理解某些情况下的错误)。这也许是比学习DOM或JDOM接口都更有意义的工作。
JDOM自身不包含解析器。它通常使用SAX2解析器来解析和验证输入XML文档(尽管它还可以将以前构造的DOM表示作为输入)。它包含一些转换器以将JDOM表示输出成SAX2事件流、DOM模型或XML文本文档。JDOM是在Apache许可证变体下发布的开放源码。
Bean文件:
package com.test;
import java.io.*;import java.util.*;import org.jdom.*;import org.jdom.input.*;
public class MyXMLReader {
public static void main(String arge[]) {
long lasting = System.currentTimeMillis();
try {
SAXBuilder builder = new SAXBuilder();
Document doc = builder.build(new File("data_10k.xml"));
Element foo = doc.getRootElement();
List allChildren = foo.getChildren();
for(int i=0;i<allChildren.size();i++) {
System.out.print("车牌号码:" + ((Element)allChildren.get(i)).getChild("NO").getText());
System.out.println("车主地址:" + ((Element)allChildren.get(i)).getChild("ADDR").getText());
}
} catch (Exception e) {
e.printStackTrace();
}
System.out.println("运行时间:" + (System.currentTimeMillis() - lasting) + "毫秒");}}
10k消耗时间:125 62 187 94
100k消耗时间:704 625 640 766
1000k消耗时间:27984 30750 27859 30656
10000k消耗时间:OutOfMemoryError
最后是DOM4J http://dom4j.sourceforge.net/
虽然DOM4J代表了完全独立的开发结果,但最初,它是JDOM的一种智能分支。它合并了许多超出基本XML文档表示的功能,包括集成的XPath支持、XML Schema支持以及用于大文档或流化文档的基于事件的处理。它还提供了构建文档表示的选项,它通过DOM4J API和标准DOM接口具有并行访问功能。从2000下半年开始,它就一直处于开发之中。
为支持所有这些功能,DOM4J使用接口和抽象基本类方法。DOM4J大量使用了API中的Collections类,但是在许多情况下,它还提供一些替代方法以允许更好的性能或更直接的编码方法。直接好处是,虽然DOM4J付出了更复杂的API的代价,但是它提供了比JDOM大得多的灵活性。
在添加灵活性、XPath集成和对大文档处理的目标时,DOM4J的目标与JDOM是一样的:针对Java开发者的易用性和直观操作。它还致力于成为比JDOM更完整的解决方案,实现在本质上处理所有Java/XML问题的目标。在完成该目标时,它比JDOM更少强调防止不正确的应用程序行为。
DOM4J是一个非常非常优秀的Java XML API,具有性能优异、功能强大和极端易用使用的特点,同时它也是一个开放源代码的软件。如今你可以看到越来越多的Java软件都在使用DOM4J来读写XML,特别值得一提的是连Sun的JAXM也在用DOM4J。
Bean文件:
package com.test;
import java.io.*;import java.util.*;import org.dom4j.*;import org.dom4j.io.*;
public class MyXMLReader {
public static void main(String arge[]) {
long lasting = System.currentTimeMillis();
try {
File f = new File("data_10k.xml");
SAXReader reader = new SAXReader();
Document doc = reader.read(f);
Element root = doc.getRootElement();
Element foo;
for (Iterator i = root.elementIterator("VALUE"); i.hasNext();) {
foo = (Element) i.next();
System.out.print("车牌号码:" + foo.elementText("NO"));
System.out.println("车主地址:" + foo.elementText("ADDR"));
}
} catch (Exception e) {
e.printStackTrace();
}
System.out.println("运行时间:" + (System.currentTimeMillis() - lasting) + "毫秒");}}
10k消耗时间:109 78 109 31
100k消耗时间:297 359 172 312
1000k消耗时间:2281 2359 2344 2469
10000k消耗时间:20938 19922 20031 21078
JDOM和DOM在性能测试时表现不佳,在测试10M文档时内存溢出。在小文档情况下还值得考虑使用DOM和JDOM。虽然JDOM的开发者已经说明他们期望在正式发行版前专注性能问题,但是从性能观点来看,它确实没有值得推荐之处。另外,DOM仍是一个非常好的选择。DOM实现广泛应用于多种编程语言。它还是许多其它与XML相关的标准的基础,因为它正式获得W3C推荐(与基于非标准的Java模型相对),所以在某些类型的项目中可能也需要它(如在JavaScript中使用DOM)。
SAX表现较好,这要依赖于它特定的解析方式。一个SAX检测即将到来的XML流,但并没有载入到内存(当然当XML流被读入时,会有部分文档暂时隐藏在内存中)。
无疑,DOM4J是这场测试的获胜者,目前许多开源项目中大量采用DOM4J,例如大名鼎鼎的Hibernate也用DOM4J来读取XML配置文件。如果不考虑可移植性,那就采用DOM4J吧!(文/rosen)
*****************************************************************************
JAVA学习日记致本文转载者: andjia
andjia,您好,
感谢您转载的这篇文章,据本文作者反映,移去您原来的转载地网址,改为原作者网址。
admin 2007年4月16日下午
努力打好基础
努力打好基础, 不做。。。。。。。。。。。。。。。