Partial fix for AWC-999: Content upload guesses character encoding and offers the user the chance to change it.

TODO: Fix the "Modify Content Properties" to include the encoding as a changeable option.

Modified other entry points of content into the system.  All calls to ContentWriter.setEncoding("UTF-8") need some serious examination.
It is no longer necessary to assume anything about the encoding.  The worst case scenario is that we guess the encoding from the stream
without giving the user the chance to change it.  This works for most non-interactive scenarios like CIFS, WebDAV and FTP, now.


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@6113 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/web/ui/repo/component/UICharsetSelector.java

@@ -0,0 +1,87 @@
+/*
+ * Copyright (C) 2005-2007 Alfresco Software Limited.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+
+ * As a special exception to the terms and conditions of version 2.0 of 
+ * the GPL, you may redistribute this Program in connection with Free/Libre 
+ * and Open Source Software ("FLOSS") applications as described in Alfresco's 
+ * FLOSS exception.  You should have recieved a copy of the text describing 
+ * the FLOSS exception, and it is also available here: 
+ * http://www.alfresco.com/legal/licensing"
+ */
+package org.alfresco.web.ui.repo.component;
+
+import java.io.IOException;
+import java.nio.charset.Charset;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
+import javax.faces.component.UISelectItems;
+import javax.faces.component.UISelectOne;
+import javax.faces.context.FacesContext;
+import javax.faces.model.SelectItem;
+
+/**
+ * Component that holds a list of characterset encodings supported by the repository.
+ * 
+ * @since 2.1
+ * @author Derek Hulley
+ */
+public class UICharsetSelector extends UISelectOne
+{
+   public static final String COMPONENT_TYPE = "org.alfresco.faces.CharsetSelector";
+   public static final String COMPONENT_FAMILY = "javax.faces.SelectOne";
+   
+   @Override
+   @SuppressWarnings("unchecked")
+   public void encodeBegin(FacesContext context) throws IOException
+   {
+      // if the component does not have any children yet create the
+      // list of Charsets the user can choose from as a child 
+      // SelectItems component.
+      if (getChildren().size() == 0)
+      {
+         UISelectItems items = (UISelectItems)context.getApplication().createComponent("javax.faces.SelectItems");
+         items.setId(this.getId() + "_items");
+         items.setValue(createList());
+         
+         // add the child component
+         getChildren().add(items);
+      }
+      
+      // do the default processing
+      super.encodeBegin(context);
+   }
+
+   /**
+    * Creates the list of SelectItem components to represent the list
+    * of Charsets the user can select from
+    * 
+    * @return List of SelectItem components
+    */
+   protected List<SelectItem> createList()
+   {
+      Map<String, Charset> availableCharsets = Charset.availableCharsets();
+      List<SelectItem> items = new ArrayList<SelectItem>(availableCharsets.size());
+      for (Charset charset : availableCharsets.values())
+      {
+         SelectItem item = new SelectItem(charset.name(), charset.displayName());
+         items.add(item);
+      }
+      return items;
+   }
+}