Java String Buffer Treated As String In ColdFusion (When Needed)

Posted September 27, 2007 at 8:29 AM by Ben Nadel

Tags: ColdFusion

Just a tiny discovery here: ColdFusion will automatically convert a Java String Buffer to a string when it is required for a method call. Here's a little demo:

  • <!--- Create a Java String Buffer. --->
  • <cfset objBuffer = CreateObject(
  • "java",
  • "java.lang.StringBuffer"
  • ).Init()
  • />
  •  
  • <!--- Add some XML tags to the String Buffer. --->
  • <cfset objBuffer.Append(
  • "<foo>" &
  • "<bar>blam</bar>" &
  • "</foo>"
  • ) />
  •  
  •  
  • <!---
  • Parse the string buffer contents into a
  • ColdFusion XML document object.
  • --->
  • <cfset xmlDoc = XmlParse( objBuffer ) />
  •  
  • <!--- Write string buffer to screen. --->
  • <cfset WriteOutput(
  • HtmlEditFormat( objBuffer )
  • ) />

Here we are storing the contents of an XML document inside the Java String Buffer. Then, we try passing it as an argument to two ColdFusion functions, XmlParse() and HtmlEditFormat(), both of which require a parameter of type String. This code works perfectly well, no ColdFusion errors get thrown.

At first, I assumed that the code is attempting to call the ToString() method on the object or something? But this doesn't exactly make sense because any Java object that extends the java.lang.Object class has a ToString() method, and this auto-string-conversion does NOT work for all data types.

Take, for example, the array. You can call the .ToString() method on a ColdFusion array:

  • #ListToArray( "1,2,3" ).ToString()#

... and it will output:

[1, 2, 3]

However, if you were to pass in the array to the WriteOutput() method, ColdFusion would throw the following error:

Complex object types cannot be converted to simple values. The expression has requested a variable or an intermediate expression result as a simple value, however, the result cannot be converted to a simple value. Simple values are strings, numbers, boolean values, and date/time values. Queries, arrays, and COM objects are examples of complex values.

So, this leads me to believe that ColdFusion isn't just calling .ToString() behind the scenes. I wonder if there is special code in these methods to check for String Buffers.



Reader Comments

Sep 27, 2007 at 10:18 AM // reply »
10 Comments

My guess would be that you are correct in your guess, that CF is calling toString() as a default. I would guess that when known 'complex' objects are passed in, that CF is throwing an error instead of calling the toString() method. If you attempt to output any object in Java, the complier will by default call the toString() method, which is what I would guess is happening here.

My 2 cents of a guess.


Sep 27, 2007 at 10:35 AM // reply »
10,640 Comments

@Rich,

I am thinking your are correct. I tried to create an Object instance (the root Java object) and write that to the output:

<cfset objJava = CreateObject( "java", "java.lang.Object" ).Init() />
<cfset WriteOutput( objJava ) />

And it works fine, outputting:

java.lang.Object@1f6cf3c

So, it looks like it will call ToString() all the object UNLESS it encounters a known complext structure.


Post A Comment

Comment Etiquette: Please do not post spam. Please keep the comments on-topic. Please do not post unrelated questions or large chunks of code. And, above all, please be nice to each other - we're trying to have a good conversation here.

Please review the following issues:

Author Name:


Author Email:

Author Website:

Comment:

Supported HTML tags for formatting: <strong>bold</strong>   <em>italic</em>   <code>code</code>







  • Help Wanted - Find Your Next ColdFusion Job
InVision App - Prototyping Made Beautiful With Prototyping Tools Ben Nadel's Company - Epicenter Consulting Recent Blog Comments
Feb 10, 2012 at 7:21 PM
jQuery AJAX Strips Script Tags And Inserts Them After Parent-Most Elements
Update! Instead of $(eval(options.insertAfter)).after(data['insertData']); I now use: var ajaxNode = document.createElement('span'); var parent = $(eval(options.insertAfter))[0].parentNode; ... read »
Feb 10, 2012 at 6:18 PM
jQuery AJAX Strips Script Tags And Inserts Them After Parent-Most Elements
encountered this same, what I consider, jQuery bug last week. I'm building a site in which I load some content via AJAX. This content contains Linkedin share button placeholders which Linkedin API ne ... read »
Feb 10, 2012 at 11:30 AM
Cross-Origin Resource Sharing (CORS) AJAX Requests Between jQuery And Node.js
After you understand the concepts here, this is an awesome cheatsheet for enabling CORS in just about anything http://enable-cors.org/ ... read »
JM
Feb 10, 2012 at 9:10 AM
My Safari Browser SQLite Database Hello World Example
@Amy, Here is a very good tutorial on how to use JOIN: http://www.sqltutorial.org/sqljoin-innerjoin.aspx ... read »
Feb 10, 2012 at 4:42 AM
Building A Twitter-Inspired RESTful API Architecture In ColdFusion
This is great, very useful Ben. I spotted a small typo in the api.cgm listing: <cfthrow type="Unauthroized" /> Cheers Stefan ... read »
Feb 9, 2012 at 10:35 PM
CFDirectory Filtering Uses Pipe Character For Multiple Filters (Thanks Steve Withington)
I was wondering if there would be a filter you could apply so that you got everything but what you included in the filter. As in show me all docs that are not a .pdf. ... read »
Feb 9, 2012 at 10:29 PM
Learning ColdFusion 9: Application-Specific Data Sources
@Ben, No offence, but if people were really wanting advanced features they would be using a platform like ASP.NET MVC. CFML is so structurally compromised as a tag-based scripting language that ... read »
Feb 9, 2012 at 10:03 PM
Subversion - Cleanup Failed To Process The Following Paths
@Leviaguirre, do you still have problems with this? ... read »