eclipse项目中.classpath文件详解

落日映苍穹つ 2022-05-24 04:44 250阅读 0赞

# 1 前言 #

在使用eclipse或者myeclipse进行java项目开发的时候，每个project（工程）下面都会有一个.classpath文件，那么这个文件究竟有什么作用？

# 2 作用 #

.classpath文件用于记录项目编译环境的所有信息，包括：源文件路径、编译后class文件存放路径、依赖的jar包路径、运行的容器信息、依赖的外部project等信息。如果把该文件删除，则eclipse不能讲该工程识别为一个正常的java工程，仅仅当做普通的文件夹而导致不能正常运行。

# 3 .classpath内容 #

.classpath文件其实也是一个xml格式的内容文件，其具体内容大致如下：

<?xml version="1.0" encoding="UTF-8"?>
    <classpath>
        <classpathentry kind="src" path="src"/>
        <classpathentry kind="src" path="resource"/>
        <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/jdk1.7">
            <attributes>
                <attribute name="owner.project.facets" value="java"/>
            </attributes>
        </classpathentry>
        <classpathentry kind="con" path="org.eclipse.jst.server.core.container/org.eclipse.jst.server.tomcat.runtimeTarget/学习 8080">
            <attributes>
                <attribute name="owner.project.facets" value="jst.web"/>
            </attributes>
        </classpathentry>
        <classpathentry kind="con" path="org.eclipse.jst.j2ee.internal.web.container"/>
        <classpathentry kind="con" path="org.eclipse.jst.j2ee.internal.module.container"/>
        <classpathentry kind="output" path="WebContent/WEB-INF/classes"/>
    </classpath>

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8
 *  9
 *  10
 *  11
 *  12
 *  13
 *  14
 *  15
 *  16
 *  17
 *  18
 *  19

①以”classpath”为根节点，每个“classpathentry”节点代表一个说明信息。  
②每个“classpathentry”以“kind”属性指明类型，“path”指明路径。  
③以上文件的所有内容，都是依赖项目中的“Java Build Path”内容改变而改变的，即对“Java Build Path”的所有操作都会反应到文件内容中。  
![这里写图片描述][SouthEast]  
现在来具体分析文件内容的每个节点含义

## 3.1 `kind="src"` ##

src：即source 源文件，代表的是一个源文件，path=”src”是一个相对路径，相对.classpath文件本身，即path=”src”表示文件夹src与.classpath在同一个目录，且代表源文件。

*  1
 *  2

kind=”src”的操作对应于“Java Build Path”的“Source”tab页  
![这里写图片描述][SouthEast 1]  
如下图，增加一个文件夹bin作为源文件，则.classpath文件增加内容  
![这里写图片描述][SouthEast 2]  
内容增加如下：

*  1
 *  2
 *  3

当然，做相应修改或删除，同样.classpath文件内容会相应改变。  
另外，当指定属性combineaccessrules=”false”是则代表引入外部project，具体如下

*  1

对应页面tab，其中path=”/mybatis”，是相对应workspace下的  
绝对路径。  
![这里写图片描述][SouthEast 3]

## 3.2 `kind="output"` ##

output用于指定java源文件编译后的class文件存放路径，格式如下

*  1

path：代表存放class文件路径，同样是相对.classpath文件的路径，找到“WebContent/WEB-INF/classes”，可以看到class文件的存放  
![这里写图片描述][SouthEast 4]

假设修改输出文件路径，则相应内容也会改变  
改为：spring-mybatis\\WebContent\\WEB-INF\\newclasses  
![这里写图片描述][SouthEast 5]  
则.classpath文件内容修改为：

*  1

实际存放class文件的路径也会改变  
![这里写图片描述][SouthEast 6]

## 3.3 `kind="con"` ##

con即是container,就是程序运行的容器，或者就说是运行环境也OK，它实际上是在Myeclipse最初的时候要配置installed JREs中指定（一般情况下我们指定的是JDK），但是这里实际使用的是JDK下的JRE中的jar包，就是JDK\_HOME/jre/lib就是对应的这条语句。具体内容如下

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8
 *  9
 *  10
 *  11
 *  12

对应操作tab如下  
![这里写图片描述][SouthEast 7]

### 3.3.1 JRE配置 ###

path=”XXX”用于指定jre容器的使用情况，可选择jre的不同来源，不同来源path的实际值会有些变化  
![这里写图片描述][SouthEast 8]  
①选择”Workspace default JRE(jdk1.7)”,则值为

path="org.eclipse.jdt.launching.JRE_CONTAINER"

*  1

②选择“Alternate JRE”，则值为

path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/jdk1.7"

*  1

其中最后么的jdk1.7是我自定义的JRE名称  
③选择”Execution environment”，即选择eclipse自带的内置jre，值为

path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.7"

*  1

其中最后么的JavaSE-1.7是系统内置的JRE名称  
另外属性值name=”owner.project.facets”

*  1

应该是指定JRE容器的具体使用的模板，默认使用”java”，具体的没有探究。

### 3.3.2 Server Runtime配置 ###

同理，其他容器配置同上，如对Server Runtime 容器的配置，下面配置了tomcat容器运行环境

*  1

### 3.3.3 Web App Libraries配置 ###

*  1

### 3.3.4 User Library配置 ###

*  1

## 3.4 `kind="lib"` ##

`kind="lib"`用于指定project依赖的Referenced Libraries，如图增加了一个jar包  
![这里写图片描述][SouthEast 9]  
则相应.classpath文件内容增加

*  1

其中path指定了依赖的jar的相对路径。

## 3.5 顺序 ##

.classpath文件中各节点的顺序是通过tab-Order and Export 来控制的，不同的顺序可能会引起加载class文件问题，一般是源码放在最前面。  
![这里写图片描述][SouthEast 10]

[SouthEast]: /images/20220524/20fec3600021419d8f6d31795b3bd8d4.png
[SouthEast 1]: /images/20220524/81258fa100134fbf81791f89a2d610c0.png
[SouthEast 2]: /images/20220524/ad76a2b08c0e45599fa9c2cc21804599.png
[SouthEast 3]: /images/20220524/77ca419a7c084124b518b4fbfd30830d.png
[SouthEast 4]: /images/20220524/8fbad20c28274a369504227f29c15e06.png
[SouthEast 5]: /images/20220524/67876fd2b8f840faa770b4727f29f6b1.png
[SouthEast 6]: /images/20220524/780fb259453849bd9ce82f3ea6457f81.png
[SouthEast 7]: /images/20220524/d886f4247b414309bce22652558de07a.png
[SouthEast 8]: /images/20220524/27318b0eb5b74feaba099eceefb5e976.png
[SouthEast 9]: /images/20220524/9a05e00260e249aea68d2650e42e3c23.png
[SouthEast 10]: /images/20220524/336a7a793e35405f96d5aa8a83c4d8f7.png