script/html.rb text/01_ActiveRecord/0.markdown text/02_ActiveSupport/0.markdown text/03_ActiveResource/0.markdown text/04_ActionPack/0_title.markdown text/04_ActionPack/1_timezone.markdown text/04_ActionPack/2_auto_link.markdown text/04_ActionPack/3_labels.markdown text/04_ActionPack/4_partials.markdown text/04_ActionPack/5_atom_feed.markdown text/04_ActionPack/6_cache.markdown text/05_Railties/0.markdown text/06_Rake Tasks/0.markdown text/07_Ruby 1.9/0.markdown text/07_Ruby 1.9/1.markdown text/07_Ruby 1.9/2.markdown text/08_Prototype e script.aculo.us/0.markdown text/08_Prototype e script.aculo.us/1.markdown text/09_Debug/0.markdown text/09_Debug/1.markdown @@ -1,4 +1,4 @@ require 'script/merge' -require 'script/textilize' +require 'script/html' require 'script/pdf' require 'script/prince' \ No newline at end of file Rakefile @@ -27,3 +27,9 @@ Sun Jun 1 01:43:09 2008: -:289: error: Opening and ending tag mismatch: p and s Sun Jun 1 01:43:09 2008: -:334: error: Unexpected end tag : strong Sun Jun 1 01:43:09 2008: finished: success Sun Jun 1 01:43:09 2008: ---- end +Sun Jun 1 02:15:51 2008: ---- begin +Sun Jun 1 02:15:52 2008: -:8: error: Tag front invalid +Sun Jun 1 02:15:52 2008: -:9: error: Tag contents invalid +Sun Jun 1 02:15:52 2008: -:10: error: htmlParseStartTag: misplaced <body> tag +Sun Jun 1 02:15:53 2008: finished: success +Sun Jun 1 02:15:53 2008: ---- end log/prince.log output/book.pdf @@ -19,25 +19,32 @@ <h2> TimeZone</h2> -### Definindo um fuso-horário padrão +<h3> Definindo um fuso-horário padrão</h3> -Uma nova opção foi acrescentada ao método timezoneselect, agora você pode indicar um valor padrão para os casos em que o seu usuário ainda não tenha selecionado nenhum TimeZone, ou quando a coluna no banco de dados for nula. Para isto foi criada a opção :default, então você poderá usar o método das seguintes maneiras: +Uma nova opção foi acrescentada ao método time_zone_select, agora você pode indicar um valor padrão para os casos em que o seu usuário ainda não tenha selecionado nenhum TimeZone, ou quando a coluna no banco de dados for nula. Para isto foi criada a opção :default, então você poderá usar o método das seguintes maneiras: -ruby. ActionPack/timezone.rb#default +<pre><code>time_zone_select("user", "time_zone", nil, :include_blank => true) +time_zone_select("user", "time_zone", nil, :default => "Pacific Time (US & Canada)" ) +time_zone_select( "user", 'time_zone', TimeZone.us_zones, :default => "Pacific Time (US & Canada)") +</code></pre> -Nos casos onde usamos a opção :default deve aparecer com o TimeZone informado já selecionado. +Nos casos onde usamos a opção :default deve aparecer com o TimeZone informado já selecionado. <h2> Auto Link</h2> -Para quem não conhece, o método auto_link recebe um texto qualquer como parâmetro e se o texto tiver algum endereço de email ou de um site ele retorna o mesmo texto com hyperlinks. +Para quem não conhece, o método auto_link recebe um texto qualquer como parâmetro e se o texto tiver algum endereço de email ou de um site ele retorna o mesmo texto com hyperlinks. Por exemplo: -ruby. ActionPack/auto_link.rb#exemplo1 +<pre><code>auto_link("Acesse este endereço: http://www.rubyonrails.com") +# => Acesse este endereço: http://www.rubyonrails.com +</code></pre> Acontece que alguns sites como o Amazon estão usando também o sinal de "=" (igual) em suas URLs, e este método não reconhece este sinal. Veja como o método se comporta neste caso: -ruby. ActionPack/auto_link.rb#exemplo2 +<pre><code>auto_link("Acesse este endereço: http://www.amazon.com/Testing-Equal-Sign-In-Path/ref=pd_bbs_sr_1?ie=UTF8&s=books&qid=1198861734&sr=8-1") +# => Acesse este endereço: http://www.amazon.com/Testing-Equal-Sign-In-Path/ref=pd_bbs_sr_1?ie=UTF8&s=books&qid=1198861734&sr=8-1 +</code></pre> Note que o método terminou o hyperlink exatamente antes do sinal de "=", pois ele não suporta este sinal. Quer dizer, não suportava. Nesta nova versão do Rails já temos este problema resolvido. @@ -60,7 +67,7 @@ <% end %> </code></pre> -Desta forma faz muito mais sentido. O método label foi incluído. Este método retorna uma string com o título da coluna dentro de uma tag HTML <label>. +Desta forma faz muito mais sentido. O método label foi incluído. Este método retorna uma string com o título da coluna dentro de uma tag HTML <label>. <pre><code>>> f.label :title => <label for="post_title">Title</label> @@ -72,11 +79,11 @@ => <label for="post_title" class="title_label">A short title</label> </code></pre> -Percebeu o parâmetro for dentro da tag? O "posttitle" é o nome da caixa de texto que contém o título do nosso post. A tag <label> é na verdade um rótulo associado ao objeto *posttitle*. Quando se clica no rótulo (ele não é um link) o controle associado à ele recebe o foco. +Percebeu o parâmetro for dentro da tag? O "post_title" é o nome da caixa de texto que contém o título do nosso post. A tag <label> é na verdade um rótulo associado ao objeto post_title. Quando se clica no rótulo (ele não é um link) o controle associado à ele recebe o foco. Robby Russell escreveu um artigo interessante em seu blog sobre este assunto. Você pode lê-lo no endereço: <a href="http://www.robbyonrails.com/articles/2007/12/02/that-checkbox-needs-a-label">http://www.robbyonrails.com/articles/2007/12/02/that-checkbox-needs-a-label</a> -Também foi incluído o método label_tag no FormTagHelper. Este método funciona exatamente como o label mas de uma forma mais simplista: +Também foi incluído o método label_tag no FormTagHelper. Este método funciona exatamente como o label mas de uma forma mais simplista: <pre><code>>> label_tag 'nome' => <label for="nome">Nome</label> @@ -98,7 +105,7 @@ <% end %> </code></pre> -Partial é um fragmento de código (um template). A vantagem de se usar uma partial é evitar a repetição desnecessária de código. Para usar uma partial é muito simples, você pode começar com algo mais ou menos assim: render :partial => “name”. Depois deve criar um arquivo com o mesmo nome da partial, mas com um underscore na frente, só isso. +Partial é um fragmento de código (um template). A vantagem de se usar uma partial é evitar a repetição desnecessária de código. Para usar uma partial é muito simples, você pode começar com algo mais ou menos assim: render :partial => "name". Depois deve criar um arquivo com o mesmo nome da partial, mas com um underscore na frente, só isso. O código acima é a forma como estamos acostumados a fazer hoje, mas nesta nova versão do Rails, faremos a mesma coisa de uma forma um pouco diferente, assim: @@ -108,13 +115,13 @@ <% end %> </code></pre> -Neste exemplo nós vamos renderizar a partial “users/_form”, que receberá uma variável chamada form com as referências criadas pelo FormBuilder. +Neste exemplo nós vamos renderizar a partial "users/_form", que receberá uma variável chamada form com as referências criadas pelo FormBuilder. A forma antiga também vai continuar funcionando. <h2> Novos namespaces no Atom Feed</h2> -Conhece o método atom_feed? Ele é uma novidade no Rails 2.0, que facilitou muito a criação de feeds Atom. Veja um exemplo de uso: +Conhece o método atom_feed? Ele é uma novidade no Rails 2.0, que facilitou muito a criação de feeds Atom. Veja um exemplo de uso: Em um arquivo index.atom.builder: @@ -137,7 +144,7 @@ end O que é um atom feed? Atom é o nome de um estilo baseado em XML e meta data. Em outras palavras é um protocolo quer serve para publicar conteúdo na internet que é sempre atualizado, como um blog, por exemplo. Os feeds sempre são publicados em XML e no caso do Atom Feed ele é identificado como application/atom+xml media type. -Nas primeiras versões do Rails 2.0 este método aceitava como parâmetros as opções :language, :root_url e :url, você pode obter mais informações sobre estes métodos na documentação do Rails. Mas com a alteração realizada, agora podemos incluir novos namespaces ao elemento root do feed. Por exemplo, se fizermos assim: +Nas primeiras versões do Rails 2.0 este método aceitava como parâmetros as opções :language, :root_url e :url, você pode obter mais informações sobre estes métodos na documentação do Rails. Mas com a alteração realizada, agora podemos incluir novos namespaces ao elemento root do feed. Por exemplo, se fizermos assim: <pre><code>atom_feed('xmlns:app' => 'http://www.w3.org/2007/app') do |feed| </code></pre> @@ -172,13 +179,13 @@ end <h2> Cache</h2> -Todos os métodos fragmentcachekey agora retornam por padrão o namespace 'view/' como prefixo. +Todos os métodos fragment_cache_key agora retornam por padrão o namespace 'view/' como prefixo. -Todos os caching stores foram retirados de ActionController::Caching::Fragments::** e agora estão em ActiveSupport::Cache::*. Neste caso se você faz referência a um store, como ActionController::Caching::Fragments::MemoryStore, por exemplo, será necessário alterar sua referência para ActiveSupport::Cache::MemoryStore*. +Todos os caching stores foram retirados de ActionController::Caching::Fragments:: e agora estão em ActiveSupport::Cache::. Neste caso se você faz referência a um store, como ActionController::Caching::Fragments::MemoryStore, por exemplo, será necessário alterar sua referência para ActiveSupport::Cache::MemoryStore. -ActionController::Base.fragmentcachestore deixa de existir e dá lugar à ActionController::Base.cache_store. +ActionController::Base.fragment_cache_store deixa de existir e dá lugar à ActionController::Base.cache_store. -Foi incluído no ActiveRecord::Base o método cache_key para facilitar o armazenamento em cache de Active Records pelas novas bibliotecas *ActiveSupport::Cache::**. Este método funciona assim: +Foi incluído no ActiveRecord::Base o método cache_key para facilitar o armazenamento em cache de Active Records pelas novas bibliotecas ActiveSupport::Cache::*. Este método funciona assim: <pre><code>>> Product.new.cache_key => "products/new" @@ -190,9 +197,9 @@ end => "people/5-20071224150000" </code></pre> -Foi incluído o ActiveSupport::Gzip.decompress/compress para facilitar o wrapper para o Zlib. +Foi incluído o ActiveSupport::Gzip.decompress/compress para facilitar o wrapper para o Zlib. -Agora você pode usar entre as opções de environment o config.cache_store para informar o local padrão de armazenamento do cache. Vale lembrar que se o diretório tmp/cache existir o padrão é o FileStore, caso contrário o MemoryStore é usado. Você pode configurar das seguintes formas: +Agora você pode usar entre as opções de environment o config.cache_store para informar o local padrão de armazenamento do cache. Vale lembrar que se o diretório tmp/cache existir o padrão é o FileStore, caso contrário o MemoryStore é usado. Você pode configurar das seguintes formas: <pre><code>config.cache_store = :memory_store config.cache_store = :file_store, "/path/to/cache/directory" @@ -215,13 +222,13 @@ config.cache_store = MyOwnStore.new("parameter") <h2> Detalhes</h2> -O principal foco das alterações do Rails foi o Ruby 1.9, mesmo os menores detalhes foram analisados para deixar o Rails o mais compatível possível com a nova versão do Ruby. Detalhes como alterar de File.exists? para File.exist? não foram deixados de fora. +O principal foco das alterações do Rails foi o Ruby 1.9, mesmo os menores detalhes foram analisados para deixar o Rails o mais compatível possível com a nova versão do Ruby. Detalhes como alterar de File.exists? para File.exist? não foram deixados de fora. -Também, no Ruby 1.9, o módulo Base64 (base64.rb) foi removido, por isto todas as referencias a ele foram substituídas por ActiveSupport::Base64. +Também, no Ruby 1.9, o módulo Base64 (base64.rb) foi removido, por isto todas as referencias a ele foram substituídas por ActiveSupport::Base64. <h2> Novos métodos para a classe DateTime</h2> -Outra alteração interessante para a nova versão. Para manter a compatibilidade (duck-typing) com a classe Time, três métodos novos foram adicionados à classe DateTime. Os métodos são #utc, #utc? e #utc_offset. Vamos ver um exemplo de uso de cada um: +Outra alteração interessante para a nova versão. Para manter a compatibilidade (duck-typing) com a classe Time, três métodos novos foram adicionados à classe DateTime. Os métodos são #utc, #utc? e #utc_offset. Vamos ver um exemplo de uso de cada um: <pre><code>>> date = DateTime.civil(2005, 2, 21, 10, 11, 12, Rational(-6, 24)) #=> Mon, 21 Feb 2005 10:11:12 -0600 @@ -251,7 +258,7 @@ config.cache_store = MyOwnStore.new("parameter") Foi habilitada novamente a opção de usar o ruby-debug nos testes do Rails. -Se antes você desejasse usá-lo nos testes seria necessário incluir um require 'ruby-debug' na classe e logo em seguida usar o método debugger no local desejado. Agora só se preocupe com o método debugger, o resto é nativo, desde que você já tenha o gem instalado. +Se antes você desejasse usá-lo nos testes seria necessário incluir um require 'ruby-debug' na classe e logo em seguida usar o método debugger no local desejado. Agora só se preocupe com o método debugger, o resto é nativo, desde que você já tenha o gem instalado. <h1> Bugs e Correções</h1> @@ -259,7 +266,7 @@ config.cache_store = MyOwnStore.new("parameter") Havia um bug ao se usar o banco de dados PostgreSQL. O bug ocorria quando se criava uma migration para adicionar uma coluna em uma tabela já existente, veja um exemplo: -Arquivo: db/migrate/002addcost.rb +Arquivo: db/migrate/002_add_cost.rb <pre><code>class AddCost < ActiveRecord::Migration def self.up @@ -273,13 +280,13 @@ config.cache_store = MyOwnStore.new("parameter") end </code></pre> -Note que estou criando uma coluna com :precision => 6 e :scale => 2. Agora é hora de rodar o rake db:migrate e vamos ver como ficou nossa tabela no banco: +Note que estou criando uma coluna com :precision => 6 e :scale => 2. Agora é hora de rodar o rake db:migrate e vamos ver como ficou nossa tabela no banco: -<table border="0" cellspacing="5" cellpadding="5"> +<table border="1" cellspacing="0" cellpadding="5"> <tr> - <th>Column</th> - <th>Type</th> - <th>Modifiers</th> + <td>Column</td> + <td>Type</td> + <td>Modifiers</td> </tr> <tr> <td>id</td> @@ -304,7 +311,7 @@ end </table> -Veja a coluna "cost" que acabamos de criar. Ela é um numeric comum, mas deveria ser uma coluna como a "price", logo acima dela, mais precisamente um numeric(6,2). Nesta versão este erro não existe mais, a coluna será criada da forma correta neste banco de dados. +Veja a coluna "cost" que acabamos de criar. Ela é um numeric comum, mas deveria ser uma coluna como a "price", logo acima dela, mais precisamente um numeric(6,2). Nesta versão este erro não existe mais, a coluna será criada da forma correta neste banco de dados. <h1> Informações Adicionais</h1> @@ -319,7 +326,7 @@ end end </code></pre> -Note a chamada para o método protectfromforgery. +Note a chamada para o método protect_from_forgery. Já ouviu falar de Cross Site Scripting? Este é o nome de uma falha de segurança encontrada facilmente em grande parte dos websites e aplicações web que permite à pessoas maldosas (aqui estou me referindo à adolescentes sem nada para fazer e sem vida social) alterarem o conteúdo de páginas web, incluírem conteúdo hostil, executarem ataques de phishing, obterem o controle do navegador através de códigos JavaScript e na maioria dos casos forçarem o usuário a executar algum comando que eles desejem. Este último tipo de ataque se chama crosssite request forgeries. output/index.html @@ -1,5 +1,5 @@ desc 'Cria um arquivo pdf à partir do html gerado' -task :to_pdf => :textilize do +task :pdf => :html do prince = Prince.new() prince.add_style_sheets 'layout/coderay.css', 'layout/default.css' script/pdf.rb text/.DS_Store code/ActionPack/auto_link.rb code/ActionPack/label.html.erb code/ActionPack/timezone.rb script/textilize.rb text/01_ActiveRecord/0.textile text/02_ActiveSupport/0.textile text/03_ActiveResource/0.textile text/04_ActionPack/0_title.textile text/04_ActionPack/1_timezone.textile text/04_ActionPack/2_auto_link.textile text/04_ActionPack/3_labels.textile text/04_ActionPack/4_partials.textile text/04_ActionPack/5_atom_feed.textile text/04_ActionPack/6_cache.textile text/05_Railties/0.textile text/06_Rake Tasks/0.textile text/07_Ruby 1.9/0.textile text/07_Ruby 1.9/1.textile text/07_Ruby 1.9/2.textile text/08_Prototype e script.aculo.us/0.textile text/08_Prototype e script.aculo.us/1.textile text/09_Debug/0.textile text/09_Debug/1.textile c2c938c058b47373c3a27cdfde6aea2184e7d039 Carlos Brando eduardobrando@gmail.com http://github.com/escobera/rails21-book/commit/8b970bed436465188ed4dd3c14015763cac4b832 8b970bed436465188ed4dd3c14015763cac4b832

2008-05-31T22:17:13-07:00

Change to Markdown. 73f9d03434a811ac700225fed313a8eb7c4ef50d Carlos Brando eduardobrando@gmail.com