|
|||||||||||||||||||
Source file | Conditionals | Statements | Methods | TOTAL | |||||||||||||||
IndentFilter.java | 0% | 0% | 0% | 0% |
|
1 | /* | |
2 | * Copyright (c) 2001-2004, | |
3 | * RedVerst Group, ISP RAS http://www.ispras.ru | |
4 | * All rights reserved. | |
5 | * | |
6 | * Redistribution and use in source and binary forms, with or without | |
7 | * modification, are permitted provided that the following conditions are met: | |
8 | * | |
9 | * 1. Redistributions of source code must retain the above copyright notice, this | |
10 | * list of conditions and the following disclaimer. | |
11 | * | |
12 | * 2. Redistributions in binary form must reproduce the above copyright notice, | |
13 | * this list of conditions and the following disclaimer in the documentation | |
14 | * and/or other materials provided with the distribution. | |
15 | * | |
16 | * 3. The names "ATP", "TreeDL", "RedVerst", "ISP RAS" | |
17 | * may not be used to endorse or promote products derived from this software | |
18 | * without specific prior written permission. | |
19 | * | |
20 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND | |
21 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED | |
22 | * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | |
23 | * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR | |
24 | * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
25 | * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
26 | * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON | |
27 | * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
28 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
29 | * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
30 | */ | |
31 | ||
32 | package com.unitesk.atp.text.filters; | |
33 | ||
34 | import java.util.Stack; | |
35 | ||
36 | /** | |
37 | * This filter manages indent levels and inserts spaces according | |
38 | * to the current indent level at the start of every line. | |
39 | * | |
40 | * @author <A href="mailto:demakov@ispras.ru">Alexey Demakov</A> | |
41 | * @version $Id: IndentFilter.java,v 1.1 2004/10/09 06:36:40 all-x Exp $ | |
42 | */ | |
43 | public class IndentFilter extends Filter | |
44 | { | |
45 | /** | |
46 | * The default value of indent step. | |
47 | */ | |
48 | public static final int DEFAULT_INDENT_STEP = 4; | |
49 | ||
50 | /** | |
51 | * Constructs indent filter with default indent step. | |
52 | * | |
53 | * @see #DEFAULT_INDENT_STEP | |
54 | */ | |
55 | 0 | public IndentFilter( TextReceiver client ) |
56 | { | |
57 | 0 | super( client ); |
58 | ||
59 | 0 | indent_stack.push( new Integer( 0 ) ); |
60 | } | |
61 | ||
62 | /** | |
63 | * Constructs indent server with given indent step. | |
64 | * | |
65 | * @param indent_step the indent step value | |
66 | * @throws IllegalArgumentException | |
67 | * <code>if indent_step <= 0</code> | |
68 | */ | |
69 | 0 | public IndentFilter( TextReceiver client, int indent_step ) |
70 | { | |
71 | 0 | this( client ); |
72 | ||
73 | 0 | if( indent_step <= 0 ) |
74 | { | |
75 | 0 | throw |
76 | new IllegalArgumentException( Integer.toString( indent_step ) ); | |
77 | } | |
78 | ||
79 | 0 | this.indent_step = indent_step; |
80 | } | |
81 | ||
82 | /** | |
83 | * Returns the indent step. | |
84 | */ | |
85 | 0 | public int getIndentStep() |
86 | { | |
87 | 0 | return indent_step; |
88 | } | |
89 | ||
90 | /** | |
91 | * Pushes in stack new indent level. | |
92 | * | |
93 | * @param indent the new indent level | |
94 | * @throws IllegalArgumentException | |
95 | * if <code>indent</code> is negative | |
96 | */ | |
97 | 0 | public void pushIndent( int indent ) |
98 | { | |
99 | 0 | if( indent < 0 ) |
100 | { | |
101 | 0 | throw new IllegalArgumentException( Integer.toString( indent ) ); |
102 | } | |
103 | 0 | indent_stack.push( new Integer( indent ) ); |
104 | } | |
105 | ||
106 | /** | |
107 | * Returns the current indent level. | |
108 | * | |
109 | * @throws java.util.EmptyStackException | |
110 | * if no indent level is in stack. | |
111 | */ | |
112 | 0 | public int getIndent() |
113 | { | |
114 | 0 | return ((Integer)indent_stack.peek()).intValue(); |
115 | } | |
116 | ||
117 | /** | |
118 | * Restores the previous indent level. | |
119 | * | |
120 | * @throws java.util.EmptyStackException | |
121 | * if no indent level is in stack. | |
122 | */ | |
123 | 0 | public void popIndent() |
124 | { | |
125 | 0 | indent_stack.pop(); |
126 | } | |
127 | ||
128 | /** | |
129 | * Receives string and passes it to the client inserting appropriate | |
130 | * number of spaces at the start of each line | |
131 | * | |
132 | * @param str the string to receive | |
133 | * | |
134 | * @throws NullPointerException | |
135 | * if <code>str</code> is <code>null</code> | |
136 | */ | |
137 | 0 | public void txt( String str ) |
138 | { | |
139 | 0 | if( str.length() == 0 ) return; |
140 | ||
141 | 0 | if( is_line_start ) |
142 | { | |
143 | 0 | int indent = ((Integer)indent_stack.peek()).intValue(); |
144 | 0 | client.txt( fill( ' ', indent ) ); |
145 | 0 | is_line_start = false; |
146 | } | |
147 | 0 | client.txt( str ); |
148 | } | |
149 | ||
150 | /** | |
151 | * Receives line separator and passes it to the client. | |
152 | * The next string received by {@link TextReceiver#txt(String)} will be | |
153 | * prefixed by indent. | |
154 | * | |
155 | * @throws NullPointerException | |
156 | * if <code>c</code> is <code>null</code> | |
157 | */ | |
158 | 0 | public void nl() |
159 | { | |
160 | 0 | client.nl(); |
161 | 0 | is_line_start = true; |
162 | } | |
163 | ||
164 | /** | |
165 | * Returns the current state of the line start indicator. | |
166 | */ | |
167 | 0 | public boolean isLineStart() |
168 | { | |
169 | 0 | return is_line_start; |
170 | } | |
171 | ||
172 | /** | |
173 | * Fills a string with characters. | |
174 | * | |
175 | * @param c the character to fill | |
176 | * @param l the length of the string | |
177 | * @return The string of the length <code>l</code> filled by <code>c</code>. | |
178 | * If <code>l < 0</code> empty string is returned. | |
179 | */ | |
180 | 0 | public static String fill( char c, int l ) |
181 | { | |
182 | 0 | StringBuffer sb = new StringBuffer( l ); |
183 | ||
184 | 0 | while( l-- > 0 ) |
185 | { | |
186 | 0 | sb.append( c ); |
187 | } | |
188 | ||
189 | 0 | return sb.toString(); |
190 | } | |
191 | ||
192 | //-------------------------------------------------------------------------- | |
193 | // implementation | |
194 | ||
195 | /** | |
196 | * The line start indicator. | |
197 | */ | |
198 | private boolean is_line_start = true; | |
199 | ||
200 | /** | |
201 | * The stack of indent levels. | |
202 | */ | |
203 | private Stack/*Integer*/ indent_stack = new Stack/*Integer*/(); | |
204 | ||
205 | /** | |
206 | * The current step of indentation. | |
207 | * | |
208 | * @see #DEFAULT_INDENT_STEP | |
209 | */ | |
210 | private int indent_step = DEFAULT_INDENT_STEP; | |
211 | } |
|