View Javadoc

1   /*
2    * $Id: WildcardDefinitionPatternMatcher.java 795343 2009-07-18 11:26:09Z apetrelli $
3    *
4    * Licensed to the Apache Software Foundation (ASF) under one
5    * or more contributor license agreements.  See the NOTICE file
6    * distributed with this work for additional information
7    * regarding copyright ownership.  The ASF licenses this file
8    * to you under the Apache License, Version 2.0 (the
9    * "License"); you may not use this file except in compliance
10   * with the License.  You may obtain a copy of the License at
11   *
12   * http://www.apache.org/licenses/LICENSE-2.0
13   *
14   * Unless required by applicable law or agreed to in writing,
15   * software distributed under the License is distributed on an
16   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
17   * KIND, either express or implied.  See the License for the
18   * specific language governing permissions and limitations
19   * under the License.
20   */
21  
22  package org.apache.tiles.definition.pattern.wildcard;
23  
24  import java.util.List;
25  
26  import org.apache.tiles.Definition;
27  import org.apache.tiles.definition.pattern.DefinitionPatternMatcher;
28  import org.apache.tiles.definition.pattern.PatternUtil;
29  import org.apache.tiles.util.WildcardHelper;
30  
31  /***
32   * Matches wildcard patterns in definitions.
33   *
34   * @version $Rev: 795343 $ $Date: 2009-07-18 13:26:09 +0200 (sab, 18 lug 2009) $
35   * @since 2.2.0
36   */
37  public class WildcardDefinitionPatternMatcher implements
38          DefinitionPatternMatcher {
39  
40      /***
41       * Allows to parse wildcard expressions and to recognize substitution
42       * variables.
43       */
44      private WildcardHelper wildcardHelper;
45  
46      /***
47       * The definition to use as a basis.
48       */
49      private Definition definition;
50  
51      /***
52       * The pattern to use.
53       */
54      private int[] pattern;
55  
56      /***
57       * Constructor.
58       *
59       * @param pattern The pattern to use, in string form.
60       * @param definition The definition to use as a basis.
61       * @param wildcardHelper The object that parses wildcard expressions and
62       * recognized substitution variables.
63       * @since 2.2.0
64       */
65      public WildcardDefinitionPatternMatcher(String pattern,
66              Definition definition, WildcardHelper wildcardHelper) {
67          this.wildcardHelper = wildcardHelper;
68          this.definition = definition;
69          this.pattern = wildcardHelper.compilePattern(pattern);
70      }
71  
72      /*** {@inheritDoc} */
73      public Definition createDefinition(String definitionName) {
74          List<String> vars = wildcardHelper.match(definitionName, pattern);
75          Definition d = null;
76  
77          if (vars != null) {
78              d = PatternUtil.replacePlaceholders(definition, definitionName,
79                      vars.toArray());
80          }
81  
82          return d;
83      }
84  }