1、关于开发平台
在开发平台的选择上,本人并没有过多的考虑。基本上和之前的 Java 入门教程一样(Java 8 + eclipse + maven)。因为,本人一直都是用 eclipse 来开发 Java 代码。唯一不同的是,最近升级了新版本 eclipse 。其实,大家如果不喜欢 eclipse 问题也不大,反正,Java 语言是跨平台,不受环境限制的。所以,这里我把配置贴上来,大家参考下:
java 信息:
java version "1.8.0_271" Java(TM) SE Runtime Environment (build 1.8.0_271-b09) Java HotSpot(TM) 64-Bit Server VM (build 25.271-b09, mixed mode) |
eclipse 信息:
Eclipse IDE for Enterprise Java and Web Developers (includes Incubating components)
Version: 2023-12 (4.30.0) Build id: 20231201-2043 |
maven信息:
Apache Maven 3.8.5 (3599d3414f046de2324203b78ddcf9b5e4388aa0) Maven home: D:\dev-ide\apache-maven-3.8.5 Java version: 1.8.0_271, vendor: Oracle Corporation, runtime: D:\dev-ide\java8\jre Default locale: zh_CN, platform encoding: GBK OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows" |
注意:
在 eclipse 构建一个新的 java maven 项目时,可能遇到许多诡异的问题。建议多网上搜索下,查找答案。这里我举例2个我遇到的问题(这2个问题在2019版没有遇到,在2023版遇到,所以很诡异)。
问题1:在新建 source folder 时,不能创建 resources 文件夹。解决方法:右键点击项目->重新配置 build path,把红色的 resources 文件夹删了。然后就可以添加 resources 文件夹作为 source folder。
问题2:在 pom.xml 文件配置工具包的 maven 依赖后,本地仓库已经下载完成,依赖 jar 包在项目可见。但是,pom.xml 文件中关于工具包的依赖信息,提示红色报错。解决方法:关闭 pom.xml 文件,然后 右键项目,maven-> update project。更新一次就好了。
2、关于依赖关系
在我开发之初,这个工具包只是自己使用,所以并没有发布到网络上。现在,我已经把软件包发布到 Maven 中央仓库了。在发布时,本来只考虑使用 maven。但是发布之后,发现仓库提供了多个工具的链接。所以简单粘贴如下:
Maven:
<dependency> <groupId>io.github.pdcgithub</groupId> <artifactId>pdc-common-tool</artifactId> <version>1.1.0-jre8-RC</version> </dependency>
Gradle:
implementation group: 'io.github.pdcgithub', name: 'pdc-common-tool', version: '1.1.0-jre8-RC'
3、关于资源文件夹的配置
在使用我的工具包之前,大家需要先了解下资源文件的管理。在 Java 项目中,我们一般会创建一个资源文件夹(resources),它的类型是 source folder 。打包的时候,会将其中的文件放到 classpath 的根目录。具体文件夹结构如下图:

具体解析如下:
(1) conf 文件夹位于 resources 文件夹下的第一层。它是用于存放我自己工具包的配置用的(主要是避免配置文件和其他人的位置、名称冲突)。
(2) database-config 文件夹位于 conf 文件夹下属。用于存放数据库配置(数据库连接池使用)。
(3) email-config 文件夹位于 conf 文件夹下属。用于存放邮件服务器配置信息(邮件工具类使用)。
(4) 这个位置是位于 resources 文件夹下的第一层。用于存放其他人的插件配置文件(比如:logback.xml)
注意:
上面图中的配置文件都加了 demo 前缀。主要是避免框架自动识别,产生一些误会。因为,在实际使用中,我们是根据需要添加配置文件的。如果有默认配置,会产生误解。所以,我这些 demo 文件只是作为一个参考。
4、关于工具包源代码管理
在考虑开源的时候,我就打算把代码都放到 GitHub 上面。因为,它是目前全球最多人用的代码托管平台。虽然,国内上 GitHub 很慢,但是挂个梯子也是可以的。其实经过验证,Github 偶尔也是可以直接上去的。GitHub 仓库地址如下:
https://github.com/pdcGithub/pdc-common-tools
5、关于仓库的使用
有时候,找依赖信息比较麻烦(比如:想知道有几个版本)。我建议大家可以上 https://mvnrepository.com/ 这个网站查找。简单介绍如下:



本文完结。