PayPal BuyNow コンポーネントの使用方法

Jayashri Visvanathan 氏によって作成された BuyNow JSF コンポーネントは、PayPal の BuyNow ボタン機能をラップしているため、簡単に再利用できます。このボタンにより、JavaServer Faces ページを使用できる Web サイト上で、個々の品目を販売できます。 JSF コンポーネントで BuyNow ボタンをラップする最大の利点は、さまざまなコンポーネント属性を管理対象 Bean 内のプロパティーにバインドすることによって、コンポーネント属性を動的に設定できることです。 特に、Web サイトで何百もの品目を販売する場合に、かなりの時間を節約できます。 BuyNow コンポーネント用のタグライブラリには、次の宣言を使用してアクセスできます。
   <%@taglib prefix="ui" uri="http://java.sun.com/blueprints/ui/14"%>
BuyNow コンポーネントは、購入者が非表示のフォームフィールドを介して注文する品目の情報を PayPal に送信する、form HMTL 要素を表示します。 このため、JSP ページ上でこのコンポーネントを使用している場合、このコンポーネントを form 要素内に置いてはいけません。 取引を完了する時に PayPal に送信する基本的な情報はすべて、BuyNow コンポーネントのプロパティーとしてサポートされています。 BuyNow コンポーネントの属性でサポートされている情報以外に PayPal に送信する追加情報がある場合は、BuyNow コンポーネントの postData 属性を使用できます。 postData 属性は、「com.sun.j2ee.blueprints.ui.shopping.BuyNowPostData」型 JavaBean として評価される ValueBinding 式を受け付けます。 この Bean は、取引を完了するために任意で PayPal に送信するすべての属性をサポートします。

デフォルトでは、BuyNow コンポーネントは PayPal サンドボックスに送信します。 サンドボックスは実際の PayPal サイトのミラーであり、実際の金銭取引は行われません。Web サイトからの支払いなど、PayPal の機能をテストするために使用される安全なテスト環境です。 Web サイトが運営可能になり、パブリックドメインでホスティングされる準備が完了するまで、このモードで運用できます。

デフォルトでは、ボタン画像は PayPal サイトから読み込まれます。 このデフォルトの動作を無効にする場合は、「image」属性を設定して別の画像を読み込むことができます。 テストモードまたは本稼働モードのどちらでも、アプリケーションをテストする場合は、PayPal Payment サービスへの接続が開始されるため、インターネットに接続する必要があります。

BuyNow JSF コンポーネントの使用例を次に示します。
  <ui:buyNow business="donate@animalfoundation.com" id="buyNow1" itemName="Buy Item One"
amount="100.00" quantity="1" type="BuyNow" postData="#{PayPalBean.postData}" target="paypal"/>

JSP タグ属性

BuyNow コンポーネントは、標準の JSF CommandButton の固有の属性に加えて次の属性をサポートしています。括弧内は、対応する PayPal 属性の名前です。

BuyNowPostData Bean のプロパティー

BuyNowPostData Bean は次のプロパティーをサポートしています。括弧内は、対応する PayPal 属性の名前です。

既知の制限事項

参考資料


© Sun Microsystems 2006. Java BluePrints Solutions Catalog の内容はすべて著作権保護されており、サン・マイクロシステムズ社の書面による許可なしに他の著作物に発表することを禁止します。