BlogJava-空间站-文章分类-其他http://www.blogjava.net/i369/category/17407.html北极心空zh-cnTue, 01 Apr 2008 12:44:38 GMTTue, 01 Apr 2008 12:44:38 GMT60python实现抢qq奥运火炬[仅供学习][转贴]http://www.blogjava.net/i369/articles/190179.html芦苇芦苇Tue, 01 Apr 2008 11:22:00 GMThttp://www.blogjava.net/i369/articles/190179.htmlhttp://www.blogjava.net/i369/comments/190179.htmlhttp://www.blogjava.net/i369/articles/190179.html#Feedback0http://www.blogjava.net/i369/comments/commentRss/190179.htmlhttp://www.blogjava.net/i369/services/trackbacks/190179.html 最近，看到qq上不少好友的头像前都有个小火炬，自己也想要一个，遂行..
结果发现，需要登陆网页 http://huoju.icoke.qq.com/ 去自己‘抢’火炬去，而且我试验多次，也没办法抢到，只有靠‘机器’来抢了....
言归正传，经过分析，如果想抢到火炬，需要激发网页上的‘立即争夺’按钮，获取网页代码：

##按钮部分代码

<tr>
<td height="67" align="center"><a id="rob" href="#" onclick="return rob_torch();"> ... </td>
</tr>
由此可知，如函数rob_torch()有关，下载此网页相关的javascript（JS）代码，找出rob_torch()函数如下所示：

function rob_torch()
{
    if (Cookie.getCookie("tobtorchcookie") == null)
    {
        var ntime = new Date();
        var stime = new Date(ntime.getYear(), ntime.getMonth(), ntime.getDate(), ntime.getHours(), ntime.getMinutes(), ntime.getSeconds()+25);
        Cookie.setCookie("tobtorchcookie", "ok", stime);
    }
    else
    {
        alert("抱歉，您的操作过于频繁，请于25秒后重试。");
        return false;
    }
    if (arrDelay.num == 0)
    {
        alert("目前没有活动资格可供争夺，请耐心等候!");
        return false;
    }
    var vers = getQQVersion();
    if (vers == -1)
    {
        return false;
    }
    if (vers < 1777 || vers >= 2007)
    {
        alert("您当前的版本不支持活动资格争夺，请到http://im.qq.com下载安装官方2007II正式版或2008贺岁版QQ客户端。");
        return false;
    }        
    JsonLoader.load('http://app.icoke.qq.com/icoke/torchdelay.php?'+Math.random(),function()
        {
            if (typeof(numJson) != undefined)
            {
                var url = "tencent://LargeSizedActivity/?HandleID=3&PUIN=&TorchUIN="+numJson[1];
                $("rob").href = url;
                window.open(url, "robtorchiframe", "location=no");
                return true;
            }
            else
            {
                ;
            }
    });
    return false;
}
其中大部分都是验证，不是很重要，我们注意到JsonLoader.load这个函数调用，其中有两个参数，一个是原url地址，另一个是回调函数内容，我们先看到这个回调函数会调用url地址‘tencent://LargeSizedActivity/?HandleID=3&PUIN=&TorchUIN=XXX’其中XXX经过后来分析，是一个号码，火炬号码，$("rob").href = url;讲网页中的变量rob赋值为这个刚刚生成的url地址，然后由window.open()来调用这个链接，后来分析这个tencent协议需要调用一个qq客户端程序，暂时不知，由这个客户端程序去处理url地址请求。
再返回来查看JsonLoad对象的load函数，代码如下：

var JsonLoader = {
    load: function(sUrl, fCallback)
    {
        var _script = document.createElement("script");
        _script.setAttribute("type", "text/javascript");
        _script.setAttribute("src", sUrl);
        document.getElementsByTagName("head")[0].appendChild(_script);
        if (!!document.all)
        {
            _script.onreadystatechange = function()
            {
                if (this.readyState=="loaded" || this.readyState=="complete")
                {
                    fCallback();
                }
            };
        }
        else
        {
            _script.onload = function()
            {
                fCallback();
            };
        }
    },
.............
这个，我们截取了一部分，其主要意思是根据情况，调用load的第二个参数，回调函数。
这样，我们就知道了，我们只需要激发这个tencent的协议调用就可以激发按钮事件了....
现在的问题就是我们如何去获得上文中的XXX，即火炬号码，由上述代码rob_torch()函数中的url = "tencent://LargeSizedActivity/?HandleID=3&PUIN=&TorchUIN="+numJson[1]，我们发现，这个XXX变量numjSon[1]同函数delay_refresh()中的arrDelay.delayqq的值是一样的，所以我们就直接每次通过调用delay_refresh()函数来更新获得当前放出来的火炬的延迟编号。

function delay_refresh()
{
    var url = 'http://huoju.icoke.qq.com/huojuicoke/datajs/torch_delay2.js?'+Math.random();
    AsynLoader.load(url,
             {
                method:'get',
                onSuccess: function(xmlHttp)
                {
                    arrDelay = eval("(" + xmlHttp.responseText + ")");
                    $("torch_num").innerHTML = arrDelay.num;
                    if ($("torch_total") != null)
                    {
                        $("torch_total").innerHTML = formatNum(arrDelay.total_count);
                    }
                    var url = "tencent://LargeSizedActivity/?HandleID=3&PUIN=&TorchUIN="+arrDelay.delayqq;
                    $("rob").href = url;
                },
                onFailure: function()
                { }
    });

后面进一步分析得知，此页面每隔一定时间调用这个fresh函数去刷新获取当前释放出来的火炬编号，一段时间只释放一个编号，我们可以频繁调用这个刷新函数，然后在这个火炬被释放的第一时间，获取这个火炬的编号，然后调用tencent协议url请求去获取获取，这样，一旦有火炬被释放出来，就可以很快的去'抢'，比自己用手去点要快多了，本代码没有考虑异常情况，而且实现也不是很完善....不想继续完善了，因为本来是用于分析和学习，所以没必要继续了....
经过测试，机器就是比人快...哈哈，以下是python实现的而代码，再次提醒，对于代码造成的任何影响，本作者不附带任何责任。

import urllib,webbrowser,time
import random
import re

regx = re.compile('\"[0-9]*\"') #分析获取火炬编号的模式

#用于记录原来的火炬编号，如果两次获取的火炬编号一致，则不激发获取火炬的事件

old=''

num=999 #试验999次

fresh_url='http://huoju.icoke.qq.com/huojuicoke/datajs/torch_delay2.js?'

get_url='tencent://LargeSizedActivity/?HandleID=3&PUIN=&TorchUIN='

while num-- <= 0:
    net=urllib.urlopen(fresh_url) #刷新释放的火炬
    data=net.read()
    m_list=re.findall(regx,data) #获取火炬编号
    if old != m_list[0]:
        webbrowser.open(get_url + str(m_list[0])) #激发获取火炬事件
    time.sleep(1) #stop 1 second


芦苇 2008-04-01 19:22 发表评论
]]>log4j和commons.logging日志记录的使用方法http://www.blogjava.net/i369/articles/185309.html芦苇芦苇Tue, 11 Mar 2008 03:48:00 GMThttp://www.blogjava.net/i369/articles/185309.htmlhttp://www.blogjava.net/i369/comments/185309.htmlhttp://www.blogjava.net/i369/articles/185309.html#Feedback3http://www.blogjava.net/i369/comments/commentRss/185309.htmlhttp://www.blogjava.net/i369/services/trackbacks/185309.html

Log4j中文手册下载地址http://www.matrix.org.cn/resource/upload/forum/2006_04_07_205056_ZCxoePRlHJ.pdf

log4j的好处在于：
1.通过修改配置文件，就可以决定log信息输出到何处(console,文件,...),是否输出。
这样，在系统开发阶段可以打印详细的log信息以跟踪系统运行情况,而在系统稳定后可以关闭log输出,从而在能跟踪系统运行情况的同时,又减少了垃圾代码(System.out.println(...)等)。
2.使用log4j，需要整个系统有一个统一的log机制，有利于系统的规划。

当你在开发程序的时候, 调试(debugging)和日志(logging)都是非常重要的工作, 但是, 现在有太多的 logging API 问世, 因为他们都不错, 很难做一个抉择. 国外 java 论坛对于这些 logging 方式也是有一番讨论.

而 common logging 就是一个在这几个不同的 logging API 中建立小小的桥梁.目前在 Java 中最有名的 Log 方式, 首推是 Log4j, 另是 JDK 1.4 Logging API. 除此之外, 还有 Avalon 中用的 LogKit 等等 . 而 commons-logging 也有实现一些基本 的 logging 方式为 NoOpLog 及 SimpleLog. 对于他们的比较不在这次讨论范围,

有兴趣者请自行参阅参考文件.

快速使用 Logging 其实 logging 非常简单去使用, 将 commons-logging.jar 放到 /WEB-INF/lib 之下.接著写以下的代码

LoggingTest.java

package com.softleader.newspaper.java.opensource;

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

public class LoggingTest {

Log log = LogFactory.getLog(LoggingTest.class);

public void hello() {
log.error("ERROR");
log.debug("DEBUG");
log.warn("WARN");
log.info("INFO");
log.trace("TRACE");
System.out.println("OKOK");
}

}

在 / 放置一个 jsp 测试 test-commons-logging.jsp

<%@ page import="com.softleader.newspaper.java.opensource.LoggingTest" %>
<% LoggingTest test = new LoggingTest(); test.hello();%>

你将会看到 tomcat console 会有下面输出

log4j:WARN No appenders could be found for logger (com.softleader.newspaper.java.opensource.LoggingTest).
log4j:WARN Please initialize the log4j system properly.OKOK

是因为你还没有配置 commons-logging.properties, 马上会为你介绍 ~~~.

设定 commons-logging.properties 你可以设置你的 log factory 是要使用哪一个 我以 Log4J 为例子 在 /WEB-INF/classes/commons-logging.properties 中写入
org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JCategoryLog
如果你 server 是使用 jdk1.4 以上的版本
可以使用 org.apache.commons.logging.impl.Jdk14Logger
接著根据你的 Logger 撰写符合他的 properties 拿 Log4j 为例子 你就要在
/WEB-INF/classes/ 下放置一个

//日志输出到文件
log4j.rootLogger=DEBUG, A_default
log4j.appender.A_default=org.apache.log4j.RollingFileAppender
log4j.appender.A_default.File=c://log/test.log
log4j.appender.A_default.MaxFileSize=4000KB
log4j.appender.A_default.MaxBackupIndex=10
log4j.appender.A_default.layout=org.apache.log4j.PatternLayout
log4j.appender.A_default.layout.ConversionPattern=%d{ISO8601} - %p - %m%n

//日志输出到控制台
log4j.rootLogger=INFO, A1
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n

//发送邮件
# Configuration for receiving e-mails when ERROR messages occur.

#自定义的Appender
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
#日志的错误级别
log4j.appender.MAIL.Threshold=ERROR
#缓存文件大小，日志达到512K时发送Email
log4j.appender.MAIL.BufferSize=512
#发件人
log4j.appender.MAIL.From=webmaster@bcxy.com
#发送邮件的服务器
log4j.appender.MAIL.SMTPHost=smtp.163.com
#邮件的标题
log4j.appender.MAIL.Subject=Log4J Message
#日志邮件的接收者
log4j.appender.MAIL.To=ezerg@126.com
#日志PatternLayout
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
#日志的格式
log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n


此时你去执行 test-commons-logging.jsp 输出的内容, 就会记录在你的 c:\log 目录的 test.log 中了 ps:如果没有相关的 class 会使用到 SimpLog, 此时要设定的是
simplelog.properties 结论以我自己本身使用的经验, Log4j 可以满足所有工程师, 所以我也是直接使用 log4j 而没有使用 commons-logging.

不过为了增加产品的通用性, 避免移植时候的麻烦, 新的产品及项目, 我会将他改成 commons-logging api 去调用.

如果你对commons-logging的工作原理不是很了解，请参考＜commons-logging的使用方法＞

另，mvnforum里面的commons-logging.properties写法：
# This is configuration file which used to config Logging for mvnForum application
# mvnForum supports 2 Loggings: Log4J and jzonic
# Depend on your web server, you should choose a logging properly


# IMPORTANT NOTE FOR TOMCAT 5.x USERS:
#
# By default, Tomcat 5.x will not work with Log4J.
# However, this file (commons-logging.properties) with a line
# config : org.apache.commons.logging.LogFactory=org.apache.commons.logging.impl.Log4jFactory
# make Tomcat 5.x and Log4J work happyly together forever, I dont know why :-)



# Log4J
# This used to config logging Log4J
# Note that by default, common logging will look for Log4J first
# Comment out folling line to if you will use Jlo logging (also remember to enable Jlo below)

org.apache.commons.logging.LogFactory=org.apache.commons.logging.impl.Log4jFactory

# Jlo
# jlo.xml config logging which only log the statements (DEBUG, ERROR, TRACE, INFO, WARN)
# from the packages start with net.myvietnam and com.mvnforum.
# See properities/jlo.xml for detail about this logging
# See http://jzonic.org for documentation
# If you want to extend mvnForum application, you should be aware of that

# Uncomment folling line to choose jlo logging
# You will need Jlo if Log4j could not run on Tomcat 5.0.x, Tomcat 5.5.x or JRun 4
# NOTE: read comment above about Tomcat 5.x issue

# org.apache.commons.logging.LogFactory=org.jzonic.jlo.LogManager

====================================================================

LOG4J的配置之简单使它遍及于越来越多的应用中了：Log4J配置文件实现了输出到控制台、文件、回滚文件、发送日志邮件、输出到数据库日志表、自定义标签等全套功能。择其一二使用就够用了，



log4j.rootLogger=DEBUG,CONSOLE,A1,im
log4j.addivity.org.apache=true



# 应用于控制台

log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.Threshold=DEBUG
log4j.appender.CONSOLE.Target=System.out
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
#log4j.appender.CONSOLE.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD] n%c[CATEGORY]%n%m[MESSAGE]%n%n


#应用于文件

log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=file.log
log4j.appender.FILE.Append=false
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
# Use this layout for LogFactor 5 analysis



# 应用于文件回滚

log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender
log4j.appender.ROLLING_FILE.Threshold=ERROR
log4j.appender.ROLLING_FILE.File=rolling.log
log4j.appender.ROLLING_FILE.Append=true
log4j.appender.ROLLING_FILE.MaxFileSize=10KB
log4j.appender.ROLLING_FILE.MaxBackupIndex=1
log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n


#应用于socket
log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender
log4j.appender.SOCKET.RemoteHost=localhost
log4j.appender.SOCKET.Port=5001
log4j.appender.SOCKET.LocationInfo=true
# Set up for Log Facter 5
log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout
log4j.appender.SOCET.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]%n%c[CATEGORY]%n%m[MESSAGE]%n%n


# Log Factor 5 Appender
log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender
log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000



# 发送日志给邮件

log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
log4j.appender.MAIL.Threshold=FATAL
log4j.appender.MAIL.BufferSize=10
log4j.appender.MAIL.From=web@www.wuset.com
log4j.appender.MAIL.SMTPHost=www.wusetu.com
log4j.appender.MAIL.Subject=Log4J Message
log4j.appender.MAIL.To=web@www.wusetu.com
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n



# 用于数据库
log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test
log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
log4j.appender.DATABASE.user=root
log4j.appender.DATABASE.password=
log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES ('[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n')
log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
log4j.appender.DATABASE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n


log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File=SampleMessages.log4j
log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j'
log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout

#自定义Appender

log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender

log4j.appender.im.host = mail.cybercorlin.net
log4j.appender.im.username = username
log4j.appender.im.password = password
log4j.appender.im.recipient = corlin@cybercorlin.net

log4j.appender.im.layout=org.apache.log4j.PatternLayout
log4j.appender.im.layout.ConversionPattern =[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n




芦苇 2008-03-11 11:48 发表评论
]]>访问安全网站(使用SSL)总是跳出安全警报的解决方法http://www.blogjava.net/i369/articles/157717.html芦苇芦苇Fri, 02 Nov 2007 04:04:00 GMThttp://www.blogjava.net/i369/articles/157717.htmlhttp://www.blogjava.net/i369/comments/157717.htmlhttp://www.blogjava.net/i369/articles/157717.html#Feedback0http://www.blogjava.net/i369/comments/commentRss/157717.htmlhttp://www.blogjava.net/i369/services/trackbacks/157717.html

芦苇 2007-11-02 12:04 发表评论
]]>[转]一个优秀软件开发人员的必修课：GRASP软件开发模式浅析 http://www.blogjava.net/i369/articles/153199.html芦苇芦苇Tue, 16 Oct 2007 03:22:00 GMThttp://www.blogjava.net/i369/articles/153199.htmlhttp://www.blogjava.net/i369/comments/153199.htmlhttp://www.blogjava.net/i369/articles/153199.html#Feedback3http://www.blogjava.net/i369/comments/commentRss/153199.htmlhttp://www.blogjava.net/i369/services/trackbacks/153199.html  

你是一个优秀软件开发人员吗？你知道GRASP 

一.职责分配和职责驱动设计

在一个软件项目开始的时候，我们通常需要进行需求分析，了解客户需要设计一个什么样的软件，这个软件中应当有什么功能。需求分析了解到的是现实世界中客户需求的业务功能，每个业务功能往往是一个业务流程，即客户在日常工作中不断在完成的业务流程。同时，在用户的问题世界中，必然有一些东西或者说事物，它们之间存在着相互的关联。

拿一个软件评审管理系统作为一个例子吧。评审管理系统的业务需求如下：

1通过以上需求的描述，我们不难发现整个问题世界中的相关事物：评审组织者、评审计划、评审者、评审对象、评审表、疑问、评审报告、评审结论、问题。我们也不难分析出这些事物相互关系，比如评审计划与评审者是一对多，而评审报告与评审结论是一对一。

在RUP领域模型中的对象将成为软件开发中形成具体对象的基础（软件开发中形成什么对象是根据软件开发的具体需求而定的，并不一定要与领域模型的对象一致）。用例模型中的用例，将通过赋予这些对象行为而得以实现。现在的问题就出来了，用例模型中的功能，或者说一系列行为，应当如何分配给这些对象呢。也就是说，为了完成同一个任务，我可以将行为A我们通过对现实世界的分析，或者说对于领域模型的分析，设计出了软件系统中的对象，这时候我们应当为每一个对象分配职责。什么是对象的职责呢，当然是通过对现实世界的分析，定义的这个对象应当完成的任务。比如评审者对象的职责是存取与评审者相关的数据。当然对象的职责不一定是一个，比如评审计划包含了评审对象和评审者的子项，所以它在工作不繁忙的情况下可以代理处理评审对象和评审者的信息存取。但是一个对象的职责不应当过多（也就2职责分配现在已经被普遍认为是一个优秀的软件设计应当遵循的原则，它有以下好处：

1这种通过考虑对象、职责、协作的对象设计及构件方式，被称为“职责驱动设计（RDD

二.GRASP模式挨个析

GRASP（原创）一个优秀软件开发人员的必修课：GRASP（2）低耦合

（原创）一个优秀软件开发人员的必修课：GRASP（3）高内聚

一个对象撕心裂肺的怒吼：谁来创建我！GRASP（4）创建者模式

（待续）



以下是原博客的讨论:[建议到员博客阅读]
最后更新：2007-02-04 15:24
14:11  |   永久链接  |   浏览 (5801)  |   评论 (13)  |    收藏  |   进入论坛  |  
评论    共 13 条 发表评论
amigobot     2007-01-20 13:08

没有下文了？ 期待中。GRASP和GoF是不同类型的模式， 出发点不同。 GRASP是解决类之间如何交互， 如何设计合理， 和具体问题无关。
galaxystar     2007-01-20 13:50

感觉是一种综合体！
zuly     2007-01-20 14:08

知道名字就可以!其他的可以google!

what we need is the name , add others to google!
fangang     2007-01-22 08:46

zuly 写道
知道名字就可以!其他的可以google!

 

what we need is the name , add others to google!

我写这篇文章的起因是因为我偶然在google或yahoo这样的搜索引擎搜索GRASP发现，除了国外的网站，国内网站多介绍和讨论GoF而很少介绍GRASP，即使这少量的文章也讲解非常粗略。个人认为作为优秀的开发人员，理解GRASP比GoF更重要，故写此文章。此文章后面的内容我会不断添上，谢谢支持

 
fangang     2007-01-22 09:15

amigobot 写道
没有下文了？ 期待中。GRASP和GoF是不同类型的模式， 出发点不同。 GRASP是解决类之间如何交互， 如何设计合理， 和具体问题无关。

我同意。GRASP与GoF最大的区别，本人认为GoF往往是解决一些具体的问题，比如类的具体创建方式等等，而GRASP是解决对象分析的一些基本原则，即你如何去设计你的问题空间中的类和它们的行为，是原则性的东西。后面我会一个一个分析GRASP的9个模式，也就是9个基本原则，谢谢支持

 
newman     2007-01-24 10:36

有点意思。不过从fangang朋友对grasp的介绍，我得到的印象是grasp跟gof作为比较有些不当，可能是我的理解有误。希望能看到fangang朋友对grasp给出一个比较明确的定义，以及适用范围，比如在软件开发生命周期中，grasp在什么阶段用合适？有哪些效用。。。等等，期待中。
fangang     2007-01-24 13:46

谢谢指教，grasp和gof都是称为软件开发模式，只是描述的内容和角度不同，这相关的问题Craig Larman在《UML和模式应用》的第17章中有详细描述
fly_ever     2007-01-24 15:55

有一本书阐述了GRASP，《深入浅出设计模式 C#/JAVA版》，06年出版的。
感觉跟GOF相比，GRASP主要是用来指导面向对象的分析和设计。
fangang     2007-01-24 16:23

newman 写道
有点意思。不过从fangang朋友对grasp的介绍，我得到的印象是grasp跟gof作为比较有些不当，可能是我的理解有误。希望能看到fangang朋友对grasp给出一个比较明确的定义，以及适用范围，比如在软件开发生命周期中，grasp在什么阶段用合适？有哪些效用。。。等等，期待中。

grasp(General Responsibility Assignment Software Patterns)，它往往适用于对象分析和设计中，即在RUP的制作分析模型和设计模型阶段。grasp有9种模式，是用于解决软件设计中的9种常见的问题，因此其效用各不一样，不能一概而论。

 
fangang     2007-01-25 09:51

非常感谢newman给我提的数个问题。GRASP虽好，GoF虽好，最关键是我们怎么用和啥时候用，这两个问题一直是我反复思考的问题。我正在筹划写一篇关于软件开发过程，特别是分析和设计这个阶段，如何运用GRASP和GoF的一点儿认识，期望和大家切磋切磋


芦苇 2007-10-16 11:22 发表评论
]]>SVN配置http://www.blogjava.net/i369/articles/153192.html芦苇芦苇Tue, 16 Oct 2007 03:13:00 GMThttp://www.blogjava.net/i369/articles/153192.htmlhttp://www.blogjava.net/i369/comments/153192.htmlhttp://www.blogjava.net/i369/articles/153192.html#Feedback2http://www.blogjava.net/i369/comments/commentRss/153192.htmlhttp://www.blogjava.net/i369/services/trackbacks/153192.html　　subversion(以下简称svn)是近年来崛起的版本管理工具，是cvs的接班人。
　　svn服务器有2种运行方式：独立服务器和借助apache。2种方式各有利弊。
　　svn存储版本数据也有2种方式：BDB和FSFS。因为BDB方式在服务器中断时，有可能锁住数据（我在搞ldap时就深受其害，没法根治），所以还是FSFS方式更安全一点。
1. svn服务器安装
操作系统: Redhat Linux AS4
安装包获取:
下载http://subversion.tigris.org/downloads/subversion-1.4.0.tar.gz和http://subversion.tigris.org/downloads/subversion-deps-1.4.0.tar.gz。
编译:
以root用户登录。
将subversion-1.4.0.tar.gz和subversion-deps-1.4.0.tar.gz传到服务器。
tar xfvz subversion-1.4.0.tar.gz
tar xfvz subversion-deps-1.4.0.tar.gz
cd subversion-1.4.0
./configure --prefix=/opt/svn --without-berkeley-db –with-zlib
(注：以svnserve方式运行，不加apache编译参数。以fsfs格式存储版本库，不编译berkeley-db)
make clean
make
make install
vi /etc/profile,在/etc/profile最后加入:
PATH=$PATH:/opt/svn/bin
export PATH
测试:
svnserve –version
如果显示如下，安装成功:
svnserve, version 1.4.0 (r21228)
　 compiled Oct 12 2006, 10:18:56
Copyright (C) 2000-2006 CollabNet.
Subversion is open source software, see http://subversion.tigris.org/
This product includes software developed by CollabNet (http://www.Collab.Net/).
The following repository back-end (FS) modules are available:
* fs_fs : Module for working with a plain file (FSFS) repository.
2. svn配置
建立版本库目录，可建多个：
mkdir -p /opt/svndata/repos1
mkdir -p /opt/svndata/repos2
建立版本库:
svnadmin create /opt/svndata/repos1
svnadmin create /opt/svndata/repos2
修改版本库配置文件:
版本库1：
vi /opt/svndata/repos1/conf/svnserve.conf
内容修改为:
[general]
anon-access = none
auth-access = write
password-db = /opt/svn/conf/pwd.conf
authz-db = /opt/svn/conf/authz.conf
realm = repos1
版本库2:
vi /opt/svndata/repos2/conf/svnserve.conf
内容修改为:
[general]
anon-access = none
auth-access = write
password-db = /opt/svn/conf/pwd.conf
authz-db = /opt/svn/conf/authz.conf
realm = repos2
　　即除realm = repos2外，其他与版本库1配置文件完全相同。如果有更多的版本库，依此类推。
配置允许访问的用户:
vi /opt/svn/conf/pwd.conf
　　为了简化配置，2个版本库共用1个用户配置文件。如有必要，也可以分开。
注意：对用户配置文件的修改立即生效，不必重启svn。
文件格式如下：
[users]
<用户1> = <密码1>
<用户2> = <密码2>
　　其中，[users]是必须的。下面列出要访问svn的用户，每个用户一行。示例：
[users]
alan = password
king = hello
配置用户访问权限:
vi /opt/svn/conf/authz.conf
　　为了简化配置，3个版本库共用1个权限配置文件/opt/svn/conf/pwd.conf。如有必要，也可以分开。文件中定义用户组和版本库目录权限。
注意：
* 权限配置文件中出现的用户名必须已在用户配置文件中定义。
* 对权限配置文件的修改立即生效，不必重启svn。
用户组格式：
[groups]
<用户组名> = <用户1>,<用户2>
其中，1个用户组可以包含1个或多个用户，用户间以逗号分隔。
版本库目录格式：
[<版本库>:/项目/目录]
@<用户组名> = <权限>
<用户名> = <权限>
　　其中，方框号内部分可以有多种写法:
/,表示根目录及以下。根目录是svnserve启动时指定的，我们指定为/opt/svndata。这样，/就是表示对全部版本库设置权限。
repos1:/,表示对版本库1设置权限
repos2:/occi, ,表示对版本库2中的occi项目设置权限
repos2:/occi/aaa, ,表示对版本库2中的occi项目的aaa目录设置权限
　　权限主体可以是用户组、用户或*，用户组在前面加@，*表示全部用户。权限可以是w、r、wr和空，空表示没有任何权限。
示例：
[groups]
admin = alan
[/]
@admin = rw
[repos1:/occi/aaa]
king = rw
[repos2:/pass]
king =
删除无用文件:
rm /opt/svndata/repos1/conf/authz
rm /opt/svndata/repos1/conf/passwd
rm /opt/svndata/repos2/conf/authz
rm /opt/svndata/repos2/conf/passwd
3. 启动svn
建立启动svn的用户:
useradd svn
passwd svn
根据提示为用户svn设置密码
允许用户svn访问版本库:
chown –R svn:svn /opt/svndata
chown –R svn:svn /opt/data
启动svn：
su - svn -c "svnserve -d --listen-port 9999 -r /opt/svndata"
其中：
su – svn表示以用户svn的身份启动svn
-d表示以daemon方式（后台运行）运行
--listen-port 9999表示使用9999端口，可以换成你需要的端口。但注意，使用1024以下的端口需要root权限
-r /opt/svndata指定根目录是/opt/svndata
检查:
ps –ef|grep svnserve
如果显示如下，即为启动成功：
svn　　　 6941　　 1　0 15:07 ?　　　　00:00:00 svnserve -d --listen-port 9999 -r /opt/svndata
参考资料：
http://www.gbunix.com/htmldata/2006_07/15/27/article_1337_1.html
http://www.iusesvn.com/bbs/thread-157-1-1.html
http://16hot.blog.isyi.com/post/1/552

检测服务是否开启：netstat -ntlp如果看到3690的端口正常开放了，证明SVN启动了。]
下面是机器上的端口显示:
Active Internet connections (only servers)
Proto Recv-Q Send-Q Local Address         Foreign Address              State        PID/Program name
tcp         0       0 0.0.0.0:32769         0.0.0.0:*                    LISTEN       2611/rpc.statd
tcp         0       0 0.0.0.0:111           0.0.0.0:*                    LISTEN       2591/portmap
tcp         0       0 0.0.0.0:113           0.0.0.0:*                    LISTEN       2827/xinetd
tcp         0       0 127.0.0.1:631         0.0.0.0:*                    LISTEN       4860/cupsd
tcp         0       0 127.0.0.1:25          0.0.0.0:*                    LISTEN       2846/sendmail: acce
tcp         0       0 :::3690               :::*                        LISTEN       5513/svnserve
tcp         0       0 :::22                 :::*                        LISTEN       2812/sshd
下面这个就是了:
tcp         0       0 :::3690               :::*                        LISTEN       5513/svnserve
好了,svn已经架起来了
主页 | 照片 | 视频 | 收藏
Onion的天空
Live In ShangHai.Mon 7 Aug 2006在 Linux/Apache 2.2 上配置SVN服务器
By Onion under Linux   | Tag : Apache, Linux, svn, Ubuntu
You can skip to the end and leave a response. Pinging is currently not allowed.
准备，下载所需要文件.
检查已安装的 Apache2 是否已经安装了 mod_dav .
编译SVN，遇到的问题和解决方法
使用 默认文件系统(fsfs) 保存数据
使用 Berkeley DB 保存数据
配置Apache和SVN，测试.
其它小结
从Windows平台上数据转移
配置文件,使用其支持对文件中的 $Id$ 标签每次提交的时候自动更新版本信息.
基于路径的权限控制
常用SVN命令
相关资源
* 准备，下载所需要文件.
本文测试环境：
ubuntu 6.06 LTS (kernel 2.6.15-25-k7，gcc-4.0.3) /ubuntu server (2.6.15-26-server,gcc-4.0.4)
Subversion 1.3.2
Apache 2.2.2
最新的版本 Subversion 可以在这里找到 ：http://subversion.tigris.org/project_packages.html
* 检查已安装的 Apache2 是否已经安装了 mod_dav .
如果已经成功安装了Apache，使用 httpd -M 来查看有没有安装 dav_module，如果没有的话 必须附加 ‘–enable-dav’ ‘–enable-dav-fs’ 两个参数重新编译 Apache，否则即使编译通过了svn,apache也会启动不起来.
如何编译 Apache 请参考我另外一篇文章.
* 编译SVN，遇到的问题和解决方法.
使用默认的文件系统保存数据.
最终完整通过安装和测试的编译参数为：
./configure --with-apxs=/usr/local/apache2/bin/apxs \
--with-apr=/home/src/server/httpd-2.2.2/srclib/apr \
--with-apr-util=/home/src/server/httpd-2.2.2/srclib/apr-util
make
make install
其中 /home/src/server/ 为 httpd-2.2.2 源代码所在文件夹，根据实际情况调整一下.
◆ 遇到问题：
1) --with-apr 和 --with-apr-util 如果没有加上的话，即使编译成功了也会出现
Can’t set position pointer in file ‘/home/svn/repos/db/revs/0′: Invalid argument
这样的错误提示.
2) 暂时不能使用 Berkeley DB [* 已解决]
svn保存文件更新数据库的方法有两个，一种是直接使用 fs (filesystem)来保存,另一种是通过Oracle提供支持的开源数据库 Berkeley DB 进行保存。但是如果加上 –with-berkeley-db=/usr/local/BerkeleyDB.4.4 就会configure时就会报错.
configure: error: APR-UTIL was installed independently, it won’t be
possible to use the specified Berkeley DB: /usr/local/BerkeleyDB.4.4
我想 apr-unit 暂时不支持吧，我们就用默认的fs好了.
3) 在make 的时候可能会遇到缺少 srclib/apr/libapr-1.la，srclib/apr-util/libaprutil-1.la 两个文件，找不到而make error.
解决办法：/usr/local/apache2/lib/ 中找到，将其复制到源代码文件夹相应的位置中.
Update!!
使用 BerkeleyDB 保存数据.
1) 安装 BerkeleyDB
cd /usr/local/src
wget http://downloads.sleepycat.com/db-4.3.29.tar.gz
tar xzvf db-4.3.29.tar.gz
cd /usr/local/src/db-4.3.29/build_unix
../dist/configure --enable-compat185
make
make install
2) 更新apr和apr-util源代码
# 清理编译后的.la文件
cd /usr/local/src/httpd-2.2.3
make clean
cd /usr/local/src/subversion-1.3.2
rm -rf apr
rm -rf apr-util
cp -rf /usr/local/src/httpd-2.2.3/srclib/apr ./
cp -rf /usr/local/src/httpd-2.2.3/srclib/apr-util/ ./
3) 编译安装
./configure --with-apxs=/usr/local/apache2/bin/apxs \
--with-berkeley-db=/usr/local/BerkeleyDB.4.3 \
--with-ssl
make
make install
◆ 遇到问题：
1) BerkeleyDB 版本不能大于 4.3.否则同样会出现以下错误.
configure: error: APR-UTIL was installed independently, it won’t be
possible to use the specified Berkeley DB: /usr/local/BerkeleyDB.4.4
主要是apr-util 暂时不支持4.4的版本.
2) 必须更新apr，apr-util 源代码.
subversion-1.3.2 自带的 apr-util 的版本是0.9.6的,必须升级为 1.2.7 虽然能编译过去。但在 svn checkout 的时候会提示
svn: REPORT request failed on ‘/!svn/vcc/default’
svn: REPORT of ‘/!svn/vcc/default’: Could not read status line: connection was closed by server.
这个问题困扰了我很长时间，Google和官方论坛都无结果。后来昨天竟然自己无意中解决了，感动的得哭了:)
* 配置Apache和SVN，测试
成功编译svn后会在 httpd.conf 中自动加上
LoadModule dav_svn_module modules/mod_dav_svn.so
LoadModule authz_svn_module modules/mod_authz_svn.so
两个模块，没有的话，自行加上或检测是否真的编译成功.
假设我们现在要将一个名为 Lair 的项目导入到 SVN中
1). Apache的配置
在 conf/httpd.conf 或 conf/extra/httpd-vhosts.conf 中加入
<Location /svn/Lair>
DAV svn
SVNPath /home/svn/Lair
</Location>
可以参考以下apache的配置，实现数据加密传输，用户身份验证.
Listen 443
AddType application/x-x509-ca-cert .crt
AddType application/x-pkcs7-crl .crl.
SSLPassPhraseDialog exec:/etc/sendsslpwd
SSLSessionCache shmcb:/usr/local/apache2/logs/ssl_scache(512000)
SSLSessionCacheTimeout 300
SSLMutex file:/usr/local/apache2/logs/ssl_mutex
<VirtualHost _default_:443>
DocumentRoot /var/SVNRoot
ServerName svn.yousite.com:443
ServerAdmin webmaster@yousite.com
<Location />
DAV svn
SVNPath /var/SVNRoot
AuthzSVNAccessFile /etc/svnserve.conf
Satisfy Any
AuthType Basic
AuthName “yousite SVN Repository”
AuthUserFile /etc/httpd-passwords.txt
Require valid-user
</Location>
SSLEngine on
SSLCipherSuite ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP:+eNULL
SSLCertificateFile /etc/ssl/server.crt
SSLCertificateKeyFile /etc/ssl/server.key
</VirtualHost>
更详细的配置说明文档 http://svnbook.red-bean.com/nightly/en/svn.ref.mod_dav_svn.conf.html
2). 配置，并且测试SVN，
创建一个新用户,用了保存仓库.
useradd -m svn
创建一个新模块
su daemon (apache是以daemon用户运行的,所以要切换身份，否则可能会报目录访问权限错误)
svnadmin create --fs-type fsfs /home/svn/Lair
导入原来的项目
svn import /var/www/Lair http://localhost/svn/Lair -m ‘Initial import’
重新建立工作目录
rm -rf /var/www/Lair (注意备份!!)
svn checkout http://localhost/svn/Lair
测试打开 http://localhost/svn/Lair
如能看到一个你项目录列表，说明您成功了。
* 其它小结
■ 数据转移:
从 Windows 平台 SVN 服务器转移
如果windows svn储存的格式也是dbd的话，直接将SVN的文件夹copy过来即可.然后
执行 svnadmin recover /var/SVNRoot 检查一下数据库是否损坏.
最后注意权限,确保 db 目录下的所有文件可写。
chmod 755 db
chmod 666 db/*
否则checkout时出现以下错误，多数是因为文件或者目录权限问题引起的，可以尝试用 chown 或者 chmod 命令修改一下权限
<m:human-readable errcode=”160029″>
Could not open the requested SVN filesystem
</m:human-readable>
<m:human-readable errcode=”13″>
Could not open the requested SVN filesystem
</m:human-readable>
另外一种方法没有测试过，原理大致和mysqldump一样，将svn导出为文本文件，然后重新导入，好处是可以避免因为存储格式不同而导致的数据转移困难。
# dump data to file (assuming a repo @ c:\repo):
svnadmin dump c:\repo > c:\repo.txt
# Copy the file over to linux:
mkdir /repo
svnadmin create /repo
svnadmin load /repo < /repo.txt
■ 设置访问控制
当 httpd.conf 中 设置 AuthzSVNAccessFile 时，可以设置不同用户对不同目录的访问控制.以下是一个例子.
[groups]
root = admin.root
web = user1,user2
soft = user3,user4
[/]
@root = rw
[/www]
@web = rw
[/soft]
@soft = rw
详细的说明文档：http://svnbook.red-bean.com/nightly/en/svn.serverconfig.httpd.html
■ 配置文件，使用其支持对文件中的 $Id$ 标签每次提交的时候自动更新版本信息(自动属性).
Windows : C:\Documents and Settings\%USERNAME%\Application Data\Subversion\config
Linux : ~\.subversion\config
[miscellany]
enable-auto-props = yes
[auto-props]
*.php=svn:keywords=Id
*.html=svn:keywords=Id
>> 关于自动属性的更高级讨论
■ 几条常用svn 命令
svn update
svn add “filename”
svn commit
———————–
Change Log:
2006-08-14 neon库subversion已经自带,不需要在单独安装,添加-with-ssl即可使用svn对ssl支持.
2006-08-10 补充自动属性的说明.
2006-08-08 加入关于目录访问验证的说明.
2006-08-07 httpd,2.2.3测试依然有效，解决bdb数据库的支持问题，添加从Windows到Linux下的数据转移方案。
2006-07-25 看到到.声仔对 Can’t set position pointer in file 另一种解决方案,我当时也测试了，好像没有成功。不想用apache源代码编译的朋友可以也测试一下


芦苇 2007-10-16 11:13 发表评论
]]>一步一步架设自用svn服务器http://www.blogjava.net/i369/articles/151220.html芦苇芦苇Tue, 09 Oct 2007 00:54:00 GMThttp://www.blogjava.net/i369/articles/151220.htmlhttp://www.blogjava.net/i369/comments/151220.htmlhttp://www.blogjava.net/i369/articles/151220.html#Feedback0http://www.blogjava.net/i369/comments/commentRss/151220.htmlhttp://www.blogjava.net/i369/services/trackbacks/151220.html  目的：

1.架设基于Svnserve的服务器

2.让Svnserve在Windows启动时，自动启动  

一，下载TortoiseSVN和Subversion软件

1.下载TortoiseSVN,当前最新的版本是1.4.4, 从这儿下载http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.4.4.9706-win32-svn-1.4.4.msi?download

2.安装

3.重启

4.下载Subversion，当前最新版是1.4.4，从这儿下载http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91%20.

5.安装

二，新建仓库
    仓库是存放你的源代码文件等等的集散地。

1.在任意地方新建一个文件夹。譬如: d:"Repo.

2.右击这个文件夹，选择TortoiseSVN->Create repository here …

3.创建仓库结束 


三，架设Svnserver服务器
    Svnserver是Subversion自带的一个轻量级的服务器。
    1. 启动Svnserver服务

1.Windows桌面，点击开始

2.运行，键入cmd(打开一个dos窗口)

3.键入svnserve.exe –daemon –root drive:"path"to"repository

4.启动了一个svn服务器。

5.这样你就可以从任何地方访问你的repository了,譬如svn co svn://192.168.0.1/test/trunk或者svn co svn://localhost/test/trunk

    2. 让Svnserver随Windows自动启动

1.sc create svnserve binpath= “C:"Program Files"Subversion"bin"svnserve.exe –service –root drive:"path"to"repository” displayname= “Subversion” depend= tcpip start= auto   将C:"Program Files"Subversion"改为Subversion安装文件夹，将drive:"path"to"repository改为Repository所在文件夹。如果命令写错了，先sc delete svnserve，然后再写命令，否则会因为有相同的服务名，而无法创建成功

    3. 控制Svnserver访问权限

1.让匿名访问可以读可以写：Repository所在位置下的conf目录，打开svnserve.conf,把[general]下的password-db = passwd前的注释去掉，注意要把空格也去掉。然后再在passwd文件里添加用户和用户名



芦苇 2007-10-09 08:54 发表评论
]]>JAVA程序员不可不注意的编码规范作者: 周建东 日期: 2007-09-30 14:05http://www.blogjava.net/i369/articles/151209.html芦苇芦苇Tue, 09 Oct 2007 00:43:00 GMThttp://www.blogjava.net/i369/articles/151209.htmlhttp://www.blogjava.net/i369/comments/151209.htmlhttp://www.blogjava.net/i369/articles/151209.html#Feedback0http://www.blogjava.net/i369/comments/commentRss/151209.htmlhttp://www.blogjava.net/i369/services/trackbacks/151209.html一、规范存在的意义

    应用编码规范对于软件本身和软件开发人员而言尤为重要，有以下几个原因：

    1、好的编码规范可以尽可能的减少一个软件的维护成本 , 并且几乎没有任何一个软件，在其整个生命周期中，均由最初的开发人员来维护；

    2、好的编码规范可以改善软件的可读性，可以让开发人员尽快而彻底地理解新的代码；

    3、好的编码规范可以最大限度的提高团队开发的合作效率；

    4、长期的规范性编码还可以让开发人员养成好的编码习惯，甚至锻炼出更加严谨的思维；

二、命名规范

    1、一般概念

        1、尽量使用完整的英文描述符

        2、采用适用于相关领域的术语

        3、采用大小写混合使名字可读

        4、尽量少用缩写，但如果用了，必须符合整个工程中的统一定义
       
        5、避免使用长的名字（小于 15 个字母为正常选择）

        6、避免使用类似的名字，或者仅仅是大小写不同的名字

        7、避免使用下划线（除静态常量等）

     2、标识符类型说明

        1、包（ Package ）的命名
            Package 的名字应该采用完整的英文描述符，都是由一个小写单词组成。并且包名的前缀总是一个顶级域名，
            通常是 com、edu、gov、mil、net、org 等；
            如： com.yjhmily.test

        2、类（ Class ）的命名
            类名应该是个一名词，采用大小写混合的方式，每个单词的首字母大写。尽量保证类名简洁而富于描述。
            使用完整单词，避免缩写词 ( 除非工程内有统一缩写规范或该缩写词被更广泛使用，像 URL ， HTML)
        如： FileDescription

        3、接口（ Interface ）的命名
            基本与 Class 的命名规范类似。在满足 Classd 命名规则的基础之上，保证开头第一个字母为 ”I”，
            便于与普通的 Class区别开。其实现类名称取接口名的第二个字母到最后，且满足类名的命名规范；
        如： IMenuEngine

        4、枚举（ Enum ）的命名
            基本与 Class 的命名规范类似。在满足 Classd 命名规则的基础之上，保证开头第一个字母为 ”E” ，
            便于与普通的 Class区别开。
        如： EUserRole

        5、异常（ Exception ）的命名
            异常（ Exception ） 通常采用字母 e 表示异常，对于自定义的异常类，其后缀必须为 Exception
        如： BusinessException

        6、方法（ Method ）的命名
            方法名是一个动词，采用大小写混合的方式，第一个单词的首字母小写，其后单词的首字母大写。
            方法名尽可能的描述出该方法的动作行为。返回类型为 Boolean 值的方法一般由“ is ”或“ has ”来开头
        如： getCurrentUser() 、 addUser() 、 hasAuthority()

        7、参数（ Param ）的命名
            第一个单词的首字母小写，其后单词的首字母大写。参数量名不允许以下划线或美元符号开头，
            虽然这在语法上是允许的。参数名应简短且富于描述。
        如： public UserContext getLoginUser(String loginName);
       
        8、常量字段 （ Constants ）的命名
            静态常量字段（ static final ） 全部采用大写字母，单词之间用下划线分隔；
        如： public static final Long FEEDBACK;
        public static Long USER_STATUS;

 三、注释规范

        一个很好的可遵循的有关注释的经验法则是：

            问问你自己，你如果从未见过这段代码，要在合理的时间内有效地明白这段代码，你需要一些什么信息？？？

        1、一般概念

            1、注释应该增加代码的清晰度

            2、保持注释的简洁

            3、在写代码之前或同时写注释

            4、注释出为什么做了一些事，而不仅仅是做了什么

        2、注释哪些部分

            1、Java 文件：必须写明版权信息以及该文件的创建时间和作者；

            2、类：类的目的、即类所完成的功能，以及该类创建的时间和作者名称；多人一次编辑或修改同一个类时，
                应在作者名称处出现多人的名称；

            3、接口： 在满足类注释的基础之上，接口注释应该包含设置接口的目的、它应如何被使用以及如何不被使用。
                在接口注释清楚的前提下对应的实现类可以不加注释；

            4、方法注释： 对于设置 (Set 方法 ) 与获取 (Get 方法 ) 成员的方法，在成员变量已有说明的情况下，
                可以不加注释；普通成员方法要求说明完成什么功能，参数含义是什么且返回值什么；另外方法的创建
                时间必须注释清楚，为将来的维护和阅读提供宝贵线索；

            5、方法内部注释： 控制结构，代码做了些什么以及为什么这样做，处理顺序等，特别是复杂的逻辑处理部分，
                要尽可能的给出详细的注释；

            6、参数： 参数含义、及其它任何约束或前提条件；

            7、属性： 字段描述；

            8、局部 ( 中间 ) 变量： 无特别意义的情况下不加注释；

        3、注释格式

            遵循工程规定的统一注释格式，一般情况下会以 codetemplates.xml 格式的文件导入 IDE(Eclipse)
            或者用Eclipse默认的；

四、代码格式规范

            遵循工程规定的统一代码格式，一般情况下直接使用 IDE(Eclipse) 自带的默认代码格式对代码进行格式化；

五、其他规范

       JSP 文件命名
            采用完整的英文描述说明 JSP 所完成的功能，尽可能包括一个生动的动词，第一个字母小写，
        如： viewMessage.jsp 、editUser.jsp 等。

六、工程特有命名规范

        1、持久层

            1、 Hibernate 映射文件及实体
                与数据库表名称完全对应；
                如： Advertisement.hbm.xml 、 Advertisement.java

            2、数据访问 DAO
                DAO 接口和实现类名称必须完全符合正常接口和实现类的命名规则，且最后以 ”DAO” 结尾
                DAO 内的数据访问方法必须足够抽象的描述出对数据库的基本 CRUD 操作；
                如： ICrossAdDAO( 接口 ) 、 CrossAdDAO( 实现类 )
           
            3、各种操作数据库的 HQL 配置文件
                HQL 文件的个数原则上与系统的 Services 层的服务个数相等，且以服务名称命名 HQL 文件；
                如： resource.hbm.xml

       2、服务层

            1、服务接口和实现
                服务接口和实现类必须完全符合正常接口和实现类的命名规则；以工程定义的服务名为主体，
                并统一以 ”Serv” 结尾
                如： IResourceServ( 服务接口 ) 、 ResourceServ( 接口实现类 )

            2、服务接口方法
                方法名是一个动词，采用大小写混合的方式，第一个单词的首字母小写，其后单词的首字母大写。
           方法名尽可能的描述出该方法的动作行为。
                返回类型为 Boolean 值：用“ is ”或“ has ”来开头
                得到某数据： get+ 数据描述名词复数 + 数据类型；
                得到所有数据： get+All+ 数据描述名词复数 + 数据类型；
                通过 XXX 得到 / 查询某数据： get/query+ 数据描述名词复数 + 数据类型 +By+ 条件；
                添加某数据： save/add+ 数据描述名词 ()
                更新某数据： save/update+ 数据描述名词；
                删除某数据： delete/remove+ 数据描述名词；

            3、业务对象
                业务名称 +BO

            4、查询参数对象
                凡是继承 Abst***QuerySpec 的查询参数类全部满足以下规则：
                Query+ 所要查询的数据描述名词 +Spec
                作为参数传入时，参数名必须为：所要查询的数据描述名词 +Spec
                如： QueryProgramSpec

       3、MVC 层           

            1、Action 控制层
                Action 类名：功能模块名称 +Action ；
                Actoin 方法名称尽可能的描述出页面迁移的去向
                如： LoginAction( 登录用 action) ， toWelcome( 转向欢迎页的 action 方法 )

            2、资源文件
                系统全局资源文件： globalMessages_+ 字符编码类型 +.properties
                功能模块内部的资源文件： package.properties

        4、Spring 配置文件

            1、Action 相关配置文件
                文件目录： WebRoot/WEB-INF/spring/action/ 功能模块名称 +_ApplicationContext.xml

            2、Services 相关配置文件
                文件目录： WebRoot/WEB-INF/spring/services/Services_ApplicationContext.xml

            3、全局性配置文件
                文件目录： WebRoot/WEB-INF/spring/工程名+_ApplicationContext.xml

       5、JSP 文件
            采用完整的英文描述说明 JSP 所完成的功能，尽可能包括一个生动的动词，第一个字母小写，
            如： viewMessage.jsp 、editUser.jsp 等。
引用通告地址: http://tmsoft.lsxy.com/trackback.php?tbID=462&extra=f85ca6


芦苇 2007-10-09 08:43 发表评论
]]>GB2312汉字笔画解析http://www.blogjava.net/i369/articles/151208.html芦苇芦苇Tue, 09