Android Studio 自定义模板实现一键创建 MVP 结构,已拿到 offer
<thumbs>
<thumb>template_blank_activity.png</thumb>
</thumbs>
<globals file="globals.xml.ftl" />
<execute file="recipe.xml.ftl" />
</template>
我们挑出其中的重点来说
<category value="Activity" />
表示当前的这个模版的分类,当前的 Value 是 Activity ,就表示它会出现在 File -> New -> Activity 中,这个是可以自定义的.
<thumbs>
<thumb>template_blank_activity.png</thumb>
</thumbs>
thumbs 用于指定创建模版时所展示出来的图片
而最重要的,还是 parameter 代码块的内容了,在这之中,我们只需要关注以下几个,其他的顾名思义即可。
<parameter
id="activityClass"
name="Activity Name"
type="string"
constraints="class|unique|nonempty"
suggest="${layoutToActivity(layoutName)}"
default="MainActivity"
help="The name of the activity class to create" />
activityClass 表示所要创建的 Activity ,其中 default 为默认名。
<parameter
id="generateLayout"
name="Generate Layout File"
type="boolean"
default="true"
help="If true, a layout file will be generated" />
上面的代码块表示是否同时自动创建一个 Activity 对应的布局
<parameter
id="layoutName"
name="Layout Name"
type="string"
constraints="layout|unique|nonempty"
suggest="${activityToLayout(activityClass)}"
default="activity_main"
visibility="generateLayout"
help="The name of the layout to create for the activity" />
layoutName 则表示布局的名字,这里的 suggest 属性所填写的内容即为布局名,**${activityToLayout(activityClass)}**则为跟随 Activity 的名字,其中 activityClass 是 Activity 名字的引用
剩下的不用再作说明,基本上可以见名知意。
模版代码
====
接下来我们从 EmptyActivity 中的 root 目录一直进入,直到看到下面两个文件
可以看到,一个后缀是 java.ftl 另外一个后缀是 kt.ftl,他们分别用于创建 Java 模版与 Kotlin 模版,如果你暂时不使用 Kotlin 的话,可以不用去关心 Kotlin 模版,当你完成了 Java 模版的编写,也可以使用 Android Studio 自带的转换功能,还是蛮方便的。
下面来看一下 Java 的模版代码:
package ${packageName};
import ${superClassFqcn};
import android.os.Bundle;
<#if (includeCppSupport!false) && generateLayout>
import android.widget.TextView;
</#if>
public class {superClass} {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
<#if generateLayout>
setContentView(R.layout.${layoutName});
<#include "../../../../common/jni_code_usage.java.ftl">
<#elseif includeCppSupport!false>
// Example of a call to a native method
android.util.Log.d("${activityClass}", stringFromJNI());
</#if>
}
<#include "../../../../common/jni_code_snippet.java.ftl">
}
${packageName}:表示当前包名
${activityClass}:表示当前的 Activity 名字
- {superClassFqcn}
${l
ayoutName}:当前 Activity 所对应的布局名
目前我们只需要关注上面这部分,接下来可以看一下我们实际想要创建的 MVP 结构:
编写模版代码前,最好的方式是先写一遍例子,然后对照例子去替换关键名部分,这样做是最轻松的。
下面就来看一看具体的实现吧:
样例代码
====
接口部分:TestActivityContact
package com.example.testcustomtemplates.contact;
public interface TestActivityContact {
interface Presenter<T> {
void succeed(T t);
void failed(T t);
void error(Throwable e);
void subscribe();
void unSubscribe();
}
interface View<T> {
void setPresenter(Presenter presenter);
void succeed(T t);
void failed(T t);
void error(Throwable e);
}
interface Model {
void setPresenter(Presenter presenter);
}
}
为了方便测试,这里并没有另外创建一些基类接口,可以看到上面代码中分别对应 MVP 结构中三个模块的接口,写的是最基本的需求方法,不过 MVP 也不都是完全一样的,这里你可以定义自己想写的方法。
Model 层:TestActivityModel
package com.example.testcustomtemplates.model;
import android.content.Context;
import com.example.testcustomtemplates.contact.TestActivityContact;
public class TestActivityModel implements TestActivityContact.Model {
private Context context;
private TestActivityContact.Presenter mPresenter;
public TestActivityModel(Context context) {
this.context = context;
}
@Override
public void setPresenter(TestActivityContact.Presenter presenter) {
this.mPresenter = presenter;
}
}
Model 层主要就是做一些网络请求,存储之类的数据相关操作,不可以持有对 View 的引用,他是通过 Presenter 去和 View 进行交互的。
Presenter 层:TestActivityPresenter
package com.example.testcustomtemplates.presenter;
import android.content.Context;
import com.example.testcustomtemplates.contact.TestActivityContact;
import com.example.testcustomtemplates.model.TestActivityModel;
public class TestActivityPresenter<T> implements TestActivityContact.Presenter<T> {
private TestActivityContact.View mView;
private TestActivityModel mModel;
private Context context;
public TestActivityPresenter(TestActivityContact.View mView, Context context) {
this.mView = mView;
this.context = context;
mModel = new TestActivityModel(context);
}
@Override
public void succeed(T t) {
}
@Override
public void failed(T t) {
}
@Override
public void error(Throwable e) {
}
@Override
public void subscribe() {
}
@Override
public void unSubscribe() {
}
}
Presenter 层自然不必多说,他最好是不要持有 View 控件的引用,大部分的逻辑操作需要他来完成,不过不可避免的,如果业务逻辑复杂了,Presenter 层也会变得臃肿,这也是 MVP 结构的一个短处。
View 层:TestActivity
package com.example.testcustomtemplates.activity;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import com.example.testcustomtemplates.R;
import com.example.testcustomtemplates.contact.TestActivityContact;
import com.example.testcustomtemplates.presenter.TestActivityPresenter;
public class TestActivity<T> extends AppCompatActivity implements TestActivityContact.View<T> {
private TestActivityContact.Presenter mPresenter;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_test);
new TestActivityPresenter<T>(this, this);
}
@Override
public void setPresenter(TestActivityContact.Presenter presenter) {
this.mPresenter = presenter;
}
@Override
public void succeed(T t) {
}
@Override
public void failed(T t) {
}
@Override
public void error(Throwable e) {
}
}
评论