KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > commons > jrcs > util > ToString


1 /*
2  * ====================================================================
3  *
4  * The Apache Software License, Version 1.1
5  *
6  * Copyright (c) 1999-2003 The Apache Software Foundation.
7  * All rights reserved.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  *
13  * 1. Redistributions of source code must retain the above copyright
14  * notice, this list of conditions and the following disclaimer.
15  *
16  * 2. Redistributions in binary form must reproduce the above copyright
17  * notice, this list of conditions and the following disclaimer in
18  * the documentation and/or other materials provided with the
19  * distribution.
20  *
21  * 3. The end-user documentation included with the redistribution, if
22  * any, must include the following acknowledgement:
23  * "This product includes software developed by the
24  * Apache Software Foundation (http://www.apache.org/)."
25  * Alternately, this acknowledgement may appear in the software itself,
26  * if and wherever such third-party acknowledgements normally appear.
27  *
28  * 4. The names "The Jakarta Project", "Commons", and "Apache Software
29  * Foundation" must not be used to endorse or promote products derived
30  * from this software without prior written permission. For written
31  * permission, please contact apache@apache.org.
32  *
33  * 5. Products derived from this software may not be called "Apache"
34  * nor may "Apache" appear in their names without prior written
35  * permission of the Apache Software Foundation.
36  *
37  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
38  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
39  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
40  * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
41  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
42  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
43  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
44  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
45  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
46  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
47  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
48  * SUCH DAMAGE.
49  * ====================================================================
50  *
51  * This software consists of voluntary contributions made by many
52  * individuals on behalf of the Apache Software Foundation. For more
53  * information on the Apache Software Foundation, please see
54  * <http://www.apache.org/>.
55  *
56  */
57
58 package org.apache.commons.jrcs.util;
59
60 import java.io.BufferedReader JavaDoc;
61 import java.io.StringReader JavaDoc;
62 import java.util.List JavaDoc;
63 import java.util.LinkedList JavaDoc;
64
65 /**
66  * This class delegates handling of the to a StringBuffer based version.
67  *
68  * @version $Revision: 1.2 $ $Date: 2005/06/16 18:11:13 $
69  * @author <a HREF="mailto:juanco@suigeneris.org">Juanco Anez</a>
70  */
71 public class ToString
72 {
73     public ToString()
74     {
75         // do nothing
76 }
77
78     /**
79      * Default implementation of the
80      * {@link java.lang.Object#toString toString() } method that
81      * delegates work to a {@link java.lang.StringBuffer StringBuffer}
82      * base version.
83      */
84     public String JavaDoc toString()
85     {
86         StringBuffer JavaDoc s = new StringBuffer JavaDoc();
87         toString(s);
88         return s.toString();
89     }
90
91     /**
92      * Place a string image of the object in a StringBuffer.
93      * @param s the string buffer.
94      */
95     public void toString(StringBuffer JavaDoc s)
96     {
97             s.append(super.toString());
98     }
99
100
101
102     /**
103      * Breaks a string into an array of strings.
104      * Use the value of the <code>line.separator</code> system property
105      * as the linebreak character.
106      * @param value the string to convert.
107      */
108     public static String JavaDoc[] stringToArray(String JavaDoc value)
109     {
110         BufferedReader JavaDoc reader = new BufferedReader JavaDoc(new StringReader JavaDoc(value));
111         List JavaDoc l = new LinkedList JavaDoc();
112         String JavaDoc s;
113         try
114         {
115             while ((s = reader.readLine()) != null)
116             {
117                 l.add(s);
118             }
119         }
120         catch (java.io.IOException JavaDoc e)
121         {
122             // do nothing
123 }
124         return (String JavaDoc[]) l.toArray(new String JavaDoc[l.size()]);
125     }
126
127     /**
128      * Converts an array of {@link Object Object} to a string
129      * Use the value of the <code>line.separator</code> system property
130      * the line separator.
131      * @param o the array of objects.
132      */
133     public static String JavaDoc arrayToString(Object JavaDoc[] o)
134     {
135         return arrayToString(o, System.getProperty("line.separator"));
136     }
137
138     /**
139      * Converts an array of {@link Object Object} to a string
140      * using the given line separator.
141      * @param o the array of objects.
142      * @param EOL the string to use as line separator.
143      */
144     public static String JavaDoc arrayToString(Object JavaDoc[] o, String JavaDoc EOL)
145     {
146         StringBuffer JavaDoc buf = new StringBuffer JavaDoc();
147         for (int i = 0; i < o.length - 1; i++)
148         {
149             buf.append(o[i]);
150             buf.append(EOL);
151         }
152         buf.append(o[o.length - 1]);
153         return buf.toString();
154     }
155 }
156
157
Popular Tags