001: /*
002: License $Id: Tag.java,v 1.6 2003/09/13 04:59:56 hendriks73 Exp $
003:
004: Copyright (c) 2001-2005 tagtraum industries.
005:
006: LGPL
007: ====
008:
009: jo! is free software; you can redistribute it and/or
010: modify it under the terms of the GNU Lesser General Public
011: License as published by the Free Software Foundation; either
012: version 2.1 of the License, or (at your option) any later version.
013:
014: jo! is distributed in the hope that it will be useful,
015: but WITHOUT ANY WARRANTY; without even the implied warranty of
016: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
017: Lesser General Public License for more details.
018:
019: You should have received a copy of the GNU Lesser General Public
020: License along with this library; if not, write to the Free Software
021: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
022:
023: For LGPL see <http://www.fsf.org/copyleft/lesser.txt>
024:
025:
026: Sun license
027: ===========
028:
029: This release contains software by Sun Microsystems. Therefore
030: the following conditions have to be met, too. They apply to the
031: files
032:
033: - lib/mail.jar
034: - lib/activation.jar
035: - lib/jsse.jar
036: - lib/jcert.jar
037: - lib/jaxp.jar
038: - lib/crimson.jar
039: - lib/servlet.jar
040: - lib/jnet.jar
041: - lib/jaas.jar
042: - lib/jaasmod.jar
043:
044: contained in this release.
045:
046: a. Licensee may not modify the Java Platform
047: Interface (JPI, identified as classes contained within the javax
048: package or any subpackages of the javax package), by creating additional
049: classes within the JPI or otherwise causing the addition to or modification
050: of the classes in the JPI. In the event that Licensee creates any
051: Java-related API and distribute such API to others for applet or
052: application development, you must promptly publish broadly, an accurate
053: specification for such API for free use by all developers of Java-based
054: software.
055:
056: b. Software is confidential copyrighted information of Sun and
057: title to all copies is retained by Sun and/or its licensors. Licensee
058: shall not modify, decompile, disassemble, decrypt, extract, or otherwise
059: reverse engineer Software. Software may not be leased, assigned, or
060: sublicensed, in whole or in part. Software is not designed or intended
061: for use in on-line control of aircraft, air traffic, aircraft navigation
062: or aircraft communications; or in the design, construction, operation or
063: maintenance of any nuclear facility. Licensee warrants that it will not
064: use or redistribute the Software for such purposes.
065:
066: c. Software is provided "AS IS," without a warranty
067: of any kind. ALL EXPRESS OR IMPLIED REPRESENTATIONS AND WARRANTIES,
068: INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
069: PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED.
070:
071: d. This License is effective until terminated. Licensee may
072: terminate this License at any time by destroying all copies of Software.
073: This License will terminate immediately without notice from Sun if Licensee
074: fails to comply with any provision of this License. Upon such termination,
075: Licensee must destroy all copies of Software.
076:
077: e. Software, including technical data, is subject to U.S.
078: export control laws, including the U.S. Export Administration Act and its
079: associated regulations, and may be subject to export or import regulations
080: in other countries. Licensee agrees to comply strictly with all such
081: regulations and acknowledges that it has the responsibility to obtain
082: licenses to export, re-export, or import Software. Software may not be
083: downloaded, or otherwise exported or re-exported (i) into, or to a national
084: or resident of, Cuba, Iraq, Iran, North Korea, Libya, Sudan, Syria or any
085: country to which the U.S. has embargoed goods; or (ii) to anyone on the
086: U.S. Treasury Department's list of Specially Designated Nations or the U.S.
087: Commerce Department's Table of Denial Orders.
088:
089:
090: Feedback
091: ========
092:
093: We encourage your feedback and suggestions and want to use your feedback to
094: improve the Software. Send all such feedback to:
095: <feedback@tagtraum.com>
096:
097: For more information on tagtraum industries and jo!
098: please see <http://www.tagtraum.com/>.
099:
100:
101: */
102: package com.tagtraum.framework.markup;
103:
104: import com.tagtraum.framework.util.UnSyncStringBuffer;
105:
106: import java.io.IOException;
107: import java.io.PushbackReader;
108: import java.util.Enumeration;
109: import java.util.HashMap;
110: import java.util.StringTokenizer;
111: import java.util.Vector;
112:
113: /**
114: * Parses a Tag.
115: *
116: * @author <a href="mailto:hs@tagtraum.com">Hendrik Schreiber</a>
117: * @version 1.1beta1 $Id: Tag.java,v 1.6 2003/09/13 04:59:56 hendriks73 Exp $
118: */
119: public class Tag extends RawDataElement implements I_Tag {
120:
121: /**
122: * Source-Version
123: */
124: public static String vcid = "$Id: Tag.java,v 1.6 2003/09/13 04:59:56 hendriks73 Exp $";
125:
126: protected HashMap myAttributes;
127: protected Vector myOrderedAttributeNames;
128: protected boolean wellFormed;
129: protected boolean attributesRead;
130: protected StringTokenizer st;
131: protected String myName;
132:
133: /**
134: * Constructor.
135: */
136: public Tag(String aTagStart) {
137: super (aTagStart);
138: wellFormed = true;
139: attributesRead = false;
140: st = null;
141: }
142:
143: /**
144: * Returns the name of this tag. I.e. P for <p>.
145: */
146: public String getName() {
147: if (st == null) {
148: st = new StringTokenizer(myData, "\\\r\n\t\f \"\'=/", true);
149: }
150: if (myName == null) {
151: myName = nextToken();
152: // end tags
153: if ("/".equals(myName)) {
154: String theToken = nextToken();
155: if (theToken != null) {
156: myName += theToken;
157: }
158: }
159: // if (myName != null) myName = myName.toUpperCase();
160: }
161: return myName;
162: }
163:
164: /**
165: * Returns the names of the attributes.
166: *
167: * @return an enumeration of the attribute names
168: */
169: public Enumeration getAttributeNames() {
170: if (getName() == null) {
171: return null; // read name first.
172: }
173: readAttributes(); // read attributes
174: return myOrderedAttributeNames.elements();
175: }
176:
177: /**
178: * Returns an attribute value of this tag.
179: *
180: * @param aName key of this value
181: */
182: public String getAttribute(String aName) {
183: if (getName() == null) {
184: return null; // read name first.
185: }
186: readAttributes(); // read attributes
187: return (String) myAttributes.get(aName.toUpperCase());
188: }
189:
190: public void addAttribute(String key, String value) {
191: myAttributes.put(key.toUpperCase(), value);
192: }
193:
194: /**
195: * Indicates whether this tag starts with a '/'
196: */
197: public boolean isEndTag() {
198: return toString().startsWith("</");
199: }
200:
201: /**
202: * Indicates whether this tag ends with a '/'
203: */
204: public boolean isEmptyTag() {
205: return toString().endsWith("/>");
206: }
207:
208: /**
209: * Parses the current element.
210: */
211: public void parse(PushbackReader aReader) throws IOException {
212: int c = 0;
213: while (true) {
214: c = aReader.read();
215: if (c != -1 && c != '>') {
216: append((char) c);
217: } else {
218: break;
219: }
220: }
221: finish();
222: }
223:
224: /**
225: * Check for well-formedness of this tag.
226: */
227: public boolean isWellFormed() {
228: if (getName() == null) {
229: return false;
230: }
231: return readAttributes();
232: }
233:
234: /**
235: * Attempt to read attributes from tag if not already read.
236: *
237: * @return true if everything was read fine, false otherwise
238: */
239: protected boolean readAttributes() {
240: if (attributesRead) {
241: return wellFormed;
242: }
243: attributesRead = true;
244: String key;
245: String value;
246: String token;
247: wellFormed = true;
248: myAttributes = new HashMap();
249: myOrderedAttributeNames = new Vector();
250:
251: ParseLoop: while (st.hasMoreTokens()) {
252: wellFormed = false;
253: key = skipWhiteSpace();
254: // isEmptyElement
255: if (key == null || "/".equals(key)) {
256: wellFormed = true;
257: break ParseLoop;
258: }
259: if (!myOrderedAttributeNames.contains(key))
260: myOrderedAttributeNames.add(key);
261: // ensure '='-sign
262: token = skipWhiteSpace();
263: if (token == null || "/".equals(key)) {
264: break ParseLoop;
265: }
266: if (!token.equals("=")) {
267: break ParseLoop;
268: }
269: // get value or quotes
270: token = skipWhiteSpace();
271: if (token == null) {
272: break ParseLoop;
273: }
274: String endToken = null;
275: if (token.equals("\"")) {
276: endToken = "\"";
277: token = nextToken();
278: } else if (token.equals("\'")) {
279: endToken = "\'";
280: token = nextToken();
281: }
282: if (endToken != null) {
283: UnSyncStringBuffer sb = new UnSyncStringBuffer();
284: boolean escaped = false;
285: while (endToken != null
286: && ((!token.equals(endToken)) || escaped)) {
287: if (token.equals("\\") && !escaped) {
288: escaped = true;
289: } else {
290: sb.append(token);
291: escaped = false;
292: }
293: token = nextToken();
294: if (token == null) {
295: // ends too early
296: break ParseLoop;
297: }
298: }
299: value = sb.toString();
300: } else {
301: value = token;
302: }
303: if (value == null) {
304: break ParseLoop;
305: }
306: addAttribute(key.toUpperCase(), value);
307: wellFormed = true;
308: }
309: return wellFormed;
310: }
311:
312: /**
313: * Skips whitespace.
314: */
315: protected String skipWhiteSpace() {
316: while (st.hasMoreTokens()) {
317: String theToken = st.nextToken();
318: if (!Character.isWhitespace(theToken.charAt(0))) {
319: return theToken;
320: }
321: }
322: return null;
323: }
324:
325: /**
326: * Returns next token.
327: */
328: protected String nextToken() {
329: if (st.hasMoreTokens()) {
330: return st.nextToken();
331: }
332: return null;
333: }
334:
335: /**
336: * String representation.
337: */
338: public String toString() {
339: return "<" + myData + getTagEnd() + ">";
340: }
341:
342: /**
343: * Returns the start characters of this tag.
344: */
345: public String getTagStart() {
346: return myTagStart;
347: }
348:
349: /**
350: * Returns the end characters of this tag.
351: */
352: public String getTagEnd() {
353: return "";
354: }
355:
356: }
|