001: /*--
002: $Id: InsetsConverter.java,v 1.1 2004/03/01 07:56:00 wolfpaulus Exp $
003:
004: Copyright (C) 2003-2007 Wolf Paulus.
005: All rights reserved.
006:
007: Redistribution and use in source and binary forms, with or without
008: modification, are permitted provided that the following conditions
009: are met:
010:
011: 1. Redistributions of source code must retain the above copyright
012: notice, this list of conditions, and the following disclaimer.
013:
014: 2. Redistributions in binary form must reproduce the above copyright
015: notice, this list of conditions, and the disclaimer that follows
016: these conditions in the documentation and/or other materials provided
017: with the distribution.
018:
019: 3. The end-user documentation included with the redistribution,
020: if any, must include the following acknowledgment:
021: "This product includes software developed by the
022: SWIXML Project (http://www.swixml.org/)."
023: Alternately, this acknowledgment may appear in the software itself,
024: if and wherever such third-party acknowledgments normally appear.
025:
026: 4. The name "Swixml" must not be used to endorse or promote products
027: derived from this software without prior written permission. For
028: written permission, please contact <info_AT_swixml_DOT_org>
029:
030: 5. Products derived from this software may not be called "Swixml",
031: nor may "Swixml" appear in their name, without prior written
032: permission from the Swixml Project Management.
033:
034: THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
035: WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
036: OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
037: DISCLAIMED. IN NO EVENT SHALL THE SWIXML PROJECT OR ITS
038: CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
039: SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
040: LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
041: USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
042: ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
043: OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
044: OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
045: SUCH DAMAGE.
046: ====================================================================
047:
048: This software consists of voluntary contributions made by many
049: individuals on behalf of the Swixml Project and was originally
050: created by Wolf Paulus <wolf_AT_swixml_DOT_org>. For more information
051: on the Swixml Project, please see <http://www.swixml.org/>.
052: */
053: package org.swixml.converters;
054:
055: import org.jdom.Attribute;
056: import org.swixml.Converter;
057: import org.swixml.Localizer;
058:
059: import java.awt.*;
060: import java.util.StringTokenizer;
061:
062: /**
063: * The <code>InsetsConverter</code> class defines a converter that creates Insets objects based on a provided String.
064: *
065: * <h3>Examples for Valid XML attribute notations:</h3>
066: * <pre>
067: * <ul>
068: * <li>border="MatteBorder(4,4,4,4,red)"</li>
069: * <li>insets="2,2,2,2"</li>
070: * </ul>
071: * </pre>
072: *
073: * @author <a href="mailto:wolf@paulus.com">Wolf Paulus</a>
074: * @version $Revision: 1.1 $
075: *
076: * @see java.awt.Insets
077: * @see org.swixml.ConverterLibrary
078:
079: */
080: public class InsetsConverter implements Converter {
081:
082: /** converter's return type */
083: public static final Class TEMPLATE = Insets.class;
084:
085: /**
086: * Converts a Strings into an Insets object
087: *
088: * @param type <code>Class</code> not used
089: * @param attr <code>Attribute</code> value needs to provide String containing comma sep. integers
090: * @return <code>Object</code> runtime type is subclass of <code>Insets</code>
091: */
092: public Object convert(final Class type, final Attribute attr,
093: Localizer localizer) {
094: Insets insets = null;
095: if (attr != null) {
096: StringTokenizer st = new StringTokenizer(attr.getValue(),
097: "(,)");
098: if (5 == st.countTokens()) { // assume "insets(...)"
099: st.nextToken().trim();
100: }
101: int[] param = Util.ia(st);
102: if (4 <= param.length) {
103: insets = new Insets(param[0], param[1], param[2],
104: param[3]);
105: }
106: }
107: return insets;
108: }
109:
110: /**
111: * A <code>Converters</code> conversTo method informs about the Class type the converter
112: * is returning when its <code>convert</code> method is called
113: * @return <code>Class</code> - the Class the converter is returning when its convert method is called
114: */
115: public Class convertsTo() {
116: return TEMPLATE;
117: }
118: }
|