View Javadoc
1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one
3    * or more contributor license agreements.  See the NOTICE file
4    * distributed with this work for additional information
5    * regarding copyright ownership.  The ASF licenses this file
6    * to you under the Apache License, Version 2.0 (the
7    * "License"); you may not use this file except in compliance
8    * with the License.  You may obtain a copy of the License at
9    *
10   *   http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing,
13   * software distributed under the License is distributed on an
14   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15   * KIND, either express or implied.  See the License for the
16   * specific language governing permissions and limitations
17   * under the License.
18   */
19  
20  package org.apache.myfaces.tobago.facelets;
21  
22  import org.slf4j.Logger;
23  import org.slf4j.LoggerFactory;
24  
25  import java.net.URL;
26  
27  /**
28   * <p>
29   * Provides facelets from the directory "META-INF/resources/" of any jar file in the classpath.
30   * With the Servlet 3.0 specification this is no longer needed.
31   * </p>
32   * <p>
33   * To configure this ResourceResolver put this code into the web.xml file:
34   * </p>
35   * <pre>
36   *  &lt;context-param&gt;
37   *    &lt;param-name&gt;javax.faces.FACELETS_RESOURCE_RESOLVER&lt;/param-name&gt;
38   *    &lt;param-value&gt;
39   *        org.apache.myfaces.tobago.facelets.MetaInfResourcesClasspathResourceResolver
40   *    &lt;/param-value&gt;
41   *  &lt;/context-param&gt;
42   * </pre>
43   */
44  public class MetaInfResourcesClasspathResourceResolver extends DefaultResourceResolver {
45  
46    private static final Logger LOG = LoggerFactory.getLogger(MetaInfResourcesClasspathResourceResolver.class);
47  
48    public MetaInfResourcesClasspathResourceResolver() {
49      if (LOG.isDebugEnabled()) {
50        LOG.debug("MetaInfResourcesClasspathResourceResolver is configured to resolve resources.");
51      }
52    }
53  
54    @Override
55    public URL resolveUrl(String path) {
56      URL url = super.resolveUrl(path);
57      if (LOG.isDebugEnabled()) {
58        LOG.debug("default   url='" + url + "'");
59      }
60      if (url == null) {
61        if (path.startsWith("/")) {
62          path = path.substring(1);
63        }
64        path = "META-INF/resources/" + path;
65  
66        url = Thread.currentThread().getContextClassLoader().getResource(path);
67        if (LOG.isDebugEnabled()) {
68          LOG.debug("classpath url='" + url + "'");
69        }
70      }
71      return url;
72    }
73  }