[richfaces-svn-commits] JBoss Rich Faces SVN: r13873 - in trunk/docs/realworld_app_guide/en/src/main/docbook: includes and 1 other directory.

[richfaces-svn-commits at lists.jboss.org]

Author: artdaw
Date: 2009-04-25 11:56:51 -0400 (Sat, 25 Apr 2009)
New Revision: 13873

Modified:
   trunk/docs/realworld_app_guide/en/src/main/docbook/includes/hiw.xml
   trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml
Log:
https://jira.jboss.org/jira/browse/RF-5768 - Photo Album review

Modified: trunk/docs/realworld_app_guide/en/src/main/docbook/includes/hiw.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/includes/hiw.xml	2009-04-25 15:08:12 UTC (rev 13872)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/includes/hiw.xml	2009-04-25 15:56:51 UTC (rev 13873)
@@ -1,90 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<section>
-            <title>Upload images</title>
-            <para>The implementation of <emphasis role="bold"><property>&lt;rich:fileUpload&gt;</property></emphasis> in the Photo Album Demo uses the embedded Flash module that adds extra functionality to the component. 
-                  Here are the additional features that the Flash module provides:
-            </para>
-            <itemizedlist>
-                  <listitem><para>Multiple files choosing;</para></listitem>
-                  <listitem><para>Specification of permitted file types in the &quot;Open File&quot; dialog window;</para></listitem>
-                  <listitem><para>A number of additional entry object properties.</para></listitem>
-            </itemizedlist>
-            
-            <para>
-                  The photos uploading functionality is based on the <code>/includes/fileUpload/fileUploader.xhtml page</code>. Let's have a look at this page to find out how the uploader is implemented:   
-            </para>
-            
-            <programlisting role="XML"><![CDATA[<rich:fileUpload style="margin : 0px 0px 20px 0px; width : 504px; height : 200px; background : #f1f1f1; border : 1px solid #A1A1A1"
-		id="fileUpload"
-		allowFlash="true" 
-		immediateUpload="false" 
-		acceptedTypes="jpg,jpeg"
-		maxFilesQuantity="100" 
-		autoclear="true"
-		fileUploadListener="#{fileUploadManager.listener}" >
-	<a4j:support event="onuploadcomplete" reRender="filesPanel, tree" />
-	<a4j:support event="onfileuploadcomplete" />
-	</rich:fileUpload>]]></programlisting>
-            
-            <para>
-                  The &quot;<emphasis><property>FileUploadListener</property></emphasis>&quot; attribute is binded with <code>fileUploadManager.listener</code> method which makes the main job on the upload. 
-                  Below is the <code>fileUploadManager.listener</code> method:
-            </para>
-            <programlisting role="JAVA"><![CDATA[public void listener(UploadEvent event) throws Exception {
-      UploadItem item = event.getUploadItem();
-      Image image = constructImage(item);
-      try {
-            extractMetadata(item, image);
-      } catch (Exception e1) {
-            addError(item, image, Constants.FILE_PROCESSING_ERROR);
-            return;
-      }
-      image.setAlbum(model.getSelectedAlbum());
-      if(image.getAlbum() == null){
-            addError(item, image, Constants.NO_ALBUM_TO_DOWNLOAD_ERROR);
-            return;
-      }
-      try{
-            if(imageAction.isImageWithThisPathExist(image)){
-                  image.setPath(generateNewPath(image.getPath()));
-            }
-            imageAction.addImage(image);
-      }catch(Exception e){
-            addError(item, image, Constants.IMAGE_SAVING_ERROR);
-            return;
-      }
-      if(!fileManager.addImage(image.getFullPath(), item.getFile().getPath())){
-            addError(item, image, Constants.FILE_SAVE_ERROR);
-                  return;
-      }
-      fileWrapper.getFiles().add(image);
-      Events.instance().raiseEvent(Constants.IMAGE_ADDED_EVENT, image);
-      item.getFile().delete();
-}]]></programlisting>
-            
-<para>
-      When a photo is added into the uploader, the first thing it does is saving this photo in the file system. 
-      The uploaded files are stored in the temporary folder in the computer file system. 
-      For this purpose  the value of the <code>createTempFile</code> parameter in <code>Ajax4jsf Filter</code> section should be set to <code>true</code>. 
-      Below in the <code>Web.xml</code> file Ajax filter section:
-</para>
 
-            <programlisting role="XML"><![CDATA[...
-<init-param>
-      <param-name>createTempFiles</param-name>
-      <param-value>true</param-value>
-</init-param>
-...]]></programlisting>
-       
-       <para>
-             Then the uploader creates an <code>Image</code> object and extracts all image metadata such as Camera name, Image size etc. 
-             Then it sets an album and generates a new path to it. 
-             The system should save six different sizes of the photo. 
-             After the photo was added into the database the system removes a temporary file created for storage.
-       </para>
-            
-            
-      </section>
       
       <section>
             <title>Slide show</title>

Modified: trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml	2009-04-25 15:08:12 UTC (rev 13872)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml	2009-04-25 15:56:51 UTC (rev 13873)
@@ -9,6 +9,7 @@
 	
     <!ENTITY usedComponents SYSTEM "includes/usedComponents.xml">
 	<!ENTITY navigationPanel SYSTEM "includes/navigationPanel.xml">
+	<!ENTITY uploadImages SYSTEM "includes/uploadImages.xml">
 	<!ENTITY hiw SYSTEM "includes/hiw.xml">
 ]>
 
@@ -63,6 +64,7 @@
       		  <?forseChanks?>
 				  &usedComponents;
 				  &navigationPanel;
+				  &uploadImages;
 				  &hiw;
 			</chapter>