OracleデータベースにinterMediaオブジェクトとして格納されたイメージ・コンテンツを表示するHTML IMGタグを挿入します。
JSP構文
<jbo:EmbedImage
datasource="datasourceInstanceName"
mediaattr="mediaAttributeName"
[[ rowkey="rowKeyString" ] | [ whereclause="whereClause" ]]
[ retrievepath="customRetrievePath" ]
[ width="imageWidth" ]
[ height="imageHeight" ]
[ border="borderPixel" ]
[ align="alignOption" ]
[[ alt="alternateText" ] | [ altattr="alternateAttributeName" ]]
[ longdesc="longDescription" ]
/>
説明
<jbo:EmbedImage>
データ・タグを使用すると、HTML IMGタグを組み込んで、データベースにinterMediaオブジェクトとして格納されたイメージ・コンテンツを表示できます。
このタグは、<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ページです。独自のメディア配信コンポーネントを記述し、こうした要件が生じた場合に独自の検索パスを指定できます。
属性
datasource: interMediaオブジェクトへのアクセスに使用するデータ・ソースid。データ・ソースは<jbo:DataSource>
データ・タグを使用して作成します。
mediaattr: interMediaオブジェクトを含む特定のビュー・オブジェクト属性(データ・ソース内)の名前。
rowkey: (オプション)行を一意に識別するために使用する行識別子のテキスト・エンコーディング。
whereclause: (オプション)行の場所を一意に特定する問合せのWHERE句。
retrievepath: メディア・コンテンツ転送コンポーネントのカスタム取得パス。デフォルト値はordPlayMedia.jsp
です。
width: オプション。表示されるイメージの幅。この属性を指定しない場合、<jbo:EmbedImage>
データ・タグは、イメージ・コンテンツからinterMediaによって解析される実際の幅を使用しようとします。interMediaがイメージを解析できない場合、width
属性は設定されません。
height: オプション。表示されるイメージの高さ。この属性を指定しない場合、<jbo:EmbedImage>
データ・タグは、イメージ・コンテンツからinterMediaによって解析される実際の高さを使用しようとします。interMediaがイメージを解析できない場合、height
属性は設定されません。
border: オプション。枠線のピクセル数。この使用方法は、HTML IMGタグのBORDER属性と同じです。
align: オプション。位置合せオプション。この使用方法は、HTML IMGタグのALIGN属性と同じです。
alt: オプション。イメージの代替テキスト。altattr
属性が指定されている場合、この属性は使用できません。
altattr: オプション。代替テキストを含む属性の名前。alt
属性が指定されている場合、この属性は使用できません。
longdesc: オプション。イメージの長い説明。この使用方法は、HTML IMGタグのLONGDESC属性と同じです。
例 1
<jbo:EmbedImage datasource="ds" mediaattr="Pic" whereclause="id = 2" alt="family reunion picture" />
HTML出力
<IMG SRC="[mediaFetchingURL]" ALT="family reunion picture" WIDTH="400" HEIGHT="350">
例 2
<jbo:RowsetNavigate datasource="ds" action="First" />
<jbo:EmbedImage datasource="ds" mediaattr="Pic" altattr="Description" border="2" width="200" height="200" />
HTML出力
<IMG SRC="[mediaFetchingURL]" ALT="[description text]" BORDER="2" WIDTH="200" HEIGHT="200">
Copyright © 1997, 2007, Oracle. All rights reserved.