001: // ============================================================================
002: // $Id: FormatValue.java,v 1.7 2006/01/08 00:52:25 davidahall Exp $
003: // Copyright (c) 2003-2005 David A. Hall
004: // ============================================================================
005: // The contents of this file are subject to the Common Development and
006: // Distribution License (CDDL), Version 1.0 (the License); you may not use this
007: // file except in compliance with the License. You should have received a copy
008: // of the the License along with this file: if not, a copy of the License is
009: // available from Sun Microsystems, Inc.
010: //
011: // http://www.sun.com/cddl/cddl.html
012: //
013: // From time to time, the license steward (initially Sun Microsystems, Inc.) may
014: // publish revised and/or new versions of the License. You may not use,
015: // distribute, or otherwise make this file available under subsequent versions
016: // of the License.
017: //
018: // Alternatively, the contents of this file may be used under the terms of the
019: // GNU Lesser General Public License Version 2.1 or later (the "LGPL"), in which
020: // case the provisions of the LGPL are applicable instead of those above. If you
021: // wish to allow use of your version of this file only under the terms of the
022: // LGPL, and not to allow others to use your version of this file under the
023: // terms of the CDDL, indicate your decision by deleting the provisions above
024: // and replace them with the notice and other provisions required by the LGPL.
025: // If you do not delete the provisions above, a recipient may use your version
026: // of this file under the terms of either the CDDL or the LGPL.
027: //
028: // This library is distributed in the hope that it will be useful,
029: // but WITHOUT ANY WARRANTY; without even the implied warranty of
030: // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
031: // ============================================================================
032: package net.sf.jga.fn.string;
033:
034: import java.text.Format;
035: import net.sf.jga.fn.UnaryFunctor;
036:
037: /**
038: * Unary Functor that generates a formatted string for a given value.
039: * <p>
040: * Copyright © 2003-2005 David A. Hall
041: *
042: * @author <a href="mailto:davidahall@users.sf.net">David A. Hall</a>
043: */
044:
045: public class FormatValue<T> extends UnaryFunctor<T, String> {
046:
047: static final long serialVersionUID = -6545061527457884949L;
048:
049: private Format _format;
050:
051: public FormatValue(Format format) {
052: if (format == null) {
053: String msg = "Format must be specified";
054: throw new IllegalArgumentException(msg);
055: }
056:
057: _format = format;
058: }
059:
060: /**
061: * Returns the format object used to present values in formatted form.
062: * @return the format used to present values
063: */
064:
065: public Format getFormat() {
066: return _format;
067: }
068:
069: // UnaryFunctor interface
070:
071: /**
072: * Formats the argument using the java.text.Format given at construction.
073: * <p>
074: * @param arg the value to formatted
075: * @return the formatted value
076: */
077:
078: public String fn(T arg) {
079: return _format.format(arg);
080: }
081:
082: /**
083: * Calls the Visitor's <code>visit(FormatValue)</code> method, if it
084: * implements the nested Visitor interface.
085: */
086: public void accept(net.sf.jga.fn.Visitor v) {
087: if (v instanceof FormatValue.Visitor)
088: ((FormatValue.Visitor) v).visit(this );
089: else
090: v.visit(this );
091: }
092:
093: // Object overrides
094:
095: public String toString() {
096: return "FormatValue[" + _format + "]";
097: }
098:
099: // Acyclic Visitor
100:
101: /**
102: * Interface for classes that may interpret a <b>FormatValue</b>
103: * predicate.
104: */
105: public interface Visitor extends net.sf.jga.fn.Visitor {
106: public void visit(FormatValue host);
107: }
108: }
|