aaaa

aaa

Maven实战（一）安装和配置

README.txt

 

This file exists at the top-level of the Roller source tree.

 

Roller is made up of the following Maven projects:

 

  roller-project:         Top level project

  roller-core:            Core Roller component

  planet-business:        Planet POJOs and business logic

  planet-web:             Planet webapp (under construction as before)

  weblogger-business:     Weblogger POJOs and business logic

  weblogger-web:          Roller Weblogger Web Classes, Servlets, Filters, etc.

  weblogger-webapp:       Roller Weblogger webapp, JSP pages, Velocity templates

  weblogger-war-assembly: Assembly that builds the Roller WAR

  weblogger-assembly:     Assembly that builds Roller distro

  test-utils:             Test utils (e.g. start/stop Derby task)

 

To pull the latest trunk sources you need a Subversion client:

  svn co https://svn.apache.org/repos/asf/roller/trunk roller_trunk

 

Building this version of Roller requires Apache Maven 3.

  - How to build Roller: https://cwiki.apache.org/confluence/x/EM4

  - To build and run Roller on Eclipse: https://cwiki.apache.org/confluence/x/EM4

 

---------------------------

BUILDING FOR APACHE TOMCAT

 

The normal Roller build creates a product suitable for use on Tomcat 6 or later,

which includes OpenJPA bytecode enhancement, OpenJPA and other Java EE jars.

 

After pulling the source tree and changing directory to its top level, as

indicated above, the following command will build and run all unit tests:

 

   mvn clean

   mvn install

 

After doing that, you should find the newly built Roller webapp, suitable

for use with Tomcat in weblogger-web/target/roller. 

 

To build Roller release files, you do this:

 

   cd weblogger-war-assembly

   mvn -Dtomcat=true install

   cd ..

 

   cd weblogger-assembly

   mvn -Dtomcat=true install

   cd ..

 

After that, you'll find Roller distribution files in weblogger-assembly/target. 

The Tomcat specific release files will have 'for-tomcat' in their names.

 

See the script build-tomcat-release.sh to see the sequence of commands used

to create Roller releases for Tomcat.

 

 

---------------------------

BUILDING FOR JAVA EE 6

 

The Tomcat build includes extra things that are not needed on a full Java EE

application server. In fact, the Tomcat release won't work on some Java EE 

servers. If we leave those extra things out, Roller can run on most Java EE 

servers.

 

If you add a 'javaee' flag to the Roller build invocation, you can create 

Roller release files that will work on a Java EE 6 app server.

 

    mvn clean

    mvn -Djavaee=true install

 

    cd weblogger-war-assembly

    mvn -Djavaee=true install

    cd ..

 

    cd weblogger-assembly

    mvn -Djavaee=true install

    cd ..

 

When that finishes, you will find Roller distribution files in 

weblogger-assembly/target. The Java EE specific release files will have 

'for-javaee' in their names.

 

See the script build-javaee-release.sh to see the sequence of commands used

to create Roller releases for Java EE.

 

 

---------------------------

BUILDING FOR JBOSS 6

 

JBoss 6 is a Java EE server, but due to differences in JNDI naming, it needs

a separate build. If you add a 'jboss' flag to the Roller build invocation, 

you can create Roller release files that will work on a JBoss 6 app server.

 

    mvn clean

    mvn -Djboss=true install

 

    cd weblogger-war-assembly

    mvn -Djboss=true install

    cd ..

 

    cd weblogger-assembly

    mvn -Djboss=true install

    cd ..

 

When that finishes, you will find Roller distribution files in 

weblogger-assembly/target. The Java EE specific release files will have 

'for-jboss' in their names.

 

See the script build-jbossee-release.sh to see the sequence of commands used

to create Roller releases for JBoss.

 

 

---------------------------

NOTES

 

1) Set MAVEN_OPTS to include your preferred server

 

If you always build for one server, then you might wish to define 

MAVEN_OPTS to include your preferred server flag, for example:

 

   export MAVEN_OPTS=${MAVEN_OPTS} -Dtomcat=true

 

2) Building other versions of Roller

 

If you wish to pull a branch other than the trunk, replace the word

"trunk" in both lines above with the appropriate branch name.  Note that

versions of Roller before 5.0 have an Ant-based build.  In general, you should

be able to follow instructions accompanying the sources that you pull in order

to build that version.