JavaFX实现自定义“表单验证工具类”，简化对控件TextField、PassWordField、TextArea添加验证时的代码

最新推荐文章于 2024-07-28 02:05:19 发布
最新推荐文章于 2024-07-28 02:05:19 发布
阅读量3.4k 收藏 10
点赞数 4
分类专栏： Java 文章标签： javafx 表单验证 软件开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/MrChung2016/article/details/72637014
版权
问题描述

使用JavaFX进行软件开发的过程中，TextField（子类PassWordField）、TextArea等文本输入控件的使用频率较高，而且一般情况下我们需要对其添加表单验证，这就涉及到两个问题：

  1. 验证时机问题，即什么时候添加验证的问题（可以是失去焦点、获取焦点或者是实时）；
  2. 验证类型问题，即确定是非空验证、格式验证两大验证类型；

虽然很容易就能实现以上功能，但是如果只是简单的对每个表单去编写验证代码，那么代码量在表单控件多的时候会显得很冗长、重复，最好的办法就是编写一个公用的表单验证工具类，这样可以简化代码，减少工作量。这篇文章就是介绍我自己写的JavaFX表单验证工具类，附带调用代码，是一个完整的DEMO。

下面进行介绍：

DEMO层级结构
  1. FormPageController.java是测试页面的控制器，里面主要是调用表单验证工具类的代码示例；
  2. FormValidate.java是表单验证工具类，本篇文章的核心；

  3. Main.java程序主类，FormPage.css、FormPage.fxml界面相关资源文件；

    　　　　　　　　　　　　　　　这里写图片描述

FormValidate.java
package Forms;

import java.util.regex.Pattern;

import javafx.collections.FXCollections;
import javafx.collections.ObservableList;
import javafx.scene.Node;
import javafx.scene.control.Label;
import javafx.scene.control.TextInputControl;
import javafx.scene.layout.Pane;

/**
 * 表单验证工具类
 * 
 * @author Administrator
 *
 */
public class FormValidate<T extends TextInputControl> {
    private T[] requireControls;// 非空验证目标控件
    private ObservableList<Label> reqLabels = FXCollections.observableArrayList();
    private ObservableList<Label> regLabels = FXCollections.observableArrayList();
    public static final String BIGDECIMAL_REG = "^[+-]?\\d+(\\.\\d+)?$"; // BigDecimal类型数据的正则表达式
    public static final String CHINAMOBILENO_REG = "^13\\d{9}$"; // 中国手机号码的正则表达式

    /**
     * 为表单添加非空验证
     * 
     * @param targetControls，目标表单数组
     * @param errorTexts，错误提示文字数组
     * @return，返回验证结果，只要出现一个表单为空，则返回为false
     */
    public void installrequireValidation(T[] targetControls, String[] errorTexts) {

        // 初始化非空验证目标控件数组
        requireControls = targetControls;

        for (int i = 0, tarCount = targetControls.length; i < tarCount; i++) {
            Label requireLabel = new Label();
            requireLabel.setVisible(false);
            requireLabel.setText(errorTexts[i]);
            requireLabel.getStyleClass().add("error-text");// 设置错误提示信息的样式
            FormValidate.setTextLocation(targetControls[i], requireLabel);
            reqLabels.add(requireLabel);

            // 表单获取焦点时进行验证
            int curIndex = i;
            targetControls[i].focusedProperty().addListener((obVal, oldVal, newVal) -> {
                if (newVal) {
                    if ("".equals(targetControls[curIndex].getText())) {
                        requireLabel.setVisible(true);
                    } else {
                        requireLabel.setVisible(false);
                    }
                }
            });
            // 键入文字时实时验证
            targetControls[i].textProperty().addListener((obVal, oldVal, newVal) -> {

                if ("".equals(newVal)) {
                    requireLabel.setVisible(true);
                } else {
                    requireLabel.setVisible(false);
                }
            });
        }
    }

    /**
     * 为表单添加正则验证
     * 
     * @param targetControls,目标表单数组
     * @param regType，正则验证类型
     * @param errorText，错误提示文字
     * @return，只要有一个表单未通过正则，则返回就为false
     */
    public void installRegularValidation(T[] targetControls, String regType, String[] errorTexts) {

        for (int i = 0, tarCount = targetControls.length; i < tarCount; i++) {
            Label regLabel = new Label();
            regLabel.setVisible(false);
            regLabel.setText(errorTexts[i]);
            regLabel.getStyleClass().add("error-text");// 设置错误提示信息的样式
            FormValidate.setTextLocation(targetControls[i], regLabel);
            regLabels.add(regLabel);

            int curIndex = i;
            targetControls[i].textProperty().addListener((obVal, oldVal, newVal) -> {

                // 表单为空时不进行正则验证
                if (!"".equals(newVal) && !Pattern.matches(regType, targetControls[curIndex].getText())) {
                    regLabel.setVisible(true);
                } else {
                    regLabel.setVisible(false);
                }
            });
        }
    }

    /**
     * 验证当前所有目标控件
     * 
     * @param targetControls,当前所有目标控件
     * @return
     */
    public boolean isvalid() {

        /* 触发初始非空验证 */
        for (int i = 0, reqCount = reqLabels.size(); i < reqCount; i++) {

            if (0 == requireControls[i].getLength()) {
                reqLabels.get(i).setVisible(true);
            } else {
                reqLabels.get(i).setVisible(false);
            }

        }

        /* 检验所有指定控件是否通过验证 */
        for (int i = 0, reqLabelSize = reqLabels.size(); i < reqLabelSize; i++) {
            if (reqLabels.get(i).isVisible()) {
                return false;
            }
        }
        for (int i = 0, regLabelSize = regLabels.size(); i < regLabelSize; i++) {
            if (regLabels.get(i).isVisible()) {
                return false;
            }
        }

        return true;
    }

    /**
     * 向页面添加Label
     * 
     * @param target，目标控件
     * @param errorLabel，错误信息Label
     */
    private static void setTextLocation(Node target, Label errorLabel) {
        Pane nodeContainer = (Pane) target.getParent();
        nodeContainer.getChildren().add(errorLabel);

        final double Y_OFFSET = 30.0;
        errorLabel.setLayoutX(target.getLayoutX());
        errorLabel.setLayoutY(target.getLayoutY() + Y_OFFSET);

    }
}
FormPageController.java
package Forms;

import java.net.URL;
import java.util.ResourceBundle;

import javafx.beans.property.BooleanProperty;
import javafx.beans.property.SimpleBooleanProperty;
import javafx.fxml.FXML;
import javafx.fxml.Initializable;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.control.PasswordField;
import javafx.scene.control.TextArea;
import javafx.scene.control.TextField;
import javafx.scene.layout.AnchorPane;

public class FormPageController implements Initializable {
    @FXML
    private AnchorPane rootPane;
    @FXML
    private TextField nameTF, genderTF, heightTF, phoneNumber1TF, phoneNumber2TF;
    @FXML
    private PasswordField passwordPF;
    @FXML
    private TextArea remarkTA;
    @FXML
    private Button signBtn;
    @FXML
    private Label logResult;

    @Override
    public void initialize(URL location, ResourceBundle resources) {
        // 取消输入框获取默认焦点
        final BooleanProperty firstTime = new SimpleBooleanProperty(true);
        remarkTA.focusedProperty().addListener((observable, oldValue, newValue) -> {
            if (newValue && firstTime.get()) {
                rootPane.requestFocus();
                firstTime.setValue(false);
            }
        });

        FormValidate<TextField> formDemo = new FormValidate<>();

        /** 非空验证 **/
        TextField[] requireTFs = { nameTF, genderTF, heightTF, passwordPF };
        String[] reqTexts = { "姓名栏不能为空", "性别栏不能为空", "身高栏不能为空", "密码栏不能为空" };
        formDemo.installrequireValidation(requireTFs, reqTexts);

        /** 数字验证 **/
        TextField[] heightTFs = { heightTF };
        String[] notHeightTexts = { "身高数据必须为数字" };
        formDemo.installRegularValidation(heightTFs, FormValidate.BIGDECIMAL_REG, notHeightTexts);

        /** 手机号验证 **/
        TextField[] mobileNoTFs = { phoneNumber1TF, phoneNumber2TF };
        String[] noFormErrTexts = { "手机号1格式错误", "手机号2格式错误" };
        formDemo.installRegularValidation(mobileNoTFs, FormValidate.CHINAMOBILENO_REG, noFormErrTexts);

        FormValidate<TextArea> formDemo1 = new FormValidate<>();
        /** 文本域非空验证 **/
        TextArea[] tTAs = { remarkTA };
        String[] reamrkErrTexts = { "备注信息不能为空" };
        formDemo1.installrequireValidation(tTAs, reamrkErrTexts);

        signBtn.setOnMouseClicked(me -> {

            if (formDemo.isvalid() && formDemo1.isvalid()) {
                logResult.getStyleClass().clear();
                logResult.setText("恭喜，验证通过！");
                logResult.getStyleClass().add("validTxt");
            } else {
                logResult.getStyleClass().clear();
                logResult.setText("错误，请重试！");
                logResult.getStyleClass().add("error-text");
            }
        });
    }

}
Main.java
/**
 * 实现表格的序号列的计算填充，
 * 实现按钮操作列的正常显示以及事件绑定
 */
package Forms;

import java.io.IOException;

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Scene;
import javafx.scene.layout.AnchorPane;
import javafx.stage.Stage;

public class Main extends Application {

    @Override
    public void start(Stage primaryStage) {
        try {
            FXMLLoader loader = new FXMLLoader();
            loader.setLocation(this.getClass().getResource("FormPage.fxml"));
            AnchorPane rootPane = loader.load();
            Scene scene = new Scene(rootPane,385,630);
            primaryStage.sizeToScene();
            primaryStage.setScene(scene);
            primaryStage.show();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        launch(args);
    }
}
FormPage.css
.optDiv{
    -fx-border-width:2.0px;
    -fx-border-color:rgb(192.0,192.0,192.0);
}
.validateLabel{
    -fx-font-size:23.0px;
    -fx-alignment:center;
    -fx-font-weight:bold;
    -fx-font-family:"Microsoft YaHei";
}
.form-title{
    -fx-font-size:13.0px;
    -fx-font-weight:bold;
    -fx-font-family:"Microsoft YaHei";
}
.signinBtn{
    -fx-text-fill:rgb(64,0,64);
    -fx-font-size:15.0px;
    -fx-font-weight:bold;
    -fx-font-family:"Microsoft YaHei";
}
.validTxt{
    -fx-font-size:12.0px;
    -fx-font-weight:bold;
    -fx-text-fill:green;
    -fx-font-family:"Microsoft YaHei";
}
.error-text,.emit-err-text{
    -fx-font-size:12.0px;
    -fx-font-weight:bold;
    -fx-text-fill:red;
    -fx-font-family:"Microsoft YaHei";
}
FormPage.fxml
<?xml version="1.0" encoding="UTF-8"?>

<?import javafx.scene.control.*?>
<?import java.lang.*?>
<?import javafx.scene.layout.*?>
<?import javafx.scene.layout.AnchorPane?>

<AnchorPane fx:id="rootPane" prefHeight="629.0" prefWidth="385.0" stylesheets="@FormPage.css" xmlns="http://javafx.com/javafx/8" xmlns:fx="http://javafx.com/fxml/1" fx:controller="Forms.FormPageController">
   <children>
      <Label prefHeight="41.0" prefWidth="385.0" styleClass="validateLabel" text="表单验证DEMO" />
      <AnchorPane layoutX="10.0" layoutY="49.0" prefHeight="523.0" prefWidth="366.0" styleClass="optDiv">
         <children>
            <Label layoutX="21.0" layoutY="28.0" styleClass="form-title" text="姓名：" />
            <Label layoutX="21.0" layoutY="78.0" styleClass="form-title" text="性别：" />
            <Label layoutX="21.0" layoutY="129.0" styleClass="form-title" text="身高：" />
            <TextArea fx:id="remarkTA" layoutX="21.0" layoutY="354.0" prefHeight="133.0" prefWidth="322.0" />
            <Label layoutX="21.0" layoutY="331.0" styleClass="form-title" text="备注信息：" />
            <TextField fx:id="heightTF" layoutX="102.0" layoutY="124.0" prefHeight="29.0" prefWidth="239.0" />
            <TextField fx:id="phoneNumber1TF" layoutX="102.0" layoutY="178.0" prefHeight="29.0" prefWidth="239.0" />
            <Label layoutX="22.0" layoutY="184.0" prefHeight="18.0" prefWidth="65.0" styleClass="form-title" text="手机号1：" />
            <TextField fx:id="nameTF" layoutX="102.0" layoutY="22.0" prefHeight="29.0" prefWidth="239.0" />
            <TextField fx:id="genderTF" layoutX="102.0" layoutY="72.0" prefHeight="29.0" prefWidth="239.0" />
            <Label layoutX="22.0" layoutY="237.0" prefHeight="18.0" prefWidth="65.0" styleClass="form-title" text="手机号2：" />
            <TextField fx:id="phoneNumber2TF" layoutX="102.0" layoutY="232.0" prefHeight="29.0" prefWidth="239.0" />
            <Label layoutX="22.0" layoutY="291.0" prefHeight="18.0" prefWidth="65.0" styleClass="form-title" text="密码：" />
            <PasswordField fx:id="passwordPF" layoutX="102.0" layoutY="285.0" prefHeight="29.0" prefWidth="239.0" />
         </children>
      </AnchorPane>
      <Button fx:id="signBtn" layoutX="11.0" layoutY="589.0" mnemonicParsing="false" prefHeight="35.0" prefWidth="366.0" styleClass="signinBtn" text="注                     册" />
      <Label fx:id="logResult" layoutX="11.0" layoutY="570.0" prefHeight="18.0" prefWidth="366.0" styleClass="invalidTxt" />
   </children>
</AnchorPane>
运行截图

　这里写图片描述　　　　　这里写图片描述
　这里写图片描述

M-Chung
关注
专栏目录
PC 端微信页面拆分及 JavaFx 使用
bugstack虫洞栈
09-22 3008
一、前言 对于一个知识点的学习过程来说，往往使用自己熟悉的工具或方式才更易于上手。因为所有同类型的知识点在抛出复杂的流程拨云见日后，所能得到的几乎都是同样的设计思想和实现理论。 在 Java 语言桌面版开发中，直至目前共提供了三套 UI 开发方式；Awt、Swing、JavaFx，以及一些扩展组件 SWT 等。在这三套 UI 组件中，JavaFx 是最新也是最为好用的，因为他提供了丰富的功能，以及...
《java程序设计基础》javafx的常用控键
qq_45724328的博客
12-03 870
主要包含标签 按钮 复选框 单选按钮 文本框 文本区 组合框 列表视图 控键是结点Node的子类 1.标签类 在单行面板上添加两个标签,并调用相应的方法设置标签上的元素和相应属性 package yuan; //filename：App14_10.java import javafx.application.Application; import javafx.stage.Stage; import javafx.scene.Scene; import javafx.scene.control.Label;
JavaFX通过验证让不可编辑的文本区可编辑
weixin_45802810的博客
08-24 1166
package sample; import javafx.application.Application; import javafx.scene.Scene; import javafx.scene.control.*; import javafx.scene.layout.GridPane; import javafx.stage.Stage; public class Main extends Application { //文本框 private TextField tex
ValidatorFX:JavaFX 的表单验证库
05-29
验证者FX 表单验证变得容易。 介绍 ValidatorFX是JavaFX的验证库。 它受到启发，但试图克服其缺点： 基于任意可观察值（不仅是控件的值）的验证 验证可以装饰任意数量的节点（不仅仅是一个控件） 验证可以修饰任何节点（不仅仅是Control子类型） 验证可以立即完成或按需完成（例如，单击按钮时） ValidatorFX 的中心类是Validator ，它包含许多Check 。 通常，表单将具有一个Validator对象和多个Check 。 Maven坐标 < dependency> < groupId>net.synedra</ groupId> < artifactId>validatorfx</ artifactId> < version>0.1.12</ version> </ dependency> 例子 以下是有关如何使用V
javaFx TextField限制输入类型
最新发布
weixin_40905375的博客
07-28 73
JavaFX TextField限制输入类型 在JavaFX中，TextField是一个常用的组件，用于接收用户的输入。但是，有时候我们需要限制用户输入的类型，比如只允许输入数字、只允许输入字母等。本文将介绍如何在JavaFX中实现对TextField输入类型的限制。 1. 限制输入类型的方法 在JavaFX中，可以通过设...
JavaFX Scene Builder表单验证(一)
qq_42562636的博客
05-23 1378
因为也刚学javafx第二天 所以不能像javaweb那样用框架写的炫一点 所以就随便写了一下 下面看代码 在这是我的项目路径 个人觉得在MyController下的initialize方法 貌似就好比Jquery的$(functiom){}一样 就是 当页面加载完成执行的意思 @Override public void initialize(URL location, Resourc...
fx-validation:JavaFX FXML表单的声明性表单验证
05-24
FX验证 JavaFX是用于快速构建外观良好的UI的出色工具包。 但是，如果您使用JSF或JQuery等实现UI，则可能会习惯于在UI输入元素上定义验证规则的简单方法。 fx-validation是fx-actions的扩展，使您可以做到这一点：在UI控件上声明性地定义验证规则。 验证规则 目前，fx-validation支持以下验证规则： @FXRequired @FXNumber（min = ?, max =？） @FXString（minLength = ?, maxLength =？） @FXNotNull @FXValidation //用于自定义验证器类 这个怎么运作 验证规则将应用于控制器中的字段。 aeFXValidationTest演示应用程序中的示例控制器可能看起来像这样： /** * An example controller that illustr
JavaFX表单验证
12-27
JavaFX表单验证(目前支持,TextField和ComboBox两种表单)
JavaFX基于注解的表单验证
12-27
JavaFX表单验证(目前支持,TextField和ComboBox)
JavaFX的一些组件、布局方式的代码实现（含案例运行效果图）
weixin_45802810的博客
08-23 3777
创建按钮 import javafx.application.Application; import javafx.scene.Scene; import javafx.scene.control.Button; import javafx.stage.Stage; public class Main extends Application { /* JavaFX是借用剧院的术语来命名应用程序界面的， JavaFX程序用户界面的顶层称为Stage，代表窗口， 舞台Stage中摆放的是场景Sc
JavaFX入门（四）：JavaFX布局（一）
热门推荐
给永远比拿愉快
12-05 6万+
说道GUI编程一定要谈到布局，JavaFX内置了大量的布局控件提供给我们使用。其实，JavaFX的布局控件和界面元素控件都是继承自javafx.scene.layout.Region类。我们这里只看布局控件类。布局控件我们在界面上一般是看不到的，它一个容器用于放置其它可视的界面元素控件。（JavaFX在线API文档：JavaFX8 API Online） JavaFX布局控件的类图如下： 下面简
ValidateFX:Java Bean验证（JSR 303）插件，添加了对JavaFX属性API的支持
05-02
验证FX Java Bean验证（JSR 303）插件，添加了对JavaFX属性API的支持 通过添加此类，将添加用于JSR 303的插件，该插件允许验证JavaFX属性： public class MyModel { @NotNull private StringProperty name; }
JavaFXCustomControls:一个项目，展示了有关如何在JavaFX中创建自定义控件的不同方法
05-23
JavaFX自定义控件 该项目将展示有关如何在JavaFX中创建自定义控件的不同方法。 它将涵盖以下方法： 重新设置现有控件的样式 合并现有控件 扩展现有控件 创建一个基于区域的自定义控件 创建一个控件+基于外观的自定义控件 创建基于Canvas的自定义控件
自定义控件
09-25
自定义控件、漂亮，直接使用，快速开发，自定义按钮， 自定义控件、漂亮，直接使用，快速开发，自定义按钮，
JavaFX的知识汇总&单词认识
m0_74276368的博客
12-04 384
JavaFX是基于java语言的图形化界面工具箱，是自JDK1.8引入的新的界面库。带有大量的内置组件，如按钮，文本字段，表格，树，菜单，图表等,使用JavaFX可以让桌面应用和游戏开发变得更加容易,JavaFX编写的程序，可以运行在 Windows、Linux、Mac、iOS、Android等注jdk1.8以后引入的基于java语言的图像化界面工具箱菜单：菜单栏MenuBar 菜单Menu 菜单项MenuItem。
JavaFX自定义控件– Nest Thermostat第1部分
最佳 Java 编程
05-19 236
几周前，由于Hendrik Ebbers的出色文章 ，我决定花一些时间观看有关JavaFX的JavaOne讨论。 我不得不说我已经学到了很多东西，只是看这些视频（即使我还没有完成）！ Gerrit的“使用力，路克”或使用JavaFX功能的技巧和窍门的演讲使我将我的（基本）墨迹和设计技能与JavaFX知识联系起来。 我决定花点时间尝试创建一个完整的自定义JavaFX控件，如Gerrit在其...
10个强大的Javascript表单验证插件推荐
wanguan2000的博客
12-27 242
创建一个JavaScript表单验证插件，可以说是一个繁琐的过程，涉及到初期设计、开发与测试等等环节。实际上一个优秀的程序员不仅是技术高手，也应 该是善假于外物的。本文介绍了10个不错的JavaScript表单验证插件，使用它们完全可以节省你的时间！希望你喜欢。 1. validate.js Validate.js是一个非常不错的JavaScript表单验证库，源于Cod...
Java验证（javafx）
最佳 Java 编程
05-23 925
验证是核心javafx框架所缺少的一件事。 为了填补这一空白， controlsfx中已经存在一个第三方验证库 。 但是，我有一个问题：它不是在考虑FXML的情况下创建的。 这并不是说它不是一个很好的库，只是错过了这个细节，对我来说这是不可行的。 因此，我决定创建自己的验证框架： FXValidation 。 怎么运行的 为了向您展示FXValidation的工作原理，让我们从头开始，向...
【JavaFx构建验证框架ValidateFactory简单实用好扩展】
『梁超』博弈人生-JAVA地盘
08-07 368
JavaFx构建验证框架ValidateFactory简单实用好扩展
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值