Гобелен 4: Управление кэшем активов? - PullRequest
Новая
       24

Гобелен 4: Управление кэшем активов?

3 голосов
/ 13 ноября 2008

Я использую Tapestry 4, и всякий раз, когда мы запускаем релиз, который изменяет какие-либо ресурсы (изображение, таблицу стилей, библиотеку JS), у нас возникают проблемы, потому что у пользователей все еще есть старая версия ресурса в кеше браузера. Я хотел бы настроить простой способ разрешить кэширование, но принудительно загрузить новый актив при обновлении приложения. Простое запрещение кэширования полностью для ресурсов не является приемлемым решением.

Я не видел ни одного существующего механизма для этого, но я подумал, что может быть какой-то способ сказать Tapestry добавить номер сборки в URL, что-то вроде этого:

http://www.test.com/path/to/the/asset/asset.jpg?12345

Таким образом, каждая новая сборка будет выглядеть как актив для конечного пользователя.

Предоставляет ли Tapestry простой способ решения проблемы с кешем, о которой я не знаю? Если нет, то как можно изменить URL-адрес, созданный Tapestry? И как код, ответственный за это, получит номер сборки? (Я мог бы, например, получить номер сборки в bean-компоненте Spring, но как на это повлияет новый механизм построения URL?)

1 Ответ

6 голосов
/ 25 февраля 2009

После долгого размышления об этой проблеме я в конце концов решил ее сам. Это решение предполагает, что в вашем проекте есть библиотека гобеленовых пружин .

В моем случае у меня есть bean-компонент Spring, который содержит некоторые глобальные свойства моего приложения: 

package myapp;

public class AppProperties {
    private String build;

    public String getBuild() {
        return build;
    }

    public void setBuild(String build) {
        this.build = build;
    }

    // other properties
}

Объявите этот bean-компонент в вашей конфигурации Spring: 

<bean id="appProperties" class="myapp.AppProperties">
    <property name="build" value="@BUILD_NUMBER@"/>
</bean>

Вы можете настроить скрипт Ant для замены @BUILD_NUMBER@ на фактическое число (подробнее см. Задачу Копировать в руководстве по Ant).

Теперь создайте класс, который обернет IAsset s и прикрепит номер сборки к 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 отвечает за предоставление экземпляров 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;
    }
}

Обратите внимание, что в реализации есть установщик, который может принимать наш bean-компонент Spring. Последний шаг - заставить 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.

...