本文适合有 Java 基础知识的人群，跟着本文可学习和运行 Java 版桌面 DJ 音乐播放器。

本文作者：HelloGitHub-秦人

HelloGitHub 推出的《讲解开源项目》系列，今天给大家带来一款开源 Java 版桌面 DJ 音乐播放器项目——XR3Player，它强大的功能和炫酷的展示效果，你肯定会喜欢上它的！

一、项目介绍

OpenJFX 是一个开源的下一代客户端应用程序平台，适用于基于 Java 构建的桌面、移动和嵌入式系统。

本篇我们就重点讲一下一款 Java 版桌面 DJ 音乐播放器，先看运行效果吧！

也可以直接下载音乐播放器安装包：下载地址，更多 Java 桌面程序可以从这里获取：openjfx.io

二、运行项目

2.1 前提

安装 JDK11.2 或者更高版本，全称 Java Development Kit，它是 Java 的库函数，是编译、运行 Java 程序的工具包。

安装 Maven3 环境，进行项目构建和项目依赖包管理。

本地安装开发工具 IntelliJ IDEA。

本地安装 GitBash 工具，主要用于下载项目。

2.2 下载项目

下载项目到本地，使用 GitBash 工具，执行如下命令：

git clone https://github.com/goxr3plus/XR3Player.git

将项目导入 Idea，Maven 会自动下载所需的依赖。等待几分钟后项目依赖包都可以下载下来。使用 Idea 自带的 Maven 构建工具，就可以将项目轻松打包。如下图：

注意

项目有一个依赖 jxbrowser-win64 可能会下载失败，这个 jar 竟然有 40Mb，建议手动下载后导入项目依赖。jxbrowser-win64 下载地址

2.3 运行项目

创建入口类

打开 Run/Debug Configurations 创建一个 Application ，并选择入口类，如下图：

VM options 设置

VM options 添加下面配置参数,然后点击保存即可。

--add-exports

javafx.controls/com.sun.javafx.scene.control.behavior=com.jfoenix

--add-exports

javafx.controls/com.sun.javafx.scene.control=com.jfoenix

--add-exports

javafx.base/com.sun.javafx.binding=com.jfoenix

--add-exports

javafx.graphics/com.sun.javafx.stage=com.jfoenix

--add-exports

javafx.base/com.sun.javafx.event=com.jfoenix

--add-exports

javafx.graphics/com.sun.javafx.scene=org.controlsfx.controls,

--add-exports

javafx.graphics/com.sun.javafx.scene.traversal=org.controlsfx.controls

然后点击 Run Main 或 Debug Main 就可以本地运行项目了。如下图：

三、音乐播放器使用

项目运行起来长这样子，如下图：

1、需要创建一个用户，点击登录就可以进入音乐播放器管理页面。

2、进入音乐播放器，需要创建自己的音乐播放列表，并导入本地音乐。

3、导入本地音乐后可选择，选择需要播放的音乐，这里直接拖动你想播放的音乐。

4、DJ 版播放器可以同步播放两首歌曲，并可以分别控制音量和播放速度。

5、音乐播放器内嵌了浏览器，和在线音乐的功能。

6、其他的功能期待你的发掘，如果你也喜欢这款音乐播放器的话。

四、JavaFx 工作原理

JavaFX 的原理是这样的(如下图)：舞台(Stage)，场景(Scene)，容器(Container)，布局(Layout)和控件(Controls)之间的关系：

在 JavaFX 中，Stage 是应用程序窗口，其中包含称为 Scene 的空间。Scene 包含界面的组件，如 UI 空间(按钮，输入框，复选框)，容器等。

创建 JavaFx 项目

打开 Idea 开发工具，File -> New -> Project... -> Java Fx 创建项目，如下图：

Idea 会自动生成代码，这里我做了一些改动，代码如下：

public class Main extends Application {

@Override

public void start(Stage primaryStage) throws Exception{

primaryStage.setTitle("JavaFX 登录");

//创建网格面板

GridPane grid = new GridPane();

grid.setAlignment(Pos.CENTER);

grid.setHgap(10);

grid.setVgap(8);

grid.setPadding(new Insets(20, 20, 20, 20));

//设置背景色

Paint backgroundColor = new Color(0.32,0.6,0.32,1);

grid.setBackground(new Background(new BackgroundFill(backgroundColor,null,null)));

Text sceneTitle = new Text("欢迎进入系统");

sceneTitle.setFont(Font.font("Tahoma", FontWeight.NORMAL, 20));

grid.add(sceneTitle, 0, 0, 2, 1);

//创建用户名标签

Label userName = new Label("用户名:");

grid.add(userName, 0, 1);

//创建用户名输入框

TextField userTextField = new TextField();

grid.add(userTextField, 1, 1);

//创建密码标签

Label pwLabel = new Label("密码:");

grid.add(pwLabel, 0, 2);

//创建密码输入框

PasswordField passwordField = new PasswordField();

grid.add(passwordField, 1, 2);

//创建提交按钮

Button commitBtn = new Button("登录");

HBox hbBtn = new HBox(10);

hbBtn.setAlignment(Pos.BOTTOM_RIGHT);

hbBtn.getChildren().add(commitBtn);

grid.add(hbBtn, 1, 4);

final Text actionTarget = new Text();

grid.add(actionTarget, 1, 6);

commitBtn.setOnAction(new EventHandler() {

@Override

public void handle(ActionEvent e) {

actionTarget.setFill(Color.FIREBRICK);

actionTarget.setText("已发送请求到后台！");

}

});

Scene scene = new Scene(grid, 300, 275);

primaryStage.setScene(scene);

primaryStage.show();

}

public static void main(String[] args) {

launch(args);

}

}

代码运行效果如下图：

了解 Java Swing 的伙伴应该很熟悉，两者的原理很相似。上面代码的意思是：创建一个面板，然后在面板上添加标签，输入框和按钮，并对按钮添加绑定事件，然后把这个面板添加到场景中，这个窗口就完成了。

五、最后

Java 桌面 DJ 音乐播放器是真的香！不知道你对这款音乐播放器有什么感受，欢迎在评论区说说自己的想法。人们都喜欢美的好的事物，而今天的这个项目是通过 Java 代码撸出来的，难道你还不会不喜欢 Java 这门编程语言吗？ 有了成品的直观呈现，才能在视觉上产生更强的冲击，可能会更加能激发你的学习动力！ 如果通过我的内容分享，能让你对编程产生兴趣，我是真的开心。如果渐渐喜欢上开源项目，平时也喜欢 coding，并且愿意分享你的经验和成果，那就更完美了，编程使我快乐，内容分享让我们认识更多伙伴！

教程至此，你应该也能快速运行 DJ 版音乐播放器了。编程是不是也特别有意思呢？手痒痒了那就赶紧安装这款音乐播放器吧，对源码感兴趣的朋友可以开始学习项目源码了～

六、参考资料

关注公众号加入交流群