Data Service バインディング

Platform 4.2+が必要

データサービスプラグインが必要

DataService のシンタックス

このドキュメントでは、com.nexaweb.data.DataService インターフェイスを使用してデータを UI にバインドするための宣言型シンタックスについて説明します。com.nexaweb.data.DataService インターフェイスは、プラグインを通じて提供されるシステムサービスです。詳細については、データサービスプラグイン API の javadoc を参照してください。

"DataService" システムサービスを使用してデータを UI にバインドするために、以下のメソッドが公開されています。

重要: 以下のメソッドは、テキスト解決シンタックスで使用したり、メソッド呼び出しの引数として使用したりできる、汎用のオブジェクトを返します。

DataService.bind( 'bind-string' )

指定された

bind-string: セミコロンで区切られたパラメータのリスト
パラメータのフォーマット: 等号で区切られた名前と値のペア (名前=値)

次の表に、

パラメータ	説明	必須/省略可能
type	バインディングタイプ: ONE_TIME または ONE_WAY 指定しない場合は、デフォルトで ONE_TIME になります。	省略可能
dataSource	データソースの ID です。反復ループのコンテキストでは、祖先反復子の名前になることがあります。指定しない場合、親反復子に対して相対的に選択が実行されます。	必須
defaultValue	データが使用不可であるか、Null である場合に返される値です。	省略可能
formatter	データを UI でのプレゼンテーション用に変更するために使用するフォーマッタです。

例:

登録されているショートカット

bind
bind=DataService.bind

DataService.bind( binding://binding-id )

ID が binding-idであるバインディング定義を使用してバインドします。

例:

登録されているショートカット

bind
bind=DataService.bind

DataService.relativeBind( 'select' )

指定された select 文字列を使用してバインドします。バインディングは、最も近い祖先反復子のデータソースに対して実行され、現在の反復データが選択のコンテキストとして指定されます。

例:

<data:iterator dataSource="myDataSource" select="/customers" xmlns:data="http://nexaweb.com/data">

</data:iterator>

Registered Shortcut

*
*は DataService.relativeBind を表します

DataService.relativeBind( 'iteratorNameOrDataSourceId', 'select' )

指定された select 文字列を使用してバインドします。バインディングは、iteratorNameOrDataSourceIdという名前の祖先反復子の現在の反復に対して相対的に実行されるか、ID が iteratorNameOrDataSourceId である指定されたデータソースに対してコンテキストを使用せずに直接実行されます。

例:

<data:iterator name="topIterator" dataSource="myDataSource" select="/customers" xmlns:data="http://nexaweb.com/data">

</data:iterator>

登録されているショートカット

*
*はDataService.relativeBind を表します

bind-stringでサポートされるパラメータを示します。 bind-string を使用してバインドします。