Revision as of 01:57, 22 September 2009

• Maven2 release repository: http://caucho.com/m2
• Maven2 snapshot repository: http://caucho.com/m2-snapshot

• groupId - com.caucho

Artifacts

• resin : main Resin jar
• resin-ant : ant plugins
• resin-ejb : ejb api
• resin-hessian : Hessian and Burlap jar
• resin-jsdk : servlet api
• resin-maven-plugin : maven plugin
• resin-quercus : Quercus
• resin-util : utilities shared for resin and quercus
• resin-support : plugins and drivers for third-party
• resin-webbeans : webbeans api (early draft)

The Resin Maven plugin supports the following commands:

 mvn resin:run
 mvn resin:jspc

resin:run starts a Resin instance pointing to your build directory

resin:jspc compiles JSP files in the build directory

Step by Step for resin:run

1. install maven from http://maven.apache.org
2. Create an empty .war project (see http://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)

   unix> mvn archetype:create \
       -DarchetypeGroupId=org.apache.maven.archetypes \
       -DarchetypeArtifactId=maven-archetype-webapp \
       -DgroupId=com.mycompany.app \
       -DartifactId=my-webapp
   

3. Add the caucho release repository to my-webapp/pom.xml

   <project ...>
     ...
      <pluginRepositories>
         <pluginRepository>
           <id>caucho</id>
           <name>Caucho</name>
           <url>http://caucho.com/m2</url>
         </pluginRepository>
       </pluginRepositories>
     ...
   </project>  
   

4. Add the resin plugin to my-webapp/pom.xml

   <project ...>
      ...
     <build>
       <finalName>my-webapp</finalName>
   
         <plugins>
   	<plugin>
             <groupId>com.caucho</groupId>
             <artifactId>resin-maven-plugin</artifactId>
             <version>3.1.5</version>
   	</plugin>
         </plugins>
     </build>
   

5. Compile and start resin with "mvn resin:run"
6. Browse http://localhost:8080/my-webapp

Pointing Resin to the build directory

Resin can point a web-app directly to the Maven build directory, letting you deploy automatically without involving any extra maven plugins. The resin.conf configuration looks like:

 <resin xmlns="http://caucho.com/ns/resin">
    ...
    <cluster id="">
      ...
      <host id="">
        ...
        <web-app id="my-webapp" 
                            root-directory="/home/ferg/maven/my-webapp/target/my-webapp"/>
        ...

You can also grab a generated .war file directly and have it expand into your own Resin workspace, by setting the 'archive-path' attribute of a <web-app> defined in the resin.conf:

  <resin ...
      ...
      <host id="">
      ...
         <web-app id="/my-webapp" root-directory="my-webapp-dir"
                             archive-path="/home/ferg/maven/my-webapp/target/my-webapp.war"/>
      ...

Adding Resin plugin to pom.xml

To add Resin plugins to your maven build, modify the pom.xml as follows:

 <project ...>
   ...
 
    <pluginRepositories>
      <pluginRepository>
        <id>caucho-snap</id>
        <name>Caucho Snapshots</name>
        <url>http://caucho.com/m2-snapshot</url>
      </pluginRepository>
    </pluginRepositories>
 
   ...
 
    <build>
      ...
      <plugins>
        <plugin>
          <groupId>com.caucho</groupId>
          <artifactId>resin-maven-plugin</artifactId>
          <version>3.1-SNAPSHOT</version>
        </plugin>
      </plugins>
 
    </build
 </project>

resin:run

On the command line, you can then use

 mvn resin:run

resin:run will start a new Resin instance based on your maven build area. You can then browse the instance directly to verify your code.

resin:jspc

The resin:jspc plugin will precompile any JSP files in your project, putting the compiled classes in the usual WEB-INF/work.

Resin deployment plugins

Mojo and parameter summary