Pan

A light weight MV* framework to build android reusable UI components.

中文文档Javadoc

完整的示例：直接运行源码中的sample-github-users

设计思路

Pan的简介和设计思路

Getting Started

Pan框架使用起来很简单。采用Pan来编写界面和控制代码，可以和原有的代码完全兼容、并存。

首先，是轻量化的Activity代码，主要通过Pan的工厂方法with，得到ViewModel的实例，绑定ViewModel和Controller到Activity上。工厂方法with有很多重载，也可以传入使用实例化好的对象。

publicclassMainActivityextendsPanActivity {
MainViewModelmMainViewModel;
@OverrideprotectedvoidonCreate(BundlesavedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mMainViewModel = Pan.with(this, MainViewModel.class)
.controlledBy(MainController.class)
.getViewModel()
.setHelloString("hello Pan!")
.render();
}
}

How clean! 事实上，常见的Activity中需要实现的onResume等方法，也无需写在这里，可以完全交给Controller。

接下来编写具体ViewModel实现类。ViewModel主要完成渲染逻辑，因此ViewModel的成员变量包含两种：

1. 以v作为前缀的View对象
2. 以m作为前缀的ViewModel具体的字段

render方法负责将ViewModel字段渲染到View上

@Xml(R.layout.activity_main) //可选，让ViewModel语义更明确。当需要自己实例化新View时必选。publicclassMainViewModelextendsGeneralViewModel {
@Bind(R.id.hello) //ButterknifeButtonvHelloTv;
StringmHelloString;
@OverridepublicMainViewModelrender() {
vHelloTv.setText(mHelloString);
returnthis;
}
publicMainViewModelsetHelloString(Stringstring) {
mHelloString = string;
returnthis;
}
}

其次，是Controller实现类。当然一个View不必要有Controller，如果不需要监听任何事件的话。 Controller通过泛型参数，与ViewModel实现绑定，可以处理两类事件：

1. 用户交互，通过bindEvents()方法实现，$vm为绑定的ViewModel对象
2. 所处Activity/Fragment的生命周期，通过实现接口（例如，OnResume）进行监听

publicclassMainControllerextendsGeneralController<MainViewModel> implementsOnResume { //以监听Activity的OnResume事件@OverrideprotectedvoidbindEvents() {
$vm.vHelloTv.setOnClickListener(newView.OnClickListener() {
@OverridepublicvoidonClick(Viewv) {
Toast.makeText(getActivity(), $vm.mHelloString, Toast.LENGTH_SHORT).show();
}
});
}
@OverridepublicvoidonResume() {
Log.d("MainController", "On Resume For " + getActivity());
}
}

对应的布局XML:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"android:orientation="vertical"android:layout_width="match_parent"android:layout_height="match_parent">
<Buttonandroid:id="@+id/hello"android:text="Hello World!"android:layout_width="wrap_content"android:layout_height="wrap_content"/>
</LinearLayout>

添加Pan的依赖：

	repositories {
//jitpack repository
maven { url "https://jitpack.io" }
}
dependencies {
implementation 'com.github.campusappcn:Pan:0.9.8'//需要显式声明annotation processor
implementation 'com.jakewharton:butterknife:9.0.0-rc1'
annotationProcessor 'com.jakewharton:butterknife-compiler:9.0.0-rc1'
}

致谢： @PrototypeZ，为Pan的前身提供了很大的贡献。

License

Copyright 2015 杭州树洞网络科技有限公司
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.