View Javadoc
1   /**
2    * This file Copyright (c) 2014-2015 Magnolia International
3    * Ltd.  (http://www.magnolia-cms.com). All rights reserved.
4    *
5    *
6    * This file is dual-licensed under both the Magnolia
7    * Network Agreement and the GNU General Public License.
8    * You may elect to use one or the other of these licenses.
9    *
10   * This file is distributed in the hope that it will be
11   * useful, but AS-IS and WITHOUT ANY WARRANTY; without even the
12   * implied warranty of MERCHANTABILITY or FITNESS FOR A
13   * PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT.
14   * Redistribution, except as permitted by whichever of the GPL
15   * or MNA you select, is prohibited.
16   *
17   * 1. For the GPL license (GPL), you can redistribute and/or
18   * modify this file under the terms of the GNU General
19   * Public License, Version 3, as published by the Free Software
20   * Foundation.  You should have received a copy of the GNU
21   * General Public License, Version 3 along with this program;
22   * if not, write to the Free Software Foundation, Inc., 51
23   * Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
24   *
25   * 2. For the Magnolia Network Agreement (MNA), this file
26   * and the accompanying materials are made available under the
27   * terms of the MNA which accompanies this distribution, and
28   * is available at http://www.magnolia-cms.com/mna.html
29   *
30   * Any modifications to this file must keep this entire header
31   * intact.
32   *
33   */
34  package info.magnolia.classpathwatch;
35  
36  import info.magnolia.init.MagnoliaConfigurationProperties;
37  
38  import java.io.IOException;
39  import java.net.URL;
40  import java.util.concurrent.Executors;
41  import java.util.concurrent.Future;
42  import java.util.concurrent.ScheduledExecutorService;
43  import java.util.concurrent.TimeUnit;
44  
45  import javax.inject.Inject;
46  import javax.inject.Singleton;
47  import javax.servlet.ServletContext;
48  
49  import org.slf4j.Logger;
50  import org.slf4j.LoggerFactory;
51  
52  import com.google.common.base.Function;
53  import com.google.common.base.Predicate;
54  
55  /**
56   * Service controlling execution of the @link {@link ClasspathScanner}.
57   */
58  @Singleton
59  public class ClasspathScannerService {
60  
61      private static final int SCAN_INTERVAL = 10;
62  
63      private static final Logger log = LoggerFactory.getLogger(ClasspathScannerService.class);
64  
65      private final ServletContext servletContext;
66      private final boolean devMode;
67  
68      private ScheduledExecutorService executorService;
69      private ClasspathScanner scanner;
70  
71      private Future<?> scannerFuture;
72  
73      @Inject
74      public ClasspathScannerService(MagnoliaConfigurationProperties mcp, ServletContext servletContext) throws IOException {
75          this.servletContext = servletContext;
76          this.devMode = mcp.getBooleanProperty("magnolia.develop");
77          if (!devMode) {
78              log.info("Not in dev mode, will not watch resource changes on the classpath.");
79          }
80      }
81  
82      public void start() {
83      }
84  
85      public boolean isEnabled() {
86          return devMode;
87      }
88  
89      /**
90       * Sets up observation of classpath resource changes.
91       */
92      public synchronized void watch(Predicate<String> resourcesFilter, Predicate<? super URL> urlsFilter, Function<String, Void> callbackFunction) {
93          if (!devMode) {
94              return;
95          }
96  
97          /*
98           * All ClasspathOrigins have the same resource and url exclusion filters, by implementation/design.
99           * 
100          * - For now, first ClasspathResourceOrigin requesting #watchForChanges passes these on; scanner is then created accordingly.
101          * - Hence we currently don't support scanning for heterogeneous ClasspathOrigins with different filtering impl.
102          * - LegacyClasspathResourceOrigin is intentionally left out, in particular as it's not meant to host config files.
103          * - We may revise this whenever there is need for generalization.
104          */
105         if (scannerFuture == null) {
106             scanner = new ClasspathScanner(resourcesFilter, urlsFilter, servletContext);
107 
108             // We intentionally use a single thread executor (single ClasspathScanner with multiple callbacks)
109             executorService = Executors.newSingleThreadScheduledExecutor();
110             log.info("Scheduling execution of ClasspathScanner every {}s.", SCAN_INTERVAL);
111             scannerFuture = executorService.scheduleWithFixedDelay(scanner, SCAN_INTERVAL, SCAN_INTERVAL, TimeUnit.SECONDS);
112         }
113         scanner.watchResourceChanges(callbackFunction);
114     }
115 
116     public void stop() {
117         if (executorService != null) {
118             executorService.shutdownNow();
119             boolean terminated = false;
120             try {
121                 terminated = executorService.awaitTermination(1, TimeUnit.SECONDS);
122             } catch (InterruptedException e) {
123                 log.error("Exception during service termination", e);
124             }
125             if (terminated) {
126                 log.info("{} terminated.", getClass().getSimpleName());
127             } else {
128                 log.warn("{} not terminated, some tasks are still running.", getClass().getSimpleName());
129             }
130         }
131     }
132 
133 }