躁！DJ 风格 Java 桌面音乐播放器

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

本文作者：HelloGitHub-秦人

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

项目源码地址：https://github.com/goxr3plus/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<ActionEvent>() {

            @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 版音乐播放器了。编程是不是也特别有意思呢？手痒痒了那就赶紧安装这款音乐播放器吧，对源码感兴趣的朋友可以开始学习项目源码了～

六、参考资料

• 官方文档
• 入门教程

关注公众号加入交流群