sitemap.json enthält nur noch die Struktur für die statischen Inhalte
[website] / dist / thymeleaf / blog / article.html
1 <!DOCTYPE html>
2 <html
3     xmlns=""
4     xmlns:layout=""
5     layout:decorator="/templates/layout"
6     th:with="uri='/blog/article.html'"
7     >
8   <head>
9     <title>juplo - blog - Combining jetty-maven-plugin and wro4j-maven-plugin for Dynamic Reloading of LESS-Resources</title>
10     <!--/*-->
11     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
12     <link rel="stylesheet/less" type="text/css" href="../../less/base.less"/>
13     <link rel="stylesheet/less" type="text/css" href="../../less/screen.less" media="screen"/>
14     <link rel="stylesheet/less" type="text/css" href="../../less/print.less" media="print"/>
15     <script src="../../js/less-1.7.0.min.js"></script>
16     <!--*/-->
17   </head>
18   <body thymeproxy:variables="MERGE:/thymeleaf/blog.json">
19     <article class="main" layout:fragment="maincontent">
20       <article id="post-140" class="post-140 post type-post status-publish format-standard hentry category-jetty category-less category-maven category-wro4j">
21         <div class="entry-header">
22           <h1 class="entry-title">Combining jetty-maven-plugin and wro4j-maven-plugin for Dynamic Reloading of LESS-Resources</h1>
23           <div class="entry-meta">
24             Posted on <a href="" title="12:58" rel="bookmark"><time class="entry-date" datetime="2013-12-06T12:58:17+00:00">December 6, 2013</time></a><span class="byline"> by <span class="author vcard"><a class="url fn n" href="" title="View all posts by Kai Moritz" rel="author">Kai Moritz</a></span></span>
25           </div><!-- .entry-meta -->
26         </div><!-- .entry-header -->
27         <div class="entry-content">
28           <p>Ever searched for a simple configuration, that lets you use your <a href="" onclick="javascript:_gaq.push(['_trackEvent','outbound-article','']);" title="See the documentation for mor information">jetty-maven-plugin</a> as you are used to, while working with <a href="" onclick="javascript:_gaq.push(['_trackEvent','outbound-article','']);" title="See LESS CSS documentation for mor informations">LESS</a> to simplify your stylesheets?</p>
29           <p>You cannot do both, use the <a href="" onclick="javascript:_gaq.push(['_trackEvent','outbound-article','']);" title="More about the client-side usage of LESS">Client-side mode</a> of LESS to ease development and use the <a href="" onclick="javascript:_gaq.push(['_trackEvent','outbound-article','']);" title="Homepage of the official LESS CSS maven plugin">lesscss-maven-plugin</a> to automatically compile the LESS-sources into CSS for production. That does not work, because your stylesheets must be linked in different ways if you are switching between the client-side mode &#8211; which is best for development &#8211; and the pre-compiled mode &#8211; which is best for production. For the client-side mode you need something like:</p>
30           <pre class="prettyprint linenums">
31   <code class="html">
32   &lt;link rel="stylesheet/less" type="text/css" href="styles.less" /&gt;
33   &lt;script src="../less.js" type="text/javascript"&gt;&lt;/script&gt;
34   </code>
35           </pre>
36           <p>While, for the pre-compiled mode, you want to link to your stylesheets as usual, with:</p>
37           <pre class="prettyprint linenums">
38   <code class="html">
39   &lt;link rel="stylesheet/less" type="text/css" href="styles.css" /&gt;
40   </code>
41           </pre>
42           <p>While looking for a solution to this dilemma, I stumbled accross <a href="" onclick="javascript:_gaq.push(['_trackEvent','outbound-article','']);" title="See the documentation of ths wounderfull tool">wro4j</a>. Originally intended, to speed up page-delivery by combining and minimizing multiple resources into one through the use of a servlet-filter, this tool also comes with a maven-plugin, that let you do the same offline, while compiling your webapp.</p>
43           <p>The idea is, to use the <a href="" onclick="javascript:_gaq.push(['_trackEvent','outbound-article','']);" title="See the documentation of hte wro4j-maven-plugin">wro4j-maven-plugin</a> to compile and combine your LESS-sources into CSS for production and to use the <a href="" onclick="javascript:_gaq.push(['_trackEvent','outbound-article','']);" title="See how to configure the filter">wro4j filter</a>, to dynamically deliver the compiled CSS while developing. This way, you do not have to alter your HTML-code, when switching between development and production, because you always link to the CSS-files.</p>
44           <p>So, lets get dirty!</p>
45           <h2>Step 1: Configure wro4j</h2>
46           <p>First, we configure <strong>wro4j</strong>, like as we want to use it to speed up our page. The details are explained and linked on wro4j&#8217;s <a href="" onclick="javascript:_gaq.push(['_trackEvent','outbound-article','']);" title="Visit the Getting-Started-Page">Getting-Started-Page</a>. In short, we just need two files: <strong>wro.xml</strong> and <strong></strong>.</p>
47           <h3>wro.xml</h3>
48           <p>wro.xml tells wro4j, which resources should be combined and how the result should be named. I am using the following configuration to generate all LESS-Sources beneath <code>base/</code> into one CSS-file called <code>base.css</code>:</p>
49           <pre class="prettyprint linenums">
50   <code class="xml">
51   &lt;groups xmlns=""&gt;
52     &lt;group name="base"&gt;
53       &lt;css&gt;/less/base/*.less&lt;/css&gt;
54     &lt;/group&gt;
55   </code>
56           </pre>
57           <p>wro4j looks for <code>/less/base/*.less</code> inside the root of the web-context, which is equal to <code>src/main/webapp</code> in a normal maven-project. There are <a href="" onclick="javascript:_gaq.push(['_trackEvent','outbound-article','']);" title="See the resource locator documentation of wro4j for more details">other ways to specifie the resources</a>, which enable you to store them elswhere. But this approach works best for our goal, because the path is understandable for both: the wro4j servlet-filter, we are configuring now for our development-environment, and the wro4j-maven-plugin, that we will configure later for build-time compilation.</p>
58           <h3></h3>
59           <p> in short tells wro4j, how or if it should convert the combined sources and how it should behave. I am using the following configuration to tell wro4j, that it should convert <code>*.less</code>-sources into CSS and do that on <em>every request</em>:</p>
60           <pre class="prettyprint linenums">
61   <code class="properties">
62   preProcessors=less4j
63   disableCache=true
64   </code>
65           </pre>
66           <p>You can do a lot more here. There are countless <a href="" onclick="javascript:_gaq.push(['_trackEvent', 'outbound-article', '']);" title="See all configuration options">configuration options</a> to fine-tune the behaviour of wro4j. The <code>disableCache=true</code> is crucial, because we would not see the changes take effect when developing with <strong>jetty-maven-plugin</strong> later on. You can also do much more with your resources here, for example <a href="" onclick="javascript:_gaq.push(['_trackEvent', 'outbound-article', '']);" title="See all available processors">minimizing</a>. But for our goal, we are now only intrested in the compilation of our LESS-sources.</p>
67           <h2>Step 2: Configure the wro4j servlet-filter</h2>
68           <p>Configuring the filter in the <strong>web.xml</strong> is easy. It is explained in wro4j&#8217;s <a href="" onclick="javascript:_gaq.push(['_trackEvent', 'outbound-article', '']);" title="See the installation instructions for the wro4j servlet-filter">installation-insctuctions</a>. But the trick is, that we do not want to configure that filter for the production-version of our webapp, because we want to compile the resources offline, when the webapp is build. To acchieve this, we can use the <code>&lt;overrideDescriptor&gt;</code>-Parameter of the <a href="" onclick="javascript:_gaq.push(['_trackEvent', 'outbound-article', '']);" title="Read more about the configuration of the jetty-maven-plugin">jetty-maven-plugin</a>.</p>
69           <h2>&lt;overrideDescriptor&gt;</h2>
70           <p>This parameter lets you specify additional configuration options for the web.xml of your webapp. I am using the following configuration for my jetty-maven-plugin:</p>
71           <pre class="prettyprint linenums">
72   <code class="xml">
73   &lt;plugin&gt;
74     &lt;groupId&gt;org.eclipse.jetty&lt;/groupId&gt;
75     &lt;artifactId&gt;jetty-maven-plugin&lt;/artifactId&gt;
76     &lt;configuration&gt;
77       &lt;webApp&gt;
78         &lt;overrideDescriptor&gt;${project.basedir}/src/test/resources/jetty-web.xml&lt;/overrideDescriptor&gt;
79       &lt;/webApp&gt;
80     &lt;/configuration&gt;
81     &lt;dependencies&gt;
82       &lt;dependency&gt;
83         &lt;groupId&gt;ro.isdc.wro4j&lt;/groupId&gt;
84         &lt;artifactId&gt;wro4j-core&lt;/artifactId&gt;
85         &lt;version&gt;${wro4j.version}&lt;/version&gt;
86       &lt;/dependency&gt;
87       &lt;dependency&gt;
88         &lt;groupId&gt;ro.isdc.wro4j&lt;/groupId&gt;
89         &lt;artifactId&gt;wro4j-extensions&lt;/artifactId&gt;
90         &lt;version&gt;${wro4j.version}&lt;/version&gt;
91         &lt;exclusions&gt;
92           &lt;exclusion&gt;
93               &lt;groupId&gt;javax.servlet&lt;/groupId&gt;
94               &lt;artifactId&gt;servlet-api&lt;/artifactId&gt;
95           &lt;/exclusion&gt;
96           &lt;exclusion&gt;
97               &lt;groupId&gt;org.apache.commons&lt;/groupId&gt;
98               &lt;artifactId&gt;commons-lang3&lt;/artifactId&gt;
99           &lt;/exclusion&gt;
100           &lt;exclusion&gt;
101               &lt;groupId&gt;commons-io&lt;/groupId&gt;
102               &lt;artifactId&gt;commons-io&lt;/artifactId&gt;
103           &lt;/exclusion&gt;
104           &lt;exclusion&gt;
105               &lt;groupId&gt;commons-pool&lt;/groupId&gt;
106               &lt;artifactId&gt;commons-pool&lt;/artifactId&gt;
107           &lt;/exclusion&gt;
108           &lt;exclusion&gt;
109               &lt;groupId&gt;org.springframework&lt;/groupId&gt;
110               &lt;artifactId&gt;spring-web&lt;/artifactId&gt;
111           &lt;/exclusion&gt;
112           &lt;exclusion&gt;
113               &lt;groupId&gt;;/groupId&gt;
114               &lt;artifactId&gt;gson&lt;/artifactId&gt;
115           &lt;/exclusion&gt;
116           &lt;exclusion&gt;
117               &lt;groupId&gt;;/groupId&gt;
118               &lt;artifactId&gt;closure-compiler&lt;/artifactId&gt;
119           &lt;/exclusion&gt;
120           &lt;exclusion&gt;
121               &lt;groupId&gt;com.github.lltyk&lt;/groupId&gt;
122               &lt;artifactId&gt;dojo-shrinksafe&lt;/artifactId&gt;
123           &lt;/exclusion&gt;
124           &lt;exclusion&gt;
125               &lt;groupId&gt;org.jruby&lt;/groupId&gt;
126               &lt;artifactId&gt;jruby-core&lt;/artifactId&gt;
127           &lt;/exclusion&gt;
128           &lt;exclusion&gt;
129             &lt;groupId&gt;org.jruby&lt;/groupId&gt;
130             &lt;artifactId&gt;jruby-stdlib&lt;/artifactId&gt;
131           &lt;/exclusion&gt;
132           &lt;exclusion&gt;
133               &lt;groupId&gt;org.jruby&lt;/groupId&gt;
134               &lt;artifactId&gt;jruby-stdlib&lt;/artifactId&gt;
135           &lt;/exclusion&gt;
136           &lt;exclusion&gt;
137               &lt;groupId&gt;me.n4u.sass&lt;/groupId&gt;
138               &lt;artifactId&gt;sass-gems&lt;/artifactId&gt;
139           &lt;/exclusion&gt;
140           &lt;exclusion&gt;
141               &lt;groupId&gt;;/groupId&gt;
142               &lt;artifactId&gt;bourbon-gem-jar&lt;/artifactId&gt;
143           &lt;/exclusion&gt;
144           &lt;exclusion&gt;
145               &lt;groupId&gt;org.codehaus.gmaven.runtime&lt;/groupId&gt;
146               &lt;artifactId&gt;gmaven-runtime-1.7&lt;/artifactId&gt;
147           &lt;/exclusion&gt;
148           &lt;exclusion&gt;
149               &lt;groupId&gt;org.webjars&lt;/groupId&gt;
150               &lt;artifactId&gt;jshint&lt;/artifactId&gt;
151           &lt;/exclusion&gt;
152           &lt;exclusion&gt;
153               &lt;groupId&gt;org.webjars&lt;/groupId&gt;
154               &lt;artifactId&gt;less&lt;/artifactId&gt;
155           &lt;/exclusion&gt;
156           &lt;exclusion&gt;
157               &lt;groupId&gt;org.webjars&lt;/groupId&gt;
158               &lt;artifactId&gt;emberjs&lt;/artifactId&gt;
159           &lt;/exclusion&gt;
160           &lt;exclusion&gt;
161               &lt;groupId&gt;org.webjars&lt;/groupId&gt;
162               &lt;artifactId&gt;handlebars&lt;/artifactId&gt;
163           &lt;/exclusion&gt;
164           &lt;exclusion&gt;
165               &lt;groupId&gt;org.webjars&lt;/groupId&gt;
166               &lt;artifactId&gt;coffee-script&lt;/artifactId&gt;
167           &lt;/exclusion&gt;
168           &lt;exclusion&gt;
169               &lt;groupId&gt;org.webjars&lt;/groupId&gt;
170               &lt;artifactId&gt;jslint&lt;/artifactId&gt;
171           &lt;/exclusion&gt;
172           &lt;exclusion&gt;
173               &lt;groupId&gt;org.webjars&lt;/groupId&gt;
174               &lt;artifactId&gt;json2&lt;/artifactId&gt;
175           &lt;/exclusion&gt;
176           &lt;exclusion&gt;
177               &lt;groupId&gt;org.webjars&lt;/groupId&gt;
178               &lt;artifactId&gt;jquery&lt;/artifactId&gt;
179           &lt;/exclusion&gt;
180         &lt;/exclusions&gt;
181       &lt;/dependency&gt;
182     &lt;/dependencies&gt;
183   &lt;/plugin&gt;
184   </code>
185           </pre>
186           <p>The dependencies to <strong>wro4j-core</strong> and <strong>wro4j-extensions</strong> are needed by jetty, to be able to enable the filter defined below. Unfortunatly, one of the transitive dependencies of <code>wro4j-extensions</code> triggers an uggly error when running the jetty-maven-plugin. Therefore, all unneeded dependencies of <code>wro4j-extensions</code> are excluded, as a workaround for this error/bug.</p>
187           <h2>jetty-web.xml</h2>
188           <p>And my jetty-web.xml looks like this:</p>
189           <pre class="prettyprint linenums">
190   <code class="xml">
191   &lt;?xml version="1.0" encoding="UTF-8"?&gt;
192   &lt;web-app xmlns=""
193     xmlns:xsi=""
194     xsi:schemaLocation=""
195     version="2.5"&gt;
196     &lt;filter&gt;
197       &lt;filter-name&gt;wro&lt;/filter-name&gt;
198       &lt;filter-class&gt;ro.isdc.wro.http.WroFilter&lt;/filter-class&gt;
199     &lt;/filter&gt;
200     &lt;filter-mapping&gt;
201       &lt;filter-name&gt;wro&lt;/filter-name&gt;
202       &lt;url-pattern&gt;*.css&lt;/url-pattern&gt;
203     &lt;/filter-mapping&gt;
204   &lt;/web-app&gt;
205   </code>
206           </pre>
207           <p>The filter processes any URI&#8217;s that end with <code>.css</code>. This way, the wro4j servlet-filter makes <code>base.css</code> available under any path, because for exampl <code>/base.css</code>, <code>/css/base.css</code> and <code>/foo/bar/base.css</code> all end with <code>.css</code>.</p>
208           <p>This is all, that is needed to develop with dynamically reloadable compiled LESS-resources. Just fire up your browser and browse to <code>/what/you/like/base.css</code>. (But do not forget to put some LESS-files in <code>src/main/webapp/less/base/</code> first!)</p>
209           <h2>Step 3: Install wro4j-maven-plugin</h2>
210           <p>All that is left over to configure now, is the build-process. If you would build and deploy your webapp now, the CSS-file <code>base.css</code> would not be generated and the link to your stylesheet, that already works in our jetty-maven-plugin environment would point to a 404. Hence, we need to set up the <strong>wro4j-maven-plugin</strong>. I am using this configuration:</p>
211           <pre class="prettyprint linenums">
212   <code class="xml">
213   &lt;plugin&gt;
214     &lt;groupId&gt;ro.isdc.wro4j&lt;/groupId&gt;
215     &lt;artifactId&gt;wro4j-maven-plugin&lt;/artifactId&gt;
216     &lt;version&gt;${wro4j.version}&lt;/version&gt;
217     &lt;configuration&gt;
218       &lt;wroManagerFactory&gt;ro.isdc.wro.maven.plugin.manager.factory.ConfigurableWroManagerFactory&lt;/wroManagerFactory&gt;
219       &lt;cssDestinationFolder&gt;${}/${}/css/&lt;/cssDestinationFolder&gt;
220     &lt;/configuration&gt;
221     &lt;executions&gt;
222       &lt;execution&gt;
223         &lt;phase&gt;package&lt;/phase&gt;
224         &lt;goals&gt;
225           &lt;goal&gt;run&lt;/goal&gt;
226         &lt;/goals&gt;
227       &lt;/execution&gt;
228     &lt;/executions&gt;
229   &lt;/plugin&gt;
230   </code>
231           </pre>
232           <p>I connected the <code>run</code>-goal with the <code>package</code>-phase, because the statically compiled CSS-file is needed only in the final war. The <code>ConfigurableWroManagerFactory</code> tells wro4j, that it should look up further configuration options in our <code></code>-file, where we tell wro4j, that it should compile our LESS-resources. The <code>&lt;cssDestinationFolder&gt;</code>-tag tells wro4j, where it should put the generated CSS-file. You can adjust that to suite your needs.</p>
233           <p>That&#8217;s it: now the same CSS-file, which is created on the fly by the wro4j servlet-filter when using <code>mvn jetty:run</code> and, thus, enables dynamic reloading of our LESS-resources, is generated during the build-process by the wro4j-maven-plugin.</p>
234           <h2>Cleanup and further considerations</h2>
235           <h3>lesscss-maven-plugin</h3>
236           <p>If you already compile your LESS-resources with the lesscss-maven-plugin, you can stick with it and skip step 3. But I strongly recommend giving wro4j-maven-plugin a try, because it is a much more powerfull tool, that can speed up your final webapp even more.</p>
237           <h3>Clean up your mess </h3>
238           <p>With a configuration like the above one, your LESS-resources and wro4j-configuration-files will be packed into your production-war. That might be confusing later, because neither wro4j nor LESS is used in the final war. You can add the following to your <code>pom.xml</code> to exclude these files from your war for the sake of clarity:</p>
239           <pre class="prettyprint linenums">
240   <code class="xml">
241   &lt;plugin&gt;
242     &lt;artifactId&gt;maven-war-plugin&lt;/artifactId&gt;
243     &lt;configuration&gt;
244       &lt;warSourceExcludes&gt;
245         WEB-INF/wro.*,
246         less/**
247       &lt;/warSourceExcludes&gt;
248     &lt;/configuration&gt;
249   &lt;/plugin&gt;
250   </code>
251           </pre>
252           <h3>What&#8217;s next?</h3>
253           <p>We only scrached the surface, of what can be done with wro4j. Based on this configuration, you can easily enable additional features to fine-tune your final build for maximum speed. You really should take a look at the <a href="" onclick="javascript:_gaq.push(['_trackEvent', 'outbound-article', '']);" title="Available Processors">list of available Processors</a>!</p>
254         </div><!-- .entry-content -->
255         <footer class="entry-meta">
256           This entry was posted in <a href="" title="View all posts in Jetty" rel="category tag">Jetty</a>, <a href="" title="View all posts in less" rel="category tag">less</a>, <a href="" title="View all posts in Maven" rel="category tag">Maven</a>, <a href="" title="View all posts in wro4j" rel="category tag">wro4j</a>. Bookmark the <a href="" title="Permalink to Combining jetty-maven-plugin and wro4j-maven-plugin for Dynamic Reloading of LESS-Resources" rel="bookmark">permalink</a>. 
257         </footer><!-- .entry-meta -->
258       </article><!-- #post-140 -->
259       <!-- You can start editing here. -->
260       <!-- If comments are open, but there are no comments. -->
261       <div id="respond">
262         <h3>Leave a Reply</h3>
263         <div id="cancel-comment-reply">
264           <small><a rel="nofollow" id="cancel-comment-reply-link" href="/combining-jetty-maven-plugin-and-wro4j-maven-plugin-for-dynamic-reloading-of-less-resources/#respond" style="display:none;">Click here to cancel reply.</a></small>
265         </div>
266         <form action="" method="post" id="commentform">
267           <p>Logged in as <a href="">Kai Moritz</a>. <a href=";;_wpnonce=09e5cb501d" title="Log out of this account">Log out &raquo;</a></p>
268           <!--<p><small><strong>XHTML:</strong> You can use these tags: <code>&lt;a href=&quot;&quot; title=&quot;&quot;&gt; &lt;abbr title=&quot;&quot;&gt; &lt;acronym title=&quot;&quot;&gt; &lt;b&gt; &lt;blockquote cite=&quot;&quot;&gt; &lt;cite&gt; &lt;code&gt; &lt;del datetime=&quot;&quot;&gt; &lt;em&gt; &lt;i&gt; &lt;q cite=&quot;&quot;&gt; &lt;strike&gt; &lt;strong&gt; </code></small></p>-->
269           <p><textarea name="comment" id="comment" cols="58" rows="10" tabindex="4"></textarea></p>
270           <p><input name="submit" type="submit" id="submit" tabindex="5" value="Submit Comment" />
271             <input type='hidden' name='comment_post_ID' value='140' id='comment_post_ID' />
272             <input type='hidden' name='comment_parent' id='comment_parent' value='0' />
273           </p>
274           <input type="hidden" id="_wp_unfiltered_html_comment_disabled" name="_wp_unfiltered_html_comment_disabled" value="2096655c89" /><script>(function() {
275       if (window === window.parent) {
276         document.getElementById('_wp_unfiltered_html_comment_disabled').name = '_wp_unfiltered_html_comment';
277       }
278     })();</script>
279           <p style="display: none;"><input type="hidden" id="akismet_comment_nonce" name="akismet_comment_nonce" value="f31e001227" /></p>
280         </form>
281       </div>
282     </article>
283     <aside layout:fragment="marginalcontent">
284       <div id="secondary" class="widget-area" role="complementary">
285         <aside id="archives" class="widget">
286           <h1 class="widget-title">Archives</h1>
287           <ul>
288             <li><a href='' title='October 2013'>October 2013</a></li>
289             <li><a href='' title='August 2013'>August 2013</a></li>
290             <li><a href='' title='January 2013'>January 2013</a></li>
291             <li><a href='' title='November 2012'>November 2012</a></li>
292           </ul>
293         </aside>
294         <aside id="categories" class="widget">
295           <h1 class="widget-title">Most Used Categories</h1>
296           <ul>
297             <li class="cat-item cat-item-4"><a href="" title="View all posts filed under Java">Java</a> (6)</li>
298             <li class="cat-item cat-item-6"><a href="" title="View all posts filed under Hibernate">Hibernate</a> (5)</li>
299             <li class="cat-item cat-item-8"><a href="" title="View all posts filed under Maven">Maven</a> (5)</li>
300             <li class="cat-item cat-item-9"><a href="" title="View all posts filed under JPA">JPA</a> (1)</li>
301             <li class="cat-item cat-item-10"><a href="" title="View all posts filed under appengine">appengine</a> (1)</li>
302             <li class="cat-item cat-item-11"><a href="" title="View all posts filed under oauth2">oauth2</a> (1)</li>
303           </ul>
304         </aside>
305         <aside id="search" class="widget widget_search">
306           <h1 class="widget-title">Search</h1>
307           <form role="search" method="get" id="searchform" class="searchform" action="">
308             <div>
309               <label class="screen-reader-text" for="s">Search for:</label>
310               <input type="text" value="" name="s" id="s" />
311               <input type="submit" id="searchsubmit" value="Search" />
312             </div>
313           </form>
314         </aside>
315       </div><!-- #secondary .widget-area -->
316       <div id="tertiary" class="widget-area" role="supplementary">
317       </div><!-- #tertiary .widget-area -->
318     </aside>
319   </body>
320 </html>