Coverage Report - org.melati.util.UTF8URLEncoder
 
Classes in this File Line Coverage Branch Coverage Complexity
UTF8URLEncoder
80%
12/15
N/A
1.8
 
 1  
 /*
 2  
  * $Source$
 3  
  * $Revision$
 4  
  *
 5  
  * Copyright (C) 2005 Tim Pizey
 6  
  *
 7  
  * Part of Melati (http://melati.org), a framework for the rapid
 8  
  * development of clean, maintainable web applications.
 9  
  *
 10  
  * Melati is free software; Permission is granted to copy, distribute
 11  
  * and/or modify this software under the terms either:
 12  
  *
 13  
  * a) the GNU General Public License as published by the Free Software
 14  
  *    Foundation; either version 2 of the License, or (at your option)
 15  
  *    any later version,
 16  
  *
 17  
  *    or
 18  
  *
 19  
  * b) any version of the Melati Software License, as published
 20  
  *    at http://melati.org
 21  
  *
 22  
  * You should have received a copy of the GNU General Public License and
 23  
  * the Melati Software License along with this program;
 24  
  * if not, write to the Free Software Foundation, Inc.,
 25  
  * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA to obtain the
 26  
  * GNU General Public License and visit http://melati.org to obtain the
 27  
  * Melati Software License.
 28  
  *
 29  
  * Feel free to contact the Developers of Melati (http://melati.org),
 30  
  * if you would like to work out a different arrangement than the options
 31  
  * outlined here.  It is our intention to allow Melati to be used by as
 32  
  * wide an audience as possible.
 33  
  *
 34  
  * This program is distributed in the hope that it will be useful,
 35  
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
 36  
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 37  
  * GNU General Public License for more details.
 38  
  *
 39  
  * Contact details for copyright holder:
 40  
  *
 41  
  *     Tim Pizey <timp At paneris.org>
 42  
  *     http://paneris.org/~timp
 43  
  */
 44  
 package org.melati.util;
 45  
 
 46  
 import java.io.UnsupportedEncodingException;
 47  
 import java.net.URLEncoder;
 48  
 import java.net.URLDecoder;
 49  
 
 50  
 import org.melati.Melati;
 51  
 
 52  
 /**
 53  
  * A utility class to work around need for catch block.
 54  
  */
 55  
 public final class UTF8URLEncoder {
 56  
   
 57  0
   private UTF8URLEncoder() {}
 58  
 
 59  
   /**
 60  
    * Encode with default encoding.
 61  
    * @param s the String to encode
 62  
    * @return the encoded String
 63  
    */
 64  
   public static String encode(String s) {
 65  909
     return encode(s, Melati.DEFAULT_ENCODING);
 66  
   }
 67  
 
 68  
   /**
 69  
    * Encode with an encoding.
 70  
    * @param s the String to encode
 71  
    * @param encoding the character encoding to use 
 72  
    * @return the encoded String
 73  
    */
 74  
   public static String encode(String s, String encoding) {
 75  3720
     String encoded = null;
 76  
     try {
 77  3720
       encoded = URLEncoder.encode(s, encoding);
 78  1
     } catch (UnsupportedEncodingException e) {
 79  1
       throw new UnexpectedExceptionException(e);
 80  3719
     }
 81  3719
     return encoded;
 82  
   }
 83  
 
 84  
   /**
 85  
    * Decode using default character encoding.
 86  
    * @param s the String to decode
 87  
    * @return the decoded String
 88  
    */
 89  
   public static String decode(String s) {
 90  10
     return decode(s, Melati.DEFAULT_ENCODING);
 91  
   }
 92  
   
 93  
   /**
 94  
    * Decode with an encoding.
 95  
    * @param s the String to decode
 96  
    * @param encoding the character encoding to use 
 97  
    * @return the decoded String
 98  
    */
 99  
   public static String decode(String s, String encoding) {
 100  13
     String decoded = null;
 101  
     try {
 102  13
       decoded = URLDecoder.decode(s, encoding);
 103  0
     } catch (UnsupportedEncodingException e) {
 104  0
       throw new UnexpectedExceptionException(e);
 105  13
     }
 106  13
     return decoded;
 107  
   }
 108  
   
 109  
 }