従来のアプローチは、定型コードと不器用なリソース処理でいっぱいです。そのため、私はSpyglassフレームワークを作成しました。これがどのように機能するかを示すために、ここでは文字列タイトルを表示するカスタムビューを作成する方法を示す例を示します。
手順1：カスタムビュークラスを作成します。
public class CustomView extends FrameLayout {
private TextView titleView;
public CustomView(Context context) {
super(context);
init(null, 0, 0);
}
public CustomView(Context context, AttributeSet attrs) {
super(context, attrs);
init(attrs, 0, 0);
}
public CustomView(Context context, AttributeSet attrs, int defStyleAttr) {
super(context, attrs, defStyleAttr);
init(attrs, defStyleAttr, 0);
}
@RequiresApi(21)
public CustomView(
Context context,
AttributeSet attrs,
int defStyleAttr,
int defStyleRes) {
super(context, attrs, defStyleAttr, defStyleRes);
init(attrs, defStyleAttr, defStyleRes);
}
public void setTitle(String title) {
titleView.setText(title);
}
private void init(AttributeSet attrs, int defStyleAttr, int defStyleRes) {
inflate(getContext(), R.layout.custom_view, this);
titleView = findViewById(R.id.title_view);
}
}
手順2：values/attrs.xmlリソースファイルで文字列属性を定義します。
<resources>
<declare-styleable name="CustomView">
<attr name="title" format="string"/>
</declare-styleable>
</resources>
ステップ3：@StringHandlerアノテーションをsetTitleメソッドに適用して、ビューが拡張されたときにSpyglassフレームワークに属性値をこのメソッドにルーティングするように指示します。
@HandlesString(attributeId = R.styleable.CustomView_title)
public void setTitle(String title) {
titleView.setText(title);
}
クラスにSpyglassアノテーションが追加されたので、Spyglassフレームワークはコンパイル時にそれを検出し、CustomView_SpyglassCompanionクラスを自動的に生成します。
手順4：生成されたクラスをカスタムビューのinitメソッドで使用します。
private void init(AttributeSet attrs, int defStyleAttr, int defStyleRes) {
inflate(getContext(), R.layout.custom_view, this);
titleView = findViewById(R.id.title_view);
CustomView_SpyglassCompanion
.builder()
.withTarget(this)
.withContext(getContext())
.withAttributeSet(attrs)
.withDefaultStyleAttribute(defStyleAttr)
.withDefaultStyleResource(defStyleRes)
.build()
.callTargetMethodsNow();
}
それでおしまい。XMLからクラスをインスタンス化すると、Spyglassコンパニオンが属性を解釈し、必要なメソッド呼び出しを行います。たとえば、次のレイアウトを膨らませると、引数としてsetTitleが呼び出さ"Hello, World!"れます。
<FrameLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:width="match_parent"
android:height="match_parent">
<com.example.CustomView
android:width="match_parent"
android:height="match_parent"
app:title="Hello, World!"/>
</FrameLayout>
フレームワークは文字列リソースに限定されず、他のリソースタイプを処理するためのさまざまな注釈がたくさんあります。また、デフォルト値を定義したり、メソッドに複数のパラメーターがある場合はプレースホルダー値を渡したりするための注釈もあります。
詳細と例については、Githubリポジトリをご覧ください。