Clover coverage report - Code Coverage for tapestry release 4.0-beta-12
Coverage timestamp: Sun Oct 30 2005 16:22:01 EST
file stats: LOC: 50   Methods: 0
NCLOC: 11   Classes: 1
 
 Source file Conditionals Statements Methods TOTAL
Translator.java - - - -
coverage
 1    // Copyright 2005 The Apache Software Foundation
 2    //
 3    // Licensed under the Apache License, Version 2.0 (the "License");
 4    // you may not use this file except in compliance with the License.
 5    // You may obtain a copy of the License at
 6    //
 7    // http://www.apache.org/licenses/LICENSE-2.0
 8    //
 9    // Unless required by applicable law or agreed to in writing, software
 10    // distributed under the License is distributed on an "AS IS" BASIS,
 11    // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 12    // See the License for the specific language governing permissions and
 13    // limitations under the License.
 14   
 15    package org.apache.tapestry.form.translator;
 16   
 17    import java.util.Locale;
 18   
 19    import org.apache.tapestry.form.IFormComponent;
 20    import org.apache.tapestry.form.FormComponentContributor;
 21    import org.apache.tapestry.form.ValidationMessages;
 22    import org.apache.tapestry.valid.ValidatorException;
 23   
 24    /**
 25    * Interface used by {@link ValidatableField}s to both format an object as text and translate
 26    * submitted text into an appropriate object for a given field.
 27    *
 28    * @author Paul Ferraro
 29    * @since 4.0
 30    */
 31    public interface Translator extends FormComponentContributor
 32    {
 33    /**
 34    * Invoked during rendering to format an object (which may be null) into a text value (which
 35    * should not be null) appropriate for the specified field.
 36    * @param locale TODO
 37    */
 38    public String format(IFormComponent field, Locale locale, Object object);
 39   
 40    /**
 41    * Invoked during rewind to parse a submitted input value into an object suitable for the
 42    * specified component.
 43    * @param messages TODO
 44    *
 45    * @return the parsed object
 46    * @throws ValidatorException
 47    * if the specified text could not be parsed into an object.
 48    */
 49    public Object parse(IFormComponent field, ValidationMessages messages, String value) throws ValidatorException;
 50    }