ファイル・アップロードの構成

Web UI フレームワークでファイルをアップロードするためのフィールドを作成するには、ファイル・アップロード・ウィジェットを使用します。これは、Ext JS の textfield コントロールの拡張機能です。

以下のグラフィックに、Ext JS を使用して作成されたファイル・アップロード・コントロールの例 (Attach Photo コントロール) を示します。 Web ブラウザーでは、入力フィールドがファイルとして使用されます。 以下のグラフィックに、「参照」ボタンを含むテキスト・フィールドを示します。 「参照」をクリックすると、ファイル選択ダイアログ・ボックスが開きます。 ダイアログ・ボックスはオペレーティング・システムに固有であり、カスタマイズできません。

また、ファイル・アップロードを構成するには、yfs.properties で以下のプロパティーを調整する必要があります。

• sc.file.upload.maxfilesize プロパティーおよび sc.file.upload.maxfilesize.table_name プロパティーは、アップロード可能なファイルのサイズを指定するために使用します。

  sc.file.upload.allowedfiletypes プロパティーおよび sc.file.upload.allowedfiletypes.table_name プロパティーは、アップロード可能なファイルのタイプを指定するために使用します。

• sc.file.upload.dir プロパティーは、アップロードされたファイルを一時的に保持するディレクトリーを指定するために使用します。
• sc.file.upload.type プロパティーは、ファイルをサーバーにアップロードする時期を決定するために使用します。

{{{
   <filter-mapping>
          <filter-name>struts</filter-name>
          <url-pattern>*.do</url-pattern>
   </filter-mapping>
   <filter-mapping>
          <filter-name>struts-cleanup</filter-name>
          <url-pattern>*.do</url-pattern>
   </filter-mapping>
}}}

• ファイルがサーバーに正常に送信された後、ファイル情報 (固有のファイル ID、ファイルの場所、ウィジェット ID など) を含む FileAttachments エレメントが、アップロードに使用される画面のデータ・オブジェクトに追加されます。 ファイル情報をデータベースに送信するための実際の API 呼び出しは、この入力で行われます。

  以下は、情報を追加した後のサンプル・データ・モデルの変更を示しています。

  {User : { 
        UserId : "user1",
        attachFile : "user1_1267599880675_1"
     }
  FileAttachments : {
       FileAttachment :
         {
          file_id : "user1_1267599880675_1",
          file_path : "att2.bmp",
          Element_ID : "ext-comp-1037"
         }
      }   
  }

ファイルがサーバー上の一時的な場所から削除されると、イベントが呼び出されます。

         +
                   /**
                    * @param file is an existing file which has to be deleted
                    * from temporary location of the server. This method
                    * implementation gets called only when file exists
                    * on the server location. 
                    * @return true if the file delete is successful, false otherwise.
                    */
                    boolean deleteFile(File file);