ValidatorFX 使用教程

ValidatorFX 使用教程

ValidatorFXA form validation library for JavaFX项目地址:https://gitcode.com/gh_mirrors/va/ValidatorFX

1. 项目的目录结构及介绍

ValidatorFX 是一个用于 JavaFX 的表单验证库。以下是其目录结构的详细介绍：

ValidatorFX/
├── github/workflows/
├── gradle/wrapper/
├── images/
├── src/
│   ├── main/
│   └── test/
├── .gitattributes
├── .gitignore
├── LICENSE
├── README.md
├── build.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
└── settings.gradle

• github/workflows/: 包含 GitHub Actions 的工作流配置文件。
• gradle/wrapper/: 包含 Gradle Wrapper 的文件，用于确保项目使用特定版本的 Gradle。
• images/: 包含项目文档中使用的图片。
• src/: 包含项目的源代码和测试代码。
  • main/: 主代码目录。
  • test/: 测试代码目录。
• .gitattributes: 用于定义 Git 属性。
• .gitignore: 用于指定 Git 忽略的文件和目录。
• LICENSE: 项目的许可证文件。
• README.md: 项目的说明文档。
• build.gradle: 项目的构建脚本。
• gradle.properties: Gradle 配置属性。
• gradlew: Gradle Wrapper 的 Unix 脚本。
• gradlew.bat: Gradle Wrapper 的 Windows 脚本。
• settings.gradle: 包含项目的设置信息。

2. 项目的启动文件介绍

ValidatorFX 的启动文件位于 src/main/java/net/synedra/validatorfx/demo/DemoApp.java。以下是该文件的简要介绍：

package net.synedra.validatorfx.demo;

import javafx.application.Application;
import javafx.geometry.Pos;
import javafx.scene.Scene;
import javafx.scene.control.TextField;
import javafx.scene.layout.GridPane;
import javafx.stage.Stage;
import net.synedra.validatorfx.Validator;

public class DemoApp extends Application {
    @Override
    public void start(Stage primaryStage) {
        TextField userTextField = new TextField();
        Validator validator = new Validator();
        validator.createCheck()
            .dependsOn("username", userTextField.textProperty())
            .withMethod(c -> {
                String userName = c.get("username");
                if (!userName.toLowerCase().equals(userName)) {
                    c.error("Please use only lowercase letters");
                }
            });

        GridPane grid = new GridPane();
        grid.setAlignment(Pos.CENTER);
        grid.add(userTextField, 0, 0);

        Scene scene = new Scene(grid, 300, 250);
        primaryStage.setScene(scene);
        primaryStage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

• DemoApp 类继承自 javafx.application.Application，是 JavaFX 应用程序的入口点。
• start 方法是应用程序的启动方法，负责初始化界面和启动应用。
• userTextField 是一个文本输入框，用于用户输入。
• validator 是 ValidatorFX 的验证器实例，用于创建和执行验证规则。
• grid 是一个布局容器，用于组织界面元素。
• scene 是 JavaFX 的场景对象，包含界面元素并显示在 primaryStage 上。

3. 项目的配置文件介绍

ValidatorFX 的配置文件主要包括 build.gradle 和 settings.gradle。以下是这两个文件的简要介绍：

build.gradle

build.gradle 是 Gradle 的构建脚本，定义了项目的依赖、任务和插件等。

plugins {
    id 'java'
    id 'application'
    id 'org.openjfx.javafxplugin' version '0.0.10'
}

group 'net.synedra'
version '0.5.1'

repositories {
    mavenCentral()
}

javafx {
    version = "17"
    modules = [ 'java

ValidatorFXA form validation library for JavaFX项目地址:https://gitcode.com/gh_mirrors/va/ValidatorFX