pom文件中${project.basedir}的使用

当我们在使用Maven构建Java项目时，经常会用到pom.xml文件来配置依赖，打包方式等信息。在pom.xml中，经常会用到${project.basedir}这个变量，那么这个变量如何使用呢？

1. ${project.basedir}的作用

${project.basedir}是Maven中的一种预定义属性，它代表的是项目的根目录。在pom.xml中，我们可以将它用于路径等信息的配置中。比如：

<build>
  <plugins>
    <plugin>
      <groupId>com.xxx</groupId>
      <artifactId>xxx-maven-plugin</artifactId>
      <version>1.0.0</version>
      <executions>
        <execution>
          <phase>package</phase>
          <goals>
            <goal>xxx</goal>
          </goals>
          <configuration>
            <outputDirectory>${project.basedir}/target/output</outputDirectory>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

在这个示例中，我们使用了${project.basedir}变量来指定插件的输出目录，这样就可以将插件生成的文件输出到项目根目录下的target/output目录。

2. ${project.basedir}的使用示例

下面再来看两个实际的应用场景，包括资源文件路径的配置和测试资源文件的使用。

2.1. 资源文件路径的配置

在Maven项目中，通常会将项目所需的配置文件和静态资源文件（比如图片、CSS等）放到src/main/resources目录下。如果我们需要将这些资源文件复制到输出目录下以便使用，可以用${project.basedir}来指定输出目录。

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-resources-plugin</artifactId>
      <version>3.0.2</version>
      <executions>
        <execution>
          <id>copy-resources</id>
          <phase>process-resources</phase>
          <goals>
            <goal>copy-resources</goal>
          </goals>
          <configuration>
            <outputDirectory>${project.basedir}/target/classes</outputDirectory>
            <resources>
              <resource>
                <directory>src/main/resources</directory>
                <includes>
                  <include>**/*.xml</include>
                  <include>**/*.properties</include>
                </includes>
              </resource>
              <resource>
                <directory>${project.basedir}/src/main/webapp</directory>
                <includes>
                  <include>**/*.css</include>
                  <include>**/*.js</include>
                  <include>**/*.png</include>
                  <include>**/*.jpg</include>
                </includes>
              </resource>
            </resources>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

在这个示例中，我们使用maven-resources-plugin插件来复制src/main/resources目录下的.xml和.properties文件，以及src/main/webapp目录下的.css、.js、.png、.jpg等文件到target/classes目录下。这里用到了${project.basedir}变量来指定输出目录，这样无论项目存放在哪个目录下，插件都能正确地将资源文件复制到目标目录下。

2.2. 测试资源文件的使用

在Maven项目中，我们可以将测试相关的代码和资源文件放到src/test/java和src/test/resources目录下。对于测试资源文件的使用，我们同样可以用${project.basedir}来指定资源文件的路径。

@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(classes = MainApplication.class)
@WebAppConfiguration
public class SomeTests {
    @Autowired
    private WebApplicationContext wac;

    @Test
    public void testSomething() throws Exception {
        MockMvc mockMvc = MockMvcBuilders.webAppContextSetup(wac).build();
        byte[] contents = Files.readAllBytes(
            Paths.get("${project.basedir}/src/test/resources/testfile.txt"));
        mockMvc.perform(MockMvcRequestBuilders.get("/doSomething"))
            .andExpect(MockMvcResultMatchers.content().bytes(contents));
    }
}

在这个示例中，我们用到了${project.basedir}变量来指定资源文件的路径，这样就可以在测试用例中读取src/test/resources目录下的testfile.txt文件。