| // Copyright 2010 The Apache Software Foundation |
| // |
| // Licensed under the Apache License, Version 2.0 (the "License"); |
| // you may not use this file except in compliance with the License. |
| // You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, software |
| // distributed under the License is distributed on an "AS IS" BASIS, |
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| // See the License for the specific language governing permissions and |
| // limitations under the License. |
| |
| package org.apache.tapestry5.services.javascript; |
| |
| import java.util.List; |
| |
| import org.apache.tapestry5.Asset; |
| import org.apache.tapestry5.SymbolConstants; |
| import org.apache.tapestry5.TapestryConstants; |
| import org.apache.tapestry5.ioc.services.ThreadLocale; |
| import org.apache.tapestry5.services.AssetSource; |
| import org.apache.tapestry5.services.ClientInfrastructure; |
| |
| /** |
| * A high level description of a group of related JavaScript libraries and stylesheets. The built-in "core" |
| * stack is used to define the core JavaScript libraries needed by Tapestry (currently, this includes |
| * Prototype and Scriptaculous, as well as Tapestry-specific libraries). Other component libraries may |
| * define additional stacks for related sets of resources, for example, to bundle together some portion |
| * of the ExtJS or YUI libraries. |
| * <p> |
| * A JavaScriptStack can be thought of as a generalization of Tapestry 5.1's {@link ClientInfrastructure}, which exists |
| * now to define the "core" JavaScript stack. |
| * <p> |
| * A JavaScript assets of a stack may (when {@linkplain SymbolConstants#COMBINE_SCRIPTS enabled}) be exposed to the |
| * client as a single URL (identifying the stack by name). The individual assets are combined into a single virtual |
| * asset, which is then streamed to the client. |
| * <p> |
| * Implementations may need to inject the {@link ThreadLocale} service in order to determine the current locale (if any |
| * of the JavaScript library or stylesheet assets are localized). They will generally need to inject the |
| * {@link AssetSource} service as well. |
| * |
| * @since 5.2.0 |
| * @see ThreadLocale |
| */ |
| public interface JavaScriptStack |
| { |
| /** |
| * Returns a list of JavaScriptStack names that this stack depends on. Each stack will be processed before |
| * the current stack (thus a dependency stack's libraries, stylesheets and initialization is emitted before |
| * the dependent stack). |
| */ |
| List<String> getStacks(); |
| |
| /** |
| * Returns a list of <em>localized</em> assets for JavaScript libraries that form the stack. |
| */ |
| List<Asset> getJavaScriptLibraries(); |
| |
| /** |
| * Returns a list of <em>localized</em> links for stylesheets that form the stack. |
| */ |
| List<StylesheetLink> getStylesheets(); |
| |
| /** |
| * Returns static JavaScript initialization for the stack. This block of JavaScript code will be added to the |
| * page that imports the stack. The code executes outside of any other function (i.e., the code is not deferred |
| * until the DOM is loaded). As with the other methods, if localization is a factor, the result of this method |
| * should be localized. |
| */ |
| String getInitialization(); |
| } |