ビジネス・コンポーネントinterMediaタグ - <jbo:MediaUrl>

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ページです。必要に応じて、独自のメディア配信コンポーネントを作成し、独自の検索パスを指定できます。

属性

例 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">