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 import java.util.ArrayList;
25 import java.util.Arrays;
26 import java.util.List;
27
28 import org.apache.commons.lang.StringUtils;
29 import org.apache.commons.logging.Log;
30 import org.apache.commons.logging.LogFactory;
31 import org.apache.turbine.services.TurbineServices;
32 import org.apache.turbine.services.template.TemplateEngineService;
33 import org.apache.turbine.services.template.TemplateService;
34
35 /**
36 * This is a pretty simple mapper which returns template pathes for
37 * a supplied template name. If the path does not exist, it looks for
38 * a templated called "Default" in the same package.
39 * This path can be used by the TemplateEngine to access
40 * a certain resource to actually render the template.
41 *
42 * @author <a href="mailto:hps@intermeta.de">Henning P. Schmiedehausen</a>
43 * @version $Id: ScreenDefaultTemplateMapper.java 1723699 2016-01-08 11:29:21Z tv $
44 */
45
46 public class ScreenDefaultTemplateMapper
47 extends BaseTemplateMapper
48 implements Mapper
49 {
50 /** Logging */
51 private static Log log = LogFactory.getLog(ScreenDefaultTemplateMapper.class);
52
53 /**
54 * Default C'tor. If you use this C'tor, you must use
55 * the bean setter to set the various properties needed for
56 * this mapper before first usage.
57 */
58 public ScreenDefaultTemplateMapper()
59 {
60 // empty
61 }
62
63 /**
64 * Look for a given Template, then try the
65 * default.
66 *
67 * @param template The template name.
68 * @return The parsed module name.
69 */
70 @Override
71 public String doMapping(String template)
72 {
73 log.debug("doMapping(" + template + ")");
74 // Copy our elements into an array
75 List<String> components
76 = new ArrayList<String>(Arrays.asList(StringUtils.split(
77 template,
78 String.valueOf(TemplateService.TEMPLATE_PARTS_SEPARATOR))));
79 int componentSize = components.size() - 1 ;
80
81 // This method never gets an empty string passed.
82 // So this is never < 0
83 String templateName = components.get(componentSize);
84 components.remove(componentSize--);
85
86 log.debug("templateName is " + templateName);
87
88 // Last element decides, which template Service to use...
89 TemplateService templateService = (TemplateService)TurbineServices.getInstance().getService(TemplateService.SERVICE_NAME);
90 TemplateEngineService tes = templateService.getTemplateEngineService(templateName);
91
92 if (tes == null)
93 {
94 return null;
95 }
96
97 String defaultName = "Default.vm";
98
99 // This is an optimization. If the name we're looking for is
100 // already the default name for the template, don't do a "first run"
101 // which looks for an exact match.
102 boolean firstRun = !templateName.equals(defaultName);
103
104 for(;;)
105 {
106 String templatePackage = StringUtils.join(components.iterator(), String.valueOf(separator));
107
108 log.debug("templatePackage is now: " + templatePackage);
109
110 StringBuilder testName = new StringBuilder();
111
112 if (!components.isEmpty())
113 {
114 testName.append(templatePackage);
115 testName.append(separator);
116 }
117
118 testName.append((firstRun)
119 ? templateName
120 : defaultName);
121
122 // But the Templating service must look for the name with prefix
123 StringBuilder templatePath = new StringBuilder();
124 if (StringUtils.isNotEmpty(prefix))
125 {
126 templatePath.append(prefix);
127 templatePath.append(separator);
128 }
129 templatePath.append(testName);
130
131 log.debug("Looking for " + templatePath);
132
133 if (tes.templateExists(templatePath.toString()))
134 {
135 log.debug("Found it, returning " + testName);
136 return testName.toString();
137 }
138
139 if (firstRun)
140 {
141 firstRun = false;
142 }
143 else
144 {
145 // We run this loop only two times. The
146 // first time with the 'real' name and the
147 // second time with "Default". The second time
148 // we will end up here and break the for(;;) loop.
149 break;
150 }
151 }
152
153 log.debug("Returning default");
154 return getDefaultName(template);
155 }
156 }