Advantages of ThreadLocal in Java

ThreadLocal is one of the rarely used class in Java. I found it is one of the powerful class in Java on multi-threaded programming. In multi-threaded program generally we use session object to track the current users information.

These information is passed to various method to retrieve desired value. For example in Struts execute method passes HttpServletRequest and HttpServletResponse, what if we want the instance of ServletContext? we have to change the method signature to pass ServletContext. One can use ThreadLocal to keep certain objects/values available throughout the thread execution.

ThreadLocal object is not required on day to day programming unlike ArrayList or HashMap. But it is good choice to solve a few problem at framework level.

In one of my recent project I have used ThreadLocal to expose user specific information like UserPreferences, UserId, Permissions, etc. The main reason is I want hide the code which identifies these values so that in future it is easy to change the behavior and fine tune the code across the application.

A neat example of a “good” use of ThreadLocal is in JSF and FacesContext.getInstance(). Compare this to many other frameworks which forces framework users to pass HttpRequest et al around, polluting method signatures all over the place, because somewhere deep inside there might be some bloody utility method that needs.


  • Code which depends directly on a ThreadLocal can be difficult to test (on par with code which depends directly on a static variable).
  • Remember to explicitly clear the value in ThreadLocal to prevent memory leaks. Don’t forget this, especially if you are using thread pools.
  • ThreadLocal concept is not specific to Java. The same feature is available in many other languages as well. See Wikipedia definition here.

Delicious Digg reddit Facebook StumbleUpon

Related Articles

5 Responses to Advantages of ThreadLocal in Java

  1. Gopi says:

    This article was really enlightening.. ! Thanks!

  2. Jim Manico says:

    ThreadLocal is very clever – but my instinct says to never user it in a clustered or ThreadPool enviornment. All calls to ThreadLocal are essentially synchronized + require a little more overhead. Passing the HTTP request around is a common, simple to understand, and clear method of writing code. Writing code is the easy part – it’s the debugging and maintenance that is the tough part – and ThreadLocal makes that process much more difficult.

    Now, regardless of my opinion your blog post is well written and well through out.

  3. Venkat says:

    One of my friend asked me: “Is it good to use ThreadLocal?”
    My answer: I don’t see ThreadLocal as an optional solution I see as a mandatory solution. For example can you think of designing web application without session-id tracking? In connection less protocol session id is mandatory to identify current user. Similarly in multi-threaded design ThreadLocal is a mandatory solution to identify current thread context/info.

  4. Agus says:

    Another typical use of ThreadLocal is to pass on the persistence session (and associated transaction) from the action controller to the DAO class in Hibernate-based web applications.

  5. Rajiv says:

    One example of ThreadLocal is to encapsulate DateFormat in ThreadLocal and share it as shown here

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: