Following good multi-tier architecture, most applications will have at least two tiers. With two tiers the presentation- and business-code reside on the first tier and the second tier is typically the database. Sometimes, applications go with more than two tiers. When this happens, figure 1 (Multitier architecture, 2001) shows how the presentation- and business-tiers are separated and stand on their own.
Figure 1: Multitier architecture
"Overview of a three-tier application vectorVersion" by Bartledan (talk), based on a file by User:Foofy. Original uploader was Bartledan at en.wikipedia - Transferred from en.wikipedia; transfer was stated to be made by User:Sliwers.(Original text : I created this work based on en:File:Overview_of_a_three-tier_application.png). Licensed under Public domain via Wikimedia Commons.
"Overview of a three-tier application vectorVersion" by Bartledan (talk), based on a file by User:Foofy. Original uploader was Bartledan at en.wikipedia - Transferred from en.wikipedia; transfer was stated to be made by User:Sliwers.(Original text : I created this work based on en:File:Overview_of_a_three-tier_application.png). Licensed under Public domain via Wikimedia Commons.
Once you move to this three (or more) tier architecture you must ask yourself, how will the presentation- and business-tiers communicate with each other? Java EE has a number of options including:
- Remote EJB
- Return serialized object
- Servlet
- Return serialized object
- JAX-RS (REST Service)
- Return JSON/Text
- JAX-WS (Web Service)
- Return SOAP/XML
Having recently finished co-authoring EJB 3 In Action Second Edition and Presenting at JavaOne on EJB Best Practices, I am biased toward EJB technology. Naturally I assume it is the fastest technology for communicating between presentation- and business-tiers. The purpose of this article is present my results of a experiment I designed which put these four technologies up against each other to see which one would win the race. If you are just interested in the results, jump down to the Results section.
Authors
The experiment and results described in this article are the result of work from two people.
Michael Remijan
Java EE Architect, developer, researcher, evangelist. Author, writer, instructor.
LinkedIn, Twitter, Tumbler
Timothy Taylor
Java developer, architect.
System Requirements
The code was developed and run using the following system setup. If yours is different, it may work but no guarantees.
Development Environment
- JDK 1.7.0_65
- NetBeans 8.0
- Maven 3.0.5 (bundled with NetBeans)
- Glassfish 4.0
Presentation-tier Server
- Dell Inspiron 15 7000 Series
- Windows 8.1
- Intel(R) Core(TM) i7-4500U CPU @ 1.80GHz
- 16.0 GB RAM
- 64-bit
- Intel(R) Wireless-N 7260
- MSI Computer Corp GT70 0ND-444US
- Windows 8.1 Pro with Media Center
- Intel(R) Core(TM) i7-3630QM CPU @ 2.40GHz
- 12.0 GB RAM
- 64-Bit
- Intel(R) Centrino(R) Wireless-N 2230
- Netgear Genie R6300v2
- Channel: Auto
- Mode: Up to 450 Mbps
- Security: WPA2-PSK [AES]
- 5GHz a/n/ac
The project is on GitHub.
Project Structure
Let's start with an understanding of the projects in GitHub.
The top-level directory is /ejbrace. This is a Maven parent POM project which references the modules underneath it.
The modules inside of /ejbrace are as follows:
- /ejbrace-business-ear
- /ejbrace-ejb
- /ejbrace-model
- /ejbrace-presentation-ear
- /ejbrace-service
- /ejbrace-web
Shared Code
- /ejbrace-model
- This is a basic shared library of the beans in your business model.
- /ejbrace-web
- A Maven WAR project
- This is the WebApp used to perform the experiment
- /ejbrace-presentation-ear
- Maven EAR project
- EAR is deployed on the presentation-tier.
- EAR contains:
- The WAR from /ejbrace-web
- /ejbrace-ejb
- Maven EJB-JAR project
- These are the remote EJBs for the experiment
- /ejbrace-service
- Maven WAR project
- JAX-RS for the experiment
- JAX-WS for the experiment
- Servlet for the experiment
- /ejbrace-business-ear
- Maven EAR project
- EAR is deployed on the business-tier
- EAR contains:
- EJB-JAR from /ejbrace-ear
- WAR from /ejbrace-service
Before running the applications, there are a few source code and server configurations which need to be made. So let's take a look at them.
Source Code
The following files and classes in the /ejbrace-war project have hard-coded URL values and server names. You you need to update these values for your environment before building and deploying the EAR to your presentation-tier.
- org.ferris.ejbrace.web.servlet.CallToJaxRs
- org.ferris.ejbrace.web.servlet.CallToJaxWs
- org.ferris.ejbrace.web.servlet.CallToServlet
- /WEB-INF/glassfish-web
Presentation-tier
For the experiment, the servlets in the /ejbrace-war project repeatedly call the services deployed on the business-tier and maintain statistics of performance. The number for "repeatedly" is determined by a JNDI Custom Resource. This resource is configured by the GlassFish administration console. Figure 2 shows how to to create the numberOfCalls JNDI Custom Resource. I wrote a previous blog on using JNDI Custom Resources which goes into more detail.
Figure 2: The numberOfCalls JNDI Custom Resource
The numberOfCalls JNDI Custom Resource is created with the information shown in figure 2 which consists of:
- A: Go to "Resources/JNDI/Custom Resources" to add a new one
- B: JNDI Name is numberOfCalls
- C: Resource Type is java.lang.Integer
- D: FactoryClass will default to org.glassfish.resources.custom.factory.PrimitivesAndStringFactory which is fine.
- E: There should only be one property, with Name value
- F: The value is any integer you want it to be.
Having numberOfCalls as a JNDI Custom Resource is nice because the value can be changed on the fly without having to rebuild and redeploy the code. Now that we've covered configuring the code and the presentation-tier, let's look at the final configuration of GlassFish on the business-tier.
Business-tier
Configuring GlassFish on the business-tier may be optional for you. I found it was necessary for me because of some quirks in my home network. You may need to configure of the ORB IIOP listener on the business-tier. IIOP is the commnication protocol for remote EJBs. Figure 3 shows this optional configuration.
Figure 3: ORB IIOP Listener
- A: /Configuration/default-config/ORB/IIOP Listeners/orb-listener-1
- B: Network Address is the IP address of the business-tier server.
Now that we've looked at configuration of the code and configuration of both GlassFish instances, let's look at deployment next.
Deployment
Deployment should be pretty easy. Just drop the EAR files and your done. . .well almost. Let's take a look.
Presentation-tier
On the presentation-tier you deploy the EAR file generated by the /ejbrace-presentation-ear project. Using the GlassFish administration console, just select the EAR and deploy. No values need to be changed. The application.xml file will set the context root for the WAR. Once deployed, you will have the following on the presentation-tier.
- http://localhost:8080/ejbrace
- /ejbrace-war WAR project
On the business-tier you deploy the EAR file generated by the /ejbrace-business-ear project. Deploying to the business-tier is almost as easy as the presentation-tier, except for one small difference. When you use the GlassFish administration console to deploy you MUST remember to change the application name to ejbrace-business as shown in figure 4.
Figure 4: Application name for /ejbrace-business-ear EAR file
- A: Maven builds an EAR file named using artifact-id and version
- B: Application name must be ejbrace-business
java:<namespace>/[app-name]/<module-name>/<bean-name>[!fully-qualified-interface-name]
The value for [app-name] must be ejbrace-business because that is what the presentation-tier is expecting. I have not yet found a way to deploy an EAR with EJBs where the display name in the GlassFish administration console is the Maven file name (so you can easily see versions) but the application name is what I want it to be. If you know how to do this, please answer this question.
Once deployed, you will have the following on the business-tier.
Once deployed, you will have the following on the business-tier.
- java:global/ejbrace-business/ejb/AccountServiceEjb!org.ferris.ejbrace.ejb.AccountService
- /ejbrace-ejb EJB-JAR project
- http://[business-server-name]:8080/ejbrace-service/AccountServiceServlet
- Servlet returning Serialized object
- /ejbrace-service WAR project
- http://[business-server-name]:8080/ejbrace-service/AccountServiceJaxWsService
- JAX-WS returning SOAP/XML
- /ejbrace-service WAR project
- http://[business-server-name]:8080/ejbrace-service/resources/AccountServiceJaxRs/Get
- JAX-RS returning JSON/Text
- /ejbrace-service WAR project
Now that everything is deployed, let's run the experiment.
The experiment is very simple.
First, the /ejbrace-model project builds a LinkedList<Account> object. The list contains 55 Account objects. All of the data in the Account objects are Strings and the values of all the Strings are generated by UUID. For this experiment the data itself isn't important just as long as all the data in the 55 Account objects are unique. The LinkedList<Account> object is also static for the experiment. There is a bit of overhead to build the object model the first time but after that it quickly comes directly from memory.
Second, the business-tier returns the LinkedList<Account> object using the following technologies:
- The /ejbrace-ejb project contains a Remote EJB (AccountServiceEjb) which returns a serialized object over IIOP.
- The /ejbrace-service project contains a Servlet (AccountServiceServlet) which serializes the object to the HttpServletResponse OutputStream.
- The /ejbrace-service project contains a JAX-RS (AccountServiceJaxRs) which returns the object by @Produces(MediaType.APPLICATION_JSON).
- The /ejbrace-service project contains a JAX-WS (AccountServiceJaxWs) which returns the object by SOAP/XML.
Step 1: Set numberOfCalls value to 1
Login to the GlassFish administration console on the presentation-tier. Set the value for numberOfCalls to 1.
The reason to set numberOfCalls to 1 is because we want to run all the tests at least one time so we get all of the code in memory and ready to run as fast as possible.
Step 2: Browse to the WebApp on the presentation-tier
Open a browser to the WebApp on the presentation-tier. If you are running GlassFish with all its defaults, the WebApp is:
http://[presentation-tier-server]:8080/ejbraceThe welcome page for the WebApp is shown in figure 5. It has hyperlinks for performing each experiment.
Figure 5: Welcome page to run all the experiments
Let's take a look at each experiment in more detail.
Get account by remote EJB (Default transaction)
This experiment calls a Remote EJB method which has no @TransactionAttribute on it so it uses the application's servers default transaction.
Get account by remote EJB (Transaction Never)
This experiment calls a Remote EJB method which has @TransactionAttribute(TransactionAttributeType.NEVER) on it.
Get account by remote EJB (Transaction Supports)
This experiment calls a Remote EJB method which has @TransactionAttribute(TransactionAttributeType.SUPPORTS) on it.
Get account by remote Servlet
This experiment calls the Servlet at:
http://[business-server-name]:8080/ejbrace-service/AccountServiceJaxWsService
It uses Apache HttpClientBuilder to make the call.
Get account by remote RESTful Web Service
This experiment calls the JAX-RS RESTful Web Service at:
http://[business-server-name]:8080/ejbrace-service/resources/AccountServiceJaxRs/Get.
It uses the the JAX-RS Client to make the call.
Get account by remote SOAP Web Service
This experiment calls the JAX-WS SOAP Web Service at:
http://[business-server-name]:8080/ejbrace-service/AccountServiceJaxWsService
It uses an AccountServiceJaxWsService object generated by the WSDL to make the call.
Get account by LOCAL EJB
Just for fun, this calls a local version of the Remote EJB.
Step 3: Prepare each experiment
Click through each of the hyperlinks and run each experiment. Because numberOfCalls is set to 1, each experiment should be very quick. This gets everything into memory. When you are done you are ready to run the experiments and get real results.
Step 4: Set numberOfCalls value to 2000
Go back to the GlassFish administration console on the presentation-tier. Set the value for numberOfCalls to 2000. You can use whatever number you want but I ran all my experiments making 2000 calls.
Step 5: Run each experiment
Click through each of the hyperlinks and run each experiment. Because numberOfCalls is set to 2000, each experiment will now take a while. Of course which is the fastest? We'll find out!
Results
When an experiment completes its 2000 loops, the results are displayed as in figure 6.
Figure 6: Results of an experiment
I copied the results (A) into Excel and re-ran the experiment. I ran each experiment 10 times and used Excel to average all 10 runs and draw some pretty graphs.- A: Statistics of the experiment. For this run the business-tier service was called 2000 times and it took a total of 156,655ms to make all 2000 calls
- B: List<Account> of size 55 was returned by the business-tier service.
- C: Print of the first Account from the List<Account>.
Download Excel ResultsA summary of the results of all the experiments shown in Graph 1.
Graph 1: Graph of all runs of all the experiments
From this graph, we can rank the results. From fastest to slowest we have:
- Servlet
- JAX-RS
- Remote EJB
- JAX-WS
So of the 4 technologies on the business-tier - according to this experiment - it looks like a plain old Servlet returning a serialized object is the fastest!
Conclusion
So the results of the experiment show a Servlet returning a serialized object is the fastest whencompared with a Remote EJB returning a serialized object, JAX-RS returning JSON/Text, and JAX-WS returning SOAP/XML.
Does this mean we should be updating all our projects and using nothing but Servlets returning serialized objects from now on? Well, no not so much. Each technology exists for a reason and they all have their uses and are appropriate solutions for the roles they play. But if speed is your goal, then it looks like your business-tier should be basic Servlets returning Serialized objects.
Caveat
Any experiment like this will naturally result a lot of what-if conversation. What if the tiers were Linux instead of Windows? What if you used JBoss instead of GlassFish. What if it was a wired network not wireless? I'm sure you can think of more. If so please download the source code, set up your own experiment, and let me know the results.
References
Jendrock, Cervera- Navarro, Evans, Haase, Markito. (2014, May). Java EE 7 Tutorial. Retrieved August 2014, from http://docs.oracle.com/javaee/7/tutorial/doc/javaeetutorial7.pdf
dwuysan. (2012, December 6). Starting with JAX-RS: Configuring javax.ws.rs.ApplicationPath. Retrieved July 2014, from http://dwuysan.wordpress.com/2012/12/06/starting-with-jax-rs-configuring-javax-ws-rs-applicationpath/
Kops, Micha. (2013, December 30). JAX-RS 2.0 REST Client Features by Example. Retrieved August 2014, from http://www.hascode.com/2013/12/jax-rs-2-0-rest-client-features-by-example/
Marthin. (2013, August 31). deploy REST services on glassfish 4. Retrieved August 2014, from http://stackoverflow.com/questions/18548983/deploy-rest-services-on-glassfish-4
Multitier architecture. (2001, September 25). In Wikipedia. Retrieved September 3, 2014, from http://en.wikipedia.org/w/index.php?title=Multitier_architecture&oldid=621927321
end