Using the WebLogic Embedded EJB Container

The WebLogic Server 12.1.3 EJB Developers Guide was recently updated to note that the embedded EJB container can be used by adding a reference to weblogic.jar to the CLASSPATH when the EJB client is being executed.

https://docs.oracle.com/middleware/1213/wls/EJBAD/embedejb.htm#EJBAD1403

This is very convenient since it enables the WebLogic Server embedded EJB container to used by simply adding weblogic.jar to the classpath when running the client:

$ java -classpath ${CLASSPATH}:${ORACLE_HOME}/wlserver/server/lib/weblogic.jar

view raw cmd line run with weblogic.jar hosted with ❤ by GitHub

Or for example if you are developing unit tests using JUnit and running them from a maven project, you can configure the maven-surefire-plugin to use WebLogic Server to run the EJB test code in its embedded EJB container:

	<properties>
	<weblogic.jar.path>${oracle.home}/wlserver/server/lib/weblogic.jar</weblogic.jar.path>
	</properties>
	....
	<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-surefire-plugin</artifactId>
	<version>2.18</version>
	<configuration>
	<argLine>-Xmx128m</argLine>
	<enableAssertions>false</enableAssertions>
	<classpathDependencyScopeExclude>compile</classpathDependencyScopeExclude>
	<additionalClasspathElements>
	<additionalClasspathElement>${weblogic.jar.path}</additionalClasspathElement>
	</additionalClasspathElements>
	</configuration>
	</plugin>

view raw pom.xml for maven-surefire-plugin with wls hosted with ❤ by GitHub

A fully working example of using this is available in this GitHub repository:

https://github.com/buttso/weblogic-embedded-ejb

For more information have a look at the repository and check out the example.