用最真诚的态度，和你分享生活

发布新日志

  • Tomcat

    2008-12-25 11:47:21

    在Tomcat安装目录下的bin子目录中，有一些批处理文件（以.bat作为后缀名的文件），其中的startup.bat就是启动Tomcat的脚本文件，用鼠标双击这个文件，你将看到一个窗口一闪而过，之后就什么也没有了，这说明Tomcat的启动出错了。

    单击Windows的【开始】菜单，选择【所有程序】→【附件】→【命令提示符】，打开“命令提示符”窗口，进入Tomcat的bin目录中，在“命令提示符”窗口中输入startup，你将看到如图1-9所示的画面。

     
    （点击查看大图）图1-9  运行Tomcat提示出错信息

    笔者以前碰到过很多学员，在初次运行Tomcat时，看到如图1-9所示的信息就不知所措了。有的学员以前还配置过Tomcat，但是再次使用的时候，由于忘记了上次是如何配置的，同样感觉无从下手。

    我们在学习软件开发时，一定要养成查看错误提示信息，进而根据错误提示解决问题的良好习惯。笔者第一次配置Tomcat时，就是根据错误提示信息一步一步配置成功的。当看到错误信息时，首先不要慌张和无所适从，要仔细看清楚错误提示，弄明白错误的原因。

    图1-9中的错误提示信息，已经很明确地告诉你了错误的原因。我们看图1-9中的错误信息，如下所示：

    Neither the JAVA_HOME nor the JRE_HOME environment variable is defined
    At least one of these environment variable is needed to run this program

    这个错误信息是告诉你要配置JAVA_HOME或者JRE_HOME环境变量，以便Tomcat能够找到JDK或JRE的安装目录。从环境变量的名字，我们可以猜测到JAVA_HOME是配置JDK的安装目录，JRE_HOME是配置JRE的安装目录。

    由于Tomcat 6.x不再需要JDK的支持，所以才新增了JRE_HOME环境变量，对于6.0之前的Tomcat版本，没有JRE_HOME环境变量，只能配置JAVA_HOME环境变量。

    下面，我们在Windows XP Service Pack 2操作系统下设置JAVA_HOME环境变量，步骤如下。

    ① 右键单击“我的电脑”，选择【属性】，出现如图1-10所示的画面。

    ② 单击“高级”选项卡，选择“环境变量(N)”，如图1-11和图1-12所示。

    ③ 在“系统变量”下方单击“新建”按钮。在“变量名”中输入“JAVA_HOME”，在变量值中输入JDK所在的目录“D:\Java\jdk1.6.0_05”（读者可以根据自己机器上JDK的安装目录来修改这个值），然后单击“确定”按钮，如图1-13所示。


     
    （点击查看大图）图1-10 “我的电脑”属性

     
    （点击查看大图）图1-11 “高级”选项卡

    ④ 最后在“环境变量”对话框上单击“确定”按钮，结束JAVA_HOME环境变量的设置。

    我们再一次转到Tomcat的bin目录下，用鼠标双击startup.bat文件，可以看到如图1-14所示的启动信息。

    注意图1-14中圆角矩形框中的文本，可以看到启动的是Tomcat 6.0.16。

     
    （点击查看大图）图1-12 “环境变量”对话框

     
    图1-13  新建JAVA_HOME系统变量

     
    （点击查看大图）图1-14  Tomcat启动信息

    然后，打开浏览器，在地址栏中输入http://localhost:8080/（localhost表示本地机器，8080是Tomcat默认监听的端口号），将出现如图1-15所示的Tomcat页面。

     
    （点击查看大图）图1-15  Tomcat的默认主页

    注意图1-15中鼠标（小手形状）指向的链接——“Tomcat Documentation”，单击这个链接将进入Tomcat的文档页面，有关Tomcat的帮助信息可以在文档页面中找到；读者也可以直接访问Tomcat的文档，文档首页的位置是Tomcat安装目录下的webapps\docs\index.html。如果要关闭Tomcat服务器，可以用鼠标双击Tomcat bin目录下的shutdown.bat文件。

    查看(567) 评论(0) 收藏 分享 管理

  • Java 程序编码命名规范

    2008-12-17 20:06:25

    Java 程序编码命名规范

    命名规范
    定义这个规范的目的是让项目中所有的文档都看起来像一个人写的，增加可读性，减少项目组中因为换人而带来的损失。（这些规范并不是一定要绝对遵守，但是一定要让程序有良好的可读性）


    Package 的命名
    Package 的名字应该都是由一个小写单词组成。
    Class 的命名
    Class 的名字必须由大写字母开头而其他字母都小写的单词组成
    Class 变量的命名
    变量的名字必须用一个小写字母开头。后面的单词用大写字母开头。
    Static Final 变量的命名
    Static Final 变量的名字应该都大写，并且指出完整含义。
    参数的命名
    参数的名字必须和变量的命名规范一致。
    数组的命名
    数组应该总是用下面的方式来命名：

    byte[] buffer;


    而不是：

    byte buffer[];



    方法的参数
    使用有意义的参数命名，如果可能的话，使用和要赋值的字段一样的名字：

    SetCounter(int size){
    this.size = size;
    }




    Java 文件样式
    所有的 Java(*.java) 文件都必须遵守如下的样式规则


    版权信息
    版权信息必须在 java 文件的开头，比如：

    /**
    * Copyright ® 2000 Shanghai XXX Co. Ltd.
    * All right reserved.
    */


    其他不需要出现在 javadoc 的信息也可以包含在这里。


    Package/Imports
    package 行要在 import 行之前，import 中标准的包名要在本地的包名之前，而且按照字母顺序排列。如果 import 行中包含了同一个包中的不同子目录，则应该用 * 来处理。

    package hotlava.net.stats;

    import java.io.*;
    import java.util.Observable;
    import hotlava.util.Application;


    这里 java.io.* 使用来代替InputStream and OutputStream 的。


    Class
    接下来的是类的注释，一般是用来解释类的。

    /**
    * A class representing a set of packet and byte counters
    * It is observable to allow it to be watched, but only
    * reports changes when the current set is complete
    */


    接下来是类定义，包含了在不同的行的 extends 和 implements

    public class CounterSet
    extends Observable
    implements Cloneable



    Class Fields
    接下来是类的成员变量：

    /**
    * Packet counters
    */
    protected int[] packets;


    public 的成员变量必须生成文档（JavaDoc）。proceted、private和 package 定义的成员变量如果名字含义明确的话，可以没有注释。


    存取方法
    接下来是类变量的存取的方法。它只是简单的用来将类的变量赋值获取值的话，可以简单的写在一行上。

    /**
    * Get the counters
    * @return an array containing the statistical data. This array has been
    * freshly allocated and can be modified by the caller.
    */
    public int[] getPackets() { return copyArray(packets, offset); }
    public int[] getBytes() { return copyArray(bytes, offset); }

    public int[] getPackets() { return packets; }
    public void setPackets(int[] packets) { this.packets = packets; }
    其它的方法不要写在一行上


    构造函数
    接下来是构造函数，它应该用递增的方式写（比如：参数多的写在后面）。
    访问类型 ("public", "private" 等.) 和 任何 "static", "final" 或 "synchronized" 应该在一行中，并且方法和参数另写一行，这样可以使方法和参数更易读。

    public
    CounterSet(int size){
    this.size = size;
    }



    克隆方法
    如果这个类是可以被克隆的，那么下一步就是 clone 方法：

    public
    Object clone() {
    try {
    CounterSet ōbj = (CounterSet)super.clone();
    obj.packets = (int[])packets.clone();
    obj.size = size;
    return obj;
    }catch(CloneNotSupportedException e) {
    throw new InternalError("Unexpected CloneNotSUpportedException: " + e.getMessage());
    }
    }



    类方法
    下面开始写类的方法：

    /**
    * Set the packet counters
    * (such as when restoring from a database)
    */
    protected final
    void setArray(int[] r1, int[] r2, int[] r3, int[] r4)
    throws IllegalArgumentException
    {
    //
    // Ensure the arrays are of equal size
    //
    if (r1.length != r2.length || r1.length != r3.length || r1.length != r4.length)
    throw new IllegalArgumentException("Arrays must be of the same size");
    System.arraycopy(r1, 0, r3, 0, r1.length);
    System.arraycopy(r2, 0, r4, 0, r1.length);
    }




    toString 方法
    无论如何，每一个类都应该定义 toString 方法：

    public
    String toString() {
    String retval = "CounterSet: ";
    for (int i = 0; i < data.length(); i++) {
    retval += data.bytes.toString();
    retval += data.packets.toString();
    }
    return retval;
    }
    }



    main 方法
    如果main(String[]) 方法已经定义了, 那么它应该写在类的底部.

    代码编写格式


    代码样式
    代码应该用 unix 的格式，而不是 windows 的（比如：回车变成回车+换行）
    文档化
    必须用 javadoc 来为类生成文档。不仅因为它是标准，这也是被各种 java 编译器都认可的方法。使用 @author 标记是不被推荐的，因为代码不应该是被个人拥有的。
    缩进
    缩进应该是每行2个空格. 不要在源文件中保存Tab字符. 在使用不同的源代码管理工具时Tab字符将因为用户设置的不同而扩展为不同的宽度.
    如果你使用 UltrEdit 作为你的 Java 源代码编辑器的话，你可以通过如下操作来禁止保存Tab字符, 方法是通过 UltrEdit中先设定 Tab 使用的长度室2个空格，然后用 Format|Tabs to Spaces 菜单将 Tab 转换为空格。
    页宽
    页宽应该设置为80字符. 源代码一般不会超过这个宽度, 并导致无法完整显示, 但这一设置也可以灵活调整. 在任何情况下, 超长的语句应该在一个逗号或者一个操作符后折行. 一条语句折行后, 应该比原来的语句再缩进2个字符.
    {} 对
    {} 中的语句应该单独作为一行. 例如, 下面的第1行是错误的, 第2行是正确的:

    if (i>0) { i ++ }; // 错误, { 和 } 在同一行

    if (i>0) {
    i ++
    }; // 正确, { 单独作为一行


    } 语句永远单独作为一行.


    如果 } 语句应该缩进到与其相对应的 { 那一行相对齐的位置。
    括号
    左括号和后一个字符之间不应该出现空格, 同样, 右括号和前一个字符之间也不应该出现空格. 下面的例子说明括号和空格的错误及正确使用:

    CallProc( AParameter ); // 错误
    CallProc(AParameter); // 正确

    不要在语句中使用无意义的括号. 括号只应该为达到某种目的而出现在源代码中。下面的例子说明错误和正确的用法:

    if ((I) = 42) { // 错误 - 括号毫无意义
    if (I == 42) or (J == 42) then // 正确 - 的确需要括号


    程序编写规范


    exit()
    exit 除了在 main 中可以被调用外，其他的地方不应该调用。因为这样做不给任何代码代码机会来截获退出。一个类似后台服务地程序不应该因为某一个库模块决定了要退出就退出。
    异常
    申明的错误应该抛出一个RuntimeException或者派生的异常。
    顶层的main()函数应该截获所有的异常，并且打印（或者记录在日志中）在屏幕上。
    垃圾收集
    JAVA使用成熟的后台垃圾收集技术来代替引用计数。但是这样会导致一个问题：你必须在使用完对象的实例以后进行清场工作。比如一个prel的程序员可能这么写：

    ...
    {
    FileOutputStream fos = new FileOutputStream(projectFile);
    project.save(fos, "IDE Project File");
    }
    ...


    除非输出流一出作用域就关闭，非引用计数的程序语言，比如JAVA，是不能自动完成变量的清场工作的。必须象下面一样写：

    FileOutputStream fos = new FileOutputStream(projectFile);
    project.save(fos, "IDE Project File");
    fos.close();



    Clone
    下面是一种有用的方法：

    implements Cloneable

    public
    Object clone()
    {
    try {
    ThisClass ōbj = (ThisClass)super.clone();
    obj.field1 = (int[])field1.clone();
    obj.field2 = field2;
    return obj;
    } catch(CloneNotSupportedException e) {
    throw new InternalError("Unexpected CloneNotSUpportedException: " + e.getMessage());
    }
    }



    final 类
    绝对不要因为性能的原因将类定义为 final 的（除非程序的框架要求）
    如果一个类还没有准备好被继承，最好在类文档中注明，而不要将她定义为 final 的。这是因为没有人可以保证会不会由于什么原因需要继承她。
    访问类的成员变量
    大部分的类成员变量应该定义为 protected 的来防止继承类使用他们。
    注意，要用"int[] packets"，而不是"int packets[]"，后一种永远也不要用。

    public void setPackets(int[] packets) { this.packets = packets; }

    CounterSet(int size)
    {
    this.size = size;
    }




    编程技巧


    byte 数组转换到 characters
    为了将 byte 数组转换到 characters，你可以这么做：

    "Hello world!".getBytes();


    Utility 类
    Utility 类（仅仅提供方法的类）应该被申明为抽象的来防止被继承或被初始化。


    初始化
    下面的代码是一种很好的初始化数组的方法：

    objectArguments = new Object[] { arguments };


    枚举类型
    JAVA 对枚举的支持不好，但是下面的代码是一种很有用的模板：
    class Colour {
    public static final Colour BLACK = new Colour(0, 0, 0);
    public static final Colour RED = new Colour(0xFF, 0, 0);
    public static final Colour GREEN = new Colour(0, 0xFF, 0);
    public static final Colour BLUE = new Colour(0, 0, 0xFF);
    public static final Colour WHITE = new Colour(0xFF, 0xFF, 0xFF);
    }


    这种技术实现了RED, GREEN, BLUE 等可以象其他语言的枚举类型一样使用的常量。 他们可以用 '==' 操作符来比较。
    但是这样使用有一个缺陷：如果一个用户用这样的方法来创建颜色 BLACK

    new Colour(0,0,0)

    那么这就是另外一个对象，'=='操作符就会产生错误。她的 equal() 方法仍然有效。由于这个原因，这个技术的缺陷最好注明在文档中，或者只在自己的包中使用。

    Swing


    避免使用 AWT 组件
    混合使用 AWT 和 Swing 组件
    如果要将 AWT 组件和 Swing 组件混合起来使用的话，请小心使用。实际上，尽量不要将他们混合起来使用。


    滚动的 AWT 组件
    AWT 组件绝对不要用 JscrollPane 类来实现滚动。滚动 AWT 组件的时候一定要用 AWT ScrollPane 组件来实现。


    避免在 InternalFrame 组件中使用 AWT 组件
    尽量不要这么做，要不然会出现不可预料的后果。


    Z-Order 问题
    AWT 组件总是显示在 Swing 组件之上。当使用包含 AWT 组件的 POP-UP 菜单的时候要小心，尽量不要这样使用。



    调试


    调试在软件开发中是一个很重要的部分，存在软件生命周期的各个部分中。调试能够用配置开、关是最基本的。

    很常用的一种调试方法就是用一个 PrintStream 类成员，在没有定义调试流的时候就为 null，类要定义一个 debug 方法来设置调试用的流。



    性能


    在写代码的时候，从头至尾都应该考虑性能问题。这不是说时间都应该浪费在优化代码上，而是我们时刻应该提醒自己要注意代码的效率。比如：如果没有时间来实现一个高效的算法，那么我们应该在文档中记录下来，以便在以后有空的时候再来实现她。

    不是所有的人都同意在写代码的时候应该优化性能这个观点的，他们认为性能优化的问题应该在项目的后期再去考虑，也就是在程序的轮廓已经实现了以后。
    不必要的对象构造
    不要在循环中构造和释放对象


    使用 StringBuffer 对象
    在处理 String 的时候要尽量使用 StringBuffer 类，StringBuffer 类是构成 String 类的基础。String 类将 StringBuffer 类封装了起来，（以花费更多时间为代价）为开发人员提供了一个安全的接口。当我们在构造字符串的时候，我们应该用 StringBuffer 来实现大部分的工作，当工作完成后将 StringBuffer 对象再转换为需要的 String 对象。比如：如果有一个字符串必须不断地在其后添加许多字符来完成构造，那么我们应该使用 StringBuffer 对象和她的 append() 方法。如果我们用 String 对象代替 StringBuffer 对象的话，会花费许多不必要的创建和释放对象的 CPU 时间。

    避免太多的使用 synchronized 关键字
    避免不必要的使用关键字 synchronized，应该在必要的时候再使用她，这是一个避免死锁的好方法。

    可移植性
    Borland Jbulider 不喜欢 synchronized 这个关键字，如果你的断点设在这些关键字的作用域内的话，调试的时候你会发现的断点会到处乱跳，让你不知所措。除非必须，尽量不要使用。


    换行
    如果需要换行的话，尽量用 println 来代替在字符串中使用"\n"。
    你不要这样：

    System.out.print("Hello,world!\n");

    要这样：

    System.out.println("Hello,world!");

    或者你构造一个带换行符的字符串，至少要象这样：

    String newline = System.getProperty("line.separator");
    System.out.println("Hello world" + newline);


    PrintStream
    PrintStream 已经被不赞成（deprecated）使用，用 PrintWrite 来代替她。

    查看(397) 评论(0) 收藏 分享 管理

  • 从JDK下载到HELLOWORLD调试成功

    2008-12-17 19:00:46

    文章来自于java.com.cn：ZHANGTAOCN

    [编者注]

    你是否还只是一个程序设计初学者？并且早已被Java语言的魅力所吸引已经很久了？你是否强烈像走进Java的世界却感到无从下手？

    不像很多文章的作者，每当遇到这样的初学者遇到入门难的问题时，总是以一大堆入门书籍（这些书籍通常都是行业中的“圣经”）来把这些可怜的孩子们从刚进了一半的编程圣殿之门中重重砸出去……

    本文的作者另辟蹊径，从Java的开发工具包（JDK）的获取（下载）安装说起，一直讲到调试一个经典范例HelloWorld的撰写和调试，一步一步，不惜放弃“Java程序设计高手”的身份，亲自伸出自己仅用于写程序和吃饭的手，把一个初学者带入了Java程序设计的殿堂。

    不过，如果你真的是一个十足的初学者，并从本文中得到了很大帮助的话，请暂时不要沾沾自喜，还是要把“大虾”们推荐的大部头拿出来努力地啃上些日子。程序设计的殿堂是宏伟的，有很多房间，中间有一个宝座，Java不例外，每当你啃完一个大部头，并进行了大量的修炼（写程序），你就能走进下一个房间，这可能需要很多年，但不必害怕，无论你身处哪个房间，你都有你的价值。当你啃完所有的书你就走到了最后的房间，再过若干年的修炼，你最终坐上圣殿中的宝座。

    这很可怕么？不，你去问问“大师”，至今没有人坐上这个宝座，只不过有的人走到了比较靠前的屋子罢了。尽管努力吧！

    [正文]

    方法针对(WinXP/J2SDK1.4.1_03)

    步骤一：访问JDK环境下载网址 http://java.sun.com/j2se/1.4.1/download.html

    选择 Download J2SE v 1.4.1_03 下

    点击 Windows (all languages, including English) 行最右边的 DOWNLOAD．

    步骤二：接下来的页面里填写自己的简略资料，并点击 Yes,submit 按钮．

    步骤三：接下来的页面里点击 ACCEPT　按钮．

    步骤四：接下来的页面里点击 Download j2sdk-1_4_1_03-windows-i586.exe 链接便下载．

    步骤五：安装已下载的JDK (默认安装盘符为 C:\j2sdk1.4.1_03 )．

    注意：无需更改安装路径

    步骤六：现在开始具体配置环境

    右击＂我的电脑＂，选择＂属性＂，再选择＂高级＂，点击＂环境变量＂，注意到

    ＂系统变量＂，点击＂新建＂三次，每次创建一个系统变量 (注意大小写)．

    变量名 变量值
    path C:\j2sdk1.4.1_03\bin
    java_home C:\j2sdk1.4.1_03
    classpath C:\j2sdk1.4.1_03\lib\tools.jar;C:\j2sdk1.4.1_03\jre\lib\rt.jar;


    变量创建完后点击＂确定＂，直到＂属性＂窗口消失．

    步骤七：打开＂记事本＂，输入这段代码 (注意大小写)

    class HelloWorld
    {
        public static void main(String args[])
        {  
            System.out.println("Hello World");
        }
    }

    步骤八：以 HelloWorld.java 保存文件到 d:\java

    注意：保存地址可自由选择，文件名注意大小写．

    步骤九：进入＂开始＂－＂所有程序＂－＂附件＂－＂命令提示符＂

    直接键入 javac 回车，数秒后显示环境测试结果，出现大片英文字符即为正常．

    步骤十：更换盘符到 HelloWorld.java 文件所在目录 (D:\java>)．

    键入 javac HelloWorld.java 数秒后回到文件所在目录 (D:\java>) 编译成功．

    键入 java HelloWorld 数秒后显示将显示 Hello World

    步骤十请注意大小写！

    大功告成啦！我们的 Java 旅途要开始咯！


    查看(418) 评论(1) 收藏 分享 管理

我的栏目

数据统计

  • 访问量: 4328
  • 日志数: 8
  • 建立时间: 2008-06-27
  • 更新时间: 2008-12-25

RSS订阅

Open Toolbar