interMediaオブジェクトとしてOracleデータベースに格納されているマルチメディア・コンテンツを取得するURL文字列を指定します。
JSP構文
<jbo:MediaUrl
id="uniqueIdName"
datasource="datasourceInstanceName"
mediaattr="mediaAttributeName"
[[ rowkey="RowKeyString" ] | [ whereclause="WhereClause" ]]
[ retrievepath="CustomRetrievePath" ]
>
body content
</jbo:MediaUrl>
説明
<jbo:MediaUrl>
データ・タグは、interMediaに格納されているマルチメディア・コンテンツをレンダリングするための高度なカスタムHTMLタグを記述する場合に役立ちます。<jbo:MediaUrl>
データ・タグのid属性により、<jbo:MediaUrl>
データ・タグのボディ内でOrdURLBuilder
オブジェクトを表すスクリプト変数が導入されます。このスクリプト変数は、カスタムHTMLタグ用に、メディアをフェッチするURLを作成します。一例として、スクリプト変数を使用してHTMLの<IMG>
タグのSRC属性に対するURLを作成するという使用方法があります。また、スクリプト変数はgetHeight()
やgetWidth()
などのユーティリティ・メソッドも提供しており、HTMLのその他のカスタム・タグ属性への移入に役立ちます。
このタグは、<jbo:Row>
または<jbo:RowsetIterate>
データ・タグ内にネストされます。ネストされたタグがこれら2つのタグのいずれかに表示される場合、これらのタグで定義された行を使用し、rowkey
およびwhereclause
属性を無視します。それ以外の場合、ネストされたタグはrowkey
またはwhereclause
属性を使用し、行を検索します。rowkey
は、whereclause
より優先されます。どちらの属性も指定されない場合、タグはデータ・ソース・オブジェクトの現在の行を使用します。<jbo:RowsetNavigate>
データ・タグを使用して、データ・ソース・オブジェクトの現在の行を変更できます。
[mediaFetchingURL]
の書式は次のとおりです。
[retrievepath]?appModId=[appModId]&rowSetName=[rowSetName]&contentCol=[mediaAttributeName]&rowKey=[rowKeyString]
デフォルトでは、[retrievepath]
はあらかじめ提供されているordPlayMedia.jsp
というJSPページです。必要に応じて、独自のメディア配信コンポーネントを作成し、独自の検索パスを指定できます。
属性
id: <jbo:MediaUrl>
タグによって作成されたURLビルダーのインスタンスの名前。割り当てる名前は、ページ内で一意である必要があります。これは有効なJava識別子にできます。スクリプトレット内では、タイプOrdURLBuilder
のスクリプト可能変数としてこのIDを使用できます。
datasource: interMediaオブジェクトへのアクセスに使用するデータ・ソースid。データ・ソースは<jbo:DataSource>
データ・タグを使用して作成します。
mediaattr: interMediaオブジェクトを含む、(データソース内の)特定のビュー・オブジェクト属性の名前。
rowkey: (オプション)行を一意に識別するために使用する行識別子のテキスト・エンコーディング。
whereclause: (オプション)行の場所を一意に特定する問合せのWHERE句。
retrievepath: メディア・コンテンツ転送コンポーネントのカスタム取得パス。デフォルト値はordPlayMedia.jsp
です。
例 1
<jbo:MediaUrl id="urlBuilder" datasource="ds" mediaattr="Photo" whereclause="id = 15" >
<IMG SRC="<%= urlBuilder.getOrdDomainURL() %>" ALT="vacation photo.">
</jbo:MediaUrl>
HTML出力
<IMG SRC="[mediaFetchingURL]" ALT="vacation photo.">
例 2
<jbo:RowsetIterate datasource="ds">
<jbo:MediaUrl id="builder" datasource="ds" mediaattr="Image" >
<IMG SRC="<%= builder.getOrdDomainURL() %>"
<% if(builder.getWidth()>0 && builder.getHeight()>0) { %>
HEIGHT="<%= builder.getHeight() %>"
WIDTH="<%= builder.getWidth() %>"
<% } %>
ALT="my cat">
</jbo:MediaUrl>
</jbo:RowsetIterate>
HTML出力
<IMG SRC="[mediaFetchingURL]" HEIGHT="[nn]" WIDTH="[nn]" ALT="my cat">
<IMG SRC="[mediaFetchingURL]" HEIGHT="[nn]" WIDTH="[nn]" ALT="my cat">
<IMG SRC="[mediaFetchingURL]" HEIGHT="[nn]" WIDTH="[nn]" ALT="my cat">
Copyright © 1997, 2006, Oracle. All rights reserved.