CF10 Hidden Gem: New method to obtain ColdFusion instance name via CFML code
Note: This blog post is from 2012. Some content, links and indeed comments from others may be outdated--though not necessarily. Corrections are welcome, in the comments. I may revise the content if necessary.One of the many hidden gems in CF10 is that there's a new way to programmatically obtain the current instance name. In CF 6-9, we had to call a method in a JRun class. In CF10, they've added a new method in the Admin API.
The quick answer is that there's a getInstanceName method in the runtime.cfc of the Admin API. And yes, any user can execute this code. They do not need to BE an admin. You can use this in production code. For more, see below.
If that's enough to get you going, have at it. For more info, read on.
Why would one need this?
If you have multiple instances of CF installed (in CF 6-10), and especially if you're using load balancing, you may want to know, via code, which instance you're running within, whether for testing purposes, or for diagnostics/troubleshooting, or perhaps as part of some utility.
What was the old way?
The old way was to call a method within a java class in the JRun API. Of course, we can't do that any more in CF10, since it runs atop Tomcat. (For more on that and the differences related to it, see my talk "What's New and Different About CF 10 on Tomcat.)
Here's an example of just one way one might have called and used that Java method and class in prior releases:
What's the new way?
So the new way again is to call the CF admin API, via the getInstanceName method in the Administrator.cfc. Fortunately, it can be called exactly the same way:
(Of course, there are other ways to call such methods, using CFOBJECT, CFINVOKE, or without chaining the method on the createobject. The best choice for you depends on coding style, how many other methods you'll be calling on the object, whether you want to save the object as a shared scope variable for reuse, and so on.)
More on the Admin API
For more on using the Admin API, you could of course find it in the docs (in the "Configuring and Administering CF10" manual), specifically here.
And as I said at the open, this particular method does not require that the user calling it BE an admin user. You could safely put this code in production code that's called by any user, and it will work. (For other methods in this or other AdminAPI CFCs, if you DO need to be an Admin, then you would have to call the login method of the runtime.cfc.)
This new Admin API method is one of many "hidden gems" in CF10 that are not mentioned much. In fact, I can't even now find this method referred to in any of the CF10 docs. :-( If anyone finds where it's listed, please add a comment here. Thanks.
I'll note that I did mention it in a talk I've been giving recently, "Hidden Gems in CF10", which is available as both a PDF and a recording.
I also mention it in my blog entry listing over 200 new features of CF10.
Hope those may be as helpful as this tip on the new API method.
For more like this: