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;
+   }
+}

source/java/org/alfresco/web/ui/repo/converter/CharsetConverter.java

@@ -0,0 +1,79 @@
+/*
+ * 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.converter;
+
+import java.nio.charset.Charset;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+import javax.faces.convert.Converter;
+
+import org.alfresco.i18n.I18NUtil;
+
+/**
+ * Converter class to convert a Charset to a String
+ * 
+ * @since 2.1
+ * @author Derek Hulley
+ */
+public class CharsetConverter implements Converter
+{
+   /**
+    * <p>The standard converter id for this converter.</p>
+    */
+   public static final String CONVERTER_ID = "org.alfresco.faces.CharsetConverter";
+
+   /**
+    * {@inheritDoc}
+    */
+   public Object getAsObject(FacesContext context, UIComponent component, String value)
+   {
+      return value;
+   }
+
+   /**
+    * {@inheritDoc}
+    */
+   public String getAsString(FacesContext context, UIComponent component, Object value)
+   {
+      if (value == null)
+      {
+         throw new IllegalArgumentException(I18NUtil.getMessage("error_charset_null"));
+      }
+      
+      String result = null;
+      
+      if (value instanceof Charset)
+      {
+         result = ((Charset)value).name();
+      }
+      else if (value != null)
+      {
+         result = value.toString();
+      }
+      
+      return result;
+   }
+}

source/java/org/alfresco/web/ui/repo/converter/MimeTypeConverter.java

@@ -32,7 +32,7 @@ import org.alfresco.service.cmr.repository.MimetypeService;
 import org.alfresco.web.bean.repository.Repository;
 
 /**
- * Converter class to convert an XML date representation into a Date
+ * Converter class to convert a MIME type to an appropriate display name
  * 
  * @author gavinc
  */

source/java/org/alfresco/web/ui/repo/tag/CharsetSelectorTag.java

@@ -0,0 +1,96 @@
+/*
+ * 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.tag;
+
+import javax.faces.component.UIComponent;
+
+import org.alfresco.web.ui.common.ComponentConstants;
+import org.alfresco.web.ui.common.tag.HtmlComponentTag;
+import org.alfresco.web.ui.repo.component.UICharsetSelector;
+
+/**
+ * Tag class for the Charset selector component
+ * 
+ * @since 2.1
+ * @author Derek Hulley
+ */
+public class CharsetSelectorTag extends HtmlComponentTag
+{
+   /** The value */
+   private String value;
+   
+   /** Whether the component is disabled */
+   private String disabled;
+   
+   @Override
+   public String getComponentType()
+   {
+      return UICharsetSelector.COMPONENT_TYPE;
+   }
+
+   @Override
+   public String getRendererType()
+   {
+      return ComponentConstants.JAVAX_FACES_MENU;
+   }
+   
+   @Override
+   protected void setProperties(UIComponent component)
+   {
+      super.setProperties(component);
+      
+      setStringBindingProperty(component, "value", this.value);
+      setBooleanProperty(component, "disabled", this.disabled);
+   }
+   
+   @Override
+   public void release()
+   {
+      super.release();
+      
+      this.value = null;
+      this.disabled = null;
+   }
+   
+   /**
+    * Set the value
+    *
+    * @param value     the value
+    */
+   public void setValue(String value)
+   {
+      this.value = value;
+   }
+   
+   /**
+    * Sets whether the component should be rendered in a disabled state
+    * 
+    * @param disabled true to render the component in a disabled state
+    */
+   public void setDisabled(String disabled)
+   {
+      this.disabled = disabled;
+   }
+}