一、类路径 (class path)
“初学者写出第一个“hello world”,然后编译,运行。却不幸看到“Can't find class HelloWorld”或者“Exception in thread "main" java.lang.NoSuchMethodError: main。但是查找良久,却发现编译好的class明明在。”
java程序的运行过程:
java通过java虚拟机解释运行,.class文件就是虚拟机要执行的代码,称之为字节码(bytecode),虚拟机通过classloader来装载这些字节码,也就是通常意义上的类。classloader需要知道java本身的类库和用户的类在哪,要么是缺省值(当前路径) ,要么有一个类路径(classpath)来指定,或者在运行的时候传参数给虚拟机。这也就是指明classpath的三个方法。编译的过程和运行的过程大同小异,只是一个是找出来编译,另一个是找出来装载。实际上java虚拟机是由java luncher初始化的,也就是java (或java.exe) 这个程序来做的。虚拟机按以下顺序搜索并装载所有需要的类:
1、引导类:组成java平台的类,包含rt.jar和i18n.jar中的类。
2、扩展类:使用java扩展机制的类,都是位于扩展目录($JAVA_HOME/jre/lib/ext)
中的.jar档案包。
3、用户类:开发者定义的类或者没有使用java扩展机制的第三方产品。你必须在命令行中使用-classpath选项或者使用CLASSPATH环境变量来确定这些类的位置。
我们在上面所说的用户自己的类就是特指这些类。
这样,一般来说,用户只需指定用户类的位置,引导类和扩展类是“自动”寻找的。那么到底该怎么做呢?用户类路径就是一些包含类文件的目录,.jar, .zip文件的列表,至于类具体怎么找,因为牵扯到package的问题,下面将会说到,暂时可认为只要包含了这个类就算找到了这个类。根据平台的不同分隔符略有不同,类unix的系统基本上都是“:”,windows多是“;”。其可能的来源是:
* “. ”,即当前目录,这个是缺省值。
* CLASSPATH环境变量,一旦设置,将缺省值覆盖。
* 命令行参数-cp或者-classpath,一旦指定,将上两者覆盖。
* 由-jar参数指定的.jar档案包,就把所有其他的值覆盖,所有的类都来自这个指定的档案包中。由于生成可执行的.jar文件,还需要其他一些知识,比如package,还有特定的配置文件,本文的最后会提到。可先看看jdk自带的一些例子。
我们举个HelloWorld的例子来说明。先做以下假设:
* 当前目录是/HelloWorld(或c:\HelloWorld,以后都使用前一个)
* jdk版本为1.2.2 (linux下的)
* PATH环境变量设置正确。(这样可以在任何目录下都可以使用工具)
* 文件是HelloWorld.java,内容是:
publicclass HelloWorld
{
publicstaticvoid main(String[] args)
{
System.out.println("Hello World!\n ");
System.exit(0);
}
}
到现在为止,我们设置方面只设置了PATH。
1、当前路径就是指你的.class文件在当前目录下,
[HelloWorld]$ javac HelloWorld.java //这一步不会有多大问题,
[HelloWorld]$ java HelloWorld // 这一步可能就会有问题.。
如果出了象开头那样的问题,首先确定不是由于敲错命令而出错。如果没有敲错命令,那么接着做:
[HelloWorld]$ echo $CLASSPATH
或者 c:\HelloWorld> echo %CLASSPATH%
看看CLASSPATH环境变量是否设置了,如果设置了,那么用以下命令:
[HelloWorld]$ CLASSPATH=
或者 c:\HelloWorld> set CLASSPATH=
来使它为空,然后重新运行。这次用户类路径缺省的是". ",所以应该不会有相同的问题了。还有一个方法就是把". "加入到 CLASSPATH中。
[/]$ CLASSPATH=$CLASSPATH:.
或者 c:\HelloWorld> set CLASSPATH=%CLASSPATH%;
同样也可以成功. Good Luck。
2、当你的程序需要第三方的类库支持,而且比较常用,就可以采用此种方法。比如常用的数据库驱动程序,写servlet需要的servlet包等等。设置方法就是在环境变量中加入CLASSPATH。然后就可以直接编译运行了。还是以HelloWorld为例,比如你想在根目录中运行它,那么你直接在根目录下执行
$ java HelloWorld
或者 c:\> java HelloWorld
这样肯定会出错,如果你的CLASSPATH没有改动的话.。我想大家应该知道为什么错了吧,那么怎么改呢?前面说过,用户类路径就是一些包含你所需要的类的目录,.jar档案包,.zip包。现在没有生成包,所以只好把HelloWorld.class所在的目录加到CLASSPATH了,根据前面的做法,再运行一次,看看,呵呵,成功了,换个路径,又成功了!!不仅仅以直接运行其中的类,当你要import其中的某些类时,同样处理。
不知道你想到没有,随着你的系统的不断的扩充,(当然了,都是一些需要java的东西。如果都加到这个环境变量里,那这个变量会越来越臃肿,虽然环境变量空间可以开很大,总
觉得有些不舒服。看看下面一个方法。
3、在命令行参数中指明classpath。
还是和上面相同的目标,在任何目录下执行HelloWorld,用这个方法怎么实现呢?
[/]$ java -cp /HelloWorld HelloWorld
或者 c:\> java -cp c:\HelloWorld HelloWorld
就可以了。这是这种方法的最简单的应用了。当你使用了另外的包的时候,还可以采用用这种方法。例如:
$ javac -classpath aPath/aPackage.jar:. myJava.java
$ java -cp aPath/aPackage.jar:. myJava
或者 c:\> javac -classpath aPath\aPackage.jar;. myJava.java
c:\> java -cp aPath\aPackage.jar;. myJava
这种方法也有一个不方便的的地方就是当第三方包所在的路径较长或者需要两个以上包包的时候,每次编译运行都要写很长,非常不方便,这时候可以写脚本来解决。比如一个例子:
compile (文件,权限改为可执行,当前目录)
$ cat compile
---------------------------
#!/bin/bash
javac -classpath aPath\aPackage.jar:anotherPath\anotherPackage.jar:. myJavva.java
---------------------------
run (文件,权限改为可执行,当前目录)
$cat run
---------------------------
#!/bin/bash
java -cp aPath\aPackage.jar:anotherPath\anotherPackage.jar:. myJava
---------------------------
或者:
compile.bat
c:\HelloWorld> type compile.bat
-------------------------
javac -classpath aPath\aPackage.jar:anotherPath\anotherPackage.jar:. myJavva.java
-------------------------
run.bat
c:\HelloWorld> type run.bat
------------------------
java -cp aPath\aPackage.jar:anotherPath\anotherPackage.jar:. myJava
------------------------
就可以了。试试看。
前面提到了扩展类,扩展类是什么呢?java的扩展类就是应用程序开发者用来扩展核心平台功能的java类的包(或者是 native code)。虚拟机能像使用系统类一样使用这些扩展类。有人建议可以把包放入扩展目录里,这样,CLASSPATH也不用设了,也不用指定了,岂不是很方便?确实可以正确运行,但是个人认为这样不好,不能什么东西都往里搁,一些标准的扩展包可以,比如,JavaServlet,Java3D等等。可以提个建议,加一个环境变量,比如叫JARPATH,指定一个目录,专门存放用户的jar 、zip等包,这个要等SUN公司来做了。windows98下,我原来安装的时候,一直装不上,总是死机,好不容易装上了,缺省的是不能运行正确的,然后把 tool.jar 放入 CLASSPATH 后工作正常。现在作测试,去掉仍然是正确的。经过多次测试,发现如果原来曾装过jdk的都很好,没有装过的装的时候会死机,多装几次就可以了。如果你发现正确安装后,不能正常工作,就把tools.jar加入CLASSPATH,试一下。
二、包 (package)
Java中的“包”是一个比较重要的概念,package是这样定义的: Definition: A package is a collection of related classes and interfaces that provides access protection and namespace management。
也就是: 一个包就是一些提供访问保护和命名空间管理的相关类与接口的集合。使用包的目的就是使类容易查找使用,防止命名冲突,以及控制访问。这里我们不讨论关于包的过多的东西,只讨论和编译,运行,类路径相关的东西。至于包的其他内容,请自己查阅相关文档。简单一点来说,包就是一个目录,下面的子包就是子目录,这个包里的类就是这个目录下的文件。我们用一个例子来说明。
首先建目录结构如下: PackageTest/source/,以后根目录指的是PackageTest目录,我们的源程序放在source目录下。源程序如下:
PackageTest.java
package pktest;
import pktest.subpk.*;
public class PackageTest
{
private String value;
public PackageTest(String s)
{
value = s;
}
public void printValue()
{
System.out.println( "Value of PackageTest is " + value);
}
public static void main(String[] args)
{
PackageTest test = new PackageTest( "This is a Test Package ");
test.printValue();
PackageSecond second = new PackageSecond( "I am in PackageTest ");
second.printValue();
PackageSub sub = new PackageSub( "I am in PackageTest ");
sub.printValue();
System.exit(0);
}
}
PackageSecond.java
package pktest;
public class PackageSecond
{
private String value;
public PackageSecond(String s)
{
value = s;
}
public void printValue()
{
System.out.println( "Value of PackageSecond is " + value);
}
}
PackageSub.java
package pktest.subpk;
import pktest.*;
public class PackageSub
{
private String value;
public PackageSub(String s)
{
value = s;
}
public void printValue()
{
PackageSecond second = new PackageSecond( "I am in subpackage. ");
second.printValue();
System.out.println( "Value of PackageSub is " + value);
}
}
Main.java
import pktest.*;
import pktest.subpk.*;
public class Main()
{
public static void main()
{
PackageSecond second = new PackageSecond( "I am in Main ");
second.printValue();
PackageSub sub = new PackageSub( "I am in Main ");
sub.printValue();
System.exit(0);
}
}
其中,Main.java 是包之外的一个程序,用来测试包外的程序访问包内的类, PackageTest.java 属于 pktest 这个包,也是主程序. PackageSecond.java 也属于 pktest,PackageSub 属于 pktest 下的 subpk 包,也就是 pktest.subpk。详细使用情况,请参看源程序。
好了,先把源程序都放在 source 目录下,使 source 成为当前目录,然后编译一下,呵呵,出错了,
Main.java:1: Package pktest not found in import.
import pktest.*;
这里涉及到类路径中包是怎么查找的,前面我们做了一点假设: "只要包含了这个类就算找到了这个类 ",现在就有问题了。其实jdk的工具javac 、java 、javadoc都需要查找类,看见目录,就认为是包的名字,对于 import 语句来说,一个包对应一个目录。这个例子中,import pktest.*,我们知道类路径可以包含一个目录,那么就以那个目录为根,比如有个目录 /myclass,那么就会在查找/myclass/pktest 目录及其下的类. 所有的都找遍,如果没有就会报错。由于现在的类路径只有当前目录,而当前目录下没有 pktest 目录,所以就会出错。类路径还可以包含 .jar .zip文件,这些就是可以带目录的压缩包,可以把 .jar .zip文件看做一个虚拟的目录,然后就和目录一样对待了。
好了,应该知道怎么做了吧,修改后的目录结构如下:
PackageTest
|
|__source Main.java
|
|__pktest PackageTest.java PackageSecond.java
|
|__subpk PackageSub.java
然后重新编译,运行,哈哈,通过了。我们再来运行一下PackageTest。
[source]$ java pktest/PackageTest
怎么又出错了?
Exception in thread "main" java.lang.NoClassDefFoundError: pktest/PackageTest
是这样的,java所要运行的是一个类的名字,它可不管你的类在什么地方,就象我们前面所讨论的一样来查找这个类,所以它把pktest/PackageTest看成是一个类的名字了,当然会出错了,应该这么做,
[source]$ java pktest.PackageTest
大家应该明白道理吧,我就不多说了。注意javac不一样,是可以指明源文件路径的,javac只编译,不运行,查找类也只有在源文件中碰到import时才会做,与源文件所在的包没有关系。似乎还又些不好的地方,怎么生成的 .class 文件这么分散呀,看着真别扭。别急,javac有一个 -d 命令行参数,可以指定一个目录,把生成的 .class 文件按照包给你好好地搁在这个目录里面.
[source]$ mkdir classes
[source]$ javac -d classes pktest/PackageTest.java
[source]$ javac -d classes Main.java
那么运行怎么运行呢?
[source]$ cd classes
[classes]$ java pktest.PackageTest
[classes]$ java Main
就可以了。其实jdk的这一套工具小巧简单,功能强大,不会用或者用错其实不关工具的事,关键是明白工具背后的一些原理和必要的知识。集成环境是很好,但是它屏蔽了很多底层的知识,不出错还好,一旦出错,如果没有这些必要的知识就很难办,只好上bbs问,别人只告诉了你解决的具体方法,下一次遇到稍微变化一点的问题又不懂了。所以不要拘泥于工具,java 的这一套工具组合起来使用,中小型工程(五六十个类),还是应付得下来的。
三、jar文件
以下把.jar.zip都看做是.jar文件。
1、从前面我们可以看出来jar文件在java中非常重要,极大地方便了用户的使用。我们也可以做自己的.jar包。
2、还是使用前面那个例子,Main.java是包之外的东西,用了pktest包中的类,我们现在就是要把pktest做成一个.jar包,很简单,刚才我们已经把pktest中的.class都集中起来了,
[classes]$ jar -cvf mypackage.jar pktest
就会生成mypackage.jar文件,测试一下,刚才我们生成的Main.class就在classes目录下,所以,从前面可以知道:
[classes]$ java -cp mypackage.jar:. Main
就可以运行了。
3、如果你看过jdk所带的例子,你就会知道,.jar还可以直接运行,
[/demo]$ java -jar aJar.jar
那好,就那我们的试一试,
[classes]$ java -jar mypackage.jar
Failed to load Main-Class manifest attribute from mypackage.jar
看来我们的jar和它的jar还不一样,有什么不一样呢?拿它一个例子出来,重新编译,生成.jar文件,比较后发现,是.jar压缩包中META-INF/MANIFEST.MF文件不一样,多了一行,Main-Class: xxxxx,再看看出错信息,原来是没有指定Main-Class,看看jar命令,发现有一个参数-m,
-m include manifest information from specified manifest file
和出错信息有点关系,看来它要读一个配制文件. 只好照猫画虎写一个了。
[classes]$ cat myManifest
Manifest-Version: 1.0
Main-Class: pktest.PackageTest
Created-By: 1.2.2 (Sun Microsystems Inc.)
[classes]$ jar cvfm mypackage.jar myManifest pktest
added manifest
adding: pktest/(in = 0) (out= 0)(stored 0%)
adding: pktest/PackageSecond.class(in = 659) (out= 395)(deflated 40%)
adding: pktest/subpk/(in = 0) (out= 0)(stored 0%)
adding: pktest/subpk/PackageSub.class(in = 744) (out= 454)(deflated 38%)
adding: pktest/PackageTest.class(in = 1041) (out= 602)(deflated 42%)
[classes]$ java -jar mypackage.jar
Value of PackageTest is This is a Test Package
Value of PackageSecond is I am in PackageTest
Value of PackageSecond is I am in subpackage.
Value of PackageSub is I am in PackageTest
好了,成功了,这样就做好了一个可以直接执行的.jar文件。大家可以自己试一试
做一个以Main为主程序的可执行的jar。
小结:
这篇文章中,我们讨论了java中的classpath,package,jar等基本但比较重要的东西,主要是classpath 并不是简单的一份CLASSPATH的完全功略,而是试图让读者明白其原理,自己思考,自己动手。其实大多数东西都在sun的java doc 中都有,我只不过结合例子稍微谈了一下,希望能有所帮助。由于条件所限,只测试了 jdk1.2.2在98及linux的情况,其他版本的jdk和平台请大家自己测试,错误在所难免,还请指正。
下面是一些需要注意的问题:
1、如果类路径中需要用到.jar文件,必须把jar文件的文件名放入类路径,而不是其所在的目录。
2、在任何时候,类名必须带有完全的包名。
3、". " 当前目录最好在你的类路径中。
下面是一些常见的编译和运行的模式:
(1)To compile HelloWorld.java app in the default package in C:\MyDir,
use CD \MyDir C:\jdk1.3\bin\Javac.exe -classpath . HelloWorld.java
(2)To run a HelloWorld.class app,in the default package in C:\MyDir,
Use CD \MyDir C:\jdk1.3\bin\Java.exe -classpath . HelloWorld
(3)To run a HelloWorld.class app,in the default package in a jar in C:\MyDir,
use CD \MyDir C:\jdk1.3\bin\Java.exe -classpath HelloWorld.jar HelloWorld
(4)To compile a HelloWorld.java app in C:\MyPackage,in package MyPackage,
use CD \C:\jdk1.3\bin\Javac.exe -classpath . MyPackage\HelloWorld.java
(5)To run a HelloWorld.class app in C:\MyPackage,in package MyPackage,
use CD \C:\jdk1.3\bin\Java.exe -classpath . MyPackage.HelloWorld
(6)To run a HelloWorld.class app in C:\MyPackage,in a jar in package MyPackage,
use CD \MyDir C:\jdk1.3\bin\Java.exe -classpath HelloWorld.jar MyPackage.HelloWorld
(注: default package 指的是在程序中不指定任何包)。
最后一个小小的建议,把sun的jdk tools documentation好好地看一看,把jdk 的那些工具 java javac javadoc jar javap jdb......好好用一用,会有好处的。The Simplest Is The Best。
参考文献:
Java Tools Documentation.
Java Glossary http://mindprod.com