Author: jlmonteiro
Date: Thu Nov 8 21:51:26 2012
New Revision: 1407283
URL: http://svn.apache.org/viewvc?rev=1407283&view=rev
Log:
Renaming, refactoring arquillian and TomEE MP
Added:
openejb/site/trunk/content/arquillian-available-adapter.mdtext
- copied, changed from r1407275,
openejb/site/trunk/content/arquillian-available-adapter.md
openejb/site/trunk/content/arquillian-getting-started.mdtext
- copied, changed from r1407275,
openejb/site/trunk/content/arquillian-getting-started.md
openejb/site/trunk/content/tomee-mp-getting-started.mdtext
- copied, changed from r1407275,
openejb/site/trunk/content/tomee-mp-getting-started.md
Removed:
openejb/site/trunk/content/arquillian-available-adapter.md
openejb/site/trunk/content/arquillian-getting-started.md
openejb/site/trunk/content/arquillian.mdtext
openejb/site/trunk/content/tomee-mp-getting-started.md
Copied: openejb/site/trunk/content/arquillian-available-adapter.mdtext (from
r1407275, openejb/site/trunk/content/arquillian-available-adapter.md)
URL:
http://svn.apache.org/viewvc/openejb/site/trunk/content/arquillian-available-adapter.mdtext?p2=openejb/site/trunk/content/arquillian-available-adapter.mdtext&p1=openejb/site/trunk/content/arquillian-available-adapter.md&r1=1407275&r2=1407283&rev=1407283&view=diff
==============================================================================
--- openejb/site/trunk/content/arquillian-available-adapter.md (original)
+++ openejb/site/trunk/content/arquillian-available-adapter.mdtext Thu Nov 8
21:51:26 2012
@@ -0,0 +1,226 @@
+Title: TomEE and Arquillian
+
+{info
+See [Arquillian.org](http://arquillian.org) for some great quickstart
information on Arquillian itself.
+}
+
+All the Aqruillian Adapters for TomEE support the following configuration
options in the arquillian.xml:
+
+ <container qualifier="tomee" default="true">
+ <configuration>
+ <property name="httpPort">0</property>
+ <property name="stopPort">0</property>
+ </configuration>
+ </container>
+
+The above can also be set as system properties rather than via the
arquillian.xml file.
+
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <configuration>
+ <systemPropertyVariables>
+ <tomee.httpPort>0</tomee.httpPort>
+ <tomee.stopPort>0</tomee.stopPort>
+ </systemPropertyVariables>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+
+When a port is set to zero, a random port will be chosen. This is key to
avoiding port conflicts on CI systems or for just plain clean testing.
+
+The TomEE Arquillian adapters will export the actual port chosen back as a
system propert using the same name. The test case can use the property to
retrieve the port and contact the server.
+
+ URL url = new URL("http://localhost:"; +
System.getProperty("tomee.httpPort");
+ // use the URL to connect to the server
+
+
+# TomEE Embedded Adapter
+
+The TomEE Embedded Adapter will boot TomEE right inside the testcase itself
resulting in one JVM running both the application and the test case.
+This is generally much faster than the TomEE Remote Adapter and great for
development. That said, it is strongly recommended to also run all tests in a
Continous Integration
+system using the TomEE Remote Adapter.
+
+To use the TomEE Embedded Arquillian Adapter, simply add this Maven dependency
to your Arquillian setup:
+
+ <dependency>
+ <groupId>org.apache.openejb</groupId>
+ <artifactId>arquillian-tomee-embedded</artifactId>
+ <version>1.0.0</version>
+ </dependency>
+
+As mentioned above the Embedded Adapter has the following properties which can
be specified in the `arquillian.xml` file:
+
+ - `httpPort`
+ - `stopPort`
+
+Or alternatively as System properties, possibly shared with other TomEE
Arquillian Adapters:
+
+ - `tomee.httpPort`
+ - `tomee.stopPort`
+
+Or more specifically as a System properties only applicable to the Embedded
Adapter:
+
+ - `tomee.embedded.httpPort`
+ - `tomee.embedded.stopPort`
+
+
+# TomEE Remote Adapter
+
+The TomEE Remote Adapter will unzip and setup a TomEE or TomEE Plus
distribution. Once setup, the server will execute in a separate process. This
will be slower, but
+with the added benefit it is 100% match with the production system.
+
+The following shows a typical configuration for testing against TomEE
(webprofile version). The same can be done against TomEE+ by changing
`<tomee.classifier>webprofile</tomee.classifier>` to
`<tomee.classifier>plus</tomee.classifier>`
+
+ <properties>
+ <tomee.version>1.0.0</tomee.version>
+ <tomee.classifier>webprofile</tomee.classifier>
+ </properties>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <configuration>
+ <systemPropertyVariables>
+ <tomee.classifier>${tomee.classifier}</tomee.classifier>
+ <tomee.version>${tomee.version}</tomee.version>
+ </systemPropertyVariables>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.openejb</groupId>
+ <artifactId>arquillian-tomee-remote</artifactId>
+ <version>${tomee.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.openejb</groupId>
+ <artifactId>apache-tomee</artifactId>
+ <version>${tomee.version}</version>
+ <classifier>${tomee.classifier}</classifier>
+ <type>zip</type>
+ </dependency>
+ </dependencies>
+
+The Remote Adapter has the following properties which can be specified in the
`arquillian.xml` file:
+
+ - `httpPort`
+ - `stopPort`
+ - `version`
+ - `classifier` (must be either `webprofile` or `plus`)
+
+Or alternatively as System properties, possibly shared with other TomEE
Arquillian Adapters:
+
+ - `tomee.httpPort`
+ - `tomee.stopPort`
+ - `tomee.version`
+ - `tomee.classifier`
+
+Or more specifically as a System properties only applicable to the Remote
Adapter:
+
+ - `tomee.remote.httpPort`
+ - `tomee.remote.stopPort`
+ - `tomee.remote.version`
+ - `tomee.remote.classifier`
+
+# Maven Profiles
+
+Setting up both adapters is quite easy via maven profiles. Here the default
adapter is the Embedded Adapter, the Remote Adapter will run with
`-Ptomee-webprofile-remote` specified as a `mvn` command argument.
+
+ <profiles>
+
+ <profile>
+ <id>tomee-embedded</id>
+ <activation>
+ <activeByDefault>true</activeByDefault>
+ </activation>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.openejb</groupId>
+ <artifactId>arquillian-tomee-embedded</artifactId>
+ <version>1.0.0</version>
+ </dependency>
+ </dependencies>
+ </profile>
+
+ <profile>
+ <id>tomee-webprofile-remote</id>
+ <properties>
+ <tomee.version>1.0.0</tomee.version>
+ <tomee.classifier>webprofile</tomee.classifier>
+ </properties>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <configuration>
+ <systemPropertyVariables>
+ <tomee.classifier>${tomee.classifier}</tomee.classifier>
+ <tomee.version>${tomee.version}</tomee.version>
+ </systemPropertyVariables>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.openejb</groupId>
+ <artifactId>arquillian-tomee-remote</artifactId>
+ <version>${tomee.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.openejb</groupId>
+ <artifactId>apache-tomee</artifactId>
+ <version>${tomee.version}</version>
+ <classifier>${tomee.classifier}</classifier>
+ <type>zip</type>
+ </dependency>
+ </dependencies>
+ </profile>
+
+ <profile>
+ <id>tomee-plus-remote</id>
+ <properties>
+ <tomee.version>1.0.0</tomee.version>
+ <tomee.classifier>plus</tomee.classifier>
+ </properties>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <configuration>
+ <systemPropertyVariables>
+ <tomee.classifier>${tomee.classifier}</tomee.classifier>
+ <tomee.version>${tomee.version}</tomee.version>
+ </systemPropertyVariables>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.openejb</groupId>
+ <artifactId>arquillian-tomee-remote</artifactId>
+ <version>${tomee.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.openejb</groupId>
+ <artifactId>apache-tomee</artifactId>
+ <version>${tomee.version}</version>
+ <classifier>${tomee.classifier}</classifier>
+ <type>zip</type>
+ </dependency>
+ </dependencies>
+ </profile>
+
+ </profiles>
+
+
Copied: openejb/site/trunk/content/arquillian-getting-started.mdtext (from
r1407275, openejb/site/trunk/content/arquillian-getting-started.md)
URL:
http://svn.apache.org/viewvc/openejb/site/trunk/content/arquillian-getting-started.mdtext?p2=openejb/site/trunk/content/arquillian-getting-started.mdtext&p1=openejb/site/trunk/content/arquillian-getting-started.md&r1=1407275&r2=1407283&rev=1407283&view=diff
==============================================================================
--- openejb/site/trunk/content/arquillian-getting-started.md (original)
+++ openejb/site/trunk/content/arquillian-getting-started.mdtext Thu Nov 8
21:51:26 2012
@@ -0,0 +1,5 @@
+Title: Getting started with Arquillian and TomEE
+
+{info
+See [Arquillian.org](http://arquillian.org) for some great quickstart
information on Arquillian itself.
+}
Copied: openejb/site/trunk/content/tomee-mp-getting-started.mdtext (from
r1407275, openejb/site/trunk/content/tomee-mp-getting-started.md)
URL:
http://svn.apache.org/viewvc/openejb/site/trunk/content/tomee-mp-getting-started.mdtext?p2=openejb/site/trunk/content/tomee-mp-getting-started.mdtext&p1=openejb/site/trunk/content/tomee-mp-getting-started.md&r1=1407275&r2=1407283&rev=1407283&view=diff
==============================================================================
--- openejb/site/trunk/content/tomee-mp-getting-started.md (original)
+++ openejb/site/trunk/content/tomee-mp-getting-started.mdtext Thu Nov 8
21:51:26 2012
@@ -0,0 +1 @@
+Title: TomEE Maven Plugin
\ No newline at end of file
