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