Observando a frase anterior mais detalhadamente, concluímos que a tecnologia Adobe está presente na construção da maioria dos softwares RIA. Sabendo disto, a Adobe têm aperfeiçoando o ColdFusion Server para facilitar a construção das aplicações RIA.

E cada incremento inova de algum conceito ou funcionalidade, neste ponto, a tecnologia ColdFusion pode ser vista como um formador de opinião, com recursos usados em outras tecnologias (IDE ou Servidores), que começaram a perceber que as facilidades do ColdFusion não estão apenas no código CFML, mas também nos serviços.

Como exemplo podemos citar, que o ColdFusion foi o primeiro servidor a receber suporte AMF com o NetServices.as, os componentes auto documentáveis, componentes multisserviço (classes publica, classe remota ou ainda wsdl ), com o serviço RDS, entre outros.

Lembro ainda, que nessa época (NetServices), a união ColdFusion Server+AMF foi o embrião do conceito RIA, pois anteriormente, aplicativos RIA só realizava requisições XML (estático ou dinâmico) , e posteriormente nasceria o Flex 1 junto com a geração MX, que hoje é um dos serviços ColdFusion.

Um incremento mais recente, foi a incorporação de recursos LiveCycle ao servidor ColdFusion, possibilitando a geração e manipulação de de PDF, permitindo um gerenciamento completo dos recursos PDF, desde criação de thumbnail a controle de permissão. Onde o sistema é mais requisitado, o ColdFusion ficou mais flexível. E com suporte nativo a LiveCycle DS ou BlazeDS.

Agora, a Adobe habilita todas essas facilidades do ColdFusion para implementação direta em MXML, quando cria o CFaaS (ColdFusion as service) para versão 9.

MXML com a cara do CFML

CFaaS é um serviço ColdFusion que gerencia o acesso a um conjunto de outros serviços ColdFusion, habilitando a execução remota no servidor, sem a necessidade de construção de script no servidor, em resumo (obedecendo as regras de acesso do gerenciamento), todos os recursos descritos nos parágrafos anteriores estarão disponíveis em MXML, com auxílio de bibliotecas SWC (mxml e air) disponíveis no servidor em /CFIDE/scripts/AIR/.

Os serviços CFaaS ou tags MXML do ColdFusion, até este momento, são:

• Chart – proxy para o serviço de geração de gráficos, que é baseado no WebCharts3D (no ColdFusion 9 o WebCharts3d está na versão 5.1). Os gráficos são gerados no formato png, jpg ou swf;
• Document – proxy para geração de documentos imprimíveis a partir do Flash Player, os formatos dos documentos gerados são PDF ou SWF/FlashPaper;
• Image – proxy para manipulação de imagens, hoje é possível realizar a seguentes ações: AddBorder, batchOperation, Blur, Crop, Flip, GetEXIFMetaData, GetEXIFTAG, GetHeight, GetIPTCMetadata, GetIPTCTag, GetWidth, GrayScale, Info, Negative, Overlay, Resize, Rotate, ScaletoFit, Sharpen, Shear;
• Ldap – permite acesso a qualquer servidor LDAP, e a configuração da conexão entre o cliente SWF e o servidor LDAP é realizada inteiramente no MXML,;
• Mail – sintetiza o conceito da tecnologia CFaaS, esta tag permite que qualquer aplicação SWF envie e-mail direto ao servidor STMP;
• Pdf – proxy ao serviço de manipulação de PDF, que possui as seguintes ações: GetInfo, DeletePages, MergeFiles, ExtractPages, AddWaterMark, RemoveWaterMark, Protect, MergeSpecificPages, SetInfo, thumbnail, ProcessDDX;
• Pop – Proxy de acesso a gerenciamento de servidores POP;
• Conflict – gerencia conflitos em entre mensages do client, do server e a mensagem original;
• Session – gerencia todas as operações entre o cliente AIR e o SQLite;
• SyncManager – Classe responsável em facilitar a construção da sinconização entre o Servidor ColdFusion e o cliente AIR.

E aqui codifiquei um exemplo prático, onde o cliente criar e visualizar em FlashPaper, recebendo a url do PDF para download – Este código depende de configuração de usuário/senha e ip cliente registrados no Administrador ColdFusion; Para implementação do MXML a seguir, você deve incorporar ao projeto o arquivo /CFIDE/scripts/AIR/cfservices.swc.

Observe que só foi usado MXML e ActionScript, obtendo o seguinte resultado:

Estou focando no CFaaS, porém, o ColdFusion 9 ainda possui incontáveis recursos para agilizar o desenvolvimento, como o suporte a ORM (Hibernate) com configuração e codificação reduzida, entre outras.

Conclusão

Com um tempo de desenvolvimento otimizado, utilizando a tecnologia CFaaS e CFML, o prazo para a entrega de um projeto será reduzido, gerando competitividade no custo do projeto, quando comparado com outra linguagem, permitindo a absorção de mais projetos em menos tempo, aumentando o lucro, diluindo o custo do ColdFusion Server.

Observação: A licença do ColdFusion Builder inclui uma licença (opcional) de Flash Builder 4.

Para exemplificar, peço licença a Hal Helms, mas fiz uma releitura do artigo de Using Inheritance and Composition in ColdFusion Components. Não vou reescreve-lo por completo, vou refazer apenas as classes, todo o restante do texto ainda é atual, então leia o artigo do Hal.

Na parte que fala de herança, a classes Vehicle.cfc fica da seguinte forma:

E a classe Car.cfc que extende de Vehicle, fica assim:

e o teste das classes, TestCar.cfm, da seguinte forma:

Obtendo o seguinte resultado:

Na parte que Hal fala de composição, a classe Address.cfc fica da seguinte forma:

A classe Person.cfc, assim:

O formulário de teste é o mesmo, a pagina de processamento do formulário é que deve ser alterada:

Onde obtemos o seguinte print na tela.

Estas são algumas das novidades do ColdFusion 9, acompanhem esta semana estarei mostrando mais.

–
Pedro Claudio
Adobe User Group Manager – CFUG-BR
Adobe Certified Expert
Adobe Certified Professional

http://blog.pcsilva.com/en

http://twitter.com/pcsilva

O ColdFusion desde a versão MX vem recebendo importantes funcionalidades a cada nova versão, agora no ColdFusion 9, que já é uma inovação importante, traz consigo uma série de implementações surpreendentes e aprimoramentos que Comunidade ColdFusion desejava, superando todas as expectativas, outro avanço importante foi a criação do bugtracker público do ColdFusion.

Aqui vou citar algumas das novas funcionalidades acreditando que você também ficará surpreso do que o ColdFusion 9 pode fazer.

MXML ColdFusion (CFaaS)

Esta funcionalidade, Serviço ColdFusion Exposto, é a mais impressionante, principalmente para aqueles que desenvolvem em Flex/AIR, que de forma quase padronizada para todas as linguagens server. No ColdFusion 9 deixa de existir, ou seja, você não vai precisar escrever códigos ColdFusion (CFML) para acessar serviços ColdFusion de dentro do seu projeto Flex/AIR, permitindo um projeto inteiramente em MXML e ActionScript.

SpoolMail gerenciado

O Administrador ColdFusion recebeu um gerenciador de e-mails, onde é possível visualizar os e-mails que deixaram de ser enviados. Um pedido antigo da Comunidade ColdFusion.

Variáveis Application

As novas variáveis são:

• datasource: com esta variável você não vai precisar informar o nome do datasource em outras partes da aplicação, ou seja, tags cfquery sem o atributo datasource.
• smtpServer: sobre escreve as definições do Administrator.
• ormenabled: permite trabalhar com o ORM do ColdFusion 9.
• ormsettings: define como o ORM deve trabalhar.
• serverSideFormValidation: permite desabilitar a validação no servidor.
• timeout: esta variável sobre escreve a tag cfsetting, mas trabalha da mesma forma que a tag <cfsetting timeout=”xxx”>.
• debugipaddress: permite adicionar os IP que deseja receber debug.
• enablerobustexception: habilita robust exception.
• googlemapkey: onde informamos a KEY do googlemaps para que a tag cfmap possa trabalhar.

CFML Evolução da Linguagem

Aqui houve realmente um revolução na linguagem CFML, para todos os servidores ColdFusion, visto que esta evolução foi padronizada pelo órgão regulador, pois o CFML é open source, então vamos a elas.

Componentes ColdFusion (CFC) podem ser escritos inteiramente sem tags, com implementação de todas as tags em forma de Classes, com isso você poderá usar todas as funcionalidades de tags como objetos instanciados. O uso do operador IMPORT para adicionar Classes ColdFusion (CFC), para com o operador NEW instanciar um objeto. A criação do escopo Local para utilização dentro dos métodos. E ainda todas as propriedades que declarar no CFC criarão getters e setters de forma controlada no código, mas por padrão todos as propriedades criação getter e setters.

Método OnServerStart no Application.cfc, com ele você vai iniciar scripts junto com o start do Servidor ColdFusion.

Método OnCFCRequest no Application.cfc, trabalha da mesma forma que o método onRequest, mas este é para Componentes ColdFusion. Este implemento é visto como um FIX, pois na versão anterior o método onRequest interferia em requisições de Componentes ColFusion.

ORM

A primeira sigla da linguagem foi DBML (Database Markup Language), isto porque o Servidor ColdFusion nasceu para facilitar a integração de paginas dinâmicas com bancos de dados. Neste ponto uma outra revolução aconteceu, isto porque, de forma nativa, o ColdFusion disponibiliza uma framework de mapeamento objeto/relacional, sim ORM Hibernate nativo, de forma tão simplificada que surpreende qualquer Java programmer, isto faz com que você deixa de escrever +/- 60% de sql nas aplicações, dando uma potabilidade excelente, em tratando-se de Banco de dados, mas permite que você crie fórmulas (SQL), controle eventos preLoad, postLoad, preInsert, postInsert, preUpdate, postUpdate, preDelete, postDelete.

Integração com SharePoint e Office

Com a tag cfsharepoint você pode interagir com o SharePoint de forma transparente, e com a tag cfspreadsheet você vai transformar arquivos excel em querys, ou inserir, alterar e deletar dados da planilha.

ColdFusion Administrator Tool

Com uma ferramenta feita em AIR, você vai poder administrar remotamente no formato desktop, vários Servidores ColdFusion, possibilitando comparar configurações e verificar necessidades de aplicar HotFix automaticamente.

Apache Solr/Lucene

Este serviço integrado ao servidor dá um poder maior de indexação de documentos, pois ele não limita o número de documentos que podem ser indexados, e o Verity permanece.

Conclusão

Destaquei algumas das novas funcionalidades, existem ainda outras mais, mas o importante é testar, para verificar mais funcionalidades e informar os bugs no bugtraker.

–
Pedro Claudio
Adobe User Group Manager – CFUG-BR
Adobe Certified Expert
Adobe Certified Professional

http://blog.pcsilva.com/en

http://twitter.com/pcsilva

Serão 5 horas de palestras com a participação de grandes nomes da comunidade ColdFusion brasileira, compartilhando o máximo e informações sobre ColdFusion, o seu mercado no Brasil, funcionalidades, produtividade, novidades e futuras versões.

O evento será realizado no dia 11 de Abril de 2009 a partir das 13:30, e será totalmente on-line e gratuíto. Para isto, basta deixar seu nome e email através do menu “Quero participar”. No dia do evento basta acessar a sala de palestras através do link Acesso que estará disponível nesta mesma página.

Não fique de fora desta e conheça todos os diferenciais de uma das linguagens mais usadas para o desenvolvimento de aplicações ricas para a internet. Conheça o ColdFusion!

A palestra tem por objetivo demonstrar a integração entre o ColdFusion e o LiveCyce Data Services através do Flex 3, desde as configurações necessárias a utilização das extenções do Coldfusion para Eclipse.

E teremos como palestrante Francisco Paulino, Tofinha. Adobe Community Expert, entusiasta ColdFusion.

Já há algum tempo, não escrevo, o ColdFusion 8 foi lançado, então escolhi a maior novidade (IMHO) desta versão, que é a criação/edição/manipulação de imagens online, o mais apropriado seria uma abordagem mais ampla e resumida do assunto ColdFusion 8, mas irá achar o assunto bem interessante.

Não vou me aprofundar em definir e muito menos descrever as funções, devido a grande quantidade de funções (50)para tratamento de imagens agregadas nesta versão CF, vou exibir um cfc comentado e simular várias execuções, aproveitem.

Pré-requisito

ColdFusion 8 (download)

Conceito

Vou trabalhar com uma nova tag, a CFIMAGE, com apenas uma action (writeToBrowser), que simplesmente converte a imagem da memória para arquivo, escreve em html a tag IMG apontando para o caminho da imagem gerada na conversão.

Os demais processos embutidos no CFC trabalharão com as funções:

• IsImage
• IsImageFile
• ImageRead
• imageNew
• ImageCopy
• ImageFlip
• ImageCrop
• ImagePaste
• ImageSetDrawingTransparency
• ImageSetBackgroundColor
• ImageShear
• ImageResize
• ImageSetDrawingColor
• ImageDrawLine
• ImageSetAntialiasing
• ImageDrawRect
• ImageDrawText
• ImageBlur
• ImageDrawQuadraticCurve

A partir das funções CFML 8 crio então os métodos para manipulações específicas, de forma a facilitar a utilização e minimizar os possíveis erros, são eles:

• ImageBin
• ImageReflection
• ImageGradient
• Text2Image
• ImageShadow
• ImageRounded

O componente

<cfcomponent>
<!--- método testa o tipo da variável, que sempre deve ser um caminho de imagem ou uma variável do tipo imagem --->
<cffunction name="ImageBin" returntype="any">
<!--- caminho da imagem ou variável do tipo imagem --->
<cfargument name="image" 		   type="any"     required="yes" >
<!--- método util apenas quando criamos imagens dantro deste método, largura da imagem --->
<cfargument name="width"           type="numeric" required="no" default="150" >
<!--- método util apenas quando criamos imagens dantro deste método, altura da imagem --->
<cfargument name="height"          type="numeric" required="no" default="50" >
<!--- método util apenas quando criamos imagens dantro deste método, dor de fundo da imagem --->
<cfargument name="backgroundColor" type="string"  required="no" default="##FFFFFF" >
<cfscript>
//Objeto não é do tipo imagem
if(NOT IsImage(Arguments.image)){
//Objeto é um arquivo de imagem
if(isImageFile(Arguments.image)){
//lê o arquivo de imagem e retorna o binário da imagem
return ImageRead(Arguments.image);
}
//cria imagem e retorna o binário da imagem
return imageNew("", Arguments.width, Arguments.height, "rgb", Arguments.backgroundColor);
}
//retorna o binário da imagem
return Arguments.image;
</cfscript>
</cffunction>
<!--- método usado para criar reflexo da imagem --->
<cffunction name="ImageReflection" returntype="any">
<!--- caminho da imagem ou variável do tipo imagem --->
<cfargument name="image"           type="any"     required="yes" >
<!--- se haverá reflexão ou não --->
<cfargument name="posicao"      type="boolean" required="no" default="false" >
<!--- inverte direção da reflexão--->
<cfargument name="right"           type="boolean" required="no" default="true" >
<!--- inverte direção do gradiente --->
<cfargument name="gdirection"      type="boolean" required="no" default="false" >
<!--- cor de fundo da reflexão --->
<cfargument name="backgroundColor" type="string"  required="no" default="##FFFFFF" >
<cfscript>
//carrega variável com binario da imagem
var img1  = ImageBin(Arguments.image);
//cria uma copia da imagem
			var Copy = ImageCopy(img1, 0, 0, img1.width, img1.height);
//cria imagem de fundo da reflexão
var img  = ImageNew("", img1.width*2.17, img1.height*2, "rgb", Arguments.backgroundColor);
//inicia variavel
			var x = 0;
//inicia variavel
			var direction = 1.4;
//inicia variavel
			var width = img1.width;
//inicia variavel
			var height = img.height*.7;
//modifica posição inicial da imagem caso a rfração seja em cima da imagem
if(Not Arguments.right and Arguments.posicao){
direction *=-1;
x = img.width - img1.width;
}
//espelhamento da visão da imagem
ImageFlip(Copy, "vertical");
//corte em 85% da altura da imagem
				ImageCrop(Copy, 0, 0,  img1.width, Round(img1.height * .85));
//aplica gradiente na imagem
				Copy = ImageGradient(Copy,Arguments.gdirection,false,1,100,Arguments.backgroundColor);
//uni as imagem original com fundo da reflexão
ImagePaste(img,img1,x,0);
//aplica transparencia na imagem unida
				ImageSetDrawingTransparency(img,45);
//aplica cor de fundo na imagem unida
				ImageSetBackgroundColor(Copy,Arguments.backgroundColor);
//verifica direção da reflexão
if(Arguments.posicao){
//trnasforma imagem
					ImageShear(Copy,direction,"horizontal", "bicubic");
//redimenciona imagem
					ImageResize(Copy,"100%","50%","MEDIUMQUALITY",2);
//redefine variavel
					width = img.width;
//redefine variavel
					height = img.height *.71;
}else{
//redimenciona imagem
					ImageResize(Copy,"100%","70%","MEDIUMQUALITY",2);
}
//uni imagem alterada com a refração
ImagePaste(img,Copy, 0,img1.height);
//corta imagem no tamanho correto
				ImageCrop(img, 0,0,width,height);
//retorna imagem
			return img;
</cfscript>
</cffunction>
<!--- método para aplicar gradiente na imagem informada--->
<cffunction name="ImageGradient" returntype="any">
<!--- caminho da imagem ou variável do tipo imagem --->
<cfargument name="image" 		   type="any"     required="yes" >
<!--- direção do gradiente vertical/horizontal --->
<cfargument name="direction"	   type="boolean" required="no" default="false" >
<!--- inicio do gradiente --->
<cfargument name="position"		   type="boolean" required="no" default="false" >
<!--- afastamento do gradiente --->
<cfargument name="limit"		   type="numeric" required="no" default="1" >
<!--- alpha --->
<cfargument name="index"		   type="numeric" required="no" default="100" >
<!--- cor do gradiente --->
<cfargument name="backgroundColor" type="string"  required="no" default="##FFFFFF" >
<cfscript>
//carrega variável com binario da imagem
var img  = ImageBin(Arguments.image);
//limita final do gradiente até o limite percentual informado
var h 	 = img.height*Arguments.limit;
//inicia variavel
			var w 	 = img.width;
//divide o alpha em linhas de acordo com a altura
			var i    = Arguments.index/h;
//inicia variavel
			var per  = 0;
//inicia variavel
			var k    = 0;
//inicia variavel
			var j    = 0;
//verifica a direção do gradiente
if(Arguments.direction){
//modifica direção do gradiente
h = w*Arguments.limit;
//altera divisão
i = Arguments.index/h;
}
// aplica a cor do gradiente
				ImageSetDrawingColor(img, Arguments.backgroundColor);
// para cada linha (das 100) em Arguments.index/h aplica uma transparencia diferente
				for(;k lte h;k++){
// redefine variavel
					j = k;
//corrige numero dependendo da posição, sutil diferença
if(Arguments.position) j = h-k;
//calcula percentual de transparencia corrente
					per = 100 - round(i*j*(1.8*Arguments.limit));
//corrige percentual
					if(per lt 0) per = 0;
//aplica tranparencia
					ImageSetDrawingTransparency(img, per);
//verifica direção do gradiente
if(Arguments.direction){
//torna o gradiente visivel começando pela direita
ImageDrawLine(img, k, 0, k,img.height);
}else{
//torna o gradiente visivel cpomeçando pela esquerda
ImageDrawLine(img, 0, k, img.width, k);
}
}
//retorna imagem
			return img;
</cfscript>
</cffunction>
<!--- método aplica texto em imagem --->
<cffunction name="Text2Image" returntype="any">
<!--- texto --->
<cfargument name="text"            type="string"  required="no" default="teste" >
<!--- caminho da imagem ou variável do tipo imagem --->
<cfargument name="img"             type="any"     required="no" default="" >
<cfargument name="width"           type="numeric" required="no" default="150" >
<cfargument name="height"          type="numeric" required="no" default="50" >
<cfargument name="x"               type="numeric" required="no" default="10" >
<cfargument name="y"               type="numeric" required="no" default="25" >
<cfargument name="backgroundColor" type="string"  required="no" default="##FFFFFF" >
<cfargument name="textColor"       type="string"  required="no" default="##000000" >
<cfargument name="font"            type="string"  required="no" default="Trebuchet MS" >
<cfargument name="size"            type="numeric" required="no" default="25" >
<cfargument name="style"           type="string"  required="no" default="bold" >
<cfargument name="strikethrough"   type="boolean" required="no" default="no" >
<cfargument name="underline"       type="boolean" required="no" default="no" >
<cfscript>
//carrega variável com binario da imagem
var image  = ImageBin(Arguments.img,Arguments.width, Arguments.height, Arguments.backgroundColor);
//inicia variavel
			var Styles = StructNew();
// tipo da fonte
				Styles.font          = Arguments.font;
// tamanho da fonte
				Styles.size          = Arguments.size;
// bold/normal
				Styles.style         = Arguments.style;
// uso de strikethrough ou não
Styles.strikethrough = Arguments.strikethrough;
// underline ou não
Styles.underline     = Arguments.underline;
//prepara imagem para receber o texto
				ImageSetAntialiasing(image, "ON");
// prepara cor do texto
				ImageSetDrawingColor(image, Arguments.textColor);
// aplica o texto na imagem
				ImageDrawText(image, Arguments.text, Arguments.x, Arguments.y, Styles);
//retorna imagem
			return image;
</cfscript>
</cffunction>
<cffunction name="ImageShadow" returnType="any">
<!--- caminho da imagem ou variável do tipo imagem --->
<cfargument name="image"           type="any" 	required="true">
<!--- define para que lado a sombra será aplicada --->
<cfargument name="position"        type="numeric" required="no" default="1">
<!--- distancia da sombra --->
<cfargument name="off"             type="numeric" required="no" default="1.5">
<cfargument name="backgroundColor" type="string"  required="no" default="##FFFFFF" >
<cfargument name="shadow"          type="string" 	required="no" default="##A0A0A0">
<!--- intensidade do blur--->
<cfargument name="blur" 	          type="numeric" required="no" default="10">
<cfscript>
var i = 2*Arguments.off;
//carrega variável com binario da imagem
var img  = ImageBin(arguments.image);
//inicia variavel
			var img1 = "";
//verifica direção da sombra
if(Arguments.position){
//cria imagem com com dimensões para tornar sombra visivel
img1 = ImageBin('',img.width + i,img.height + i,Arguments.backgroundColor);
}else{
//cria imagem com com dimensões para tornar sombra visivel
img1 = ImageBin('',img.width + (i*2),img.height + (i*2),Arguments.backgroundColor);
}
//aplica cor da sombra na imagem criada
				ImageSetDrawingColor(img1,Arguments.shadow);
//verifica lado que será aplicada a sombra
switch(Arguments.position){
case 1:
//cria sombra
						ImageDrawRect(img1, Arguments.off, Arguments.off, img.width, img.height, "yes");
//aplica blur
						ImageBlur(img1,Arguments.blur);
//uni as imagens
						ImagePaste(img1,img,0,0);
break;
case 2:
//cria sombra
						ImageDrawRect(img1, Arguments.off, 0, img.width, img.height, "yes");
//aplica blur
						ImageBlur(img1,Arguments.blur);
//uni as imagens
						ImagePaste(img1,img,0,Arguments.off);
break;
case 3:
//cria sombra
						ImageDrawRect(img1, 0, 0, img.width, img.height, "yes");
//aplica blur
						ImageBlur(img1,Arguments.blur);
//uni as imagens
						ImagePaste(img1,img,Arguments.off,Arguments.off);
break;
case 4:
//cria sombra
						ImageDrawRect(img1, 0, Arguments.off, img.width, img.height, "yes");
//aplica blur
						ImageBlur(img1,Arguments.blur);
//uni as imagens
						ImagePaste(img1,img,Arguments.off,0);
break;
}
//retorna imagem
			return img1;
</cfscript>
</cffunction>
<cffunction name="ImageRounded" returntype="any">
<cfargument name="image"  		   type="any" 	  required="true">
<cfargument name="off"   		   type="numeric" required="no" default="10">
<!--- cor do gradiente --->
<cfargument name="backgroundColor" type="string"  required="no" default="##FFFFFF" >
<cfscript>
//carrega variável com binario da imagem
var img  = ImageBin(arguments.image);
//inicia variavel
			var i = 0;
//grau da curva dos cantos
			var index = Arguments.off;
//aplica cor de fundo
				ImageSetDrawingColor(img,Arguments.backgroundColor);
//prepara imagem
				ImageSetAntialiasing(img,"ON");
//aplica uma linha curva para grau
				for(i=0;i lte index;i++){
ImageDrawQuadraticCurve(img,i,0,i/(index/2),i/(index/2),0,i);
ImageDrawQuadraticCurve(img,img.width-i,0,img.width-i/(index/2),i/(index/2),img.width,i);
ImageDrawQuadraticCurve(img,0,img.height-(index-i),(index-i)/(index/2),img.height-((index-i)/(index/2)),(index-i),img.height);
ImageDrawQuadraticCurve(img,img.width,img.height-(index-i),img.width-((index-i)/(index/2)),img.height-((index-i)/(index/2)),img.width-(index-i),img.height);
}
//retorna imagem
			return img;
</cfscript>
</cffunction>
</cfcomponent>

Exibindo resultados

O componente é bem variado quanto tipos de transformações, colocarei agora os resultados que imagino sejam possível, mas você pode achar mais alguns.

[]s

Pedro Claudio

Adobe Certified Professional

Macromedia ColdFusion MX 7 Developer

FormatCF(new Array(\’ZingerChart.cfm\’,\’ZingerChartPopUpDynamic.cfm\’,\’data.cfc\’,\’ZingerChartPopUp.cfm\’)); FormatXML(new Array(\’ZingerChart_final_2.mxml\’,\’ZingerChart_final_1.mxml\’));

FormatCF(new Array(\’bd1.cfm\’,\’bd2.cfm\’)); FormatAS(new Array(\’communication.as\’,\’cfLocalConnection.as\’));

Introdução

Quando iniciamos os estudos sobre uma linguagem, ferramenta ou servidor devemos nos aprofundar, para que possamos maximizar a utilização, minimizando a quantidade de código, para criar uma aplicação otimizada. Então demonstrarei aqui como melhorar o código da aplicação de exemplo, passada no final no artigo anterior, de forma que a inclusão de ActionScript no código CFML, seja miníma, e para isto o desenvolvedor deve ter um conhecimento mínimo sobre construção de classes ActionScript 2.0 , e também informado onde essas classes devem ser armazenadas.

Pré-requisito

- ColdFusion MX 7.0.2, com um repositório de classes configurado.
- Para que você possa acompanhar os exemplos a seguir, verifique se o mapeamento / do Administrador ColdFusion, será na pasta que ali está registrado onde será armazenado o componente (Usuario.cfc) deste artigo.

Conceitos

Não vou conceituar, apenas falarei das peculiaridades, ok? ok! E segurem o folego!
A construção e utilização de classes AcitionScript 2.0 no servidor ColdFusion MX 7, obedece algumas regras e necessita de algum conhecimento específico, a primeira regra que devemos respeitar é a restrição de código imposta pelo servidor , ter um repositório de classes definido em flex-config.xml, implementar classes a partir da classe Object e/ou classes que possam receber chamadas diretas a seus métodos, uma particularidade nas declarações, todas devem ser estáticas (static), exceto o construtor, e para uma depuração detalhada, configure seu servidor para exibir as mensagens warning e/ou erro geradas no momento da execução – geralmente uso o comando tail (linux) para verificar as últimas entradas nos logs.
Com relação a execução e testes de classes em Flash Forms CFFORM, você pode ouvir, ou até chegar a pensar ?Ah! Eu atualizei a classe, copiei para o repositório configurado, mas quando executo na pagina, ele não demonstra o incremento que fiz!?, isto ocorre porque o servidor ColdFusion possui uma cache própria para Flash Forms, e para que o servidor saiba que deve atualizar a cache, você precisa requisitar sua aplicação por uma url que contenha a variável ?recompile? com valor verdadeiro (?recompile=true).
Basicamente é isso, mas no transcorrer do seu desenvolvimento poderá perceber outras particularidades dependendo do tipo de servidor que estiver usando.
E quanto a compartilhar um diretório para vários sites, bom, não aconselho.

Conteúdo

Para o conteúdo vamos utilizar o componente do artigo anterior, que já deve estar configurado e respondendo pela url http://localhost/labs/remoting/Usuario.cfc, como também estar com o banco de dados implementado, se você não fez ou não tem isso leia o artigo anterior , e implemente como orientado.

Basicamente o que faremos é implementar o ActionScript (faça um outro diagrama) em cima do diagrama de classe desenvolvido para componente, o sugere que devemos ter na classe ActionScript ao menos seis métodos, relembrando, eles são: validate, append, update, remove, get e search.
Aos que ficaram perdidos na frase acima, sugiro passar o olho em algum artigo, livro ou texto sobre UML e OO.
Nossa classe ActionScript receberá dois métodos novos, a partir da estrutura do cfc, o primeiro será o comunicador, responsável em criar a conexão e cuidar do transporte das informações entre cliente e servidor, e o segundo apenas fará uma faxina nas informações do cliente (communication,clear), dispondo então da seguinte estrutura.

hUsuario.as

import mx.remoting.NetServices;
import mx.remoting.NetServiceProxy;
import mx.remoting.Connection;
import mx.controls.Alert;
import mx.managers.CursorManager;

class hUsuario extends Object{

private static var currentService:NetServiceProxy;

public static var userid:String;
public static var username:String;
public static var nome:String;
public static var email:String;

private function hUsuario();
private static function communication(onresult:Function):Void;
private static function validate():Object;

public static function append():Void;
public static function update(user:String):Void;
public static function remove(user:String):Void;
public static function get():Void;
public static function search(query:String):Void;
public static function clear():Void;

}

Os atributos userid, username, nome e email, são uma abstração das colunas da tabela lá do banco de dados, e o elemento mais importante nesta classe é o atributo currentService, por default sempre apontará para o mesmo conjunto de serviços, porém receberá ações diferentes, para que sejam executadas no retorno dos serviços, em cada serviço que estiver sendo executado, aqui resolvi coloca-lo como privado.

Os atributos.

private static var currentService:NetServiceProxy;
public static var userid:String;
public static var username:String;
public static var nome:String;
public static var email:String;

Neste exemplo o construtor não executa nenhum comando, mesmo porque ele está declarado como privado, e não será executado da forma que utilizaremos, como pode ter reparado, nossa classe é filha da classe Object, e é assim que será tratada, ou seja, como um objeto previamente criado “diferente do padrão”? Pode ser mas a classe mx.remoting.NetServices, também utiliza este artifício.
O construtor, apenas pro forme.

private function hUsuario(){
}

O próximo método é o mais importante e o motivo da criação desta classe, pois é nele que será construída a comunicador, que fará a ponte com o servidor.

/*
Tem como parâmetro a ações que deve ser executada em um retorno ok do servidor.
*/
private static function communication(onresult:Function):Void {

/* aqui uma firula ao cliente */
CursorManager.setBusyCursor();

/* endereço do gateway */
var defaultGateway:String = “http://localhost/cfusion/flashservices/gateway/”;

/* endereço do conjunto de serviços */
var defaultPath:String = “labs.remoting.Usuario”;

/* conexão com servidor */
var conn:Connection = NetServices.createGatewayConnection(defaultGateway);

/* prepara parâmetro obrigatório da conexão com serviço*/
var eventReturn:Object = new Object();

/* ação será executada em um retorno ok do servidor, com um leve complexidade, pois é uma execução padrão, e em seu conteúdo o parâmetro do método communication será executado */
eventReturn.onResult = function(o):Void{

/* executa ação de fato */
onresult(o);
/* encerra conexão */
conn.close();
/* destrói a firula */
CursorManager.removeBusyCursor();
}
/* onStatus */
eventReturn.onStatus = function(info:Object):Void{
Alert.show(info.description,info.level);
conn.close();
CursorManager.removeBusyCursor();
};
/* constrói conexão com o conjunto de serviços, variável poderá ser acessada pelos demais métodos */
currentService = conn.getService(defaultPath,eventReturn);

}

Para um entendimento da lógica da código comentarei agora a operação mais simples desta classe.

/* método invoca todos os registros da base de dados*/
public static function get():Void{/* ação que será executada de fato em um retorno ok do servidor*/
var onResult:Function = function(result):Void{
var query:Array = result._items;
var recordount:Number = query.length;
Alert.show(‘Resposta (‘+recordount+’) do servidor’,'result’);
};

/* executa método passando a função como parâmetro, função esta que será inserida e invocada dentro de outra função, repare no método anterior (communication)*/
communication(onResult);
/* invoca serviço */
currentService.get();

}

Os métodos seguintes são simplesmente os códigos do artigo anterior, contudo dispostos de forma mais organizada e vistosa, não vou comentar, apenas exibirei a classe completa e passarei ao formulário CFML.

hUsuario.as

import mx.remoting.NetServices;
import mx.remoting.NetServiceProxy;
import mx.remoting.Connection;
import mx.controls.Alert;
import mx.managers.CursorManager;

class hUsuario extends Object{

private static var currentService:NetServiceProxy;

public static var userid:String;
public static var username:String;
public static var nome:String;
public static var email:String;

private function hUsuario(){
}

private static function communication(onresult:Function):Void {

CursorManager.setBusyCursor();

var defaultGateway:String = “http://localhost/cfusion/flashservices/gateway/”;
var defaultPath:String = “labs.remoting.Usuario”;

var conn:Connection = NetServices.createGatewayConnection(defaultGateway);

var eventReturn:Object = new Object();
eventReturn.onResult = function(o):Void{
onresult(o);
conn.close();
CursorManager.removeBusyCursor();
}
eventReturn.onStatus = function(info:Object):Void{
Alert.show(info.description,info.level);
conn.close();
CursorManager.removeBusyCursor();
};
currentService = conn.getService(defaultPath,eventReturn);

}

private static function validate():Object{

var r:Object = new Object();
var error:Boolean = true;

if(username != undefined && username.length > 0){
r.username = username;
error = false;
}

if(nome != undefined && nome.length > 0){
r.nome = nome;
error = false;
}

if(email != undefined && email.length > 0){
r.email = email;
error = false;
}
if(error){
return null;
}
return r;

}

public static function append():Void{

var user = validate();

if(user != null){

var onResult:Function = function(result):Void{
switch(result){
case -1:
Alert.show(“Erros entre os dados do registro”,”Erro”);
break;
case 0:
Alert.show(“Duplicata de identificador recusada”,”Erro”);
break;
default:
Alert.show(“Resposta ok (“+result+”)”,”result”);
clear();
break;
}
};

var arg:Object = new Object();
arg.dados = user;
communication(onResult);
currentService.append(arg);

}else{
Alert.show(“Infomação insuficiente!”,”Erro”);
}

clear();

}

public static function update(user:String):Void{

var u = validate();

if(u != null){

var onResult:Function = function(result):Void{
switch(result){
case -1:
Alert.show(“Erros entre os dados do registro”,”Erro”);
break;
case 0:
Alert.show(“Duplicata de identificador recusada”,”Erro”);
break;
default:
Alert.show(“Resposta ok”,”result”);
clear();
break;
}
};

var arg:Object = new Object();
arg.id = user;
arg.dados = u;
communication(onResult);
currentService.update(arg);

}else{
Alert.show(“Infomação insuficiente!”,”Erro”);
}

clear();

}

public static function remove(user:String):Void{

var onResult:Function = function(result):Void{
if(result){
Alert.show(‘Resposta do servidor’,'result’);
}else{
Alert.show(‘Idenficador recusado’,'Erro’);
}
};
var arg:Object = new Object();
arg.id = user;
communication(onResult);
currentService.remove(arg);

}

public static function get():Void{

var onResult:Function = function(result):Void{
var query:Array = result._items;
var recordount:Number = query.length;
Alert.show(‘Resposta (‘+recordount+’) do servidor’,'result’);
};
communication(onResult);
currentService.get();

}

public static function search(query:String):Void{

var onResult:Function = function(result):Void{
var query:Array = result._items;
var recordount:Number = query.length;
if(recordount > 0){
Alert.show(‘Resposta (‘+recordount+’) do servidor’,'result’);
}else{
Alert.show(“Nenhum registro foi encontrado.”,’Erro’);
}
};
var arg:Object = new Object();
arg.str = query;
communication(onResult);
currentService.search(arg);

}

public static function clear():Void{

username = nome = email = “”;

}

}

Vou executar um método por arquivo, iniciando pelo get, muito complicado como pode ver.

1.cfm

<cfform name=”basic” format=”flash” onload=”hUsuario.get();”>
</cfform>

O método a seguir realizará a inclusão de um novo registro, caso a inclusão termine com sucesso retornará o ID do novo individuo, vou comentar, porque ele é muito mais complicado que o anterior.

2.cfm

<cfform name=”basic” format=”flash” onload=”initRemoting();”>
<cfformitem type=”script”>
function initRemoting(){
//informo nome
hUsuario.nome = “orlando”;
//informo e-mail
hUsuario.email = “velho@mail.com”;
//informo username
hUsuario.username = “velho”;
//adiciono as informações no banco
hUsuario.append();
}
</cfformitem>
</cfform>

Vou aproveitar o ID que foi retornado no append, para nas demais execuções.
A atualização é bem semelhante ao cadastro, a diferença está justamente no identificador do usuário, que deve ser passado como parâmetro, o restante é idêntico..

3.cfm

<cfform name=”basic” format=”flash” onload=”initRemoting();”>
<cfformitem type=”script”>
function initRemoting(){
hUsuario.nome = “Orlando”;
hUsuario.email = “gandalf@mail.com”;
hUsuario.username = “gandalf”;
hUsuario.update(“20″);
}
</cfformitem>
</cfform>

As próximas execuções apresentam a mesma complexidade que a primeira, ou seja nenhuma.
Removeremos agora o gandalf da base de dados.

4.cfm

<cfform name=”basic” format=”flash” onload=”hUsuario.remove(’20′);”>
</cfform>

E para finalizar a sequencia, vamos pesquisar um caracter comum a todos os registro.

5.cfm

<cfform name=”basic” format=”flash” onload=”hUsuario.search(‘@’);”>
</cfform>

Para que entendam, mais claramente, de que ser este tipo de implementação, façam uma comparação do código da aplicação do artigo anterior para o código da aplicação a seguir.

index.cfm

<cfform name="form1" format="flash" onload="initApp()"> 

		<cfformitem type="script">			function initApp(){				Usuario.formName = 'form1';			}		</cfformitem> 

		<cfformgroup type="panel" width="420">			<cfformgroup  type="horizontal" >				<cfinput type="text"   name="qry"    id="qry"                                                                 />				<cfinput type="button" name="search" id="search" value="Pesquisar" onclick="Usuario.search(_root.qry.text);"  />			</cfformgroup>		</cfformgroup> 

		<cfformgroup type="panel" width="420" visible="false" id="pGrid">			<cfgrid name="listUsuarios" width="400" rowheaders="false" onchange="_root.pUser.visible = true;">				<cfgridcolumn name="nome"     />				<cfgridcolumn name="username" />				<cfgridcolumn name="email"    />			</cfgrid> 			<cfformgroup type="horizontal">				<cfinput name="RefreshUsuarios" id="RefreshUsuarios" type="button" value="Refresh" onclick="Usuario.get();"                                          />				<cfinput name="addUsuarios"     id="addUsuarios"     type="button" value="Novo"    onclick="Usuario.clear(); _root.pUser.visible = true;"            />				<cfinput name="RemoveUsuarios"  id="RemoveUsuarios"  type="button" value="Remove"  onclick="Usuario.remove(_root.listUsuarios.selectedItem.userid);" />			</cfformgroup>		</cfformgroup> 

		<cfformgroup type="panel" width="420" id="pUser" visible="false">			<cfinput type="text"    id="id"           name="id"           label="ID"       validate="integer"  enabled="false"  bind="{listUsuarios.selectedItem.userid}"                                           />			<cfinput type="text"    id="username"     name="username"     label="username" validate="noblanks" required="true"  bind="{listUsuarios.selectedItem.username}"                                         />			<cfinput type="text"    id="nome"         name="nome"         label="nome"     validate="noblanks" required="false" bind="{(listUsuarios.selectedItem.nome != null)?listUsuarios.selectedItem.nome:''}" />			<cfinput type="text"    id="email"        name="email"        label="email"    validate="email"    required="true"  bind="{listUsuarios.selectedItem.email}"                                            />			<cfinput  type="button" id="saveUsuarios" name="saveUsuarios" value="Salvar"					onclick="							Usuario.nome = _root.nome.text ;							Usuario.email = _root.email.text;							Usuario.username = _root.username.text;							if(_root.id.text == ''){								Usuario.append();							}else{								Usuario.update(_root.id.text);							}" >		</cfformgroup> 

</cfform>

Obs.: São três imagens, mas não houve reload, basta testar o cfml e verá.

Conclusão

“Uma boa prática deixa seu código muito mais apresentável, otimizado, com uma produtividade alta e um tempo de implementação reduzido.”

–
Pedro Claudio – pcsilva@mxstudio.com.br
visite o fórum MXStudio ColdFusion
Blog

FormatCF(new Array(\’1.cfm\’,\’2.cfm\’,\’3.cfm\’,\’4.cfm\’,\’5.cfm\’,\’index.cfm\’)); FormatAS(new Array(\’hUsuario.as\’,\’oget\’,\’communication\’,\’Construtor\’,\’atributos\’));

Introdução

Desde de a chegada do ColdFusion MX 7, venho publicando exemplos que utilizam Flash Remoting, mas aqui vamos detalhar a utilização desta tecnologia em aplicações construídas com a TAG CFFORM com o farmato flash, e o desenvolvimento do ActionScript nesta aplicação..
Depois da leitura deste documento tente exercitar com os artigos passados, identificando esta tocnologia ali contida.
#include AS no CFFORM
Ações e eventos
Flash Form e Flash Remoting
Flash Remoting em Formulrios CFFORME como pode ser visto através deste último, que estarei falando sobre um assunto já abordado.

Pré-requisito

- ColdFusion MX 7.0.2
- Para que você possa acompanhar os exemplos a seguir, verifique para qual pasta o mapeamento / do Administrador ColdFusion aponta, e crie uma estrutura de diretórios, a partir da pasta registrada, par que fique da seguinte forma [caminho visto no cfadmin]/labs/remoting, e o repositório do componente (Usuario.cfc) deste artigo, será a pasta remoting.

Conceitos

O conceito de Flash Remoting é muito confundido ao conceito de RIA, com uma simples diferença o Flash Remoting, é um mensageiro, é um dos elementos que permitem as aplicações RIA realizarem comunicações/requests sem reload de pagina, assim como wsdl, ajax e similares.
A tecnologia está baseada no protocolo AMF criado pela Macromedia, que logo foi incorporado ao servidor ColdFusion MX 6, e continuado na versão seguinte ColdFusion MX 7.
Tratando-se de aplicações Flash Remoting com Coldfusion, basicamente será preciso um componente com pelo menos um método com o tipo de access sendo remoto, e o desenvolvimento de uma aplicação ActionScript, para que o cliente acesse este componente.
Como pode reparar o cliente vai ter a sua disposição uma comunicação cliente/servidor, isto é garantido através de um gateway servido pelo ColdFusion e com a construção de um proxy no ActionScript, isto permite que a aplicação realize todos as operações sem a necessidade de uma atualização de pagina no cliente..

Conteúdo

Componente Remoto
Como foi dito um componente é necessário na utilização desta tecnologia, então vejamos o cfc.

Usuario.cfc

<cfcomponent name="Usuario" alias="labs.remoting.Usuario"> 

  <cffunction name="validate" access="private" output="false" returntype="struct">
  <cfargument name="dados"  type="struct" required="true" />
  <cfargument name="type"   type="string" required="true" /> 

  <cfset var user        = StructNew()                        />
  <cfset var colunas     = ListToArray("nome,email,username") />
  <cfset var isRequerida = ListToArray("false,true,true")     />
  <cfset var i           = 0                                  /> 

  <cfset user.destino  = ArrayNew(1)                        />
  <cfset user.value    = ArrayNew(1)                        />
  <cfset user.valid    = false                              /> 

  <cfloop from="1" to="#ArrayLen(colunas)#" index="i"> 

  <cfif StructKeyExists(arguments.dados,colunas[i]) and  Len(Trim(arguments.dados[colunas[i]])) > 

  <cfif arguments.type eq "update">
  <cfset ArrayAppend(user.value,"#colunas[i]# = '#Trim(arguments.dados[colunas[i]])#'") />
  <cfelse>
  <cfset ArrayAppend(user.destino,colunas[i])                                           />
  <cfset ArrayAppend(user.value,"'#Trim(arguments.dados[colunas[i]])#'")                />
  </cfif> 

  <cfset user.valid = true     /> 

  <cfelseif isRequerida[i] >
  <cfset    user.valid = false />
  <cfreturn user               />
  </cfif> 

  </cfloop> 

  <cfreturn user /> 

  </cffunction> 

  <cffunction name="append"   access="remote"  output="false" returntype="numeric">
  <cfargument name="dados" type="struct" required="true" /> 

  <cfset var user  = validate(arguments.dados,"add") />
  <cfset var query = ""                              />  

  <cfif user.valid > 

  <cfset query = search(arguments.dados.username) />
  <cfif query.recordcount>
  <cfreturn 0 />
  </cfif> 

  <cfquery datasource="mxstudio_mysql">
          insert into usuarios (#ArrayToList(user.destino)#) values (#ArrayToList(user.value)#)
  </cfquery> 

  <cfset query = search(arguments.dados.username) /> 

  <cfif query.recordcount>
  <cfreturn query.userid />
  </cfif> 

  </cfif> 

  <cfreturn -1 /> 

  </cffunction> 

  <cffunction name="update"   access="remote"  output="false" returntype="numeric">
  <cfargument name="dados" type="struct"  required="true" />
  <cfargument name="id"    type="numeric" required="true" /> 

  <cfset var user = validate(arguments.dados,"update") />
  <cfset var query = ""                                />  

  <cfif user.valid > 

  <cfquery name="query" datasource="mxstudio_mysql">
          select * from usuarios
          where userid <> #arguments.id#
          and   username = '#arguments.dados.username#'
  </cfquery>
  <cfif query.recordcount>
  <cfreturn 0 />
  </cfif> 

  <cfquery datasource="mxstudio_mysql">
          update usuarios set
          #ArrayToList(user.value)#
          where userid = #arguments.id#
  </cfquery> 

  <cfreturn 1 /> 

  </cfif> 

  <cfreturn -1 /> 

  </cffunction> 

  <cffunction name="remove"   access="remote"  output="false" returntype="boolean">
  <cfargument name="id" type="string" required="true" /> 

  <cfset var soma = 0 /> 

  <cftry> 

  <cfset soma = ArraySum(ListToArray(arguments.id)) /> 

  <cfcatch type="expression">
  <cfreturn false/>
  </cfcatch> 

  </cftry> 

  <cfquery datasource="mxstudio_mysql">
          delete from usuarios
          where userid in (#arguments.id#)
  </cfquery> 

  <cfreturn true/>  

  </cffunction> 

  <cffunction name="get"      access="remote"  output="false" returntype="query"> 

  <cfset var query = "" /> 

  <cfquery name="query" datasource="mxstudio_mysql">
          select userid as data, nome as label, usuarios.* from usuarios
  </cfquery> 

  <cfreturn query /> 

  </cffunction> 

  <cffunction name="search"   access="remote"  output="false" returntype="query">
  <cfargument name="str" type="any" required="true" /> 

  <cfset var query = "" /> 

  <cfquery name="query" datasource="mxstudio_mysql">
          select userid as data, nome as label, usuarios.* from usuarios
          where
  <cfif IsNumeric(arguments.str)>
          userid      = #arguments.str#
  <cfelse>
          username like '%#arguments.str#%'
          or  nome     like '%#arguments.str#%'
          or  email    like '%#arguments.str#%'
  </cfif>
  </cfquery> 

  <cfreturn query /> 

  </cffunction> 

</cfcomponent>

Banco de dados
Também será necessário um database, que aqui recebeu o nome de mxstudio_mysql, que contém a seguinte construção e valores.

Usuario.sql

create table usuarios (
userid int(10) unsigned NOT NULL auto_increment,
username  varchar(100) default  NULL,
nome  varchar(255) default NULL,
email  varchar(255) default NULL,
primary key  (userid)
) engine=InnoDB default charset=utf8; 

insert into usuarios values ('','zezinho','Jose','zezinho@mail.com');
insert into usuarios values ('','cabeça','Andre','andre@mail.com');
insert into usuarios values ('','cachaça','Walter','cachaca@mail.com');

ActionScript

A parte CFML já está a disposição para acesso por Flash Remoting, dependendo da construção do proxy ActionScript na aplicação flash cliente.
Quando do lançamento do ColdFusion MX 6, o mesmo não dispunha de aplicações Flash Form, que eram/são construídas no Flex ou Flash, então vou comparar uma construção ActionScript Flash com CFFORM Flash.

Para construir o proxy no Flash é preciso fazer o include de uma classe, isso na primeira versão de Flash MX, e nas verões posteriores através de import, como pode ser encontrado com facilidade em qualquer buscador.

Essa mesma construção em uma aplicação CFFORM Flash muda completamente, pois a época do desenvolvimento do ColdFusion MX 7, o ActionScript no qual foi baseado sofria grandes alterações, e também devido as restrições que este ActionScript recebeu quando inserido como features no ColdFusion, assunto que já foi visto http://www.mxstudio.com.br/views.tutorial.php?act=view&cid=7&aid=733.

O include ActionScript é permitido no CFFORM, porém desnecessário na construção de um proxy Flash Remoting nele, já que podemos realizar chamadas diretas as classes que estão no servidor.

Os exemplos foram construídos sem qualquer elemento cfform, a não ser o proprio cfform, que carrega proxy e executa o serviço.
E uma chamada remoting simples aos serviços disponibilizados no cfc que vimos, fica assim:

1.cfm

  <!--- o no evento onload do cfform invoco a inicialização do Remoting --->
    <cfform name="basic" format="flash" onload="initRemoting();">
  <cfformitem type="script">
   function initRemoting(){ 

    /*
    A classe mx.remoting.NetServices através do método
    createGatewayConnection construímos o a ligação
    cliente/servidor
    */
    var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection("http://localhost/cfusion/flashservices/gateway/");
   // objeto receberá ações para o serviço
    var serviceEvent:Object   = {};  

    // toda ação de um invoke ok, estaré em onResult
    serviceEvent.onResult = function(result):Void{
    alert('Resposta do servidor','result');
    }; 

    // caminho para o componente
    var servicePath:String = "labs.remoting.Usuario"; 

    // conecta o cliente ao serviço
    var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

    // invoca serviço
    service.get(); 

    }
  </cfformitem>
  </cfform>

Quando disse que o objeto receberá “ações” para o serviço, não está errado, isto porque o serviço pode responder a dois eventos, que são onResult e onStatus, este segundo só será executado caso ocorra uma anomalia na conexão com o serviço ou na execução dele. Separei alguns exemplos disto para observarmos.

Nesta primeira observação um exemplo sem erros, apenas para verificar quais as propriedades do evento receberemos do servidor, reparem na função onStatus.

2_1.cfm

    <cfform name="basic" format="flash" onload="initRemoting();">
  <cfformitem type="script">
      function initRemoting(){ 

      var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection("http://localhost/cfusion/flashservices/gateway/");
     var serviceEvent:Object   = {};  

      serviceEvent.onResult = function(result):Void{
      alert('Resposta do servidor','result');
      };
      serviceEvent.onStatus = function(info:Object):Void{
      /*
      info.code - corrente SERVER.PROCESSING
      info.type - nome da classe envolvida no erro
      info.details - informa onde ocorreu o erro
      info.level - tipo do status, no remoting sempre erro
      info.description - mensagem de erro do servidor
      */
      alert(info.description,info.level);
      }; 

      var servicePath:String = "labs.remoting.Usuario"; 

      var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

      service.get(); 

      }
  </cfformitem>
  </cfform>

Agora sim, a série de erros provocados, neste tentarei conectar o cliente a um serviço que não existe.

2_2.cfm

<cfform name="basic" format="flash" onload="initRemoting();">
  <cfformitem type="script">
      function initRemoting(){ 

      var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection("http://localhost/cfusion/flashservices/gateway/"); 

 var serviceEvent:Object   = {};  

      serviceEvent.onResult = function(result):Void{
      alert('Resposta do servidor','result');
      };
      serviceEvent.onStatus = function(info:Object):Void{
      alert(info.description,info.level);
      }; 

 // aqui o erro provocado
      var servicePath:String = "labs.remoting.ERRO"; 

      var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

      service.get(); 

      }
  </cfformitem>
  </cfform>

Uma tentativa de conexão, onde o caminho do serviço não é um componente, neste exemplo em particular o caminho informado é uma pasta, e o serviço não pede um cfc e sim um cfm, não me pergunte porque, mas o caminho deve ser um componente.

2_3.cfm

<cfform name="basic" format="flash" onload="initRemoting();">
  <cfformitem type="script">
      function initRemoting(){ 

      var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection("http://localhost/cfusion/flashservices/gateway/"); 

 var serviceEvent:Object   = {};  

      serviceEvent.onResult = function(result):Void{
      alert('Resposta do servidor','result');
      };
      serviceEvent.onStatus = function(info:Object):Void{
      alert(info.description,info.level);
      }; 

      // aqui o erro provocado
      var servicePath:String = "labs.remoting"; 

      var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

      service.get(); 

      }
  </cfformitem>
  </cfform>

Uma conexão sem caminho.

2_4.cfm

<cfform name="basic" format="flash" onload="initRemoting();">
  <cfformitem type="script">
      function initRemoting(){ 

      var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection("http://localhost/cfusion/flashservices/gateway/"); 

 var serviceEvent:Object   = {};  

      serviceEvent.onResult = function(result):Void{
      alert('Resposta do servidor','result');
      };
      serviceEvent.onStatus = function(info:Object):Void{
      alert(info.description,info.level);
      }; 

      // aqui o erro provocado
      var servicePath:String = ""; 

      var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

      service.get(); 

      }
  </cfformitem>
  </cfform>

A tentiva de execução de um serviço que não existe.

2_5.cfm

<cfform name="basic" format="flash" onload="initRemoting();">
  <cfformitem type="script">
      function initRemoting(){ 

      var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection("http://localhost/cfusion/flashservices/gateway/"); 

 var serviceEvent:Object   = {};  

      serviceEvent.onResult = function(result):Void{
      alert('Resposta do servidor','result');
      };
      serviceEvent.onStatus = function(info:Object):Void{
      alert(info.description,info.level);
      }; 

      var servicePath:String = "labs.remoting.Usuario"; 

      var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

      // aqui o erro provocado
      service.ERRO(); 

      }
  </cfformitem>
  </cfform>

A chamada de um serviço que necessita de parâmetro, mas não foi informado.

2_6.cfm

<cfform name="basic" format="flash" onload="initRemoting();">
  <cfformitem type="script">
      function initRemoting(){ 

      var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection("http://localhost/cfusion/flashservices/gateway/"); 

 var serviceEvent:Object   = {};  

      serviceEvent.onResult = function(result):Void{
      alert('Resposta do servidor','result');
      };
      serviceEvent.onStatus = function(info:Object):Void{
      alert(info.description,info.level);
      }; 

      var servicePath:String = "labs.remoting.Usuario"; 

      var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

      // aqui o erro provocado
      service.search(); 

      }
  </cfformitem>
  </cfform>

A execução de um serviço onde o parâmetro passado é diferente do requerido.

2_7.cfm

<cfform name="basic" format="flash" onload="initRemoting();">
  <cfformitem type="script">
      function initRemoting(){ 

      var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection("http://localhost/cfusion/flashservices/gateway/"); 

 var serviceEvent:Object   = {};  

      serviceEvent.onResult = function(result):Void{
      alert('Resposta do servidor','result');
      };
      serviceEvent.onStatus = function(info:Object):Void{
      alert(info.description,info.level);
      }; 

      var servicePath:String = "labs.remoting.Usuario"; 

      var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

      var param:Object = {};
      // aqui o erro provocado
      param.dados=""; 

 service.append(param); 

      }
  </cfformitem>
  </cfform>

Prosseguindo, veremos agora a passagem de parâmetros ao serviço. O mais correto é informar os parâmetros dentro de um objeto.

3.cfm

<cfform name="basic" format="flash" onload="initRemoting();">
  <cfformitem type="script">
    function initRemoting(){ 

    var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection('');
    connection.connect("http://localhost/cfusion/flashservices/gateway/"); 

 var serviceEvent:Object   = {};  

    serviceEvent.onResult = function(result):Void{
    alert('Resposta do servidor','result');
    };
    serviceEvent.onStatus = function(info:Object):Void{
    alert(info.description,info.level);
    }; 

    var servicePath:String = "labs.remoting.Usuario"; 

    var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

    //cria o objeto que receberá os parâmetros
    var params:Object = {};
    /*
    adiciona o nome do parâmetro exatamente como está no serviço,
    no atributo name da tag cfargument,
  <cfargument name="str" ...>
    */
    params.str = 'W'; 

    service.search(params); 

    }
  </cfformitem>
  </cfform>

E por fim o tratamento do tipo de dado retornado pelo serviço na execução do onResult. Os tipos de dados comuns entre linguagens serão manipulados normalmente como estivesse na linguagem de origem, porém você deve estar atento ao case-sensitive do ActionScript, e por vezes alguns servidores passam ao cliente estruturas de dados (structs) e o ActionScript recebe este como Object, natural, mas em alguns casos suas keys estarão em caixa alta, e o tratamento deste objeto no cliente estaria esperando uma key em caixa baixa, atenção com isto ? já vi casos de desenvolvedor ficar um dia inteiro procurando o erro.
Contudo, o exemplo a seguir é de um tipo de dado mais complexo, que no servidor ColdFusion é do tipo Query, na verdade é um outro, mas não vamos confundir, e no cliente será recebido como Array, e em uma propriedade especial.

4.cfm

<cfform name="basic" format="flash" onload="initRemoting();">
  <cfformitem type="script">
    function initRemoting(){ 

    var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection('');
    connection.connect("http://localhost/cfusion/flashservices/gateway/"); 

 var serviceEvent:Object   = {};  

    serviceEvent.onResult = function(result):Void{
    // _items é a propriedade onde estará a query retornada
    var query:Array = result._items;
    // identifico o recordcount da query retornada
    var recordCount:Number = query.length;
    var columnlist:String ="";
    // cria um lista com os keys do primeiro registro
    for(var i in query[0]){
    columnlist+=i+",";
    }
    alert('RecordCount = '+recordCount,'result');
    alert('ColumnList = '+columnlist,'result');
    };
    serviceEvent.onStatus = function(info:Object):Void{
    alert(info.description,info.level);
    }; 

    var servicePath:String = "labs.remoting.Usuario"; 

    var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

    service.get(); 

    }
  </cfformitem>
  </cfform>

Conclusão

Seu conhecimento vai definir a variedade de operações
que o Flash Form deve possuir, e também defini o quão reutilizável será seu código, em consequencia a quantidade de linhas, a praticidade e produtividade no desenvolvimento, bom isto veremos em um próximo post, e para exercitar deixo aqui uma aplicaçãozinha construída com as informações deste artigo.

index.cfm

<cfform name="form1" format="flash">
  <cfformgroup type="panel" width="420">
  <cfformgroup  type="horizontal">
  <cfinput type="text" name="qry" id="qry" >
  <cfinput type="button" name="search" id="search" value="Pesquisar"
    onclick="
    var params:Object = {};
    params.str = _root.qry.text; 

    var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection('http://localhost/cfusion/flashservices/gateway/'); 

    var serviceEvent:Object   = {};  

    serviceEvent.onResult = function(result):Void{
    _root.listUsuarios.dataProvider = result._items;
    _root.id.text = '';
    _root.username.text = '';
    _root.email.text = '';
    _root.nome.text = '';
    CFFormValidators.resetInValidFields();
    }; 

    var servicePath:String = 'labs.remoting.Usuario'; 

    var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

    service.search(params); 

  "
  > 

 </cfformgroup>
  </cfformgroup>
  <cfformgroup type="panel" width="420">
  <cfgrid name="listUsuarios" width="400" rowheaders="false">
  <cfgridcolumn name="nome" >
  <cfgridcolumn name="username" >
  <cfgridcolumn name="email" >
  </cfgrid>
  <cfformgroup type="horizontal">
  <cfinput name="RefreshUsuarios" id="RefreshUsuarios" type="button" value="Refresh"
    onclick="
    var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection('http://localhost/cfusion/flashservices/gateway/'); 

    var serviceEvent:Object   = {};  

    serviceEvent.onResult = function(result):Void{
    _root.listUsuarios.dataProvider = result._items;
    _root.id.text = '';
    _root.username.text = '';
    _root.email.text = '';
    _root.nome.text = '';
    CFFormValidators.resetInValidFields();
    }; 

    var servicePath:String = 'labs.remoting.Usuario'; 

    var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

    service.get(); 

  "
  >
  <cfinput name="RemoveUsuarios" id="RemoveUsuarios" type="button" value="Remove"
    onclick="
    if(_root.listUsuarios.selectedItem != null){ 

    var params:Object = {};
    params.id = _root.listUsuarios.selectedItem.userid; 

    var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection('http://localhost/cfusion/flashservices/gateway/'); 

    var servicePath:String = 'labs.remoting.Usuario'; 

    var serviceEvent:Object   = {};  

    serviceEvent.onResult = function(result):Void{
    if(result){
    var dt:Array = [];
    for(var i =0; i < _root.listUsuarios.dataProvider.length;i++ ){
    if(_root.listUsuarios.dataProvider[i].userid != params.id){
    dt.push(_root.listUsuarios.dataProvider[i]);
    }
    }
    _root.listUsuarios.dataProvider = dt;
    _root.id.text = '';
    _root.username.text = '';
    _root.email.text = '';
    _root.nome.text = '';
    CFFormValidators.resetInValidFields();
    alert('Ok','result');
    }else{
    alert('Erro','result');
    }
    };
    serviceEvent.onStatus = function(info:Object):Void{
    alert(info.description,info.level);
    }; 

    var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent); 

    service.remove(params);
    }else{
    alert('Selecione um usuario','Erro');
    }
  "
  >
  </cfformgroup>
  </cfformgroup>
  <cfformgroup type="panel" width="420">
  <cfinput type="text" id="id" name="id" label="ID" bind="{listUsuarios.selectedItem.userid}" enabled="false" validate="integer">
  <cfinput type="text" id="username" name="username" label="username" bind="{listUsuarios.selectedItem.username}" validate="noblanks" required="true">
  <cfinput type="text" id="nome" name="nome" label="nome" bind="{(listUsuarios.selectedItem.nome != null)?listUsuarios.selectedItem.nome:''}" validate="noblanks" required="false">
  <cfinput type="text" id="email" name="email" label="email" bind="{listUsuarios.selectedItem.email}" validate="email" required="true" >
  <cfinput name="saveUsuarios" id="saveUsuarios" type="button" value="Salvar"
    onclick="
    _root.enableAllValidators();
    CFFormValidators.resetInValidFields();
    if(mx.validators.Validator.isStructureValid(this, 'form1')){ 

    var params:Object = {};
    params.dados = {};
    params.dados.username = _root.username.text;
    params.dados.email = _root.email.text ;
    params.dados.nome = _root.nome.text ;
    var serviceName = 'append';
    if(_root.id.text != ''){
    serviceName = 'update';
    params.id = _root.id.text ;
    } 

    var connection:mx.remoting.Connection = mx.remoting.NetServices.createGatewayConnection('http://localhost/cfusion/flashservices/gateway/'); 

    var servicePath:String = 'labs.remoting.Usuario'; 

    var serviceEvent:Object   = {};  

    serviceEvent.onResult = function(result):Void{
    _root.id.text = '';
    _root.username.text = '';
    _root.email.text = '';
    _root.nome.text = '';
    CFFormValidators.resetInValidFields();
    alert(result,'result');
    };
    serviceEvent.onStatus = function(info:Object):Void{
    alert(info.description,info.level);
    }; 

    var service:mx.remoting.NetServiceProxy = connection.getService(servicePath,serviceEvent);
    service[serviceName](params);
    }else{
    _root.userOnError();
    }
  "
  > 

 </cfformgroup>
    </cfform>

–
Pedro Claudio – pcsilva@mxstudio.com.br
visite o fórum MXStudio ColdFusion

FormatCF(new Array(\’/labs/remoting/Usuario.cfc\’,\’1.cfm\’,\’2_1.cfm\’,\’2_2.cfm\’,\’2_3.cfm\’,\’2_4.cfm\’,\’2_5.cfm\’,\’2_6.cfm\’,\’2_7.cfm\’,\’3.cfm\’,\’4.cfm\’,\’index.cfm\’)); FormatSQL(new Array(\’Usuario.sql\’));