KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > jboss > virtual > plugins > vfs > helpers > PathTokenizer


1 /*
2 * JBoss, Home of Professional Open Source
3 * Copyright 2006, JBoss Inc., and individual contributors as indicated
4 * by the @authors tag. See the copyright.txt in the distribution for a
5 * full listing of individual contributors.
6 *
7 * This is free software; you can redistribute it and/or modify it
8 * under the terms of the GNU Lesser General Public License as
9 * published by the Free Software Foundation; either version 2.1 of
10 * the License, or (at your option) any later version.
11 *
12 * This software is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this software; if not, write to the Free
19 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
21 */

22 package org.jboss.virtual.plugins.vfs.helpers;
23
24 import java.util.StringTokenizer JavaDoc;
25
26 /**
27  * PathTokenizer.
28  *
29  * @author <a HREF="adrian@jboss.com">Adrian Brock</a>
30  * @version $Revision: 1.1 $
31  */

32 public class PathTokenizer
33 {
34    /**
35     * Utility class
36     */

37    private PathTokenizer()
38    {
39    }
40    
41    /**
42     * Get the tokens
43     *
44     * @param path the path
45     * @return the tokens or null if the path is empty
46     * @throws IllegalArgumentException if the path is null, it is empty or it is a relative path
47     */

48    public static String JavaDoc[] getTokens(String JavaDoc path)
49    {
50       if (path == null)
51          throw new IllegalArgumentException JavaDoc("Null path");
52
53       StringTokenizer JavaDoc tokenizer = new StringTokenizer JavaDoc(path, "/");
54       int count = tokenizer.countTokens();
55       if (count == 0)
56          return null;
57
58       String JavaDoc[] tokens = new String JavaDoc[count];
59       int i = 0;
60       while (tokenizer.hasMoreTokens())
61       {
62          String JavaDoc token = tokenizer.nextToken();
63
64          if (token.equals(""))
65             throw new IllegalArgumentException JavaDoc("A path element is empty: " + path);
66          if (token.equals(".") || token.equals(".."))
67             throw new IllegalArgumentException JavaDoc("Reverse paths are not allowed (containing a . or ..), use getParent(): " + path);
68
69          tokens[i++] = token;
70       }
71       return tokens;
72    }
73    
74    /**
75     * Get the remaining path from some tokens
76     *
77     * @param tokens the tokens
78     * @param i the current location
79     * @return the remaining path
80     * @throws IllegalArgumentException for null tokens or i is out of range
81     */

82    public static String JavaDoc getRemainingPath(String JavaDoc[] tokens, int i)
83    {
84       if (tokens == null)
85          throw new IllegalArgumentException JavaDoc("Null tokens");
86       if (i < 0 || i >= tokens.length)
87          throw new IllegalArgumentException JavaDoc("i is not in the range of tokens: 0" + (tokens.length-1));
88       
89       if (i == tokens.length-1)
90          return tokens[tokens.length-1];
91       
92       StringBuilder JavaDoc buffer = new StringBuilder JavaDoc();
93       for (; i < tokens.length-1; ++i)
94       {
95          buffer.append(tokens[i]);
96          buffer.append("/");
97       }
98       buffer.append(tokens[tokens.length-1]);
99       return buffer.toString();
100    }
101 }
102
Popular Tags