Classe FileReferenceList (Português)

ActionScript 3.0, Adobe AIR, Adobe Flash, Adobe Flex, Orientação a Objetos Deixe um comentário »

Fonte: http://livedocs.adobe.com/flex/201/langref/flash/net/FileReferenceList.html 

A classe FileReferenceList fornece recursos para permitir o usuário selecionar um ou mais arquivos para upload. Um objeto FileReferenceList representa um grupo de um ou mais arquivos locais no disco do usuário como um array de objetos FileReference.

Para trabalhar com a classe FileReferenceList:

  •  Instanciar a classe: var frl:FileReferenceList = new FileReferenceList();
  • Chamar o método FileReferenceList.browse(), que abre uma janela que permiete o usuário selecionar um ou mais arquivos para upload: frl.browse();
  • Depois o método é browse() ser chamado com sucesso, a propriedade fileList do pobjeto FileReferenceList é populado com um array de objetos FileReference.
  • Chame FileReference.upload() em cada elemento do array fileList.

A classe FileReferenceList inclui um método browse() e uma propriedade fileList para trabalhar com múltiplos arquivos. Enquanto uma chamada para FileReferenceList.browse() está em execução, o arquivo pausa a reprodução em stand-alone e players externos para Linux e Mac OS X 10.1 e versões anteriores.

Propriedades Públicas

  • fileList:Array – [somente leitura] Cria um novo objeto FileReferenceList.
  • browse(typeFilter:Array):Boolean – Apresenta uma janela que permite o usuário selecionar um ou mais arquivos para upload.

Eventos

  • cancel – Disparado quando o usuário fecha a janela.
  • select – Disparado quando o usuário seleciona um ou mais arquivos para upload de uma janela de arquivo

Classe FileReference (Português)

ActionScript 3.0, Adobe AIR, Adobe Flash, Adobe Flex, Orientação a Objetos Deixe um comentário »

Resolvi traduzir, apesar do meu inglês não ser muito avançado, da documentação da Adobe, para que todos tivessem um conhecimento maior da classe FileReference e de outras que pretendo traduzir. 

Essa especificamente agora, pois estarei postando aqui no Blog um tutorial de como desenvolver um MultiFileUpload com Flex e PHP.

Se alguma tradução não estiver de acordo, mande um e-mail, deixe um comentário. 

Boa leitura! 

FileReference 

Fonte:  http://livedocs.adobe.com/flash/9.0/ActionScriptLangRefV3/flash/net/FileReference.html

A classe FileReference fornece recursos para upload e download de arquivos entre o cliente e o servidor. Uma janela avisa o usuário para selecionar um arquivo para upload ou um local para download. Cada objeto FileReference referencia um único arquivo no disco do usuário e tem propriedades que contêm informações sobre o arquivo: Tamanho, tipo, data de criação, data de modificação e tipo do criador (somente Macintosh).

Instâncias FileReference são criadas em dois passos:

  • Quando você usa o operador new com o construtor FileReference: var fr:FileReference = new FileReference();
  • Quando você chama o método FileReferenceList.browse(), que cria um array de objetos FileReference.

Durante a operação de upload, todas as propriedades de um objeto FileReference são populados por chamadas para os métodos FileReference.browse() ou FileReferenceList.browse(). Durante uma operação de download, a propriedade name é populada quando o evento select é disparado, todas as outras propriedades são populadas quando o evento complete é disparado.

O método browse() abre uma janela do sistema operacional para o usuário selecionar um arquivo para upload.

O método FileReference.browse() pemite o usuário selecionar somente um arquivo; o método FileReferenceList.browse() permite o usuário selecionar múltiplos arquivos. Depois de uma chamada bem sucedida do método browse(), chame o método FileReference.upload() para fazer o upload de um arquivo de cada vez.

As classes FileReference e FileReferenceList não permitem definir o local padrão de arquivos para a caixa de diálogo que os métodos browse() ou download() geram. O local padrão mostrado na caixa de diálogo é a pasta que recentemente foi mais acessada, se aquele local puder ser determinado, ou o desktop. As classes não permitem ler ou escrever a partir do arquivo transferido. Elas não permitem que o arquivo SWF que iniciou o upload ou download acesse o arquivo baixado ou a localização no disco do usuário.

As classes FileReference e FileReferenceList também não fornecem métodos para autenticação. Como servidores que requerem  autenticação, você pode baixar arquivos com o Flash Player, mas upload (em todos players) e download (no stand-alone ou player externo) falha. Observe os eventos FileReference para determinar se as operações foram concluídas com êxito e para tratar os erros.

Para operações de upload e download, um arquivo SWF pode acessar somente dentro do mesmo domínio, incluindo alguns domínios que estiverem especificados em um arquivo cross-domain policy. Coloque um arquivo policy no servidor se iniciar upload ou download de outro servidor de arquivos.

Enquanto chamadas para o FileReference.browse(), FileReference.browse(), FileReferenceList.browse(), ou FileReference.download() são executadas, o arquivo SWF pausa a reprodução em stand-alone e players externos para o Mac OS X 10.1 e anteriores.

Propriedades Públicas

  • creationDate : Date - [somente leitura] A data de criação do arquivo no disco local.
  • creator : Strng – [somente leitura ] O tipo criador de arquivo do Macintosh, que só é usado no Mac OS em versões anteriores ao Mac OS X.
  • extension : String – [AIR][somente leitura] A extensão do arquivo.
  • modificationDate : Date – [somente leitura] A data que o arquivo foi modificado no disco local.
  • name : String – [somente leitura] O nome do arquivo no disco local.
  • size : Number – [somente leitura] O tamanho do arquivo no disco local.
  • type : String – [somente leitura] O tipo de arquivo.

Métodos Públicos

  • FileReference() – Cria um novo objeto FileReference.
  • browse(tipeFilter:Array = null):Boolean – Apresenta uma janela que permite o usuário selecionar um arquivo para upload.
  • cancel():void – Cancela qualquer operação de upload ou download em curso neste objeto FileReference.
  • download(request:URLRequest, defaultFileName:String = null):void – Abre uma janela que permite o usuário baixar um arquivo de um servidor remoto.
  • upload(request:URLRequest, uploadDataFieldName:String = “FileData”, testUpload:Boolean = false):void – Inicia o upload de um arquivo selecionado por um usuário para um servidor remote.
  • uploadUnencoded(request:URLRequest):void – Inicia o upload de um arquivo para uma URL sem qualquer codificação.

Eventos

  • cancel – Disparado quando o upload ou download de arquivos é cancelado através de uma caixa de diálogo de navegação pelo usuário.
  • complete – Disparado quando download é completado ou quando o upload gerar um HTTP status código 200.
  • httpResponseStatus – [AIR] Disparado se a chamada para o método upload() ou uploadUnencoded tenta acessar os dados sobre HTTP e Adobe AIR é capaz de detectar e retornar o código de status da solicitação.
  • httpStatus – Disparado quando um upload falha e um status HTTP está disponível para descrever a falha.
  • ioError – Disparado quando uma operação de upload ou download falha.
  • open – Disparado quando uma operação de upload ou download inicia.
  • progress – Disparado periodicamente durante a operação de upload ou download.
  • securityError – Disparado quando uma chamada para o método FileReference.upload() ou FileReference.download() tenta fazer o upload de um arquivo de um servidor ou pegar um arquivo de um servidor que esteja fora do sandbox de segurança da chamada.
  • select – Disparado quando o usuário seleciona um arquivo para download ou upload de uma janela do sistema.
  • uploadCompleteData – Disparado após os dados serem recebidos pelo servidor depois de um upload bem-sucedido.

ActionScript 3.0 - Sintaxe

ActionScript 3.0, Adobe AIR, Adobe Flash, Adobe Flex, Orientação a Objetos 3 Comentários »

Para quem vem acompanhando o meu blog, talvez tenha percebido, ou não, que meu objetivo é escrever posts que se complementem e que para quem está iniciando o aprendizado em ActionScript 3.0, Flex ou mesmo o Flash, consiga ter uma sequência num aprendizado junto comigo.

Eu desenvolvo sites e sistemas web desde 2003 e no início, como todo iniciante, ficava ansioso para ver tudo funcionando na tela. Bom, durante este tempo aprendi que não adianta querermos aprender o avançado antes de termos uma base sólida nos conceitos fundamentais, seja o que for que estivermos estudando, por isso antes mesmo de desenvolvermos em ActionScript 3.0, é importante saber como a linguagem deve ser escrita, ou seja, qual a sua sintaxe.

A sintaxe de uma linguagem define as regras que devem ser seguidas quando escrever código executável.

Case sensitivity

ActionScript é uma linguagem case-sensitive, o que significa que os identificadores diferem em case (letras maiúsculas de minúsculas). Abaixo, como exemplo duas variáveis diferentes:

var num1:int;
var Num1:int;

Sintaxe de ponto (Dot sintax)

O operador ponto (.) disponibiliza um caminho para acessar as propriedades e métodos de um objeto. Por exemplo, considere a classe:

class ExemploPonto {
	public var prop1 : String;
	public function metodo1() : void {}
}

Acessando a propriedade e o método da classe a partir de uma instância.

var meuPonto : ExemploPonto = new ExemploPonto();
meuPonto.prop1 = “oi”;
meuPonto.metodo1();

Podemos usar dot sintax para definir pacotes, usando o operador ponto (.) para referir-se a pacotes internos. Por exemplo, a classe EventDispatcher está dentro de um pacote chamado events, que está dentro de um pacote chamado flash. Você pode fazer referencia ao pacote events usando a seguinte expressão:

flash.events

Você também pode referir-se a classe EventDispatcher usando esta espressão:

flash.events.EventDispatcher

Literais
Um literal é um valor que aparece diretamente no seu código. Os exemplos abaixo são todos literais:

17
"oi"
-3
9.4
null
undefined
true
false

Literais também podem ser agrupados para formar literais compostos. Arrays literais são escritos dentro de colcheteses ([ ]) e são usadas virgulas para se separar os elementos do array.

Um array literal pode ser usado para inicializar um array. Abaixo exemplo de dois arrays sendo inicializados usando arrays literais. Você pode usar a declaração new e passar o literal composto como um parâmetro para o construtor da classe Array, mas você também pode declarar valores literais diretamente quando instancia instâncias das classes: Object, Array, String, Number, int, uint, XML, XMLList e Boolean.

// Usando a declaração new.
var minhasStrings:Array = new Array(["alpha", "beta", "gamma"]);
var meusNumeros:Array = new Array([1,2,3,5,8]);
// Declarando diretamente com literais.
var minhasStrings:Array = ["alpha", "beta", "gamma"];
var meusNumeros:Array = [1,2,3,5,8];

Literais podem ser usadas para inicializar um objeto genérico. Um objeto genérico é uma instância da classe Object. literais Object são colocados dentro de chaves ({ }) e usa vírgulas para separaras propriedades do objeto. Cada propriedade é declarada com dois pontos ( : ), que separa o nome da propriedade do valor da propriedade. Você pode usar a declaração new e passar o literal composto como um parâmetro para o construtor da classe Object. Veja o exemplo a seguir:

// Usando a declaração new.
var meuObjeto:Object = new Object({propA:1, propB:2, propC:3});
// Declarando diretamente com literais.
var myObject:Object = {propA:1, propB:2, propC:3};

Ponto e vírgura ( ; )

Você pode usar ponto e vírgula para terminar uma declaração. Alternativamente, se você omitir o ponto e vírgula, o compilador irá assumir que cada linha de código representa uma declaração.

Parênteses

Você irá usar parênteses em 3 casos:

1. Para alterar a ordem das operações em uma expressão. Operações agrupadas dentro de parênteses são executadas primeiro.

trace(2 + 3 *4); //14
trace((2 + 3) *4); //20

2. Você pode usar parênteses com o operador vírgula ( , ) para avaliar uma série de expressões e retornar o resultado no final da expressão.

var a:int = 2;
var b:int = 3;
trace((a++, b++, a+b)); // 7

3. Você usa parênteses para passar um ou mais parênteses para funções ou métodos.

trace("oi");

Comentários

O código ActionScript 3.0 suporta dois tipos de comentários: um linhas e de várias linhas. O compilador ignora o que estiver marcado como um comentário.

// comentário de uma linha
/*
comentário
de várias
linhas

*/

Palavras-chave

Palavras-chave não podem ser usadas como identificadores em seu código, pois estas palavras são reservadas para o ActionScript. As palavras reservadas incluem palavras-chave léxicas, que são transferidas para o namespace do programa pelo compilador. O compilador pode retornar um erro se você usar uma palavra léxica como um identificador. Abaixo uma lista de palavrasa lexicas:

  • as
  • break
  • case
  • catch
  • class
  • const
  • continue
  • default
  • delete
  • do
  • else
  • extends
  • false
  • finally
  • for
  • function
  • if
  • implements
  • import
  • in
  • instanceof
  • interface
  • internal
  • is
  • native
  • new
  • null
  • package
  • private
  • protected
  • public
  • return
  • super
  • switch
  • this
  • throw
  • to
  • true
  • try
  • typeof
  • use
  • var
  • void
  • while
  • with

Este é um grupo de palavras-chave, chamado palavras-chave sintática, estas podem ser usadas como identificadores, mas tem um significado especial em certos contextos. Abaixo a lista de palavras-chave sintáticas:

  • each
  • get
  • set
  • namespace
  • include
  • dynamic
  • final
  • native
  • override
  • static


Estes também são alguns identificadores que às vezes são referidos como futuras palavras reservadas. Estes identificadores não são reservados para o ActionScript 3.0, apesar de terem que ser tratadas como palavras-chave para produtos ActionScript 3.0 incorporados. Você esta apto a usar vários destes identificadores em seu código, mas a Adobe recomenda você não usar pois poderão aparecer como palavras-chave em futuras versões da linguagem.

  • abstract
  • boolean
  • byte
  • cast
  • char
  • debugger
  • double
  • enum
  • export
  • float
  • goto
  • intrinsic
  • long
  • prototype
  • short
  • synchronized
  • throws
  • to
  • transient
  • type
  • virtual
  • volatile


Conhecendo a sintaxe estamos melhor preparados para desenvolver de forma mais sólida e correta.

Um abraço e até o próximo post!

Escrevendo ActionScript 3.0

ActionScript 3.0, Adobe AIR, Adobe Flash, Adobe Flex 4 Comentários »

Acredito que finalmente chegamos a uma versão do ActionScript de “respeito”, oferecendo um modelo de programação robusta, familiar a desenvolvedores com um conhecimento básico de programação orientada a objetos. Para desenvolver desde simples animações gráficas até complexos sistemas cliente-servidor.

Ao aprendermos ActionScript 3.0, podemos desenvolver em 3 diferentes tecnologias da Adobe: Flash, Flex e AIR, com pequenas variações.

Estaremos aprendendo todo o potencial desta linguagem, da sua sintaxe a vários exemplos práticos, muito do qual estarei extraindo, traduzindo e modificando da documentação da Adobe.

Sobre o ActionScript

  • ActionScript é uma linguagem de programação que roda no Flash Player.
  • É executado pela ActionScript Virtual Machine, que é parte do Flash Player.
  • É tipicamente compilado no formato bytecode por um compilador, tais como o Flex Builder, o Flex SDK e o Flex Data Services. O bytecode é anexado em arquivos SWF, que são executados pelo Flash Player.

Onde escrever o código

Dependendo do tipo de aplicação que você estará desenvolvendo, você pode preferir usar uma ou mais destas diferentes maneiras de incluir ActionScript no seu projeto.

Escrevendo código em frames da timeline do Flash

No ambiente de desenvolvimento do Flash, você pode adicionar o código ActionScript em qualquer frame da timeline. Esse código pode ser executado enquanto o movie é reproduzido.

Colocando o código ActionScript em frames é um caminho simples para adicionar comportamentos para aplicações desenvolvidas pelo Flash. Você pode adicionar ActionScript na timeline principal ou em frames de qualquer MovieClip. Contudo, esta flexibilidade tem um custo. Quando você desenvolve grandes aplicações, se torna fácil esquecer em qual frame o código foi escrito, o que pode tornar a aplicação mais difícil de manter ao longo do tempo.

Muitos desenvolvedores simplificam a organização do seu código ActionScript no Flash colocando código somente no primeiro frame de uma timeline, ou em uma layer especifica, a qual recomendo. Isto facilita a organização do seu código em arquivos Flash, mas ainda é pouco flexível, se quiser usar o mesmo código em outros arquivos do Flash ou em projetos do Flex. A melhor opção é ter todo o código ActionScript em um arquivo separado, com a extensão .as, que pode ser escrito em qualquer editor de texto, no Flash, no Flex, ou mesmo no Dreamweaver.

Escrevendo ActionScript em arquivos MXML do Flex

No ambiente de desenvolvimento do Flex, você pode inserir código ActionScript dentro da tag <mx:Script> em arquivos MXML. Código ActionScript Inline (inserido dentro de uma página pertencente a outro código) tem o mesmo inconveniente de inserir código ActionScript em frames do Flash, perdendo o poder de reutilização do código sem ter que cortar e colar em um novo arquivo.

Escrevendo em arquivos ActionScript

Se seu projeto envolve significantemente código ActionScript, a melhor maneira de organizar seu código é em arquivos ActionScript separados. Um arquivo ActionScript pode ser estruturado de uma de duas maneiras, dependendo de como você prentende usar na sua aplicação:

Código ActionScript não estruturado

Linhas de código ActionScript, incluindo declarações ou definições de funções, escrevendo como se estivessem inseridos diretamente em uma timeline, arquivo MXML, etc.

ActionScript escrito desta maneira pode ser acessado usando uma declaração include em ActionScript, ou na tag <mx:Script> do Flex. A declaração include do ActionScript faz com que o conteúdo de um arquivo ActionScript externo seja inserido no escopo do script, como se estivesse escrito diretamente naquele ponto da aplicação. Na linguagem MXML, a tag <mx:Script> permite que você especifique no atributo source a localização do arquivo ActionScript externo que será carregado e seu código será inserido no local especificado, por exemplo:

MXML:

<mx:Script source=“Preloader.as” />

Flash ActionScript:

include “Preloader.as” (sem ponto-e-vírgula)

Observação:

O código inserido desta maneira não pode ser escrito como classe, o que prejudica a sua reusabilidade.

Definicão de classe

A definição de classes, incluem métodos e definições de propriedades.

Quando você define uma classe, você pode acessar o código ActionScript da classe criando uma instância e usando suas propriedades, métodos e eventos, da mesma forma que faria com qualquer classe original do ActionScript. Isto requer duas partes:

1. Usar a declaração import para especificar o nome completo da classe, incluindo pacotes, para que o compilador saiba onde procurá-la. Por exemplo, quando quiser usar a classe MovieClip em ActionScript:

import flash.display.MovieClip;

ou pode importar todo o pacote ao qual a classe pertence:

import flash.display.*;

A única exceção à regra é quando precisa referir-se a classes que não estão definidas em um pacote.

2. Escrever código referindo-se ao nome da classe (usualmente declarando uma variável com esta classe como tipo de dado, e criando uma instância da classe para armazenar na variável). Por exemplo:

var preloader:Preloader = new Preloader();

Quando o compilador encontra a referência da classe Preloader pela primeira vez, ele irá procurar no código a localização da definição da classe Preloader, ou seja o import.

Aassim damos início ao estudo do ActionScript 3.0, que espero ter sido claro em todos os aspectos citados, se não comentem, mandem e-mails, fiquem a vontade, toda contribuição será bem-vinda para o crescimento do blog souweb e a melhoria do conteúdo para você leitor.

Um abraço e até o próximo post.

WP Theme & Icons by N.Design Studio
Entries RSS Comments RSS Login