JarCastingMycontainer
Purpose
Mycontainer is a generic test and development enviroment. Check it out.
- Starting all modules from maven
- Start a local web server
- TCP Tunnels
- Checking for non us-ascii files
- Installing PhantomJS
- Maven Repository
- Building Mycontainer
- Embedding Mycontainer to do some GAE stuff
- Embedding Mycontainer to do some Java EE stuff
- Very Old Versions
@Before
You will need java and maven
Starting all modules from maven
Configure mycontainer maven plugin: pom.xml
Write the beanshell: mycontainer-start.bsh. You can write this in any java class and just use that in beanshell
mvn mycontainer:start
Start a local web server
No pom.xml required. And it is nice to quick start html, javascript and css projects.
$ mvn com.googlecode.mycontainer:mycontainer-maven-plugin:web -Dmycontainer.web.port=8080
TCP Tunnels
Mycontainer can start multiple tcp tunnels. You can do this using java -cp or mvn (pom.xml is not required)
$ java -cp mycontainer-util.jar com.googlecode.mycontainer.util.tunnel.Tunnels Redirect 0.0.0.0:6667:chat.freenode.net:6667 5080:google.com:80
You can get this jar here
The first argument can be Console (System.out) or Log (slf4j/jdk-logging) to show transfered data. Or Redirect to just redirect it silently.
Others arguments describes tunnels to startup. [local-host]:local-port:remote-host:remote-port.
local-host is not required (default 127.0.0.1). Use 0.0.0.0 to bind on all interfaces.
local-port can be zero to bind on a free random port.
You can also start it by maven (pom.xml is not required). It is an aggregator plugin.
$ mvn com.googlecode.mycontainer:mycontainer-maven-plugin:tunnels -Dmycontainer.tunnels.list=5000:localhost:6000,0.0.0.0:6667:chat.freenode.net:6667 -Dmycontainer.tunnels.handler=Console
Like the java -cp you need to tell Redirect, Console or Log (mycontainer.tunnels.handler) and tunnels (mycontainer.tunnels.list) separeted by comma.
Checking for non us-ascii files
Checking recursively for non-ascii files (pom.xml is not required):
$ mvn com.googlecode.mycontainer:mycontainer-maven-plugin:us-ascii
You can configure your pom.xml to check it on test maven phase like we do pom.xml. Use <inherited>false</inherited> if you are configuring your root pom.xml at multi modules project.
Installing PhantomJS
Mycontainer has a plugin to install PhantomJS.
- Download packages from original host: https://bitbucket.org/ariya/phantomjs/downloads
- Install the correct package (windows, macosx, linux).
- No pom.xml required
- It set a maven property to the phantomjs executable:
mycontainer.phantomjs.executable
Maven command:
$ mvn com.googlecode.mycontainer:mycontainer-maven-plugin:phantomjs-install -Dmycontainer.phantomjs.dest=target/phantomjs -Dmycontainer.phantomjs.version=1.9.2
Maven Repository
This project is deployed to maven central repository. Example:
<dependency>
<groupId>com.googlecode.mycontainer</groupId>
<artifactId>mycontainer-web</artifactId>
<version>${mycontainer.version}</version>
</dependency>
Building Mycontainer
mvn clean install
Use -Ddist to assembly a all-in-one jar and a binary zip.
Speed up the process:
mvn clean install -Dmaven.test.skip.exec -T 10 && mvn test
Embedding Mycontainer to do some GAE stuff
Configure pom.xml to Google App Engine
Use GAETestHelper.java or code like that.
Google has LocalServiceTestHelper to do unit tests, but it requires a thread environment. It means we need to keep the env to each request thread. This filter LocalServiceTestHelperFilter.java does the job using a non-documented google class ApiProxy.
Embedding Mycontainer to do some Java EE stuff
Configure InitialContext. You can do with jndi.properties
Code like MycontainerTestHelper.java to embed anywhere.
Here is a junit sample: AbstractWebBaseTestCase.java / MycontainerWebTest.java
- Embeddable on any java application (junit tests, jetty, tomcat, and any others)
- Programmatic configuration and deploy
- Light weight
- Fast boot
- Do not hijack the Java Virtual Machine (real embeddable):
- Do not change JVM URL protocols configs
- No dynamic classloader
- No classloader isolation