001/* 002 * Copyright 2010 Anyware Services 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 013 * See the License for the specific language governing permissions and 014 * limitations under the License. 015 */ 016 017package org.ametys.web.cache; 018 019import java.io.ByteArrayInputStream; 020import java.io.IOException; 021import java.io.InputStream; 022import java.nio.charset.StandardCharsets; 023import java.util.ArrayList; 024import java.util.HashMap; 025import java.util.List; 026import java.util.Map; 027import java.util.Timer; 028import java.util.TimerTask; 029 030import javax.xml.parsers.DocumentBuilder; 031import javax.xml.parsers.DocumentBuilderFactory; 032import javax.xml.parsers.ParserConfigurationException; 033import javax.xml.transform.TransformerException; 034 035import org.apache.commons.lang3.StringUtils; 036import org.apache.http.Header; 037import org.apache.http.HttpResponse; 038import org.apache.http.NameValuePair; 039import org.apache.http.client.ClientProtocolException; 040import org.apache.http.client.config.RequestConfig; 041import org.apache.http.client.entity.UrlEncodedFormEntity; 042import org.apache.http.client.methods.CloseableHttpResponse; 043import org.apache.http.client.methods.HttpPost; 044import org.apache.http.impl.client.CloseableHttpClient; 045import org.apache.http.impl.client.HttpClientBuilder; 046import org.apache.tika.io.IOUtils; 047import org.apache.xpath.XPathAPI; 048import org.slf4j.Logger; 049import org.w3c.dom.Document; 050import org.xml.sax.SAXException; 051 052import org.ametys.runtime.config.Config; 053import org.ametys.web.repository.page.Page; 054import org.ametys.web.repository.site.Site; 055import org.ametys.web.repository.sitemap.Sitemap; 056 057/** 058 * Helper for dealing with front-office cache. 059 */ 060public final class CacheHelper 061{ 062 static Integer _lockToken = 0; 063 static Map<String, Long> _lastInvalidationDate = new HashMap<>(); 064 static Map<String, String> _timerTasks = new HashMap<>(); 065 066 static Timer _timer = new Timer("timer-cache", true); 067 068 private static Map<String, Long> _cacheForPeriodOfValidity = new HashMap<>(); 069 070 private CacheHelper() 071 { 072 // empty constructor 073 } 074 075 /** 076 * Request the given URL on each configured front-office. 077 * @param url the url to be called. 078 * @param logger logger for traces. 079 * @throws Exception if an error occurred. 080 */ 081 public static void testWS(String url, Logger logger) throws Exception 082 { 083 testWS(url, null, logger); 084 } 085 086 /** 087 * Request the given URL on each configured front-office. 088 * @param url the url to be called. 089 * @param postParameters submited values 090 * @param logger logger for traces. 091 * @throws Exception if an error occurred. 092 */ 093 public static void testWS(String url, List<NameValuePair> postParameters, Logger logger) throws Exception 094 { 095 List<Map<String, Object>> responses = callWS(url, postParameters, logger); 096 for (Map<String, Object> response : responses) 097 { 098 byte[] byteArray = (byte[]) response.get("bodyResponse"); 099 HttpPost request = (HttpPost) response.get("request"); 100 HttpResponse httpresponse = (HttpResponse) response.get("response"); 101 102 if (_checkResponse(byteArray)) 103 { 104 if (logger.isDebugEnabled()) 105 { 106 logger.debug("Request for cache invalidation sent and received successfully to: " + request.getURI().getHost()); 107 } 108 } 109 else 110 { 111 logger.error("Unable to invalidate cache with request '" + url + "' to server '" + request.getURI().getHost() + "', response: " + (httpresponse != null ? httpresponse.getStatusLine().toString() : "<no response>")); 112 } 113 } 114 } 115 116 /** 117 * Request the given URL on each configured front-office. 118 * @param url the url to be called. 119 * @param logger logger for traces. 120 * @return The streams 121 * @throws Exception if an error occurred. 122 */ 123 public static List<Map<String, Object>> callWS(String url, Logger logger) throws Exception 124 { 125 return callWS(url, null, logger); 126 } 127 128 /** 129 * Request the given URL on each configured front-office. 130 * @param url the url to be called. 131 * @param postParameters submitted values 132 * @param logger logger for traces. 133 * @return The streams 134 * @throws Exception if an error occurred. 135 */ 136 public static List<Map<String, Object>> callWS(String url, List<NameValuePair> postParameters, Logger logger) throws Exception 137 { 138 String frontConfig = Config.getInstance().getValue("org.ametys.web.front.url"); 139 String[] frontURLs = StringUtils.split(frontConfig, ","); 140 141 List<Map<String, Object>> responses = new ArrayList<>(); 142 for (String rawFrontURL : frontURLs) 143 { 144 String frontURL = rawFrontURL.trim(); 145 146 RequestConfig requestConfig = RequestConfig.custom().setConnectTimeout(2000).setSocketTimeout(2000).build(); 147 148 String wsURL = frontURL + url; 149 150 try (CloseableHttpClient httpclient = HttpClientBuilder.create().useSystemProperties().setDefaultRequestConfig(requestConfig).build()) 151 { 152 153 // Prepare a request object 154 HttpPost request = new HttpPost(wsURL); 155 request.addHeader("X-Ametys-BO", "true"); 156 157 if (postParameters != null) 158 { 159 request.setEntity(new UrlEncodedFormEntity(postParameters, StandardCharsets.UTF_8)); 160 } 161 162 Map<String, Object> responseObject = new HashMap<>(); 163 164 // Execute the request 165 try (CloseableHttpResponse response = httpclient.execute(request)) 166 { 167 responseObject.put("bodyResponse", _getResponse(response)); 168 responseObject.put("response", response); 169 } 170 171 responses.add(responseObject); 172 responseObject.put("request", request); 173 } 174 catch (Exception e) 175 { 176 if (e instanceof IOException || e instanceof ClientProtocolException) 177 { 178 logger.error("Unable to send request: " + wsURL, e); 179 } 180 else 181 { 182 throw e; 183 } 184 } 185 } 186 187 return responses; 188 } 189 190 private static boolean _checkResponse(byte[] bodyResponse) throws ParserConfigurationException, IllegalStateException, IOException, SAXException, TransformerException 191 { 192 if (bodyResponse == null) 193 { 194 return false; 195 } 196 197 try (InputStream is = new ByteArrayInputStream(bodyResponse)) 198 { 199 DocumentBuilder docBuilder = DocumentBuilderFactory.newInstance().newDocumentBuilder(); 200 Document document = docBuilder.parse(is); 201 return XPathAPI.eval(document, "count(/ActionResult)").toString().equals("1"); 202 } 203 } 204 205 private static byte[] _getResponse(HttpResponse response) throws IllegalStateException, IOException 206 { 207 if (response.getStatusLine().getStatusCode() != 200) 208 { 209 return null; 210 } 211 212 if (response.getFirstHeader("X-Ametys-SafeMode") != null) 213 { 214 // Site application is in safe mode 215 return null; 216 } 217 218 String cType = _getContentType (response); 219 if (cType == null || !cType.startsWith("text/xml")) 220 { 221 return null; 222 } 223 224 try (InputStream is = response.getEntity().getContent()) 225 { 226 return IOUtils.toByteArray(is); 227 } 228 } 229 230 private static String _getContentType (HttpResponse invalidateResponse) 231 { 232 Header header = invalidateResponse.getFirstHeader("Content-Type"); 233 if (header != null) 234 { 235 return header.getValue(); 236 } 237 return null; 238 } 239 240 /** 241 * Invalidates the front-office from the event observed. 242 * @param site the site. 243 * @param logger logger for traces. 244 * @throws Exception if an error occurs. 245 */ 246 public static void invalidateCache(Site site, Logger logger) throws Exception 247 { 248 String siteName = site.getName(); 249 long periodOfValidity = _getPeriodOfValidity (site, siteName); 250 251 if (isCacheValidityExpired(siteName, periodOfValidity)) 252 { 253 testWS("/_invalidate-site/" + site.getName(), logger); 254 testWS("/_invalidate-skin/" + site.getSkinId(), logger); 255 } 256 else 257 { 258 delayCacheInvalidation(siteName, "/_invalidate-site/" + site.getName(), periodOfValidity, logger); 259 delayCacheInvalidation(siteName, "/_invalidate-skin/" + site.getName(), periodOfValidity, logger); 260 } 261 } 262 263 /** 264 * Invalidates the front-office from the event observed. 265 * @param sitemap the sitemap. 266 * @param logger logger for traces. 267 * @throws Exception if an error occurs. 268 */ 269 public static void invalidateCache(Sitemap sitemap, Logger logger) throws Exception 270 { 271 testWS("/_invalidate-page/" + sitemap.getSiteName() + "/" + sitemap.getName(), logger); 272 } 273 274 /** 275 * Invalidates the front-office from the event observed. 276 * @param page the page. 277 * @param logger logger for traces. 278 * @param recursively true to invalidate the sub-pages 279 * @throws Exception if an error occurs. 280 */ 281 public static void invalidateCache(Page page, Logger logger, boolean recursively) throws Exception 282 { 283 testWS("/_invalidate-page/" + page.getSiteName() + "/" + page.getSitemapName() + "/" + page.getPathInSitemap() + ".html", logger); 284 285 if (recursively) 286 { 287 testWS("/_invalidate-page/" + page.getSiteName() + "/" + page.getSitemapName() + "/" + page.getPathInSitemap(), logger); 288 } 289 } 290 291 /** 292 * Invalidates the front-office from the event observed. 293 * @param page the page. 294 * @param logger logger for traces. 295 * @throws Exception if an error occurs. 296 */ 297 public static void invalidateCache(Page page, Logger logger) throws Exception 298 { 299 invalidateCache(page, logger, false); 300 } 301 302 private static long _getPeriodOfValidity (Site site, String siteName) 303 { 304 if (!_cacheForPeriodOfValidity.containsKey(siteName)) 305 { 306 _cacheForPeriodOfValidity.put(siteName, site.getValue("cache-validity", false, 0L) * 1000); 307 } 308 return _cacheForPeriodOfValidity.get(siteName); 309 } 310 311 /** 312 * Update the last invalidation cache 313 * @param siteName the site name 314 */ 315 public static void initializeTimerPeriod (String siteName) 316 { 317 synchronized (_lockToken) 318 { 319 _lastInvalidationDate.put(siteName, System.currentTimeMillis()); 320 _timerTasks.remove(siteName); 321 } 322 } 323 324 /** 325 * Determines if cache validity is expired for given site 326 * @param siteName the site name 327 * @param periodOfValidity the period of cache validity 328 * @return true if cache validity is expired 329 */ 330 public static boolean isCacheValidityExpired (String siteName, long periodOfValidity) 331 { 332 synchronized (_lockToken) 333 { 334 long currentMillisecond = System.currentTimeMillis(); 335 336 if (!_lastInvalidationDate.containsKey(siteName)) 337 { 338 _lastInvalidationDate.put(siteName, currentMillisecond); 339 return true; 340 } 341 342 long lastInvalidationDate = _lastInvalidationDate.get(siteName); 343 344 if (currentMillisecond - lastInvalidationDate >= periodOfValidity) 345 { 346 _lastInvalidationDate.put(siteName, currentMillisecond); 347 return true; 348 } 349 350 // Cache is still valid 351 return false; 352 } 353 } 354 355 /** 356 * Delay the cache invalidation 357 * @param siteName the site name 358 * @param urlWS the WS url to be called 359 * @param periodOfValidity the period of cache validity 360 * @param logger the logger 361 */ 362 public static void delayCacheInvalidation (String siteName, String urlWS, long periodOfValidity, Logger logger) 363 { 364 synchronized (_lockToken) 365 { 366 if (!_timerTasks.containsKey(siteName)) 367 { 368 _timerTasks.put(siteName, urlWS); 369 370 long currentMillisecond = System.currentTimeMillis(); 371 372 long lastInvalidationDate = _lastInvalidationDate.get(siteName); 373 374 // delay the cache invalidation 375 long delay = lastInvalidationDate + periodOfValidity - currentMillisecond; 376 377 if (logger.isDebugEnabled()) 378 { 379 logger.debug("Cache invalidation for site '" + siteName + "' has been delayed of " + delay + " milliseconds"); 380 } 381 _timer.schedule(new InvalidateCacheTimerTask (siteName, logger), delay); 382 } 383 } 384 } 385 386 /** 387 * {@link TimerTask} to invalidate site cache 388 * 389 */ 390 public static class InvalidateCacheTimerTask extends TimerTask 391 { 392 private String _siteName; 393 private Logger _logger; 394 395 /** 396 * Constructor 397 * @param siteName the site name 398 * @param logger the logger 399 */ 400 public InvalidateCacheTimerTask (String siteName, Logger logger) 401 { 402 _siteName = siteName; 403 _logger = logger; 404 } 405 406 @Override 407 public void run() 408 { 409 try 410 { 411 synchronized (_lockToken) 412 { 413 if (_logger.isDebugEnabled()) 414 { 415 _logger.debug("Invalide cache of site '" + _siteName + "' after delay."); 416 } 417 418 CacheHelper.testWS(_timerTasks.get(_siteName), _logger); 419 CacheHelper.initializeTimerPeriod(_siteName); 420 } 421 } 422 catch (Exception e) 423 { 424 _logger.error("Unable to invalidate cache for site: " + _siteName, e); 425 } 426 } 427 } 428}