001    /*
002     * Copyright 2002-2006 the original author or authors.
003     * 
004     * Licensed under the Apache License, Version 2.0 (the "License"); you may not
005     * use this file except in compliance with the License. You may obtain a copy of
006     * 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, WITHOUT
012     * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
013     * License for the specific language governing permissions and limitations under
014     * the License.
015     */
016    
017    package org.springframework.binding.support;
018    
019    import java.lang.annotation.Annotation;
020    import java.util.Map;
021    
022    /**
023     * Provides a strategy for converting JDK 1.5 Annotations on JavaBean
024     * properties into 1.4 compatible property level user metadata.
025     *
026     * @author andy
027     * @since May 8, 2006 2:08:05 PM
028     */
029    public interface AnnotationTranslator {
030        /**
031         * Translates <code>annotation</code> into its constituent (or 
032         * equivalent) key + value pairs and places the resulting pairs into
033         * the <code>result</code> map.
034         *
035         * @param annotation the annotation to be translated
036         * @param result container to hold the result of this translation
037         */
038        void translate(Annotation annotation, Map<String,Object> result);
039    }