我使用Tapestry 4,每当我们发布更改任何资产(图像,样式表,JS库)的发行版时,都会遇到问题,因为用户在其浏览器缓存中仍然拥有资产的旧版本。我想设置一些简单的方法来允许缓存,但是在我们更新应用程序时强制下载新的资源。仅仅不允许完全为资产缓存是不可接受的解决方案。
我看不到有任何现成的机制来执行此操作,但是我发现可能存在某种方法来告诉Tapestry将内部版本号添加到URL,如下所示:
http://www.test.com/path/to/the/asset/asset.jpg?12345
这样,对于最终用户而言,每个新构建都将使其看起来像是一种不同的资产。
Tapestry是否提供一种简便的方法来解决我不知道的缓存问题?如果没有,那么如何修改Tapestry生成的URL?负责执行此操作的代码将如何获得内部版本号? (例如,我可以将内部版本号放入Spring Bean中,但是新的URL构建机制将如何实现呢?)
最佳答案
经过长时间的研究,我终于自己解决了。此解决方案假定您的项目中有tapestry-spring library。
就我而言,我有一个Spring bean,其中包含应用程序的一些全局属性:
package myapp;
public class AppProperties {
private String build;
public String getBuild() {
return build;
}
public void setBuild(String build) {
this.build = build;
}
// other properties
}
在您的Spring配置中声明此bean:
<bean id="appProperties" class="myapp.AppProperties">
<property name="build" value="@BUILD_NUMBER@"/>
</bean>
您可以设置您的Ant构建脚本,以用实际编号替换
@BUILD_NUMBER@
(有关详细信息,请参见Ant手册中的Copy任务)。现在创建一个类,该类将包装
IAsset
并将内部版本号附加到URL上:package myapp;
import java.io.InputStream;
import org.apache.hivemind.Location;
import org.apache.hivemind.Resource;
import org.apache.tapestry.IAsset;
public class BuildAwareAssetWrapper implements IAsset {
private IAsset wrapped;
private String build;
public BuildAwareAssetWrapper(IAsset wrapped, String build) {
this.wrapped = wrapped;
this.build = build;
}
public String buildURL() {
return addParam(wrapped.buildURL(), "build", build);
}
public InputStream getResourceAsStream() {
return wrapped.getResourceAsStream();
}
public Resource getResourceLocation() {
return wrapped.getResourceLocation();
}
public Location getLocation() {
return wrapped.getLocation();
}
private static String addParam(String url, String name, String value) {
if (url == null) url = "";
char sep = url.contains("?") ? '&' : '?';
return url + sep + name + '=' + value;
}
}
接下来,我们需要使Tapestry用包装器包装所有资产。
AssetSourceImpl
类负责为Tapestry提供IAsset
实例。我们将扩展此类并覆盖findAsset()
方法,以便我们可以使用包装器类包装创建的资产:package myapp;
import java.util.Locale;
import org.apache.hivemind.Location;
import org.apache.hivemind.Resource;
import org.apache.tapestry.IAsset;
import org.apache.tapestry.asset.AssetSourceImpl;
public class BuildAwareAssetSourceImpl extends AssetSourceImpl {
private AppProperties props;
@Override
public IAsset findAsset(Resource base, String path, Locale locale, Location location) {
IAsset asset = super.findAsset(base, path, locale, location);
return new BuildAwareAssetWrapper(asset, props.getBuild());
}
public void setAppProperties(AppProperties props) {
this.props = props;
}
}
注意,实现有一个可以接受我们的Spring bean的setter。最后一步是让Tapestry使用
BuildAwareAssetSourceImpl
而不是AssetSourceImpl
创建资产。为此,我们将覆盖hivemodule.xml
中的相应服务点:<!-- Custom asset source -->
<implementation service-id="tapestry.asset.AssetSource">
<invoke-factory service-id="hivemind.BuilderFactory" model="singleton">
<construct class="myapp.BuildAwareAssetSourceImpl">
<set-object property="appProperties" value="spring:appProperties"/>
<set-configuration property="contributions" configuration-id="tapestry.asset.AssetFactories"/>
<set-service property="lookupAssetFactory" service-id="tapestry.asset.LookupAssetFactory"/>
<set-service property="defaultAssetFactory" service-id="tapestry.asset.DefaultAssetFactory"/>
</construct>
</invoke-factory>
</implementation>
而已。如果运行应用程序并查看使用资产的任何页面的源,您将看到URL上将带有新的
build
参数。