スクリーンレットクラスの作成
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。
リコール 基本Screenlet作成チュートリアル Screenletクラスは、あなたのScreenletの焦点となっていること。 Screenletの動作を管理し、アプリ開発者が対話する主要なコンポーネントです。 リスト以外のスクリーンレットと同様に、アプリ開発者が利用できるようにするXML属性を最初に定義する必要があります。 たとえば、ブックマークリストスクリーンレットは次の属性を定義します。
groupId：ブックマークポートレットを含むサイトのIDfolderId：ブックマークを取得するブックマークポートレットフォルダーのIDコンパレーター：ブックマークのソートに使用するコンパレーターの名前
スクリーンレットは、 res / values / bookmark_attrs.xml ファイルでこれらの属性を定義します。
<?xml version="1.0" encoding="utf-8"?>
<resources>
<declare-styleable name="BookmarkListScreenlet">
<attr name="groupId"/>
<attr name="folderId"/>
<attr format="string" name="comparator"/>
</declare-styleable>
</resources>
これで、Screenletクラスを作成する準備ができました。 BaseListScreenlet クラス は、ページネーションやその他のデフォルトの動作のメソッドなど、リストScreenletのすべてのScreenletクラスに基本機能を提供するため、Screenletクラスは、モデルクラスとInteractorを型引数として BaseListScreenlet を拡張する必要があります。
たとえば、Bookmark List ScreenletのScreenletクラスBookmarkListScreenlet–extends BaseListScreenlet 、 Bookmark および BookmarkListInteractorパラメーター化されています。
public class BookmarkListScreenlet
extends BaseListScreenlet<Bookmark, BookmarkListInteractor> {...
Interactorに渡すXML属性のインスタンス変数も作成する必要があります。 例えば、リコールのリクエストメソッドこと BookmarkListInteractor 2つの受け取る オブジェクト のフォルダIDと比較：引数。 したがって、 BookmarkListScreenlet クラスには、これらのパラメーターの変数を含める必要があります。そうすると、Interactorに渡すことができます。
private long folderId;
private String comparator;
コンストラクターの場合、スーパークラスコンストラクターを活用します。 たとえば、 BookmarkListScreenletのコンストラクタは次のとおりです。
public BookmarkListScreenlet(Context context) {
super(context);
}
public BookmarkListScreenlet(Context context, AttributeSet attrs) {
super(context, attrs);
}
public BookmarkListScreenlet(Context context, AttributeSet attrs, int defStyleAttr) {
super(context, attrs, defStyleAttr);
}
public BookmarkListScreenlet(Context context, AttributeSet attrs, int defStyleAttr,
int defStyleRes) {
super(context, attrs, defStyleAttr, defStyleRes);
}
ここで、 エラー メソッドを実装する必要があります。 これは、Screenletフレームワークのリスナーを使用して、例外、およびサービス呼び出し中に発生する例外を生成したユーザーアクションを伝播する定型的なメソッドです。 この方法は、リスナーをチェックし、その呼び出すことによってこれを行い エラー と方法 の例外 及び userAction：
@Override
public void error(Exception e, String userAction) {
if (getListener() != null) {
getListener().error(e, userAction);
}
}
次に、 createScreenletView メソッドをオーバーライドして、前に定義したXML属性の値を読み取り、スクリーンレットのビューを作成します。 から基本的なスクリーンレット作成チュートリアル を思い出してください
このメソッドは、対応するインスタンス変数に属性値を割り当てます。 たとえば、 BookmarkListScreenlet の createScreenletView メソッドは、 folderId および コンパレータ 属性値を同じ名前の変数に割り当てます。 このメソッドは、ローカル変数 groupIdも設定します。 Screensフレームワークがこの変数をInteractorに伝播することを思い出してください。 スーパークラスの createScreenletView メソッドを呼び出して、 createScreenletView メソッドを終了し` 。 これにより、ビューがインスタンス化されます。
@Override
protected View createScreenletView(Context context, AttributeSet attributes) {
TypedArray typedArray = context.getTheme().obtainStyledAttributes(attributes,
R.styleable.BookmarkListScreenlet, 0, 0);
groupId = typedArray.getInt(R.styleable.BookmarkListScreenlet_groupId,
(int) LiferayServerContext.getGroupId());
folderId = typedArray.getInt(R.styleable.BookmarkListScreenlet_folderId, 0);
comparator = typedArray.getString(R.styleable.BookmarkListScreenlet_comparator);
typedArray.recycle();
return super.createScreenletView(context, attributes);
}
`次に、 loadRows メソッドをオーバーライドして、Interactorを起動し、サーバーからリスト行を取得します。 このメソッドは、Interactorのインスタンスを引数として受け取り、これを使用してInteractorの start メソッドを呼び出します。 Interactorは BaseListInteractorから start を継承することに注意してください。 loadRows メソッドを使用して、Interactorの起動時に実行する他のコードを実行することもできます。 たとえば、 BookmarkListScreenlet の loadRows メソッドは最初にリスナーインスタンスを取得し、リスナーの interactorCalled メソッドを呼び出すことができます。 次に、Interactorの start メソッドを folderId と コンパレーター呼び出して、サーバー操作を開始してリスト行を取得します。
@Override
protected void loadRows(BookmarkListInteractor interactor) {
((BookmarkListListener) getListener()).interactorCalled();
interactor.start(folderId, comparator);
}
Interactorが引数を必要としない場合、 start メソッド 0 または nullを渡すことができます。 ただし、引数なしで start を呼び出すと、サーバー呼び出しが失敗します。
最後に、 createInteractor メソッドをオーバーライドして、Interactorをインスタンス化します。 このメソッドが行う必要があるのはそれだけなので、Interactorのコンストラクターを呼び出して、新しいインスタンスを返します。 たとえば、 BookmarkListScreenletの createInteractor メソッドは、新しい BookmarkListInteractor返します。
@Override
protected BookmarkListInteractor createInteractor(String actionName) {
return new BookmarkListInteractor();
}
完了です！ スクリーンレットは、アプリで使用できるすぐに使えるコンポーネントです。 Screenlet を パッケージ化してScreensプロジェクトに提供したり、Maven CentralまたはjCenterで配布したりすることもできます。