Saber

KO | EN

gitlite — search

#hacktoberfest #ai #go #golang #android #machine-learning #rust #docker #nodejs #windows #vue #mcp #ios #openai

(★ 147)

【停止维护】🏄 帮助你快速使用Android的LiveData与ViewModel，已支持SavedState

Saber 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Saber

[![jitpack](https://jitpack.io/v/simplezhli/saber.svg)](https://jitpack.io/#simplezhli/saber) [![LICENSE](https://img.shields.io/badge/license-Apache%202-blue.svg)](https://raw.githubusercontent.com/simplezhli/Saber/master/LICENSE) [![作者](https://img.shields.io/badge/%E4%BD%9C%E8%80%85-weilu-orange.svg)](http://blog.csdn.net/qq_17766199)

## 本项目帮助你快速使用LiveData与ViewModel

- 已适配AndroidX。

- 支持Kotlin。

- 支持 `ViewModel`、`AndroidViewModel`。（默认为 `ViewModel`）

- 支持 `observe`、`observeForever` 两种观察模式。（默认为 `observe`）

- 支持 `SingleLiveEvent`、`MediatorLiveData`、`MutableLiveData`。（默认为 `MutableLiveData`）

- 支持 `SavedState`（仅AndroidX）

- 支持自定义`LiveData`类型。

- 支持事件总线的操作。

- Forever模式自动取消订阅。

- 支持注解处理器增量编译。

## 详细介绍

- [感受LiveData 与 ViewModel结合之美](https://blog.csdn.net/qq_17766199/article/details/80732836)

## 使用方式

添加依赖

```gradle
    implementation 'com.github.simplezhli.saber:saber-api:0.3.1'
    //AndroidX使用
    implementation 'com.github.simplezhli.saber:saberx-api:0.3.1'

annotationProcessor 'com.github.simplezhli.saber:saber-compiler:0.3.1'
```

首先创建一个类，使用`@LiveData`注解标记你要保存的数据。注意这里的参数名称value，下面会用到。
```java
public class SeekBar {

@LiveData
    Integer value;
}
```

当然也可以直接标记你的JavaBean，来直接保存此类。那么参数名为类名的首字母小写：seekBar
```java
@LiveData
public class SeekBar {

Integer value;
}
```

使用`@LiveData(classType = LiveDataClassType.LIST)`可以指定对应的数据集合类型

Build -- > Make Project 会生成代码如下：

```java
public class SeekBarViewModel extends ViewModel {
  private MutableLiveData<Integer> mValue;

public MutableLiveData<Integer> getValue() {
    if (mValue == null) {
      mValue = new MutableLiveData<>();
    }
    return mValue;
  }

public Integer getValueValue() {
    return getValue().getValue();
  }

public void setValue(Integer mValue) {
    if (this.mValue == null) {
      return;
    }
    this.mValue.setValue(mValue);
  }

public void postValue(Integer mValue) {
    if (this.mValue == null) {
      return;
    }
    this.mValue.postValue(mValue);
  }
}

```

如果想使用`AndroidViewModel`的话，可以添加`@AndroidViewModel`注解

```java
@AndroidViewModel
public class SeekBar {

@LiveData
    Integer value;
}
```

自定义`LiveData`类型

```java
public class Single {

@LiveData(type = LiveDataType.OTHER, liveDataType = XXXLiveData.class)
    Integer value;
}

```

生成代码提供了LiveData的常用操作。

- `setXXX()`要在主线程中调用。

- `postXXX()`既可在主线程也可在子线程中调用。

- `getXXX()`用于获取观察者。

- `getXXXValue()`可以获取保存的数据。

- `addSource()`用于监听LiveData。(MediatorLiveData专用)

- `removeSource()`移除监听的LiveData。(MediatorLiveData专用)

### 1. 普通使用方法

一般情况下可以直接使用它。比如：

```java
public class TestFragment extends Fragment {

private SeekBar mSeekBar;

@BindViewModel(isShare = true) //<--标记需要绑定的ViewModel
    SeekBarViewModel mSeekBarViewModel;
    
    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        // Inflate the layout for this fragment
        View root = inflater.inflate(R.layout.fragment_test, container, false);
        mSeekBar = root.findViewById(R.id.seekBar);
        Saber.bind(this); // <--这里绑定ViewModel
        subscribeSeekBar();
        return root;
    }

private void subscribeSeekBar() {

mSeekBar.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
            @Override
            public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
                if (fromUser) {
                    mSeekBarViewModel.setValue(progress);
                }
            }
			......
        });
    }

@OnChange(model = "mSeekBarViewModel") //<--接收变化的ViewModel变量名
    void setData(Integer value){ //注意这里使用 @LiveData 标记的参数名
        if (value != null) {
            mSeekBar.setProgress(value);
        }
    }
}
```

`@BindViewModel`用于绑定ViewModel。

`@OnChange(model = "xxx")`用于接收指定ViewModel的数据变化，可以不设置，默认model名称为mViewModel。

如果需要`Fragment`之间数据共享，需要`@BindViewModel(isShare = true)`，当然也要保证传入相同的key值。默认key值是类的规范名称，也就是包名加类名。

![这里写图片描述](https://img-blog.csdn.net/20180619100304754?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzE3NzY2MTk5/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70)

所以一旦需要互通的Fragment类名或包名不一致，就无法数据共享。这时可以指定key值：`@BindViewModel(key = "value")`

### 2. 事件总线使用方法，[详细用法参看LiveEventBus](https://github.com/JeremyLiao/LiveEventBus)

```java
    @LiveEventBus(model = "key_name")
    void liveDataBus(String value){
        
    }
```

发送：

```java
    LiveEventBus.get().with("key_name").postValue("value");
```

更多的使用方法可以参看本项目demo。

### 3.Kotlin环境使用注意事项

1.将以下代码添加到 `build.gradle` 文件中，保证生成代码的正确性。

```gradle

kapt {
        correctErrorTypes = true
    }

```

2.Kotlin默认会生成set/get方法，并把属性设置为`private` 所以只要保证Kotlin中字段可见性不是`private`即可，简单解决可以在字段上添加 `@JvmField`，也可以使用`lateinit`.

```kotlin

@BindViewModel
    lateinit var mViewModel: TestViewModel
    
    //或
    
    @JvmField
    @BindViewModel
    var mViewModel: TestViewModel? = null
```

## TODO

1.~~因为现有的`@OnChange`注解承载的功能过多，不易使用。后面会将`EventBus`功能从中提出，添加一个新的注解（或许叫做`@LiveEventBus`）。~~

2.有什么好的建议或者功能欢迎提Issues。

## 版本变化

- [点击查看](https://github.com/simplezhli/Saber/releases)

## Thanks For

- [butterknife](https://github.com/JakeWharton/butterknife)

- [在 SnackBar，Navigation 和其他事件中使用 LiveData](https://juejin.im/post/5b2b1b2cf265da5952314b63)

- [LiveEventBus](https://github.com/JeremyLiao/LiveEventBus)

## License

Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.

Saber

Saber 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Saber

Saber 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README