KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > net > jforum > util > URLNormalizer


1 /*
2  * Copyright (c) Rafael Steil
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms,
6  * with or without modification, are permitted provided
7  * that the following conditions are met:
8  *
9  * 1) Redistributions of source code must retain the above
10  * copyright notice, this list of conditions and the
11  * following disclaimer.
12  * 2) Redistributions in binary form must reproduce the
13  * above copyright notice, this list of conditions and
14  * the following disclaimer in the documentation and/or
15  * other materials provided with the distribution.
16  * 3) Neither the name of "Rafael Steil" nor
17  * the names of its contributors may be used to endorse
18  * or promote products derived from this software without
19  * specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT
22  * HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
23  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
24  * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
25  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR
26  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
27  * THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
28  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
29  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES
30  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
32  * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
33  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
34  * IN CONTRACT, STRICT LIABILITY, OR TORT
35  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
36  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
37  * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE
38  *
39  * Created on 11/07/2005 00:32:01
40  * The JForum Project
41  * http://www.jforum.net
42  */
43 package net.jforum.util;
44
45 /**
46  * Normalizes an URL.
47  * Normalization means replacing blank spaces by underlines,
48  * changing special chars by its regular form and etc.
49  * @author Rafael Steil
50  * @version $Id: URLNormalizer.java,v 1.3 2005/07/26 03:05:22 rafaelsteil Exp $
51  */
52 public class URLNormalizer
53 {
54     public static final int LIMIT = 30;
55     
56     /**
57      * Normalizes an URL.
58      * The url will be truncated at {@link #LIMIT} chars
59      * @param url the url to normalize
60      * @return the normalized url
61      * @see #normalize(String, int, boolean)
62      */
63     public static String JavaDoc normalize(String JavaDoc url)
64     {
65         return normalize(url, LIMIT, true);
66     }
67     
68     /**
69      *
70      * @param url the url to normalize
71      * @param limit do not process more than <code>limit + 1</code> chars
72      * @param friendlyTruncate If <code>true</code>, will try to not cut a word if
73      * more than <code>limit</code> chars were processed. It will stop in the next
74      * special char
75      * @return the normalized url
76      */
77     public static String JavaDoc normalize(String JavaDoc url, int limit, boolean friendlyTruncate)
78     {
79         char[] chars = url.toCharArray();
80         
81         StringBuffer JavaDoc sb = new StringBuffer JavaDoc(url.length());
82         
83         for (int i = 0; i < chars.length; i++) {
84             if (i <= limit || (friendlyTruncate && i > limit && sb.charAt(sb.length() - 1) != '_')) {
85                 
86                 if (Character.isSpaceChar(chars[i]) || chars[i] == '-') {
87                     if (friendlyTruncate && i > limit) {
88                         break;
89                     }
90                     
91                     if (i > 0 && sb.charAt(sb.length() - 1) != '_') {
92                         sb.append('_');
93                     }
94                 }
95                 
96                 if (Character.isLetterOrDigit(chars[i])) {
97                     sb.append(chars[i]);
98                 }
99                 else if (friendlyTruncate && i > limit) {
100                     break;
101                 }
102             }
103         }
104         
105         return sb.toString().toLowerCase();
106     }
107 }
108
Popular Tags