关于开发环境搭建的建议
作者:谎言诞行    发布时间:2024年11月03日

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 的根目录。具体文件夹结构如下图:

image.png

具体解析如下:

  • (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/ 这个网站查找。简单介绍如下:

QQ20250103-110639.png

QQ20250103-110757.png

QQ20250103-110935.png


本文完结。

填写一种颜色的字符(不区分大小写),1分钟有效,点击图片刷新