Classpath是一个参数,它的值可以通过命令行指定,或者通过环境变量来指定。Classpath这个参数的值,被Java虚拟机或者Java编译器所使用,它告诉Java虚拟机机,Java编译器,去哪里寻找用户定义的类和包。
Overview and architecture
与传统的动态载入行为类似,当执行一个Java程序的时候,Java虚拟机会寻找和载入类(但是,只有当这个类被用到的时候,Java虚拟机才会载入它。Classpath这个值,告诉Java虚拟机或者编译器,在文件系统中,哪些文件是定义了要用到的类的。
Java虚拟机按照下述流程来寻找和载入类:
-
系统导入类:这些类对Java平台是起基础性作用的,它们由以下类组成:Java类库的公共类部分;为Java类库服务的私有类。
-
扩展类:存在于JRE或者JDK扩展目录下的包,如jre/lib/ext/。
-
用户定义的包和类库
在默认情况下,只有JDK的标准API包和扩展包,是不用额外设定变量的,Java虚拟机或者Java编译器知道怎样找到它们。所有用户自定义的包或者类库,它们的存放路径,必须通过命令行来指定或者通过相关的Manifest文件来设定(每一个Manifest文件与一个Jar文件相关联,Jar文件包含了用户自定义的包或者类库)。这样,在指定了自定义的包或者类库的存放路径之后,Java虚拟机或者Java编译器,就知道怎么去找到这些类或者包。
在执行Java程序的时候指定路径
基本用法
假设,我们拥有一个叫做org.mypackage的包,它包含以下内容:
- HelloWorld (main class)
- SupportClass
- UtilClass
然后,定义这些类的文件,存放在以下位置:D:myprogram(在Window系统下);/home/user/myprogram(在Linux系统下)。
文件的路径结构如下:
在这个例子中,当我们启用Java这个工具(用于载入某个java程序到虚拟机中去执行)的时候,我们指定要运行的java程序为org.mypackage.HelloWorld。当然,我们还要告诉Java这个工具,它去什么地方找我们自己定义的要载入Java虚拟机运行的包和类。所以,要启动运行这个程序,我们使用以下的命令:
Linux:
- java -classpath /home/user/myprogram org.mypackage.HelloWorld
- -classpath D:myprogram 这个参数,指定了程序中要用到的包所在的路径。(在Linux系统中,是这样表达, -classpath /home/user/myprogram)
- org.mypackage.HelloWorld 这是主类的名称
添加一个目录下的所有JAR文件
在Java 6和更高版本的Java中,我们可以将一个指定目录下的所有JAR文件添加进来,设定一个包含通配符的路径值,将该路径值赋值给classpath.
Windows系统下运行的例子:
- java -classpath ".;c:mylib*" MyApp
在Linux系统下运行的例子:
- java -classpath '.:/mylib/*' MyApp
通过环境变量来设定路径值
环境变量CLASSPATH,可以替代classpath的功能,用CLASSPATH来存放要载入的类的定义文件的路径值。上面的例子,我们可以用下面的内容来代替(在Windows系统中):
有时候,您还要查一下JAVA_HOME的值,该值,表示正在使用的JDK的存放路径。
- set CLASSPATH=D:myprogram
java org.mypackage.HelloWorld
设置Jar文件的存放路径
现在,假设,我们要运行的程序,使用了一个辅助的类库,该类库包含在一个Jar文件中,该Jar文件存放在D:myprogramlib.
现在文件存放结构是:
基于上面的文件结构,那么,我们就要使用以下的命令:
在Manifest文件中设定路径
假设我们的程序的源代码包含在一个名为helloWorld.jar的jar文件中,并且该文件存放在D:myprogram目录下。于是,我们拥有下面的文件系统结构:
helloWorld.jar文件中的Manifest文件,是这样定义的:
- Main-Class: org.mypackage.HelloWorld
- Class-Path: lib/supportLib.jar
注意:manifest文件以换行符结束或者以return键结束。
然后,要注意在这个例子中,描述supportLib.jar的存放路径,是相对路径,是相对于helloWorld.jar文件的存放路径,用的并不是绝对路径(在命令行中,-classpath的值,就要用到绝对路径)。只要上述二者的相对位置结构保持不变,那么,jar文件的实际存放位置和它需要的类库的实际存放位置是不相关的。
要运行jar文件中的程序,我们可以使用下面的命令:
- java -jar D:myprogramhelloWorld.jar
不需要再在命令行中指定Classpath的值,因为,它的值已经在manifest文件中定义了。
注意:没有必要在载入程序(java)处定义主类,因为在manifest文件中,必须要有具有以下形式的一行:
- Main-Class: classname
要获取更多关于jar选项的信息,可以查看 JavaDoc.
在manifest文件中设定多个JAR文件的存放路径,用空格将每个路径区别开:
- Class-Path: lib/supportLib.jar lib/supportLib2.jar