001 /*
002 * Copyright 2004 The Apache Software Foundation
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 * http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 * See the License for the specific language governing permissions and
014 * limitations under the License.
015 */
016 package org.apache.commons.convert.conversion;
017
018 import org.apache.commons.convert.ConversionFactory;
019 import org.apache.commons.convert.Converter;
020
021 /**
022 * Conversion from Object to String using <code>toString()</code>.
023 *
024 * @author Stephen Colebourne
025 * @version $Id: ObjectToStringConversionFactory.java 155441 2005-02-26 13:19:22Z dirkv $
026 * @since 1.0
027 */
028 public class ObjectToStringConversionFactory extends AbstractConversionFactory {
029
030 /** Singleton instance of this factory */
031 public static final ConversionFactory INSTANCE = new ObjectToStringConversionFactory();
032
033 /**
034 * Restricted constructor.
035 */
036 protected ObjectToStringConversionFactory() {
037 super(Object.class, STRING_CLASS);
038 }
039
040 //-----------------------------------------------------------------------
041 /**
042 * Returns a low match percent to allow other conversions to replace this one.
043 *
044 * @return 20
045 */
046 protected int getMatchPercent() {
047 return 20;
048 }
049
050 /**
051 * Convert the specified input object into an output object
052 * of the another type.
053 *
054 * @param value the input value to be converted, pre-checked to not be null
055 * @param converter the converter being used, not null
056 * @return the converted value
057 */
058 protected Object convertValue(Object value, Converter converter) {
059 return value.toString();
060 }
061
062 }