Using the Project Assembly: To Create Example Projects
Anders Nawroth of the Neo4J project asked an interesting question on the neo4j-user lis
t:
What’s the best option when deploying neo4j code examples using Maven? It’s really not of any interest to deploy the artifact itself, it’s the sources (if possible with some exclusion of resources) that we want.
Anders’ requirements: create a project which packages itself, wire the appropriate goal into the lifecycle. He’s headed in the right direction, the Maven Assembly Plugin, but he might not know about the pre-defined assembly descriptors as they are somewhat hidden on the Apache Maven site. Since other projects might have similar requirements, here’s a quick explanation of all the moving parts…
What is the Maven Assembly Plugin?
The Maven Assembly Plugin allows you to create an archive with an arbitrary structure. If you have a project which needs to produce a ZIP file with a bin/ directory an a set of shell scripts, or if you want to create an archive which contains a particular project’s bytecode and all the runtime dependencies, Maven Assembly Plugin is the place to look. To generate an archive, you’ll need to do a few things:
- Include the Maven Assembly Plugin in your project’s pom.xml file.
- Configure an assembly by referencing a built-in assembly or define your own assembly.
- (optional) configure the lifecycle to bind the assembly goal to the package phase of the lifecycle.
What is an Assembly?
The Maven Assembly Plugin produces an assembly of files and folders using an Assembly descriptor which describes the contents of a directory. You can use one of several predefined assembly descriptors which are built into the Maven Assembly plugin, or you can define your own assembly by configuring your assembly in an assembly descriptor. An assembly descriptor is an XML file which selects files and directories to include in the final, assembled artifact.
Just what sort of “assemblies” can you create on your own with an Assembly descriptor? Just about anything, a collection of .class files and all of your runtime dependency JARs? Sure. The assembly descriptor is flexible enough to describe just about anything. If you want a full explanation of the power of Maven Assemblies, read the Assemblies Chapter of the Free Maven Book or Chapter 4 which introduces a built-in assembly descriptor.
A Project Which Assembles Itself
Back to Anders’ requirements, he wants a project that can package itself up as an example project. He also wants this assembly to be created when he runs mvn deploy. To do this, he can use the built-in project descriptor. Adding the following plugin configuration to any project will configure this built-in project descriptor to create an assembly of a project itself (a self-replicating project) and the executions section will attach the “assembly:attached” goal to the package phase of the lifecycle.
<build>
<plugins>
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<descriptorRefs>
<descriptorRef>project</descriptorRef>
</descriptorRefs>
</configuration>
<executions>
<execution>
<id>examples</id>
<phase>package</phase>
<goals>
<goal>attached</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
Go ahead, try it. Run mvn package or mvn deploy and you’ll end up with an assembly in ${basedir}/target. If you want to customize the name of the final product, use the finalName element in the build section of your POM.
The Lifecycle
My next post will likely be on the lifecycle, I’ve had a few questions from people over the past few weeks about running specific goals directly from the command-line. It appears that many people haven’t fully grok’d the Maven Lifecycle. Many people grew familiar with Maven 1, the way that people customized a build in Maven 1 was to string along a number of goals. If you needed to run a specific goal, you would just craft a long command line. In Maven 2, you should shy away from running specific goals on the command line, and you should configure executions (see above). This is the more natural way to customize a build, think of it as hooking your own project’s customized goals to the default lifecycle. If you find yourself running “mvn deploy assembly:assembly” often, you should take a look at the executions element in your plugin configuration.
For more information about the Maven 2 Lifecycle, read Chapter 10: Lifecycles.
-
http://www.resumedictionary.com/ resume
-
http://www.booktemplate.org/ book templates
-
http://www.resumedictionary.com/resume-writing-power-words/ power words
-
http://www.resumedictionary.com/resume-tips/ resume tips
-
http://www.resumecharisma.com/ resume templates
-
http://www.incoartists.com call for artists
-
http://www.fxgrant.com/Trading-account/receive-100ps-bonus-on-your-deposit.aspx forex 100% bonus
-
http://resumehelp16.weebly.com/ resume help
-
http://multifuelstovesx.com/info-about-outdoor-wood-furnace outdoor wood furnaces
-
http://bestofreggae.myusalocal.net inner circle online
-
http://jacksonville.craigslist.org/reo/2831058047.html owner financing jacksonville fl
-
http://adult.myphonesite.com sissy phone sex
-
http://www.acheter-fans-facebook.com/ facebook
-
http://www.smogchecksantaana.com/ Test only
-
http://www.youtube.com/watch?v=YqPKzlGGkcE Foscam FI8910W
-
http://esportes.divulgueai.com Esportes
-
http://www.reviewsexercisebikes.org/schwinn-airdyne-exercise-bike schwinn air dyne
-
http://www.youtube.com/watch?v=3Uu-wvdNDCQ& SEO Link Monster review
-
http://www.youtube.com/watch?v=3Uu-wvdNDCQ& SEO Link Monster bonus
-
http://allabouthoroscope.com/my/horoscope-psychic-tarot-love-predictions-by-date-of-birth/ best psychics
-
http://www.hostwinds.com/ vps hosting
-
http://www.youtube.com/watch?v=BqHcQ5kGwh8 schwinn airdyne ad4
-
http://www.youtube.com/watch?v=MByT0daGiyI bayou fitness total trainer
-
http://www.youtube.com/watch?v=b3AD35KS7dI lowrance m68c review
-
http://www.scrapeboxdailylists.com/scrapebox-auto-approved-vip-list-25-000-links free scrapebox list
-
http://www.youtube.com/watch?v=AztvS5Aieqk walmart gift card
-
http://www.youtube.com/watch?v=7fVEcdUObrw Tanning Lotion
-
http://www.youtube.com/watch?v=muZpZtT0U8I vtech innotab learning table
-
http://www.articlesglow.com/learn-about-solicitors-in-hove.htm Brittanie Knipp
-
http://www.scrubbylane.com/articledetail.php?artid=55020&catid=414&title=Finding-The-Right-Radiology-Tech-School-For-Your-Education radiology tech schools
-
http://www.youtube.com/watch?v=ovzompYv_mg online bingo sites
-
http://www.hyipobserver.com/guide.html free investment guide
-
http://www.konkanmuslimmatrimony.com/index.php Konkan Muslim Matrimony
-
http://www.plantlabz.com/ buy mdai
-
http://www.legaliiis.com 6-apb
-
http://www.wide-mouth-frogs.com mdai
-
http://www.debcom-software.com/custom-website-design-package custom website
-
http://www.youtube.com/watch?v=lXnRpcxpfAY home steamer
-
http://www.Fitnessjobs.me local fitness jobs
-
http://www.youtube.com/watch?v=g4dmKKJrj78 body solid exm1500s
-
http://nightofthelivingdick.com zombie porn
-
http://www.portableshampoobowl.biz portable shampoo bowl
-
http://www.scrapeboxdailylists.com scrapebox lists
-
http://www.inkesale.com/blog cheap ink cartridges
-
http://www.youtube.com/user/intersectchurchtx churches Prosper TX
-
http://finance.banks.com/intersearch.banks/?Page=MEDIAVIEWER&GUID=20604669 merchant cash advance industry
-
http://www.livesexoase.com/porno-chat.html Live Porno
-
http://sunnyvalefinehomes.com/index.php/2012/02/diet-program-answer-a-plan-that-operates/ the diet solution program
