Add IOUtils.toString(URL) and IOUtils.toString(URL, String)

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/io/trunk@1091652 13f79535-47bb-0310-9956-ffa450edef68

Author: garydgregory

src/main/java/org/apache/commons/io/IOUtils.java

@@ -32,6 +32,7 @@
 import java.io.Reader;
 import java.io.Writer;
 import java.net.Socket;
+import java.net.URL;
 import java.util.ArrayList;
 import java.util.Collection;
 import java.util.List;
@@ -601,6 +602,37 @@ public static String toString(Reader input) throws IOException {
         return sw.toString();
     }
 
+    /**
+     * Gets the contents at the given URL.
+     * 
+     * @param url
+     *            The URL source.
+     * @return The contents of the URL as a String.
+     * @throws IOException if an I/O exception occurs.
+     */
+    public static String toString(URL url) throws IOException {
+        return toString(url, null);
+    }
+
+    /**
+     * Gets the contents at the given URL.
+     * 
+     * @param url
+     *            The URL source.
+     * @param encoding
+     *            The encoding name for the URL contents.
+     * @return The contents of the URL as a String.
+     * @throws IOException if an I/O exception occurs.
+     */
+    public static String toString(URL url, String encoding) throws IOException {
+        InputStream inputStream = url.openStream();
+        try {
+            return toString(inputStream, encoding);
+        } finally {
+            inputStream.close();
+        }
+    }
+
     /**
      * Get the contents of a <code>byte[]</code> as a String
      * using the default character encoding of the platform.

src/test/java/org/apache/commons/io/IOUtilsTestCase.java

@@ -27,6 +27,7 @@
 import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.io.Reader;
+import java.net.URL;
 import java.util.Arrays;
 import java.util.List;
 
@@ -137,17 +138,17 @@ public void testInputStreamToString()
     }
 
     public void testReaderToString()
-        throws Exception
-    {
-        FileReader fin = new FileReader( m_testFile );
-        try {
-            String out = IOUtils.toString( fin );
-            assertNotNull( out );
-            assertEquals( "Wrong output size", FILE_SIZE, out.length());
-        } finally {
-            fin.close();
+            throws Exception
+        {
+            FileReader fin = new FileReader( m_testFile );
+            try {
+                String out = IOUtils.toString( fin );
+                assertNotNull( out );
+                assertEquals( "Wrong output size", FILE_SIZE, out.length());
+            } finally {
+                fin.close();
+            }
         }
-    }
 
     @SuppressWarnings("deprecation") // testing deprecated method
     public void testStringToOutputStream()
@@ -600,4 +601,35 @@ public void testSkipFileInput() throws Exception{
             in.close();
         }
     }
+
+    private void testURLToString(String encoding)
+            throws Exception
+    {
+        URL url = m_testFile.toURI().toURL();
+        String out = IOUtils.toString(url, encoding);
+        assertNotNull(out);
+        assertEquals("Wrong output size", FILE_SIZE, out.length());
+    }
+
+    public void testURLToStringNoEncoding()
+            throws Exception
+    {
+        URL url = m_testFile.toURI().toURL();
+        String out = IOUtils.toString(url);
+        assertNotNull(out);
+        assertEquals("Wrong output size", FILE_SIZE, out.length());
+    }
+
+    public void testURLToStringNullEncoding()
+            throws Exception
+    {
+        testURLToString(null);
+    }
+
+    public void testURLToStringUsAciiEncoding()
+            throws Exception
+    {
+        testURLToString("US-ASCII");
+    }
+
 }