juzu.plugin.asset.AssetController Maven / Gradle / Ivy
/*
* Copyright 2013 eXo Platform SAS
*
* 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 juzu.plugin.asset;
import juzu.asset.AssetLocation;
import juzu.impl.asset.AssetServer;
/**
* The asset controller.
*
* @author Julien Viet
*/
public class AssetController {
/**
* Generate an asset URL from the specified id.
*
* @param id the asset id
* @return null if the asset id does not exists
* @throws NullPointerException if the asset id is null
*/
public String byId(String id) throws NullPointerException {
return AssetServer.renderAssetURLById(id);
}
/**
* Returns the URL of an asset located in the assets package of the application.
*
* If the controller is not under the scope of a request, null is returned.
*
* @param path the path
* @return the asset url
* @throws NullPointerException when the path argument is null
*/
public String byPath(String path) throws NullPointerException {
return AssetServer.renderAssetURLByPath(AssetLocation.APPLICATION, path);
}
/**
* Returns the URL of an asset.
*
* If the controller is not under the scope of a request, null is returned.
*
* @param location the asset location
* @param uri the asset uri
* @return the asset url
* @throws NullPointerException when the path argument is null
*/
public String byPath(AssetLocation location, String uri) throws NullPointerException {
return AssetServer.renderAssetURLByPath(location, uri);
}
}