O Caching Application Block (CAB) é um dos Application Blocks que constituem a Enterprise Library. Caso você não conheça a Enterprise Library leia o artigo Enterprise Library e os Application Blocks. O CAB é uma biblioteca simples que permite tornas as aplicações mais escaláveis e robustas. Ao colocar em cache informações que são frequentemente acessadas, evitamos o acesso a bancos de dados, webservices ou outro serviço qualquer.

Mas por que evitar acesso a banco de dados?

Quando guardamos informações em cache os dados ficam armazenados em memória. Todo e qualquer acesso feito à memória é inúmeras vezes mais rápido do que executar uma consulta a um banco de dados e retornar as informações. Imagine que temos uma lista de estado civil, por exemplo. Esta lista dificilmente terá os seus dados alterados. Desta forma, seria desnecessários buscar no banco de dados essas informações toda vez que o sistema precise exibi-las na tela. Esta lista poderia facilmente ser colocada em cache, ou seja, armazenada em memória. A relação de custo-benefício entre o gasto de memória ao tempo de resposta da consulta ao banco de dados será gritante. Imagine, então, se ao invés de um banco de dados estejamos acessando um webservice ou outro serviço externo. O ganho de velocidade compensa qualquer gasto adicional de memória.

CONFIGURANDO O CAB

Vamos ver então como implementar o cache em uma aplicação. Antes de mais nada devemos adicionar a referência ao CAB ao projeto:

Feito isso, devemos, então, adicionar ao arquivo de configuração (web.config, app.config) os dados referentes ao CAB:

<configuration>
<configSections>
<section  name="cachingConfiguration"  type="Microsoft.Practices.EnterpriseLibrary.Caching.Configuration.CacheManagerSettings,  Microsoft.Practices.EnterpriseLibrary.Caching, Version=3.1.0.0, Culture=neutral,  PublicKeyToken=b03f5f7f11d50a3a" />
</configSections>
<cachingConfiguration defaultCacheManager="TesteCache">
<cacheManagers>
<add  expirationPollFrequencyInSeconds="60"  maximumElementsInCacheBeforeScavenging="1000"
numberToRemoveWhenScavenging="10" backingStoreName="Null  Storage"
name="TesteCache" />
</cacheManagers>
<backingStores>
<add  encryptionProviderName=""  type="Microsoft.Practices.EnterpriseLibrary.Caching.BackingStoreImplementations.NullBackingStore,  Microsoft.Practices.EnterpriseLibrary.Caching, Version=3.1.0.0, Culture=neutral,  PublicKeyToken=b03f5f7f11d50a3a"
name="Null Storage"  />
</backingStores>
</cachingConfiguration>

</configuration>

Note que TesteCache é o identificador da configuração do cache. Este é o nome que deveremos referenciar na aplicação para que o cache funcione corretamente. Este nome pode ser alterado sem problema algum.

Implementando o CAB

Devemos incluir na seção de using o namespace utilizado pelo CAB:

using Microsoft.Practices.EnterpriseLibrary.Caching;

Em seguida devemos criar o objeto que armazenará os dados em memória, ou seja, o objeto gerenciador do cache:

private CacheManager _cache = CacheFactory.GetCacheManager(”TesteCache”);

Adicionando dados ao cache

Adicionar dados ao cache é bastante simples, basta chamar o método Add:

cache.Add(”nome”, “Fabio”);

Onde nome é o identificador da informação no cache e Fabio é a informação propriamente dita. Qualquer objeto pode ser armazenado em cache.

É bom lembrar que o método Add também é utilizado para alterar os dados salvos no cache. Por exemplo:

cache.Add(”nome”, “Fabio”);
cache.Add(”nome”, “Daniel”);

Ao recuperar do cache o indíce nome, o valor retornado será sempre o último informado, no caso, “Daniel”. Como o identificador é único, não é possível ter uma lista de objetos com o mesmo identificador, mas pode-se guardar uma lista de objetos:

List lista = new List();

lista.Add(1);
lista.Add(2);
lista.Add(3);

cache.Add(”lista”, lista);

Recuperando dados do cache

Obter os dados do cache também é simples, basta chamar o método GetData passando como parâmetro o identificador:

string Nome = cache.GetData(”nome”).ToString();
List novaLista = (List)cache.GetData(”lista”);

Remover dados do cache

Para remover informações do cache, devemos chamar o método Remove, passando como parâmetro o identificador:

cache.Remove(”nome”);

Concluindo

Com o CAB é possível implementar recursos de cache de uma forma simples e rápida.

Leia também

• Microsoft Enterprise Library 4.1 – Microsoft Application Blocks (1)

Artigo publicado no site FD Web

Implemente cache nas aplicações .NET com o Caching Application Block

Os objetivos dos application blocks são:

Consistência - Todos os Application Blocks seguem boas práticas e implementações com qualidade. Além disso, são disponibilizados até mesmo os testes unitários elaborados pelo time de desenvolvimento.

Extensibilidade - Todos os Applications Blocks são desenvolvidos de tal forma que uma possível customização para uma necessidade especifica, seja facilmente customizável.

Fácil de usar - São muitos recursos prontos em que uma única linha de chamada, ou somente uma alteração em um arquivo de configuração e o recurso já está implementado.

Integração - Todos os Applications Blocks podem trabalhar de forma integrada ou podemos também trabalhar somente com um dos blocos.

Os Application blocks

A versão 4.1 (Outubro 2008) traz os seguintes blocos:

Caching Application Block: Com este componente é possível implementar funcionalidades de cache local nas aplicações

Cryptography Application Block: Este componente permite implementar hashing e encriptação simétrica nas aplicações.

Data Access Application Block: Este componente permite padrozinar e agilizar a forma como os dados são acessados.

Exception Handling Application Block: Com este componente é possível implementar políticas de tratamento de erros de forma fácil e configurável.

Logging Application Block: Permite implementar técnicas de log padrão nas aplicações.

Policy Injection Application Block: Permite aplicar regras a instâncias de classes em tempo de execução baseado em regras configuráveis.

Security Application Block: Permite implementar funcionalidades de segurança e autorização.

Unity Application Block: É um pequeno e extensível conteiner de injeção de dependencia com suporte à injeção por meio de construtor, propriedade e métodos.

Validation Application Block. Este componente permite que os desenvolvedores criem regras de validação para objetos de negócio que podem ser usadas por diferentes camadas das aplicações.

Fazendo o download

Download do Enterprise Library 4.1: download

Leia também

• Implemente cache nas aplicações .NET com o Caching Application Block (2)

Artigo publicado no site FD Web

Microsoft Enterprise Library 4.1 – Microsoft Application Blocks

• Visual Basic 2008 Express Edition
• Visual C# 2008 Express Edition
• Visual Web Developer Express Edition
• Visual C++ Express Edition
• SQL Server 2005 Express Edition

É possível também fazer o download de uma imagem ISO com todas as ferramentas em um mesmo pacote, para instalações offline. Para seguir o link para Instalação Offline do Visual Studio Express Edition.

Também é necessário efetuar o registro de cada uma das ferramentas. A boa notícia é que o registro é gratuito.

Leia também

• Acessando banco de dados usando PHP e ADODB (6)
• EasyText: Componente TextBox com recursos adicionais (0)
• Trabalhando com a taskbar do windows no Visual Basic (2)
• Novidades do C# 3.0: Implicitly Typed Local Variables (1)
• Implemente cache nas aplicações .NET com o Caching Application Block (2)

Artigo publicado no site FD Web

Visual Studio 2008 Express Edition

Vamos, então, criar um método que verifique se uma determinada string possui 8 caracteres e retornar true ou false. Fazemos isso com o código abaixo:

public bool CepValido(string cep)
{
if (cep.Length ==
return true;
else
return false;
}

Porém, este código é apenas uma função normal. Para que ela se torne uma extensão da classe string precisamos fazer alguns ajustes ao código.

1. Os extension methods devem estar em uma classe pública e estática (public static class);
2. Devem, também, ser do tipo public static;
3. Todo método deve possuir pelo menos um parâmetro, sendo este da classe a ser estendida, e possuir a palavra-chave this antes do tipo da classe;

Vamos modificar o código acima para que se torne, então, um método de extensão:

public static class ExtensionClass
{
public static bool CepValido(this string cep)
{
if (cep.Length ==
return true;
else
return false;
}
}

Note a visibilidade public static tanto na declaração da classe como na declaração do método, bem como a palavra-chave this antes do tipo (string) da variável “cep”.

Agora, para poder utilizar a extensão que acabamos de criar, basta importar o namespace onde se encontra a nossa classe criada (se for o mesmo namespace que o resto da aplicação não é necessário fazer nada. Se você não sabe o que é namespace então o código provavelmente irá funcionar por si só.) para a classe onde iremos utilizar a extensão e declarar uma variável do tipo string. Depois é só chamar o método CepValido, conforme segue abaixo:

private void TesteExtensao()
{
string cep = “12345678″;
if (cep.CepValido())
MessageBox.Show(”Cep Válido”);
else
MessageBox.Show(”Cep inválido”);

}

Como pode ser visto, é muito fácil implementar métodos de extensão, possibilitante escrever um código mais limpo e de fácil manutenibilidade (se usados corretamente). É importante lembrar, também, que caso haja conflito de nomes entre um método da instância de uma classe (por exemplo, toString) e um extension method, os métodos da instância têm precedência sobre os métodos de extensão, ou seja, o método nativo será executado.

Leia também

• Novidades do C# 3.0: Automatic Properties (0)
• Novidades do C# 3.0: Object Initializers (1)
• Novidades do C# 3.0: Implicitly Typed Local Variables (1)
• Implementando controle de transações com TransactionScope (2)
• Buscando o preview de um arquivo EPS em C# com ASP.NET (0)

Artigo publicado no site FD Web

Novidades do C# 3.0: Extension Methods

Vamos aos exemplos. Vejamos como é forma antiga (e mais trabalhosa):

// Declara as variáveis privadas

private string _nome;

private int _idade;

public string Nome
{
get
{
return _nome;
}
set
{
_nome = value;
}

}

public int Idade

{
get
{
return _idade;

}
set
{
_idade = value;
}

}

E agora vejamos como fica o código acima no C# 3.0:

public string Nome { get; set; }
public int Idade { get; set; }

Bem mais simples, não é mesmo? E ainda existe um atalho para a declaração de propriedades no Visual Studio: basta digitar prop e pressionar a tecla TAB. O próprio VS monta o esqueleto da propriedade, como segue abaixo:

public int MyProperty { get; set; }

Com esse novo recurso e mais o atalho fica muito fácil e rápido criar propriedades.

Leia também

• Novidades do C# 3.0: Extension Methods (0)
• Novidades do C# 3.0: Object Initializers (1)
• Novidades do C# 3.0: Implicitly Typed Local Variables (1)
• Implementando controle de transações com TransactionScope (2)
• Buscando o preview de um arquivo EPS em C# com ASP.NET (0)

Artigo publicado no site FD Web

Novidades do C# 3.0: Automatic Properties

Nas versões anteriores, a inicialização de objetos era feita da seguinte forma:

Cliente cli = new Cliente();
cli.Nome = “Fabio”;
cli.Idade = 26;

Agora podemos abreviar esta inicialização, da seguinte forma:

Cliente cli = new Cliente() { Nome = “Fabio”, Idade = 26};

Ou ainda, para deixar o código mais legível:

Cliente cli = new Cliente()
{
Nome = “Fabio”,
Idade = 26};
}

De qualquer forma, seja em uma única linha ou mais, não deixa de ser um recurso bastante interessante.

Leia também

• Novidades do C# 3.0: Extension Methods (0)
• Novidades do C# 3.0: Automatic Properties (0)
• Novidades do C# 3.0: Implicitly Typed Local Variables (1)
• Implementando controle de transações com TransactionScope (2)
• Buscando o preview de um arquivo EPS em C# com ASP.NET (0)

Artigo publicado no site FD Web

Novidades do C# 3.0: Object Initializers

O C# 3.0 traz uma nova palavra-chave chamada “var”. Com ela é possível declarar uma variável cujo tipo é determinado implicitamente pela expressão utilizada para inicializá-la. A verificação do tipo da variável é feita em tempo de compilação. Vejamos os exemplos a seguir:

// Inicializa a variável Nome com a o texto Fabio.
// Em tempo de execução, Nome será do tipo string

var Nome = “Fabio”;

// Inicializa OutroNome a partir de Nome.
// Ambas as variaveis serão do tipo string e conterão o mesmo valor: “Fabio”

var OutroNome = Nome;

// Inicializa a variável idade com o valor 20. Esta variável será do tipo int;

var idade = 20;

Como vimos nos exemplos acima, podemos facilmente declarar uma variável sem sabermos o tipo exato durante sua declaração. Alguns podem se perguntar: por que não utilizar então o tipo object? Pois bem, como dito, a verificação do tipo da variável é feita em tempo de compilação, o que significa que uma variável declarada com o tipo var e inicializada com o texto “xxx” será, para o compilador, do tipo string.
Ex.

var Nome = “Fabio”; // Nome será do tipo string

string OutroNome = Nome; //Funciona pois Nome é do tipo string

object Sobrenome = “Centenaro”; //Inicializa variável do tipo object

Nome = Sobrenome;
//Erro de compilação. Não é possível converter implicitamente object para string.
// É obrigatório efetuar o cast.

Outra dúvida que pode surgir é: já que o tipo var “converte” automaticamente a variável, então por que continuar usando string, int, bool? A resposta é muito simples: É possível, sim, usar var no lugar de qualquer outro tipo, porém isso torna o código mais difícil de entender e dar manutenção. Além do que, em muitos casos, não podemos inicializar uma variável com algum valor, e inicializar uma variável do tipo var com um valor do tipo -1 ou 0 apenas para que ela seja do tipo int é fazer uso da programação orientada a gambiarra. Se queremos uma variável do tipo int, então por que não declará-la como int?

Além disso, mais algumas considerações devem ser feitas:

• Este tipo de variável não pode ser inicializada com o valor null (ou Nothing no VB);
• Elas necessitam, obrigatoriamente, serem inicializadas e declaradas na mesma instrução;
• Só podem ser usadas como variáveis locais, dentro de métodos, e não como variáveis de uma classe, nem como variáveis públicas;
• Elas são largamente utilizadas para declarar tipos anôminos como parte de expressões do LINQ. Na verdade, esta é a principal função deste tipo de variável.

Leia também

• Novidades do C# 3.0: Extension Methods (0)
• Novidades do C# 3.0: Automatic Properties (0)
• Novidades do C# 3.0: Object Initializers (1)
• Implementando controle de transações com TransactionScope (2)
• Buscando o preview de um arquivo EPS em C# com ASP.NET (0)

Artigo publicado no site FD Web

Novidades do C# 3.0: Implicitly Typed Local Variables

Introdução

O controle de transação serve para garantir a integridade dos dados. Isso significa que através dele podemos ter a certeza de que todos os dados serão gravados no banco de dados. Em caso de eventual falha em algum momento da gravação todo o processo volta ao estado inicial, sem inserções parciais. Ao encontrar um erro durante o processo (leia-se um ou mais inserts em seqüencia) simplesmente é dado um rollback e nada é gravado no banco. Ao completar o processo com sucesso, a transação dá um commit e grava os dados no banco.

Exemplificando

Peguemos um sistema de vendas como exemplo. Para efetuar um pedido, devemos gravar as informações do cliente na tabela cliente, os itens do pedido na tabela itens, atualizar o estoque na tabela produtos e por fim gravar os dados da venda na tabela vendas. Agora imaginemos que no meio deste processo é gerado algum erro. Digamos que já tenhamos inserido os dados na tabela de clientes, os itens do pedido e atualizado o estoque. Falta apenas gravar os dados da venda. E neste momento ocorre algum erro. O que fazer com os dados que já foram gravados? Como fica o estoque que já foi atualizado? Em um sistema que não possui nenhum tipo de controle, isso seria o caos: o estoque fica comprometido, o banco de dados ganha inconsistências e nunca o sistema será confiável.

Pondo a teoria em prática

Então vamos implementar o nosso controle de transações utilizando o TransactionScope, fornecido pela biblioteca System.Transactions.dll. Em primeiro lugar devemos adicionar a referencia da biblioteca em nosso projeto. Com isso, basta ir no menu Project e depois em Add Reference.

Depois selecionamos o assembly System.Transactions.

Depois disso é só pôr a mão na massa. Primeiramente adicionamos a referência à nossa classe.

Em C#

using System.Transactions;

Em VB

Imports System.Transactions

Feito isso, agora implementar o controle de transações:

Em C#

TransactionOptions options = new TransactionOptions();
options.IsolationLevel = System.Transactions.IsolationLevel.ReadCommitted;

using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required, options))
{
//Insira os comandos de insert aqui

scope.Complete();

}

Em VB.NET

Using scope As New TransactionScope(TransactionScopeOption.Required, IsolationLevel.ReadCommitted)
‘* Insira os comandos de insert aqui
scope.Complete()
End Using

Parâmetros Necessários

Para criar uma nova instância de um TransactionScope, devemos passar alguns parâmetros.

TransactionScopeOption

Em TransactionScopeOption temos as seguintes opções:

Required - Re-utiliza uma transação ativa ou cria uma nova caso não haja nenhuma ativa.

RequiresNew – Cria sempre uma nova transação sem re-aproveitar outra transação.

Suppress – Simplesmente não utiliza nenhuma transação.

IsolationLevel

Serializable – Os dados, durante a transação, podem ser lidos mas nenhum dado pode ser adicionado ou modificado.

RepetableRead – Os dados podem ser lidos e adicionados mas não podem ser modificados.

ReadCommited – Dados não podem ser lidos, mas podem ser modificados.

ReadUncommited – Dados podem ser lidos e modificados durante a transação.

Snapshot – Os dados podem ser lidos e modificados, porém, antes de modificar alguma informação, a transação verifica se o conjunto de dados permanecem os mesmos. Se tiverem sido alterados, uma exceção é gerada.

Chaos – As alterações pendentes de transações em níveis superiores não podem ser sobrepostas.

Unspecified – Um IsolationLevel diferente do atual está sendo usado, mas não é possível determinar o seu tipo. Neste caso é gerada uma exceção.

Finalizando

Implementar um controle de transações é algo muito simples e poupa muita dor de cabeça. O ideal seria que todos os sistemas, por mais simples que sejam, utilizassem um controle como este. Desta forma seria possível entregar sistemas mais seguros e confiáveis, melhorando a qualidade do produto e a imagem do desenvolvedor junto aos clientes.

Leia também

• Novidades do C# 3.0: Extension Methods (0)
• Novidades do C# 3.0: Automatic Properties (0)
• Novidades do C# 3.0: Object Initializers (1)
• Novidades do C# 3.0: Implicitly Typed Local Variables (1)
• Buscando o preview de um arquivo EPS em C# com ASP.NET (0)

Artigo publicado no site FD Web

Implementando controle de transações com TransactionScope

Neste artigo vou mostrar como buscar este TIFF para podermos trabalhar com ele.

Exemplo

Este exemplo consiste em efetuar o upload de um arquivo EPS, e mostrar o preview do arquivo EPS na página.

1 – Crie o arquivo Default.aspx que vai conter a interface do exemplo;

2 – Insira no arquivo um component FileUpload e o renomeie para FileUploadEps;

3 – E insira um componente Button e o renomeie para ButtonUploadEps;

Arquivo Default.aspx

<%@ Page Language=”C#” AutoEventWireup=”true” CodeFile=”Default.aspx.cs” Inherits=”_Default” %>

<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>

<html xmlns=”http://www.w3.org/1999/xhtml” >
<head runat=”server”>
<title>Preview de Arquivos EPS</title>
</head>
<body>
<form id=”form1″ runat=”server”>
<div>
<asp:FileUpload ID=”FileUploadEps” runat=”server” Style=”position: relative” />
<asp:Button ID=”ButtonUploadEps” runat=”server” OnClick=”ButtonUploadEps_Click” Style=”position:relative” Text=”Upload EPS” />
</div>
</form>
</body>
</html>

4 – Crie o arquivo Default.aspx.cs que vai conter o código em C#;

5 – Use os seguintes namespace:

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

using System.Web.UI.HtmlControls;

using System.IO;
using System.Drawing;
using System.Drawing.Imaging;

6 – Crie o evento de click do botão “ButtonUploadEps” e insira nele o seguinte código:

FileStream fileStreamEps = null;
string strCaminhoEpsUpload = “”;

//* Verifica se o usuário selecionou algum arquivo
if (FileUploadEps.PostedFile.FileName != “”)
{

//* Monta o caminho da onde o arquivo vai ser salvo
strCaminhoEpsUpload = MapPath(”.”) + “\\” + Path.GetFileName(FileUploadEps.PostedFile.FileName);

//* Executa o upload do arquivo
FileUploadEps.PostedFile.SaveAs(strCaminhoEpsUpload);

//* Abre o arquivo e lê o header
fileStreamEps = File.Open(strCaminhoEpsUpload, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);

byte[] buf = new byte[32];

//* Passa para o buffer o header do arquivo
fileStreamEps.Read(buf, 0, 32);

//* Converte para uint
uint idArquivo = obtemU(buf, 0);

//* Verifica se o arquivo de entrada é um EPS
if (idArquivo != 0xc6d3d0c5)
{

return;

}

//* obtem o uint
uint TIFOff = obtemU(buf, 20);

//* Verifica se foi encontrado no EPS a identificação de preview
if (TIFOff == 0)
{

return;

}

//* Não posicionou no TifOffset
if (fileStreamEps.Seek(TIFOff, SeekOrigin.Begin) != TIFOff)
{
return;
}

//* obtem o uint
uint TIFSize = obtemU(buf, 24);

//* Redimensiona o buffer
byte[] msBuf = new Byte[TIFSize];

//* Passa o arquivo para a memória
MemoryStream memoryStreamEps = new MemoryStream(msBuf);
fileStreamEps.Read(msBuf, 0, (int)TIFSize);

//* Cria um novo bitmap apartir do conteudo da memoria
Bitmap bitMapEps = new Bitmap(memoryStreamEps);

//* Mostra a imagem na tela
bitMapEps.Save(Response.OutputStream, ImageFormat.Jpeg);
bitMapEps.Dispose();
}

7 – Crie uma função para obter o uint:

private static uint obtemU(byte[] buf, int pos)
{
return (uint)(buf[pos] + 0×100 * buf[pos + 1] + 0×10000 * buf[pos + 2] + 0×1000000 * buf[pos + 3]);
}

Vale lembrar que não são todos os EPS que contem um arquivo de preview. Na hora de salvar a imagem em EPS o usuário tem a escolha, se deseja salvar o preview, e em qual qualidade será gerado o preview.

Download do Exemplo

Clique aqui para efetuar o download do projeto de exemplo. O projeto foi criado no Visual Studio 2005.

Leia também

• Novidades do C# 3.0: Extension Methods (0)
• Novidades do C# 3.0: Automatic Properties (0)
• Novidades do C# 3.0: Object Initializers (1)
• Novidades do C# 3.0: Implicitly Typed Local Variables (1)
• Implementando controle de transações com TransactionScope (2)

Artigo publicado no site FD Web

Buscando o preview de um arquivo EPS em C# com ASP.NET

Os arquivos PDF se transformaram ao longo do tempo em um padrão para troca de documentos. Desde relatórios até contratos, este formato tem sido usado em larga escala devido a sua portabilidade – é possível abrir arquivos deste tipo em qualquer sistema operacional – além de, geralmente, ser um arquivo pequeno. Isso sem falar que um arquivo PDF não pode ser modificado, garantindo, desta forma, que o arquivo irá sempre manter o mesmo conteúdo. Eu arriscaria dizer, ainda, que passa uma aparência mais profissional enviar um arquivo em formato PDF, ao invés de outros formatos, como DOC, por exemplo.

Neste artigo iremos conhecer os fundamentos da criação de um arquivo PDF utilizando a linguagem PHP. Para tal, será usada a biblioteca FPDF, responsável pela criação do arquivo. O download pode ser feito aqui.

Conhecendo as principais funções

Abaixo estão relacionadas as principais funções que serão utilizadas para a criação do arquivo, com a respectiva descrição.

SetFont - Define a fonte que será usada para imprimir o texto. É obrigatório setar ao menos uma vez a fonte que será utilizada no documento.

SetTitle - Define o título do documento.

SetSubject - Define o assunto do documento.

SetX - Define a abscissa da posição corrente. A grosso modo podemos dizer que informa a posição a partir da margem esquerda do documento.

SetY - Explicando de uma forma simples, indica a linha (posição vertical).

Cell - Imprime uma célula (área retangular) com bordas opcionais, cor de fundo e texto. O canto superior-esquerdo da célula corresponde à posição atual. O texto pode ser alinhado ou centralizado. Depois de chamada, a posição atual se move para a direita ou para a linha seguinte. É possível pôr um link no texto. Se a quebra de página automática está habilitada e a pilha for além do limite, uma quebra de página é feita antes da impressão.

Ln - Faz uma quebra de linha. A abscissa corrente volta para a margem esquerda e a ordenada é somada ao valor passado como parâmetro.

MultiCell - Este método permite imprimir um texto com quebras de linha. Podem ser automática (assim que o texto alcança a margem direita da célula) ou explícita (através do caracter n). Serão geradas tantas células quantas forem necessárias, uma abaixo da outra.

Image - Permite inserir uma imagem no documento. Os tipos permitidos são JPG e PNG.

AddPage - Acrescenta uma página ao documento.

PageNo - Informa a página atual.

AliasNbPages - Define um apelido para a impressão do número total de páginas.

Header e Footer - Estes métodos inserem automaticamente o cabeçalho e rodapé das páginas do documento. Porém, para utilizá-las, é necessário criar uma subclasse para sobrepor os métodos originais.

Output – Envia o documento para o destino informado. Pode-se abrir o arquivo no navegador, fazer o download ou mesmo salvar o arquivo no disco.

OBSERVAÇÃO:

Sempre que for necessário setar a posição X e Y, sete primeiro o Y e depois o X.

Criando nosso primeiro documento

Agora vamos ver como criar um arquivo simples, contendo algum texto e uma imagem.

<?

require_once(”fpdf/fpdf.php”);

$texto = “Os arquivos PDF se transformaram ao longo do tempo em um padrão para troca de documentos. Desde relatórios até contratos, este formato
tem sido usado em larga escala devido a sua portabilidade – é possível abrir arquivos deste tipo em qualquer sistema operacional – além de, geralmente, ser um arquivo pequeno.
Isso sem falar que um arquivo PDF não pode ser modificado, garantindo, desta forma, que o arquivo irá sempre manter o mesmo conteúdo. Eu arriscaria dizer, ainda, que passa uma
aparência mais profissional enviar um arquivo em formato PDF, ao invés de outros formatos, como DOC, por exemplo.”;

//defininfo a fonte !
define(’FPDF_FONTPATH’,'fpdf/font/’);

//instancia a classe
//uso: FPDF(orientacao – retrato ou paisagem), unidade de medida, tamanho do papel)
$pdf = new FPDF(”P”,”mm”,”A4″);

//define a fonte a ser usada
//uso: SetFont(nome da fonte, estilo (branco = normal, b = negrito, i = italico, u = sublinhado), tamanho da fonte)
$pdf->SetFont(’arial’,”,10);

//define o titulo
$pdf->SetTitle(”Criando nosso primeiro arquivo PDF !”);

// seta a posicao vertical e horizontal
$pdf->SetY(”-1″);

//assunto
$pdf->SetSubject(”Criação de arquivos PDF com PHP!”);

//escreve o texto
//uso: Cell(largura, altura, conteudo, borda, quebra de linha, alinhamento (L = esquerdo, R = direito, C = centralizado)
$pdf->Cell(0,5,”Criando arquivos PDF com PHP”,0,0,’L');
$pdf->Cell(0,5,’http://fdweb.com.br’,0,1,’R');
$pdf->Cell(0,0,”,1,1,’L');
$pdf->Ln(8);

//Seta a fonte do texto do documento
$pdf->SetFont(’arial’,”,8);

// insere a imagem
//uso: Image(caminho, posicao X,posicao Y,altura, largura)
//$pdf->Image(”http://fdweb.com.br/downloads/logo.jpg”, $pdf->GetX(), $pdf->GetY(), 20, 20);
$pdf->Image(”logo.jpg”,10,30);

//posiciona horizontalmente
$pdf->SetY(”30″);
$pdf->SetX(”50″);

//Insere o texto do documento
//uso: MultiCell(largura, altura, conteudo, borda, quebra de linha, alinhamento (L = esquerdo, R = direito, C = centralizado, J = justificado)
$pdf->MultiCell(0,5,$texto,0,”L”,0);

$pdf->Output(”arquivo pdf”,”I”);

?>

Este exemplo mostra como criar um arquivo simples, com texto e uma imagem.

Implementando cabeçalho e rodapé

Para que todas as páginas possuam cabeçalho e rodapé padrão, temos que estender a classe FPDF e sobrepor os métodos Header e Footer. Note que a partir desse momento, ao invés de chamarmos a classe FPDF para gerarmos os documentos iremos passar a chamar a nossa classe estendida. Observe:

<?

require_once(”fpdf/fpdf.php”);

class PDF extends FPDF
{

// sobrepõe o método header
function Header()
{
//escreve o texto
//uso: Cell(largura, altura, conteudo, borda, quebra de linha, alinhamento (L = esquerdo, R = direito, C = centralizado)
//$this->SetY(-1);
$this->SetFont(’arial’,”,8);
$this->Cell(0,5,”Criando arquivos PDF com PHP”,0,0,’L');
$this->Cell(0,5,’http://fdweb.com.br’,0,1,’R');
$this->Cell(0,0,”,1,1,’L');
$this->Ln(8);

}
// sobrepõe o método footer
function Footer()
{
//Vai para 1.5 cm da parte inferior

$this->SetY(-15);

//Seleciona a fonte Arial itálico 8

$this->SetFont(’Arial’,'I’,8);

//Imprime o número da página corrente e o total de páginas

$this->Cell(0,10,’Página ‘.$this->PageNo().’ de {total}’,0,0,’C');
}
}

$texto = “Os arquivos PDF se transformaram ao longo do tempo em um padrão para troca de documentos. Desde relatórios até contratos, este formato
tem sido usado em larga escala devido a sua portabilidade – é possível abrir arquivos deste tipo em qualquer sistema operacional – além de, geralmente, ser um arquivo pequeno.
Isso sem falar que um arquivo PDF não pode ser modificado, garantindo, desta forma, que o arquivo irá sempre manter o mesmo conteúdo. Eu arriscaria dizer, ainda, que passa uma
aparência mais profissional enviar um arquivo em formato PDF, ao invés de outros formatos, como DOC, por exemplo.”;

//defininfo a fonte !
define(’FPDF_FONTPATH’,'fpdf/font/’);

//instancia a classe
//uso: PDF(orientacao – retrato ou paisagem), unidade de medida, tamanho do papel)
$pdf = new PDF(”P”,”mm”,”A4″);

$pdf->AliasNbPages( ‘{total}’ );

$pdf->AddPage();

//define a fonte a ser usada
//uso: SetFont(nome da fonte, estilo (branco = normal, b = negrito, i = italico, u = sublinhado), tamanho da fonte)
$pdf->SetFont(’arial’,”,10);

//define o titulo
$pdf->SetTitle(”Criando nosso primeiro arquivo PDF !”);

//assunto
$pdf->SetSubject(”Criação de arquivos PDF com PHP!”);

//Seta a fonte do texto do documento
$pdf->SetFont(’arial’,”,8);

// insere a imagem
//uso: Image(caminho, posicao X,posicao Y,altura, largura)
//$pdf->Image(”http://fdweb.com.br/downloads/logo.jpg”,$pdf->GetX(),$pdf->GetY(),20,20);
$pdf->Image(”logo.jpg”,10,30);

//posiciona horizontalmente
$pdf->SetY(”30″);
$pdf->SetX(”50″);

//Insere o texto do documento
//uso: MultiCell(largura, altura, conteudo, borda, quebra de linha, alinhamento (L = esquerdo, R = direito, C = centralizado, J = justificado)
$pdf->MultiCell(0,5,$texto,0,”L”,0);

$pdf->Output();

?>

Podemos notar que o código sofreu três alterações:

Declaramos $pdf = new PDF() ao invés de $pdf = new FPDF().

Acrescentamos as linhas : $pdf->AliasNbPages( ‘{total}’ ); e $pdf->AddPage();

O código que montava o cabeçalho foi para dentro da função Header, saindo do corpo do documento.

Considerações Finais

Antes de finalizar é bom ressaltar alguns itens:

- Não esquecer de informar a fonte antes de imprimir qualquer texto. Caso contrário a página ou o texto anterior ao primeiro SetFont não aparecerá no documento;

- Setar sempre a posição Y primeiro. Primeiro Y depois X, e não o contrário.

- Se for necessário colocar algum texto no final de cada página, como por exemplo a soma total de um campo, basta usar a função GetY é para determinar a posição da impressão dentro do documento. Isso pode ser verificado dentro de um loop for ou while. Por exemplo, o código abaixo imprime o número de linha de 1 a 150. Ao chegar no final da página (ou seja, a 27cm) ele escreve a palavra total e continua a impressão da linha seguinte na próxima página:

for($i=1;$i<=150;$i++)
{

if ($pdf->GetY() >= 270)
{
$pdf->Cell(0,5,”total: “,0,0);
$pdf->AddPage();
$pdf->Cell(0,5,”Line $i – ” . $pdf->GetY() ,0,1);
}
else
{
$pdf->Cell(0,5,”Line $i – ” . $pdf->GetY() ,0,1);
}

}

Concluindo

Vimos que criar arquivos PDF pode ser uma tarefa bem simples. Claro que documentos ou relatórios mais bem elaborados e/ou complexos podem dar um pouco mais de trabalho, mas o resultado final fica com aspecto mais profissional e elegante.

Leia também

• Curso gratuito de PHP em Português (0)
• Trabalhando com Ajax no PHP (4)
• Criando arquivos ZIP no PHP com a ZIPlib (19)
• Acessando banco de dados usando PHP e ADODB (6)

Artigo publicado no site FD Web

Gerando arquivos PDF com PHP