android-validator

KO | EN

gitlite — search

#javascript #python #ai #typescript #go #machine-learning #java #windows #cli #kubernetes #awesome-list #pytorch #security #open-source

android-validator

(★ 11)

A Parameter and Field Validator for Android Method , using AspectJ , Annotation , Reflect（Android方法参数和成员变量校验库，支持自定义规则）

android-validator Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# android-validator
Android Common Validator using AspectJ , Annotation , Reflect. Support custom rule and validator

基于AspectJ,注解，反射开发的Android方法、参数校验库，支持自定义规则校验

# Gradle 集成

### 1. add dependencies in module build.gradle
```Java
dependencies {
    ...
    compile 'com.validator:validator-core:1.0.1@aar' // 1.0.1 support res warning
}
```
### 2. add AspecJ dependenceies in the end of module build.gradle
Android Application Module
```Java
apply from: 'https://raw.githubusercontent.com/aos3618/android-validator/master/appconfig.gradle'
```
Android Library Module
```Java
apply from: 'https://raw.githubusercontent.com/aos3618/android-validator/master/libconfig.gradle'
```
### 3. sync the project

# Function
在某些方法调用时检查参数的合法性并进行提示
目前提供的注解有(持续加入中)：

# 初始化

```Java
public class DemoApplication extends Application {

@Override
    public void onCreate() {
        super.onCreate();
        Validator.init(
                ValidatorConfig
                        .newInstance()
                        .setApplication(this)
                        .setWarningProvider(new WarningProvider())  //custom how to show warning, default is Log
                        .setRuleProvider(new RuleProvider())        //custom the check rule
        );
    }

class WarningProvider implements IWarningProvider {
       ...
    }

class RuleProvider implements IRuleProvider {
       ...
    }
}

```

# Sample

```Java
public class MainActivity extends AppCompatActivity {

//validate if mTV is a mobile when @Validate method invoked
    @Mobile(warning = "wrong mobile number 1")
    TextView mTV;

@Mobile(warning = "wrong mobile number 2")
    String mText = "15022729132";

//validate if mEmail is a email when @Validate method invoked
    @Email(warning = "wrong email 1")
    String mEmail;

//validate if mEmailText is not empty when @Validate method invoked
    @NotBlank(warning = "a empty field")
    @CustomeValidator
    TextView mEmailText;

//validate if mValue is less than 10 when @Validate method invoked
    @Max(value = 10, warning = "need less than 10")
    int mValue = 8;

//validate if mPattern matched the regex when @Validate method invoked
    @Pattern(value = "^[0-9]*$", warning = "not matched regex")
    String mPattern;

//validate if mList size is 0-2 when @Validate method invoked
    //use warningId can show a res warning
    @Size(min = 0, max = 2, warningId = R.string.waring)
    List<String> mList = new ArrayList<>();

@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

Validator.inject(this);

mEmailText = findViewById(R.id.tv_email);
        mEmailText.setText("123");
        mTV = findViewById(R.id.tv_text);
        mTV.setText("13651234143");
        mEmail = "@";
        mPattern = "123";

findViewById(R.id.tv_list).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                validate3(mList);
            }
        });

mTV.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                validate1("11", 8);
            }
        });

mEmailText.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                validate2("123");
            }
        });
    }

//validate the field :mTV,mText;
    //validate the parameter : s , i
    @Validate({"mTV", "mText"})
    public void validate1(@CustomeValidator String s,
                          @Min(value = 10, warning = "need more than 10") int i) {

}

//validate the field :mEmail,mEmailText;
    //validate the parameter : pattern
    @Validate({"mEmail", "mEmailText"})
    public void validate2(@Pattern(value = "^[0-9]*$", warning = "not matched regex") String pattern) {

}

//validate the field :mPattern,mValue;
    //validate the parameter : list
    @Validate({"mPattern", "mValue"})
    public void validate3(@Size(min = 1, max = 2, warning = "wrong list size") List list) {

}
}
```

# 自定义规则检查
### 提供自定义规则检查
### 具体步骤  案例：登陆状态检查

#### 1.自定义注解 
```Java
@Documented
@Target({FIELD, PARAMETER})
@Retention(RUNTIME)
@Constraint(LoginRule.class)   //Must have a Constraint Annotation，and define a check rule
public @interface LoginValiadtor {
    String value() default "LoginValidator";
}
```

#### 2. 自定义检查规则
```Java
public class LoginRule implements IRuleValidator<LoginValiadtor> {  //need implement IRuleValidator and step1 Annotation as generics
    UserInfo userInfo;

@Override
    public void initialize(LoginValiadtor loginValiadtor, Object t) {
        if (t instanceof UserInfo) {
            userInfo = (UserInfo) t;
        }
    }

@Override
    public boolean isValid() {
        return userInfo != null && userInfo.isLogin();    //check the login status
    }

@Override
    public void showWarning() {
//        Toast.makeText(context, "请登录", Toast.LENGTH_SHORT);
        Log.d("TAG", "请登录");
    }
}

```

#### 3.使用
与默认注解一致

# 参考

* [Retrofit](https://github.com/square/retrofit)
* [Hibernate Validator](https://github.com/hibernate/hibernate-validator)

# License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

android-validator

android-validator Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

android-validator

android-validator Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README