Extending Java From ColdFusion - CFUnited 2010

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

Rupesh Kumar July 25th 2010

http://www.rupeshk.org/ : rukumar

Extending Java with ColdFusion

http://www.rupeshk.org/


Agenda

Objective

Using Java from CFML

Leveraging ColdFusion Features from Java

Areas to watch out for

ColdFusion as a Service (CFaaS)

Q&A


ColdFusion is Java

3


ColdFusion is Java

ColdFusion applications are developed in CFML (and likely take

advantage of Java, XML, SOAP, and more).

At runtime ColdFusion applications are pure Java.

A J2EE server (internal or external)

… running a Java application (the ColdFusion engine)

… invoking Java code (CFML code compiled to Java bytecode).

CFML exists only at developer time, runtime is pure Java (and deployed

like any other Java application).

CFML source need not be present at runtime.

Applications may be packaged and deployed like any other Java

applications.

4


5

ColdFusion Leverages Underlying Java

Connectivity

Security

Management

Transactions

Directory

JEE ApplicationServer

Java App #1

ColdFusion

Java App #2

© 2010 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 6

JEE Services

Java Runtime

Presentation(HTML, Reporting, PDF Generation, AJAX, Flash Forms)

Database

Connectivity

Document

ServicesPDF/Excel/P

PT/

Word

Network

Services(http, ftp, mail

–

smtp/pop/ima

p)

Enterprise

Services(Exchange,

Sharepoint)

SOA

connectivity(WebServices

FDS, Flash

Remoting)

Event

Gateways(IM, JMS

SMS)

ColdFusion Runtime

CFML Compiler


ColdFusion is Java…

ColdFusion Type Java Type

String String

Number Double

Boolean Boolean

Array List/Vector

Struct Map

Date Date

Query coldfusion.sql.QueryTable

7


Why CF + Java?

ColdFusion and Java complement each other

ColdFusion Java

Take advantage of wide set of Java libraries available

Extend ColdFusion features

Functionalities that are not baked in ColdFusion could be available in Java

J2SDK APIs

There are tons of libraries shipped with ColdFusion – Apache POI, EhCache, Hibernate, iText, webchart etc

Other libraries -

Java ColdFusion

Productivity

Easy to learn.

Rapid development.

Huge number of Services available readymade.

Leverages standards and existing IT and training investments.

8


ColdFusion Integrated Services

Database connectivity

Full text searching (Verity and Solr)

Printing (PDF)

Document Services (PDF, Excel,

Word, PPT)

Reporting (PDF, FlashPaper, RTF,

Excel, HTML, XML)

Graphing and Charting

E-Mail (POP, IMAP and SMTP)

Exchange

XML manipulation

Including XSL and XPath

Imaging

Sharepoint

Flash Remoting

Server-side HTTP and FTP

LDAP client

Windows NT/AD authentication

Gateways

Socket

JMS

Instant messaging (including XMPP)

SMS

Asynchronous processing

S3 Storage Service

RSS Feed

Java, COM, .NET, CORBA client

… and more


ColdFusion Java

Java CFX Tags

JSP and Servlets

JSP Tag Libraries

Direct Invocation

10


Direct Invocation

Object Creation

createObject(“java”, className)

<CFOBJECT type=“Java” class=“className” name=“variable”>

Method invocation

obj.foo(arg1, arg2,..)

Constructors – use init

<cfobject type=”java” class=”java.lang.StringBuffer” name=”buff”><cfset buff.init(“CFUnited”)>

Calling methods

<cfset buff.append(“2010”)>

Static method

no need to init() to call static method

integer = createObject(“Java”, “java.lang.Integer”);intval = integer.parseInt(“10”);

11


Java Invocation – class loading ColdFusionJava

ColdFusion’s java invocation needs class to be loaded by ColdFusion

classloader

Classes need to be placed in a pre-defined directory

CF Classloader will pick up from <cf_root>/lib folder

Parent i.e web application classloader will pick up from <cf_root>/WEB-INF/lib

One might not have permission to do this

Classes cannot be changed at runtime.

Server must be restarted to pick up the change

They cannot be application specific

You cannot have multiple versions of the same library in the server

12


JavaLoader ColdFusionJava

Project by Mark Mandel :

http://www.compoundtheory.com/?action=javaloader.index

Dynamically loads java libraries using its own classloader

Create JavaLoader object

createObject("component","javaloader.JavaLoader").

init(loadPaths [,loadColdFusionClassPath]

[,parentClassLoader]);

Loadpaths : Array of jars or class directories

loadColdFusionClasspath : true|false whether ColdFusion classloader will be

the parent classloader

parentClassLoader : the parent classloader object

Create object

javaloader.create(className).init(arg1, arg2...);

13

http://www.compoundtheory.com/?action=javaloader.index


Java Invocation.. ColdFusionJava

Watch out for

Overloaded constructors and methods

Resolve ambiguity using javacast – javacast(“datatype”, data)

Java is case sensitive. Classname must be in the correct case

For method invocation, it is better to use the correct case.

14


Demo

15


Java ColdFusion

CFCProxy

TemplateProxy

Dynamic Proxy

WebServices (SOAP and REST)

CFC methods over HTTP

ColdFusion as a Service (CFaaS)

Event Gateway

16


CFC Proxy

Allows Java to directly invoke CFC methods

CFCProxy

new CFCProxy(“path to cfc");

invoke(String method, Object[] args)

Example

CFCProxy myCFC = new CFCProxy("C:\\test.cfc");

Object[] args = {"CFUnited"};

Object greeting = myCFC.invoke("greet", args);

ColdFusion classloader should be the context classloader

Works with cfc’s absolute path

17

//test.cfc


TemplatePoxy

Use this when invoked from CF request

Works with cfc’s absolute path as well as cfc’s fully qualified name.

Create using TemplateProxyFactory

TemplateProxy proxy = TemplateProxyFactory.resolveFile(pageContext, file)

TemplateProxy proxy = TemplateProxyFactory.resolveName(cfcName,

pageContext)

Invoke

invoke(String method, Object[] args, PageContext ctx)

18


Dynamic Proxy

Part of JavaLoader 1.0

Makes CFCs behave like Java classes or impl for Java interfaces

Allows java objects to call cfc methods seamlessly

Java Frameworks relying on certain contract can leverage CFC

DynamicProxy = javaloader.create(

"com.compoundtheory.coldfusion.cfc.CFCDynamicProxy");

DynamicProxy.createInstance(cfc, interfaces)

DynamicProxy.createInstance(pathToCFC, interfaces)

19


CFC methods over HTTP

A remote method can be invoked directly using http

Component

{

remote String function greet(arg)

{

return "Hello " & arg;

}

}

Invoke using url

http://localhost:8500/cfunited/hello.cfc?method=greet&a

rg=cfunited

20


WebService

CFC methods exposed as webservice

Component style="document" {remote String function greet(arg){

return "Hello " & arg;}

}

Generate the Java proxies from wsdl

Axis – Use WSDL2Java

java org.apache.axis.wsdl.WSDL2Java –p cfunited.hello http://localhost:8500/Hello.cfc?wsdl

HelloServiceLocator locator = new HelloServiceLocator(); cfunited.axis.hello.Hello helloCfc = locator.getHelloCfc();String msg = helloCfc.greet("CFUnited 2010");

Java SE6 now natively supports webservices

Wsimport

wsimport http://localhost:8500/cfunited/hello.cfc?wsdl -d c:\work\cfunitedemo\classes -s c:\Work\cfunitedemo\src\ -p cfunited.hello

HelloService helloService = new HelloService();Hello helloCfc = helloService.getHelloCfc();String msg = helloCfc.greet("CFUnited 2010");

21

http://localhost:8500/Hello.cfc?wsdl


ColdFusion as a Service

CFChart

CFDocument

CFImage

CFMail

CFPop

CFPdf

22


Setup for CFaaS

Enable services in the admin

Define IPs for access

Admin>>security >> Allowed IP Address

Define users who have permission

Admin>> security >> User Manager >> add User >> Exposed Services

23


CFImage

• negative()

• rotate()

• blur()

• grayScale()

• scaletoFit()

• resize()

• overlay()

• flip()

• sharpen()

• shear()

• crop()

• addBorder()

• batchOperation()

getEXIFTAG()

getHeight()

getWidth()

info()

getIPTCTag()

getIPTCMetadata()

getEXIFMetaData()

http://localhost:8500/CFIDE/services/image.cfc?wsdl



CFPDF

protect()

thumbnail()

processDDX()

extractText()

extractImage()

setinfo()

mergeFiles()

addwatermark()

extractPages()

getinfo()

mergespecificpages()

deletepages()

removewatermark()

http://localhost:8500/CFIDE/services/pdf.cfc?wsdl



Other Services

CFChart

http://localhost:8500/cfide/services/cfchart.cfc?wsdl

generate()

CFDocument

http://localhost:8500/cfide/services/document.cfc?wsdl

Generate()

CFMail

http://localhost:8500/cfide/services/mail.cfc?wsdl

Send()

CFPOP

http://localhost:8500/cfide/services/pop.cfc?wsdl

delete()

getAll()

getHeaderOnly()

26

http://localhost:8500/cfide/services/pop.cfc?wsdl


Summary

27


Q & A

Q & A

[email protected]

http://www.rupeshk.org

rukumar

mailto:[email protected]

http://www.rupeshk.org/

Extending Java From ColdFusion - CFUnited 2010

Technology

Transcript of Extending Java From ColdFusion - CFUnited 2010