View Javadoc

    1   package org.apache.turbine.services.template.mapper;
    2
    3
    4   /*
    5    * Licensed to the Apache Software Foundation (ASF) under one
    6    * or more contributor license agreements.  See the NOTICE file
    7    * distributed with this work for additional information
    8    * regarding copyright ownership.  The ASF licenses this file
    9    * to you under the Apache License, Version 2.0 (the
    10   * "License"); you may not use this file except in compliance
    11   * with the License.  You may obtain a copy of the License at
    12   *
    13   *   http://www.apache.org/licenses/LICENSE-2.0
    14   *
    15   * Unless required by applicable law or agreed to in writing,
    16   * software distributed under the License is distributed on an
    17   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    18   * KIND, either express or implied.  See the License for the
    19   * specific language governing permissions and limitations
    20   * under the License.
    21   */
    22
    23
    24  /**
    25   * To separate out the various map and search policies for class
    26   * names and template names, we use classes that implement this
    27   * interface.
    28   *
    29   * @author <a href="mailto:hps@intermeta.de">Henning P. Schmiedehausen</a>
    30   * @version $Id: Mapper.java 615328 2008-01-25 20:25:05Z tv $
    31   */
    32
    33  public interface Mapper
    34  {
    35      /**
    36       * Mapper initialization.
    37       */
    38      void init();
    39
    40      /**
    41       * Get the CacheSize value.
    42       * @return the CacheSize value.
    43       */
    44      int getCacheSize();
    45
    46      /**
    47       * Set the CacheSize value.
    48       * @param cacheSize The new CacheSize value.
    49       */
    50      void setCacheSize(int cacheSize);
    51
    52      /**
    53       * Get the UseCache value.
    54       * @return the UseCache value.
    55       */
    56      boolean isUseCache();
    57
    58      /**
    59       * Set the UseCache value.
    60       * @param newUseCache The new UseCache value.
    61       */
    62      void setUseCache(boolean useCache);
    63
    64      /**
    65       * Get the DefaultProperty value.
    66       * @return the DefaultProperty value.
    67       */
    68      String getDefaultProperty();
    69
    70      /**
    71       * Set the DefaultProperty value.
    72       * @param defaultProperty The new DefaultProperty value.
    73       */
    74      void setDefaultProperty(String defaultProperty);
    75
    76      /**
    77       * Get the Separator value.
    78       * @return the Separator value.
    79       */
    80      char getSeparator();
    81
    82      /**
    83       * Set the Separator value.
    84       * @param separator The new Separator value.
    85       */
    86      void setSeparator(char separator);
    87
    88
    89      /**
    90       * Returns the default name for the supplied template
    91       * name. Must never return null.
    92       *
    93       * @param template The template name.
    94       *
    95       * @return The default name for this template.
    96       */
    97      String getDefaultName(String template);
    98
    99      /**
    100      * Return the first match name for the given template name.
    101      * This method might return null if no possible match can
    102      * be found.
    103      *
    104      * @param template The template name.
    105      *
    106      * @return The first matching class or template name.
    107      */
    108     String getMappedName(String template);
    109 }