From Resin 3.0

Revision as of 01:57, 22 September 2009 by Emil (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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

groupId - com.caucho

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

install maven from http://maven.apache.org

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

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>

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>

Compile and start resin with "mvn resin:run"
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

Mojo	Parameter name	System property	Required?	Default	Description
Common properties for all Mojos	server	resin.server	Yes	N/A	The IP or address of the Resin server
	port	resin.port	Yes	N/A	The port of the Resin server's HTTP port
	user	resin.user	Yes	N/A	The user to use when logging into the Resin server
	password	resin.password	Yes	N/A	The password to use when logging into the Resin server
	commitMessage	resin.commitMessage	No	N/A	The commit message to log for any changes to the application repository
resin:upload-war	warFile	resin.warFile	Yes	${project.build.directory}/${project.build.finalName}.war (the war file produced for the project)	The war file to upload to the Resin server
	stage	resin.stage	No	"default"	The stage to use for the deployed application
	virtualHost	resin.virtualHost	No	"default"	The virtual host to use for the deployed application
	contextRoot	resin.contextRoot	Yes	/${project.build.finalName} (the "final name" of the project)	The context root of the deployed application
	version	resin.version	No	N/A	The version to use for the deployed application
	archive	resin.archive	No	false	When set to true, an archive tag is set in addition to the main tag. Can also be an explicit tag.
	writeHead	resin.writeHead	No	true	When set to true and using versioning, a "head" tag is also set.
resin:copy-tag	stage	resin.stage	No	"default"	The stage of the target tag
	virtualHost	resin.virtualHost	No	"default"	The virtual host of the target tag
	contextRoot	resin.contextRoot	Yes (if tag not given)	/${project.build.finalName} (the "final name" of the project)	The context root of the target tag
	version	resin.version	No	N/A	The version of the target tag
	sourceStage	resin.sourceStage	No	"default"	The stage of the source tag
	sourceVirtualHost	resin.sourceVirtualHost	No	"default"	The virtual host of the source tag
	sourceContextRoot	resin.sourceContextRoot	Yes (if sourceTag not given)	N/A	The context root of the source tag
	sourceVersion	resin.sourceVersion	No	N/A	The version of the source tag
	tag	resin.tag	Yes (if contextRoot not given)	N/A	An explicit target tag
	sourceTag	resin.sourceTag	Yes (if sourceContextRoot not given)	N/A	An explicit source tag
resin:delete-tag	stage	resin.stage	No	"default"	The stage of the tag to be deleted
	virtualHost	resin.virtualHost	No	"default"	The virtual host of the tag to be deleted
	contextRoot	resin.contextRoot	Yes (if tag not given)	/${project.build.finalName} (the "final name" of the project)	The context root of the tag to be deleted
	version	resin.version	No	N/A	The version of the tag to be deleted
	tag	resin.tag	Yes (if contextRoot not given)	N/A	An explicit tag to be deleted
resin:query-tags	stage	resin.stage	Yes (At least one pattern (either stage, virtualHost, contextRoot, version, or pattern) must be given	"default"	The query pattern for the stage portion of tags in the repository
	virtualHost	resin.virtualHost	Yes (At least one pattern (either stage, virtualHost, contextRoot, version, or pattern) must be given	"default"	The query pattern for the virtual host portion of tags in the repository
	contextRoot	resin.contextRoot	Yes (At least one pattern (either stage, virtualHost, contextRoot, version, or pattern) must be given	/${project.build.finalName} (the "final name" of the project)	The query pattern for the context root portion of tags in the repository
	version	resin.version	Yes (At least one pattern (either stage, virtualHost, contextRoot, version, or pattern) must be given	N/A	The query pattern for the version portion of tags in the repository
	pattern	resin.pattern	Yes (At least one pattern (either stage, virtualHost, contextRoot, version, or pattern) must be given	N/A	An explicit query pattern for entire tags in the repository

Maven2

From Resin 3.0

Contents

Artifacts

Step by Step for resin:run

Pointing Resin to the build directory

Adding Resin plugin to pom.xml

resin:run

resin:jspc

Resin deployment plugins

Mojo and parameter summary

Views

Personal tools

Navigation

Search

Toolbox