2005年09月01日

2005-09-01

Proverbs&Quotes

Learning is like rowing upstream not to advance is to drop back.

学如逆水行舟,不进则退。

,
,

2005-08-31

Proverbs&Quotes

The more a man learns,the more he sees his ignorance.

学然后知不足。

,
,

2005-09-01

感悟软件工程二十七

文档

程序文档是向读者解释程序做什么以及如何实现的书面描述。内部文档是直接在代码中的描述性材料,所有其他的文档都是外部文档。

内部文档包含的信息是用来指导别人阅读程序源代码的,它提供摘要信息定义程序,描述数据结构、算法和控制流。

1.头注释块。包括:组建叫什么;组件的作者;组件在整个系统设计中完成哪个部分的功能;组件是三狠么时候编写和修改的;为什么要有这个组件;组建如何使用数据结构、算法和控制

2.其他程序注释。即使结构清晰,书写良好的代码中,注释也占有很重要的地位。注释要能反映真实的代码行为,另外,确保通过注释,而不是用过使用显而易见的标示和变量名增加新的信息。

3.有意义的变量名和声明表示。字母语句标示应该告诉读者做标记的程序段时干什么的;数字标示按照习惯是用升序排列的,而且还根据相关的目的组织到一起。

4.增进理解的格式。声明的缩进和间隔能直观的体现基本的控制结构。

5.记录数据。无论是结构化编程还是面向对象编程,内部文档应该包括对数据结构和使用的描述,特别是数据流图和数据字典很直观。

外部文档是为了那些可能不接触实际代码的人,因为内部文档的阅读对象是定位在于编程人员,而像向顾客再让他们来阅读内部文档显得不切实际。外部文档主要有三个方面要注意:描述问题、描述算法和描述数据。从某种意义上说,设计是外部文档的骨,而叙述讨论代码组件的细节则是肉,至于是不是有血有肉就和编写代码没有关系了。



全文完

2005年08月31日

2005-08-31

Eclipse状态栏显示JVM内存使用情况的改进

昨天看了Robert的Post《在eclipse中显示jvm当前内存使用量》,照着攻略了一次,居然费了九牛二虎之力才把eclipse搞定,真是越来越丢人了。看来Java这玩意儿真是让俺水土不服,不掰闲话了,言归正传。

打开记事本,输入以下内容org.eclipse.ui/perf/showHeapStatus=true,然后保存于eclipse根目录下,文件名为options,没有文件扩展名。

Robert说的:

-debug options -vm javaw.exe这条命令启动eclipse。

俺用了没有成功,看来Eclipse的官方文档后,俺想到了这是jre的路径问题。因为估计没有像俺这样每个用jre的程序都是用一个单独的jre,而系统中没有jre。原因了嘛,不是俺YY,是有些程序和有些程序的插件要求的jre是特定的版本,没办法哦:(

在eclipse的目录下有个eclipse.ini的文件,按官方文档上的说明是对eclipse的参数启动可以在eclipse.ini文件中直接定义,这样-debug options -vm javaw.exe这条命令放到eclipse.ini中也应该是可以的。

俺最先就是直接粘贴过来,内容为-vmargs -Xms64m -Xmx256m -debug options -vm javaw.exe,提示没有找到JVM。想了又想,应该是-vm javaw.exe的原因,-vm javaw.exe应该为系统JVM的路径,而俺用的是eclipse\jre的JVM,正确的命令应该是-vm .\jre\bin\javaw.exe才对。

把文件eclipse.ini的内容改成了-debug options -vmargs -Xms64m -Xmx256m -vm javaw.exe,这次看见了ecplise的splash,自己还窃喜了一番,等了一分钟不到,没有看见传说中的状态栏会显示当前jvm内存使用量,看来还是出问题了。

原因可能出在俺在改动的时候把eclipse.ini的文件内容格式给改了,就是原来在-vmargs、-Xms64m、-Xmx256m后面都一个小黑块,改成-debug#options#-vm#javaw.exe#-vmargs#-Xms64m#-Xmx256m#字符要用原来的小黑块代替,启动的时候又开始报错了。

看了官方文档说

“将 -vmargs 条目后面的所有自变量(但不包括 -vmargs)作为虚拟机自变量(即,在要运行的类的前面)直接传递到所指示的 Java VM。注意:如果 Eclipse 启动在 Java vm 自变量(-vmargs)之后提供的自变量(例如,-data),则 Eclipse 将不会启动并且您将接收到"JVM 已终止。出口代码为 1"的错误。”

原来命令的顺序错了,现在改成-debug#options#-vm#javaw.exe#-vmargs#-Xms64m#-Xmx256m#字符要用原来的小黑块代替。eclipse启动成功,看见状态栏会显示当前jvm内存使用量。

截图如下:第一张为jre在Ecplise目录下的eclipse.ini的截图,第二张为采用系统JVM的截图,第三张为运行eclipse时候信息栏显示jvm状况的截图。

eclipse

eclipse

eclipse

特别是对eclipse.ini的修改一定要使用专业的Editor工具,不然就得自己相当注意其中的一些特殊的字符,修改之前做好备份更是必不可少的。

PS:

1.感写Eclipse和Robert。

2.所以操作在jre-1_5_0_04Eclipse3.1下测试成功。

3.参数 -vmargs -Xms64m -Xmx256m为俺自己设定的,eclipse默认的设定为 -vmargs -Xms40m -Xmx256m

, ,
, ,

全文完

2005年08月30日

2005-8-30

Proverbs&Quotes

Poverty is the common fate of scholars.

贫者士之常。

,
,

2005-8-29

Proverbs&Quotes

The love of money and the love of learning rarely meet.

爱慕金钱和热衷学问不可相容。

,
,

2005-8-28

Proverbs&Quotes

Better untaught than ill-taught.

宁可没有受教育,也不要被教坏了。

,
,

2005-8-27

Proverbs&Quotes

A little learning is a dangerous thing.

一知半解是危险的事情。

,
,

2005-8-26

Proverbs&Quotes

Much learning makes men mad.

学识越多越狂妄。

,
,

2005-8-25

Proverbs&Quotes

Learning in the breast of a bad man is as a sword in the hand of a madman.

坏蛋学问深好似狂人拿刀。

,
,