DEV Community

Sharif
Sharif

Posted on

ValidX v1.0.1 Changelog

#java #programming #opensource #softwaredevelopment

ValidX v1.0.1 Changelog

Release Date: July 31, 2026

This document records the changes from v1.0.0 to v1.0.1.

Change Overview

  • ✨ Added @Contains validation annotation
  • 🔄 Renamed core class ValidaX → ValidX
  • 📖 Documentation improvements and version tracking
  • 📜 Added open source license

New Features ✨

@Contains Validation Annotation

Added string substring matching validator with flexible matching strategies.

Features:

  • OR logic: Match any one substring
  • AND logic: Must match all substrings
  • Case-insensitive option
  • Full internationalization support (8 languages)

Annotation Examples:

// Example 1: OR logic - match either "@" or ".com"
@Contains({"@", ".com"})
private String email;

// Example 2: AND logic - must contain both "@" and "."
@Contains(value = {"@", "."}, matchAll = true)
private String strictEmail;

// Example 3: Case-insensitive matching
@Contains(value = {"HELLO", "WORLD"}, ignoreCase = true)
private String greeting;

// Example 4: Custom error message
@Contains(value = {"product", "service"}, message = "Description must contain 'product' or 'service'")
private String description;
Enter fullscreen mode Exit fullscreen mode

Chain API Examples:

ValidX validator = ValidX.init();

// OR logic (default)
validator.field("Email")
    .isContains("test@example.com", new String[]{"@", ".com"});

// AND logic
validator.field("Email")
    .isContains("test@example.com", new String[]{"@", "."}, false, true);

// Case-insensitive
validator.field("Greeting")
    .isContains("Hello World", new String[]{"hello", "world"}, true, false);

// Check validation result
if (!validator.passed()) {
    System.out.println(validator.getErrors());
}
Enter fullscreen mode Exit fullscreen mode

Real-World Use Cases:

// Use Case 1: Simple email format validation
public class UserDTO {
    @Contains(value = {"@", "."}, matchAll = true)
    private String email;
}

// Use Case 2: Password strength check - must contain letters and numbers
ValidX.init()
    .field("Password")
    .isContains(password, new String[]{"[a-zA-Z]", "[0-9]"}, false, true);

// Use Case 3: Content keyword filtering
@Contains({"keyword1", "keyword2", "keyword3"})
private String content; // Triggers if any keyword is found

// Use Case 4: URL parameter validation
ValidX.init()
    .field("Callback URL")
    .isContains(callbackUrl, new String[]{"https://", "callback"}, false, true);
Enter fullscreen mode Exit fullscreen mode

Version Tracking

Added "Version" column in documentation quick reference table to indicate when each validation annotation was introduced.

Example:

Annotation Description Version
@Contains String contains validation 1.0.1
@ChineseIdCard ID card validation 1.0.0
@ChinesePhone Phone validation 1.0.0

Open Source License

Added Apache License 2.0 license file.

Changes 🔄

Core Class Rename

Renamed main validation class from ValidaX to ValidX for cleaner, more consistent naming.

Impact:

  • Core class: ValidaX → ValidX
  • Test class: ValidaXConfigTest → ValidXConfigTest

Migration Example:

// ❌ v1.0.0 (old)
ValidaX validator = ValidaX.init()
    .config(ValidXConfig.GLOBAL_NOT_NULL)
    .field("Email").isEmail(email)
    .field("Phone").isChinesePhone(phone);

// ✅ v1.0.1 (new)
ValidX validator = ValidX.init()
    .config(ValidXConfig.GLOBAL_NOT_NULL)
    .field("Email").isEmail(email)
    .field("Phone").isChinesePhone(phone);
Enter fullscreen mode Exit fullscreen mode

Documentation Improvements

  • Reduced marketing language, enhanced professionalism and objectivity
  • Updated all dependency versions to 1.0.1
  • Improved code example readability and practicality

Upgrade Guide 📋

Breaking Changes ⚠️

Class Rename: ValidaX → ValidX

This is the only breaking change requiring code modification.

Upgrade Steps

1. Update Maven Dependency

<dependency>
    <groupId>io.github.vipxieliang</groupId>
    <artifactId>validx</artifactId>
    <version>1.0.1</version>
</dependency>
Enter fullscreen mode Exit fullscreen mode

2. Global Class Name Replacement

Use your IDE's global find and replace:

  • Find: ValidaX
  • Replace with: ValidX

3. Rebuild and Test

mvn clean compile
mvn test
Enter fullscreen mode Exit fullscreen mode

Try New Features After Upgrade 

// Use the new @Contains annotation
public class ArticleDTO {

    @Contains(value = {"tech", "development", "programming"})
    private String title; // Title must contain tech-related keywords

    @Contains(value = {"http://", "https://"}, message = "Must be a valid URL")
    private String link;

    @Contains(value = {"<script", "javascript:"}, matchAll = false,
              message = "Content cannot contain script code")
    private String content;
}
Enter fullscreen mode Exit fullscreen mode

Technical Statistics 📊

  • New Code: 673 lines
  • New Files: 17 files
  • New Tests: 185+ test cases
  • Documentation Updates: 50+ locations

Related Links 🔗

Released with ❤️ by the ValidX Team

Top comments (0)