Language enhancements in cold fusion 11

© 2011 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential.

Language Enhancements in ColdFusion 11 (Splendor) Ram Kulkarni

1

@ram_kulkarni

ramkulkarni.com


Language Enhancements in ColdFusion 11

§  Full CFScript support

§  Member functions for data types §  JSON enhancements

§  Query functions

§  Elvis operator

§  Built-in functions as data type

§  Collection functions

§  Application specific dynamic datasource

2


Tags in CFScript

3


Tags in CFScript

§  Can call most tags in cfscript

§  Call tags as functions §  Name of the function is same as tag name §  Attributes are passed as name-value pair separated by comma

§  Example <cfscript> cfdocument (format="PDF" ,src="report.cfm"); </cfscript>

4


Tags in CFScript– child tags

<cfscript> cfchart ( format="html") { cfchartseries (type="bar", seriescolor="##4dc", label="Sales") { cfchartdata (item="Jan" ,value="100" ); cfchartdata (item="Feb" ,value="400" ); cfchartdata (item="Mar" ,value="200" ); cfchartdata (item="Aprl" ,value="500" ); cfchartdata (item="May" ,value="700" ); cfchartdata (item="Jun" ,value="300" ); } }

</cfscript>

5


Tags in CFScript– using writeoutput

<cfscript>name = "Ram";cfsavecontent (variable="var1" ){ writeOutput("");

writeOutput("Hello #name# !");}writeOutput(var1);

</cfscript>

6


Custom Tags in CFScript

Call custom tags in cfscript with “cf_” prefix <cfscript>

cf_sayHello(name="Ram");</cfscript>Using imported custom tags <cfimport prefix="hello" taglib="customtags"><cfscript>

hello:sayHello(name="Ram");</cfscript>

7


Tags not available in CFScript

§  cfscript §  cfoutput §  cfdump §  cfinvoke §  cfinvokeargument §  cfobject §  cfset

8


Data Type Member Functions

9


Member Functions for Data Types

§  Access functions on data types as member functions Example <cfscript>

st = { firstName: "Ram", lastName: "Kulkarni"};writeDump(st.find("firstName"));//structFind(st,"firstName");st.append({company:"Adobe"});//structAppend(st,{company:"Adobe"});writeDump(st);

</cfscript>

10


Supported Data Types

§  Array §  Struct §  List §  Date §  String §  Query §  Xml §  Image §  Spreadsheet

11


JSON Enhancements

12


JSON Enhancements

§  Case of Struct keys now are preserved §  Select option “Preserve case for Struct keys for Serialization”

in the Administrator->Settings

§  Data types inferred for Query columns and CFC properties

§  Option to serialize Query as Struct

§  Custom Serializers

13


JSON Case Sensitivity

§  Setting case preservation for Struct keys §  Application Level §  Server Level

§  Application.cfc setting component {

this.name = "JSONEnhancements";this.serialization.preserveCaseForStructKey = true;

}§  Server setting in ColdFusion Administrator

14


Type of data preserved in CFC and Query

§  ColdFusion is loosely typed language §  It infers data type based on value assigned §  But sometime it can get data type wrong

e.g. “0123” could be converted to number 123

§  JSON Serialization for Query §  Infers data type from column type of Database

§  JSON Serialization for CFC §  Infers data type from ‘type’ attribute of CFC property

15


Serialize Query as Struct

§  Before ColdFusion 11 §  serializeJSON (object [,boolean queryFormat])

§  In ColdFusion 11 §  serializeJSON (object [, object queryFormat]) §  Second argument could be

§  True, False, “row”, “column”, “struct”

§  Application.cfc setting component { this.serialization.serializeQueryAs = "struct";}

16


Custom Serializer

§  New serialize functions §  serialzeXML and deserializeXML§  serializeJSON and deserializeJSON already existed

§  Set custom serializer in Application.cfc component {

this.customSerializer = "MyJSONSerializer";}§  Create a CFC for custom serialization and implement following functions –

function canSerialize (type) access="remote" returntype="boolean” function serialize (objToSerialize, acceptHeader) access="remote" returntype="String”function canDeSerialize (type) access="remote" returntype="boolean" function deSerialize (objToSerialize, acceptHeader) access="remote" returntype="String"

17


Query Functions

18


queryExecute

§  Syntax queryExecute (sql [,queryParams] [,queryOptions])

§  Examples: <cfscript>

rs = queryExecute("select * from employee",[], {datasource:”EmployeeDS”});

rs = queryExecute("select * from employee where id = ?", [1]);

rs = queryExecute("select * from employee where id = :empId", {empId:1});

rs = queryExecute("select * from employee where id = :empId", {empId:{type="integer", value=1}});

rs = queryExecute("select * from employee where id = :empId and first_name like :firstName", {empId:1, firstName:"Ram"});</cfscript>

19


queryGetRow Function

§  Retrieves specific query row §  Result is returned as Struct §  Throws RowNumberOutOfBoundException if index is greater than num rows

§  Syntax:

row = queryGetRow (queryObj, rowIndex) OR row = queryObj.getRow(rowIndex)

<cfscript>queryObj = queryExecute("select * from employee order by first_name");writeDump(queryObj); writeDump(queryObj.getRow(2));writeDump(queryGetRow(queryObj, 1));

</cfscript>

20


Other Language Enhancements

21


Elvis Operator

§  Special case of Ternary operator - ?: <cfscript>

var1 = isDefined("var2") ? var2 : "defaultValue";writeOutput(var1 & " ");var1 = var2 ?: "defaultValue";writeOutput(var1);

</cfscript>Output is the same – “defaultValue”

22


Build-in functions as data types

§  Pass built-in function as function argument §  Return built-in function from a function §  Assign built-in function to a variable

You could do all of above with UDFs earlier, now supported for built-in functions <cfscript>

a = [10, 44, 55, 60];

function arrayOperation (opFunc){ return opFunc(a);}writeOutput("Array Max = " & arrayOperation(arrayMax) & " ");writeOutput("Array Min = " & arrayOperation(arrayMin) & " ");writeOutput("Array Average = " & arrayOperation(arrayAvg) & " ");

§  </cfscript>

23


Enhancements to collection functions

§  Index and array object arguments added to closure function of arrayEach §  arrayEach(array, function (arrayElement, index, arrayObj) { … });

§  New function listEach §  listEach

( list/String, function (listObj, index){} [, delimiters_string] [, includeEmpltyFields_boolean] )

24


Enhancements to collection functions - Continued

§  arrayReduce §  arrayReduce (arrayObj, function(prevResult,item, index, arrayObj){}); §  Returns a single value

§  arrayMap

§  arrayMap (arrayObj, function (item, index, arrayObj){}); §  Replaces value of array element at given index and returns new array

§  Similarly structReduce, structMap, listReduce and listMap are added

25


Application Specific Datasource

§  Ways to create datasource §  In the Administrator §  Using Admin API

§  CF11 – New way to create dynamic datasources §  In application.cfc

this.datasources.myDataSource = { database = “path_to_folder", driver = "Apache Derby Embedded" }; this.datasource = "myDataSource";

26


Application specific datasource – continued …

§  Creating datasource using JDBC URL this.datasources.dsn2={"driver"="MSSQLServer", url="jdbc:macromedia:sqlserver://localhost\MSSQL2008;databaseName=regression;;sendStringParametersAsUnicode=false;querytimeout=0;MaxPooledStatements=1000","username"="sa","password"="pass"};

§  In case of clash, Application datasource will get preference

27


CFZip Enhancements

§  Support for password protected zip files

§  CFZip – added two attributes §  password §  encryptionAlgorithm – Standard, AES-128, AES-256 (default)

<cfscript>cfzip (action="zip", file="C:\ZipTest\testzipfile.zip",

source="C:\ZipTest\sample.txt", password="pass");cfzip (action="list", name="zipFileList",

file="C:\ZipTest\testzipfile.zip");cfzip (action="unzip",

file="C:\ZipTest\testzipfile.zip", destination="C:\ZipTest\", password="pass", overwrite="true");

</cfscript>

28


CFZip Enhancements

§  Can specify password for individual files

<cfscript>cfzip(action="zip",

file="C:\ZipTest\testzipfile.zip", overwrite="true"){

cfzipparam(source="C:\ZipTest\sample.txt", password="pass");};cfzip(action="unzip", file="C:\ZipTest\testzipfile.zip",

destination="C:\ZipTest\", overwrite="true"){

cfzipparam(source="sample.txt", password="pass");};</cfscript>

29


Thank you

30

Software

Language enhancements in cold fusion 11