4.0.0
org.glassfish.jersey.tests.memleaks
project
2.38-SNAPSHOT
org.glassfish.jersey.tests.memleaks.testcases
project
pom
jersey-tests-memleak-testcase
Memory leaks test cases.
Tests in this maven submodule can be either:
[1] Simple tests executed by maven-surefire-plugin in a dedicated JVM. These tests should attempt to cause a memory leak
directly. The heap can be configured by means of 'memleak.jvm.maxheap' property. It can be combined with other
infrastructure which is described bellow.
[2] Integration tests executed by maven-surefire-plugin. These tests should test against Jersey application deployed to a
servlet container. The state of the servlet container (e.g., whether OutOfMemoryError occurred) should be inspected by
infrastructure described bellow.
TEST INFRASTRUCTURE
The test infrastructure is configured from Maven and the tests should be executed by Maven. Normally, test-cases shall
override maven properties defined in this pom and declare required maven plugins in their build section. All the maven
plugin executions will be configured from this pom.
[a] Container Runners (org.glassfish.jersey.test-framework.maven:container-runner-maven-plugin) feature Weblogic and
Glassfish4 with functionality: download, start, deploy and stop.
[b] Maven Enforce Custom Rules (org.glassfish.jersey.test-framework.maven:custom-enforcer-rules) that can enforce
non-existent Java Heap dumps files in a certain path or no OutOfMemoryError errors in a log file.
[c] Jetty execution in a dedicated JVM with configured to dump heap on OutOfMemoryError errors.
[d] Common Memleak JUnit test infrastructure that provides means to stop a test after a certain period of time and mark
the test as successful as well as to perform heap dumps from the Java code or to inspect log files for OutOfMemoryError
errors.
EXAMPLE OF EXECUTION
(executes all memleak test cases)
mvn clean install -amd -pl tests/mem-leaks -P gf4,memleak-test-cases -fae
(executes shutdown hook leak single test case)
mvn clean install -am -pl tests/mem-leaks/test-cases/shutdown-hook-leak -P gf4,memleak-test-cases -fae
bean-param-leak
shutdown-hook-leak
shutdown-hook-leak-client
leaking-test-app
300000
${memleak.jvm.maxheap}
${phase.tests.pre-integration-test}
${phase.tests.post-integration-test}
${phase.tests.pre-integration-test}
${phase.tests.post-integration-test}
maven-failsafe-plugin
${memleak.test.timeout}
${external.container.factory}
${external.container.port}
${external.container.contextRoot}
${external.container.logFile}
default
none
re-bound-integration-test
integration-test
${phase.tests.integration-test}
re-bound-verify
verify
${phase.tests.verify}
maven-surefire-plugin
${memleak.test.timeout}
${project.build.directory}
${external.container.factory}
${external.container.port}
${external.container.contextRoot}
-Xmx${memleak.jvm.maxheap} -XX:+HeapDumpOnOutOfMemoryError
-XX:HeapDumpPath=${memleak.jvm.heapdumpdir} -XX:GCTimeLimit=20 -XX:GCHeapFreeLimit=30
default-test
test
${phase.tests.test}
memleak-test-cases
test
pre-integration-test
integration-test
post-integration-test
verify
org.mortbay.jetty
jetty-maven-plugin
${skip.tests}
10
9999
STOP
/${external.container.contextRoot}
-Xms64m -Xmx${memleak.jetty.maxheap} -XX:PermSize=128m -XX:MaxPermSize=256m
-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=${memleak.jvm.heapdumpdir}
-Djetty.port=${external.container.port} -Djersey.config.test.memleak.jetty.magicRunnerIdentifier
-Dorg.slf4j.simpleLogger.logFile=${external.container.logFile}
false
start-jetty
${phase.tests.pre-integration-test.jetty}
run-forked
stop-jetty
${phase.tests.post-integration-test.jetty}
stop
org.slf4j
slf4j-simple
1.7.5
org.apache.maven.plugins
maven-enforcer-plugin
org.glassfish.jersey.test-framework.maven
custom-enforcer-rules
${project.version}
enforce-out-of-memory-did-not-occur
enforce
${phase.tests.post-integration-test}
${memleak.jvm.heapdumpdir}/java_pid*.hprof
${external.container.logFile}
.*java\.lang\.OutOfMemoryError.*
true
org.glassfish.jersey.test-framework.maven
container-runner-maven-plugin
gf4
none
none
wls
none
none
tomcat
none
none