Gastonramos.com

20/04/12
gastonramos.com.ar/rails21/
Ruby on Rails 2.1
QU HAY DE NUEVO?
Primer Edicin
1/50
20/04/12
Ruby on Rails 2.1
QU HAY DE NUEVO?
Primer Edicin
Carlos Brando Marcos Tapajs
2/50
20/04/12
Copyright 2008 Carlos Brando. All Rights Reserved.
Primer Edicin: Junio 2008
Carlos Brando Website: www.nomedojogo.com Marcos Tapajs Website: www.improveit.com.br/en/company/tapajos
3/50
20/04/12
Chapter 1
Introduccin
Alrededor de julio de 2004 David Heinemeier Hansson lanz la versin pblica del framework Ruby on Rails, el cual surgi como consecuencia del desarrollo de una aplicacin llamada Basecamp. Despus de tres aos, el 7 de Diciembre de 2007 se public Ruby on Rails 2.0 con una cantidad importante de cambios. Seis meses despus, y durante todo este tiempo han contribuido ms de 1400 desarrolladores alrededor de todo el mundo con 1600 parches para el framework. Hoy, 1ero. Junio de 2008, se ha publicado la versin 2.1 del framework Ruby on Rails. Segn David las principales novedades de esta versin son: Timezones Dirty tracking Gem Dependencies Named scope UTC-based migrations Better caching Como siempre, para actualizar o instalar la nueva versin:
gmisalris e ntl al
AGRADECIMIENTOS
A Marcos Tapajs, co-autor de este libro. De no ser por l, no podras estar leyendo este libro. A Daniel Lopes quien hizo la hermosa tapa de esta edicin. A toda la comunidad Brazilera de Ruby on Rails que nos ayud directa o indirectamente con este libro, comentando los artculos del blog o aconsejndonos. Como me gusta decir siempre, lo mejor de Rails es su comunidad! se mantiene creando, inventando, y especialmente compartiendo.
TRADUCTORES
Este libro fue orgullosamente traducido al espaol por estos chicos Argentinos: Lucas Florio - http://blog.lucasefe.com.ar/ Captulos 8-12 Gastn Ramos - http://gastonramos.wordpress.com Introduccin y captulos 1-7, 13-14
4/50
20/04/12
Chapter 2
ActiveRecord
ActiveRecord es una capa de mapeo objeto-relacional (object-relational mapping layer) responsable tanto de la interoperabiliadad entre la aplicacin y la base de datos como de la abstraccin de los datos. (wikipedia)
EL MTODO SUM
Expresiones en el mtodo sum Ahora podemos usar expresiones en los mtodos de clculo de ActiveRecord, sum, por ejemplo:
P r o . u (2*ae) e s ns m" g"
Cambiando el valor de retorno por defecto del mtodo sum En las versiones previas, cuando usbamos el mtodo sum de ActiveRecord para calcular la suma de una determinada columna para todos los registros de una tabla, si ningn registro corresponda con las condiciones expresadas en el mtodo de invocacin, entonces el valor de retorno por defecto era nil. En Rails 2.1 el valor de retorno por defecto (cuando no se encuentra ningn registro) es 0. Vea el ejemplo:
A c u t s m : a a c ,: o d t o s = ' =2)#>0 c o n .u (b l n e c n i i n > 1 ' =
HAS_ONE
Soporte para la opcin through El mtodo has_one ahora tiene la opcin through. Esta funciona como has_many :through, pero en este caso representa la asociacin a un objeto simple ActiveRecord. Ejemplo:
c a s Mgzn <AtvRcr:Bs l s aaie cieeod:ae hsmn : u s r p i n a_ay s b c i t o s e d n c a s Sbcito <AtvRcr:Bs l s usrpin cieeod:ae blnst : a a i e eog_o m g z n blnst : s r eog_o u e e d n c a s Ue <AtvRcr:Bs l s sr cieeod:ae hsmn : u s r p i n a_ay s b c i t o s hsoe: a a i e : h o g = :sbcitos a_n m g z n , t r u h > usrpin, : o d t o s = [sbcitosatv =?,t u ] c n i i n > 'usrpin.cie ' r e e d n
Has_one con :source_type El mtodo has_one :through que acabamos de ver, puede tambin tomar :source_type como argumento. Voy a intentar explicar esto a travs de algunos ejemplos. Vamos comenzar con estas dos clases:
c a s Cin <AtvRcr:Bs l s let cieeod:ae hsmn : o t c _ a d a_ay c n a t c r s hsmn : o t c s : h o g = : o t c _ a d a_ay c n a t , t r u h > c n a t c r s e d n
Lo que estamos viendo hasta aqu es una clase Client la cual tiene muchos (has_many) tipos de contactos (contacts), ya que la clase ContactCard tiene una relacin polimrfica. Para seguir con nuestro ejemplo, vamos a crear dos clases que van a representar a ContactCard:
c a s Pro <AtvRcr:Bs l s esn cieeod:ae hsmn : o t c _ a d ,: s = : o t c a_ay c n a t c r s a > c n a t e d n c a s Bsns <AtvRcr:Bs l s uies cieeod:ae
5/50
20/04/12
hsmn : o t c _ a d ,: s = : o t c a_ay c n a t c r s a > c n a t e d n
Person y Business estn relacionadas con mi clase Client a travs de la tabla ContactCard. En otras palabras, tengo dos tipos de contactos, personal y de negocios. Por otro lado, cuando intente recuperar un contacto esto no va a funcionar, veamos:
> C i n . i d : i s )c n a t > l e tf n (f r t.o t c s #AgmnErr /./ciespotcr_x/ahky.b4: ruetro: ..atv_upr/oeeths/esr:8 #i `setvldky' Ukonkys:plmrhc n asr_ai_es: nnw e() oyopi
Para que esto funcione tenemos que usar :source_type. Vamos cambiar nuestra clase Client:
c a s Cin <AtvRcr:Bs l s let cieeod:ae hsmn : e p e c n a t , a_ay p o l _ o t c s : h o g = : o t c _ a d , t r u h > c n a t c r s : o r e= : o t c s s u c > c n a t , : o r e t p = : e s n s u c _ y e > p r o hsmn : u i e s c n a t , a_ay b s n s _ o t c s : h o g = : o t c _ a d , t r u h > c n a t c r s : o r e= : o t c s s u c > c n a t , : o r e t p = : u i e s s u c _ y e > b s n s e d n
Note que ahora tenemos dos maneras diferentes de recuperar nuestros contactos y podemos indicar que tipo de contacto :source_type esperamos.
C i n . i d : i s )p o l _ o t c s l e tf n (f r t.e p e c n a t C i n . i d : i s )b s n s _ o t c s l e tf n (f r t.u i e s c n a t
NAMED_SCOPE
La gema has_finder ha sido incluida en Rails pero con un nombre diferente: named_scope. Para entender lo que significa este agregado en Rails vamos a ver los siguientes ejemplos:
c a s Atce<AtvRcr:Bs l s ril cieeod:ae nmdsoe: u l s e ,: o d t o s = { p b i h d = t u } ae_cp p b i h d c n i i n > : u l s e > r e nmdsoe: o t i i g t e l t e _ ,: o d t o s = "oyLK 'a ae_cp c n a n n _ h _ e t r a c n i i n > bd IE %%" e d n A t c ep b i h dp g n t (p g = 1 r i l .u l s e .a i a e: a e > ) A t c ep b i h dc n a n n _ h _ e t r ac u t r i l .u l s e .o t i i g t e l t e _ .o n A t c ec n a n n _ h _ e t r af n (f r t r i l .o t i i g t e l t e _ .i d: i s ) A t c e c n a n n _ h _ e t r a f n ( a l : o d t o s = {} r i l .o t i i g t e l t e _ .i d: l , c n i i n > )
En vez de crear un mtodo nuevo llamado published para retornar todos los posts publicados, estoy usando un named_scope para que lo haga por m. Pero puedo ir ms all que esto. Vamos a ver otro ejemplo para ver como se puede usar esto:
nmdsoe: r t e _ e o e lmd {|ie ae_cp w i t n b f r , aba tm| {: o d t o s = [witno <?,tm]} c n i i n > 'rte_n ' ie } nmdsoe: n n m u _ x e s o d ae_cp a o y o s e t n i n o d fo e e n 1 e d n e d n nmdsoe: a e _ x e s o ,: x e d = Nmdxeso ae_cp n m d e t n i n e t n > aeEtnin nmdsoe: u t p e e t n i n , ae_cp m l i l _ x e s o s : x e d = [utpexesoTo MlilEtninn] e t n > MlilEtninw, utpexesoOe
TESTEANDO NAMED_SCOPE CON PROXY_OPTIONS

Named scopes es una nueva e interesante caraterstica de Rails 2.1, pero despus de usarlo durante un tiempo quizs sea dficil testear estas estructuras ms complejas. Veamos un ejemplo:
c a s Sit<AtvRcr:Bs l s hr cieeod:ae nmdsoe: o o e ,lmd {|oo| ae_cp c l r d aba clr {: o d t o s = {: o o = clr}} c n i i n > c l r > oo } e d n
Cmo creamos un test que valide la generacin de este scope ? Para solucionar esto, se cre el mtodo proxy_options. El cual nos permite examinar las opciones usadas en named_scope. Para testear el cdigo de arriba podramos escribir esto:
c a s Sitet<Ts:Ui l s hrTs et:nt
6/50
20/04/12
d ft s _ o o e _ c p e e t c l r d s o e rdsoe= {: o d t o s = {: o o e = 'e'}} e_cp c n i i n > c l r d > rd bu_cp = {: o d t o s = {: o o e = 'le }} lesoe c n i i n > c l r d > bu' asr_qa rdsoe S i t c l r d 'e'. c p _ p i n seteul e_cp, h r . o o e (rd)s o e o t o s asr_qa bu_cp,S i t c l r d 'le)s o e o t o s seteul lesoe h r . o o e (bu'. c p _ p i n e d n e d n
INCREMENTO Y DECREMENTO
Los mtodos de ActiveRecord increment, increment!, decrement y decrement! ahora toman un nuevo parmetro opcional. En las versiones previas de Rails se podan usar estos mtodos para restar 1 a una columna dada. En rails 2.1 podemos decir que valor restar o sumar. As:
pae1i c e e t ( p i t ,5 lyr. n r m n ! : o n s ) pae2d c e e t ( p i t ,2 lyr. e r m n ! : o n s )
En el ejemplo estoy sumando 5 puntos al jugador 1 y restando 2 puntos al jugador 2. Cmo este es un parmetro opcional, el cdigo viejo no se ve afectado.
FIND
Conditions A partir de ahora, se va a poder pasar un objeto como parmetro al mtodo find de ActiveRecord, Vea este caso como ejemplo:
c a s Acut<AtvRcr:Bs l s con cieeod:ae cmoe_f: a a c ,: l s _ a e = "oe" : a p n = %(aac aon) opsdo b l n e c a s n m > Mny, m p i g > wblne mut e d n
En este caso, ud. puede pasar una instancia de Money cmo parmetro al mtodo find de la clase Account, de la siguiente manera:
aon = 50 mut 0 crec = "S" urny UD A c u t f n ( a l : o d t o s = {: a a c = M n y n w aon,crec)} c o n .i d: l , c n i i n > b l n e > o e . e (mut urny )
Last Hasta ahora slo podamos usar tres operadores para buscar datos usando el mtodo find de ActiveRecord: :first, :all o el propio id del objeto (en este caso no pasamos ningn operador especfico ms que el id en s mismo) En Rails 2.1 hay un cuarto operador llamado :last. Vea algunos ejemplos:
P r o .i d: a t e s nf n (l s ) P r o . i d : a t : o d t o s = ["srnm =?,ue_ae) e s nf n (l s , c n i i n > ue_ae " srnm] P r o . i d : a t : r e = "rae_nDS" : f s t = 5 e s n f n ( l s , o d r > cetdo EC, o f e > )
Para entender como funciona este nuevo operador, veamos el siguiente test:
d ft s _ i d l s e e t f n _ a t ls at = D v l p r f n : a t e e o e .i d l s asr_qa ls,D v l p r f n ( f r t : r e = 'dds' seteul at e e o e .i d: i s , o d r > i ec) e d n
All El mtodo esttico all es un alias al mtodo esttico find(:all). Por ejemplo:
T p c a l e l msoqeT p c f n ( a l o i .l s o im u o i .i d: l )
First El mtodo esttico first es un alias al mtodo esttico find(:first). Por ejemplo:
T p c f r t e l msoqeT p c f n ( f r t o i .i s s o im u o i .i d: i s )
Last El mtodo esttico last es un alias al mtodo esttico find(:last). Por ejemplo:
T p c l s e l msoqeT p c f n ( l s ) o i . a t s o im u o i .i d: a t
USANDO FIRST Y LAST CON NAMED_SCOPE

Todo los mtodos mencionados anteriormente funcionan con named_scope. Supongamos que creamos un named_scope llamado recent. Entonces podramos hacer esto:
7/50
20/04/12
ps. o m n s r c n . a t otc m e t . e e t l s
EAGER LOADING
Para explicar esta nueva funcionalidad, veamos el siguiente cdigo:
A t o . i d : l ,: n l d = [ p s s : o m n s ) u h rf n (a l i c u e > : o t , c m e t ]
Estoy haciendo una bsqueda en la tabla authors y tambin incluyendo las tablas posts y comments en mi consulta a travs de la columna author_id, el cual es el nombre de columna por defecto de acuerdo a la convecin que rails utiliza para las claves forneas. Esta bsqueda genera una consulta como la siguiente:
SLC EET atos"d uhr.i" A t_0 S 0r, atos"rae_t uhr.cetda" A t_1 S 0r, atos"pae_t uhr.udtda" A t_2 S 0r, pss"d ot.i" A t_0 S 1r, pss"uhri" ot.ato_d A t_1 S 1r, pss"rae_t ot.cetda" A t_2 S 1r, pss"pae_t ot.udtda" A t_3 S 1r, cmet.i" omns"d A t_0 S 2r, cmet.ato_d omns"uhri" A t_1 S 2r, cmet.cetda"A t_2 omns"rae_t S 2r, cmet.udtda"A t_3 omns"pae_t S 2r FO RM atos uhr LF OTRJI pssO pssa t o _ d = atosi ET UE ON ot N ot. u h r i uhr. d LF OTRJI cmet O cmet. u h r i = atosi ET UE ON omns N omnsa t o _ d uhr. d
Una nica consulta SQL con joins entre las tablas authors, posts y comments. A esto lo llamamos producto cartesiano. Este tipo de consultas no siempre tiene una buena performance, entonces esto se cambi en Rails 2.1. La misma consulta para la clase Author ahora se hace de una forma diferente para traer la informacin de las tres tablas. En vez de usar una nica consulta SQL con las tres tablas, Rails ahora usa tres consultas diferentes - una por cada tabla - las cuales son ms cortas que la anterior. El resultado se puede ver en los logs despues de ejecutar el codigo ruby on rails previo:
SLC * FO "uhr" EET RM atos SLC pss* FO "ot"WEE(ot. u h r i I () EET ot. RM pss HR pssa t o _ d N 1) SLC cmet. FO "omns WEE(omnsa t o _ d I () EET omns* RM cmet" HR cmet. u h r i N 1)
En la mayora de los casos estas tres simples consultas se ejecutan ms rpido que la consulta larga y compleja.
BELONGS_TO
El mtodo belongs_to se cambi en pro de permitir el uso de :dependent => :destroy y :delete en las asociaciones. Por ejemplo:
blnst : u h r a d e s eog_o a t o _ d r s blnst : u h r a d e s : e e d n = : e t o eog_o a t o _ d r s , d p n e t > d s r y blnst : u h r a d e s e t a : e e d n = : e e e eog_o a t o _ d r s _ x r , d p n e t > d l t , : l s _ a e = "uhrdrs" c a s n m > AtoAdes
POLYMORPHIC URL
Los mtodos helper para las URL polimrficas son usados para resolver de una forma ms elegante una ruta nombrada cuando cuando tenemos un modelo de ActiveRecord. Estos mtodos son tiles cuando queremos generar la URL para un recurso RESTful sin especificar el tipo de registro en cuestin. Es muy fcil de usar. Veamos algunos ejemplos (los comentarios explican las llamdas equivalentes para las versiones anteriores a Rails 2.1)
rcr = A t c e f n ( f r t eod r i l .i d: i s ) p l m r h c u l rcr)#>atceulrcr) o y o p i _ r (eod ril_r(eod rcr = C m e t f n ( f r t eod o m n .i d: i s ) p l m r h c u l rcr) #> cmetulrcr) o y o p i _ r (eod omn_r(eod #i cnas ietf rcnl cetdeeet t a lo dniy eety rae lmns rcr = C m e t n w eod o m n .e p l m r h c u l rcr) #> cmet_r( o y o p i _ r (eod omnsul)
Note como el mtodo polymorphic_url es capz de indetificar el tipo del objeto dado y generar la ruta correcta. Tambin soporta Recursos anidados y espacios de nombres:
p l m r h c u l [ a m n @ril,@omn] o y o p i _ r (: d i , atce cmet) #>ti wl rtr: hs il eun a m n a t c e c m e t u l @ril,@omn) d i _ r i l _ o m n _ r (atce cmet
Tambin se puede usar new, edit y formatted como prefijos:
8/50
20/04/12
e i _ o y o p i _ a h @ot d t p l m r h c p t (ps) #>/ot//dt = pss1ei f r a t d p l m r h c p t (@ot : d ] o m t e _ o y o p i _ a h [ps, p f ) #>/ot/.d = pss1pf
RELACIONES DE SLO LECTURA

Se agreg una nueva caraterstica a las relaciones entre modelos. Con el fin de impedir alterar los modelos ahora podemos usar :readonly para asociar modelos. Veamos algunos ejemplos:
hsmn : e o t ,: e d n y = t u a_ay r p r s r a o l > r e hsoe: o s : e d n y = : r e a_n b s , r a o l > t u blnst : r j c ,: e d n y = t u eog_o p o e t r a o l > r e hsadblnst_ay: a e o i s : e d n y = t u a_n_eog_omn c t g r e , r a o l > r e
De esta manera los registros protegidos no podrn ser alterados desde este modelo. Si intentamos editar algunos de los registros de este modelos entonces obtendramos la siguiente excepcin: ActiveRecord::ReadOnlyRecord
MTODOS ADD_TIMESTAMPS Y REMOVE_TIMESTAMPS

Ahora tenemos 2 mtodos nuevos: add_timestamps y remove_timestamps. Los cuales agregan y eliminan, respectivamente, las columnas de timestamp. Veamos un ejemplo:
d fs l . p e e f u adtmsap : e d d_ietms f e s adtmsap : r s d_ietms u l e d n d fs l . o n e e f d w rmv_ietms: r s eoetmsap u l rmv_ietms: e d eoetmsap f e s e d n
CLCULOS
ActiveRecord::Calculations ha cambiado un poco para aceptar no slo el nombre de la columna sino tambin el nombre de la tabla. Esto es muy til cuando tenemos una relacin entre dos tablas que tienen una columna con el mismo nombre. Los mtodos afectados son: sum o maximum de ActiveRecord (entre otros). Para resumir ahora podemos hacer esto de estas dos formas:
atosc t g r e . a i u ( i ) uhr. a e o i s m x m m : d atosc t g r e . a i u (ctgre.d) uhr. a e o i s m x m m "aeoisi"
ACTIVERECORD::BASE.CREATE ACEPTA BLOQUES

Estamos acostumbrados al mtodo ActiveRecord::Base.new que acepta el uso de bloques. Ahora podemos hacer lo mismo con el mtodo create:
#Cec d u neoojt psnoeu bou cnl dsrpind ssarbts rain e n uv beo adl n lqe o a ecic e u tiuo U e . r a e : i s _ a e = 'ai' d || s rc e t (f r t n m > Jme) o u ui _ d i = f l e .s a m n a s e d n
Podemos usar este mismo mtodo para crear muchos objetos de una sola vez:
#Cec d u aryd ojtsneo uad u bou. rain e n ra e beo uvs sno n lqe #E bou s eeuauavzprcd neoojt ced. l lqe e jct n e o aa uv beo rao U e . r a e [: i s _ a e = 'ai',{ f r t n m = 'eey})d || s r c e t ({ f r t n m > Jme} : i s _ a e > Jrm'] o u ui _ d i = f l e .s a m n a s e d n
Esto tambin funciona para las asociaciones:

ato. o t . r a e ( t t e = "e o Eg" {p pb d = "oeco suf" uhrp s s c e t ! : i l > Nw n de) || . o y Mr ol tf!} #o ato. o t . r a e ( t t e = "e o Eg" d || uhrp s s c e t ! : i l > Nw n de) o p pb d = "oeco suf" .o y Mr ol tf! e d n
CHANGE_TABLE
La creacin de migraciones (migrations) en Rails 2.0 se hizo mucho ms sexy que en las versiones previas, pero alterar una tabla usando migrations continuaba siendo como antes, nada sexy.
9/50
20/04/12
En Rails 2.1, ahora tambin es sexy alterar una tabla, con el nuevo mtodo change_table. Veamos el ejemplo:
cag_al : i e s d || hnetbe v d o o t tt m s a p #et arg lsclma cetda yudtda .i e t m s so gea a ouns rae_t pae_t tb l n s t : o t #et arg l clmaga_d(nee) .e o g _ o g a so gea a oun oti itgr ts r n : a e : m i ,: i i = 2 #et arg lsclma nm yeal .t i g n m , e a l l m t > 0 so gea a ouns ae mi tr m v : a e : m i #et eiialsclma nm yeal .e o e n m , e a l so lmn a ouns ae mi e d n
El nuevo mtodo change_table funciona como create_table pero en vez de crear un tabla modifica una ya existente agregando o eliminando columnas e ndices.
cag_al : a l d || hnetbe t b e o t tc l m #arg uaclmanra.E:tclm(nm,:tig .o u n gea n oun oml j .oun:ae srn) ti d x #arg u neodc. .n e gea n uv nie tt m s a p .i e t m s tc a g #cmi l dfnc d uaclma E:tcag(nm,:tig :ii = 8) .h n e aba a eiiin e n oun. j .hne:ae srn, lmt > 0 tc a g _ e a l #cmi e vlrprdfcod uaclma .h n e d f u t aba l ao o eet e n oun. tr n m #cmi e nmr d uaclma .e a e aba l obe e n oun. tr f r n e .e e e c s tb l n s t .e o g _ o ts r n .t i g tt x .e t ti t g r .n e e tf o t .l a td c m l .e i a td t t m .a e i e tt m s a p .i e t m tt m .i e td t .a e tb n r .i a y tb o e n .o l a tr m v .e o e tr m v _ e e e c s .e o e r f r n e tr m v _ e o g _ o .e o e b l n s t tr m v _ n e .e o e i d x tr m v _ i e t m s .e o e t m s a p e d n
DIRTY OBJECTS
Ahora en Rails podemos rastrear los cambios hechos por ActiveRecord. Se puede saber si un objeto ha sido modificado o no. En caso de que haya cambiado, podemos ver que fue lo que cambi exactamente como as tambin comparar su estado anterior con el actual. Veamos algunos ejemplos:
atce= A t c e f n ( f r t ril r i l .i d: i s ) atcec a g d ril. h n e ? #>fle = as atcet t e #>"il" ril. i l = Tte atcet t e = "e Tte ril. i l Nw il" atcet t e c a g d #>tu ril. i l _ h n e ? = re #metatteatsdlcmi usr il ne e abo atcet t e w s #>"il" ril. i l _ a = Tte #atsydsusdlcmi ne epe e abo atcet t e c a g ril. i l _ h n e #>[Tte,"e Tte] = "il" Nw il"
Como ud. puede ver es muy simple. Puede listar todos los cambios hechos al objeto de una esta dos formas:
#rtraualsacntdslsarbtsqecmirn eon n it o oo o tiuo u abao atcec a g d #>[tte] ril. h n e = 'il' #rtrau hs cnlsarbtsqecmirn eon n ah o o tiuo u abao #cnssvlrsatsydsus o u aoe ne ep atcec a g s #>{'il'= [Tte,"e Tte]} ril. h n e = tte > "il" Nw il"
Note que cuando el objeto se guarda su estado de alterado cambia:

atcec a g d ril. h n e ? #>tu = re atces v ril. a e #>tu = re atcec a g d ril. h n e ? #>fle = as
En caso de ud. quiera cambiar el estado de un objeto sin usar attr=, va a necesitar informar explcitamente que se ha modificado el atributo mediante el mtodo attr_name_will_change! (reemplace attr con el nombre real del atributo del objeto). Veamos un ejemplo ms:
atce= A t c e f n ( f r t ril r i l .i d: i s ) atcet t e w l _ h n e ril. i l _ i l c a g ! atcet t e u c s ! ril. i l . p a e atcet t e c a g ril. i l _ h n e #>[Tte,'IL' = 'il' TTE]
PARTIAL UPDATES
La implementacin de Dirty Objects di punto de partida a otra caracterstica muy interesante.
10/50
20/04/12
Dado que ahora podemos rastrear los cambios de los atributos de un objeto, por qu no usar esto para evitar actualizaciones innecesarias en la base de datos? En las versiones previas de Rails cuando ejecutbamos el mtodo save de un objeto ActiveRecord, se actualizaban todos los campos en la base de datos. Por ms que los mismos no hayan sufrido ningn cambio. Con Dirty Objects esta accin podra mejorarse, y esto es exactamente lo que pas. Miremos un poco la consulta SQL generada en Rails 2.1 cuando intentamos guardar un objeto que a sufrido un pequeo cambio:
atce= A t c e f n ( f r t ril r i l .i d: i s ) atcet t e #>"il" ril. i l = Tte atces b e t #>"deRis ril. u j c = Eg al" #Cmimse ttl (il) abao l uo tte atcet t e = "e Tte ril. i l Nw il" #et ce e sgineSLpr pritre ojt so ra l iuet Q aa essi l beo atces v ril. a e #> "PAEatce STtte='e Tte WEEi =1 = UDT rils E il Nw il' HR d "
Note como slo se actualizaron en la base de datos los campos que fueron cambiados en la aplicacin. Si ningn campo ha sido actualizado en la aplicacin, entonces ActiveRecord no ejecutar ninguna actualizacin. Para habilitar/deshabilitar esta nueva caracterstica debe cambiar la propiedad partial_updates de sus modelos.
#Pr hbltra aa aiial M C a sp r i l u d t s=t u y l s .a t a _ p a e r e
Si desea habilitar/deshabilitar esta caracterstica para todos sus modelos debe editar el archivo config/initializers/new_rails_defaults.rb:
#Hbltnopr tdslsmdls aiiad aa oo o oeo A t v R c r :B s . a t a _ p a e = t u c i e e o d:a ep r i l u d t s r e
No olvide informarle a Rails a travs config/initializers/new_rails_defaults.rb que va a actualizar un atributo sin usar el mtodo attr=, as:
#S ua*at=* i s *tr*, #etce et be n ifra nd. nons s in o nomr aa pro. a e = 'ob' esnn m bby pro. a e c a g esnn m _ h n e #= [bb,'ob' > 'o' bby]
#Pr db ifra qee cmos v ataia eo ee nomr u l ap e a culzr #s n v aua *at=* i o a sr *tr* pro. a e w l _ h n e esnn m _ i l c a g ! pro. a e < 'y esnn m < b' pro. a e c a g esnn m _ h n e #= [bb,'ob' > 'o' bby]
Si ud. no informa cambios como estos, no se podrn rastrear los cambios de los atributos del modelo y la tabla no se actualizar correctamente.
SMALLINT, INT O BIGINT EN MYSQL?

El adapatador para MySQL de ActiveRecord es un poco ms inteligente en el uso tipos de datos enteros a la hora de crear o alterar columnas en la base de datos. Con la opcin :limit, podemos definir si la columna va a ser smallint, int or bigint. Veamos el cdigo que hace este trabajo:
c s lmt a e ii w e 0. h n .3 "mlit#lmt) saln({ii}" w e 4. h n .8 "n({ii}" it#lmt) w e 9.0 h n .2 "iit#lmt) bgn({ii}" e s l e 'n(1' it1) e d n
Para dejar esto ms claro vamos a mapear esto en un archivo de migracin y ver que tipo de dato se usa para cada columna:
cet_al : a l _ a e : o c = t u d || raetbe t b e n m , f r e > r e o t #0-3 saln : mlit ti t g r : o u n o e : i i = 2#saln() .n e e c l m _ n , l m t > mlit2 #4-8 it : n ti t g r : o u n t o : i i = 6#it6 .n e e c l m _ w , l m t > n() #9-2:bgn 0 iit ti t g r : o u n t r e : i i = 1 #bgn(5 .n e e c l m _ h e , l m t > 5 iit1) #s n uao :ii it1) i o sms lmt n(1 ti t g r : o u n f u #it1) .n e e c l m _ o r n(1 e d n
11/50
20/04/12
El adaptador de PostgreSQL tena esta caraterstica y MySQL slo sigui esta tendencia.
OPCIONAL :SELECT EN HAS_ONE Y BELONGS_TO

Los ya conocidos mtodos has_one y belongs_to ahora tienen la opcin: :select. El valor por defecto es "" (como en "SELECT FROM table"), pero se puede editar para recuperar slo las columnas que vamos a usar. No olvide incluir las claves primarias y las claves forneas, de lo contrario obtendr un error. El mtodo belongs_to ya no tiene la opcin :order. Pero no se preocupe por que realmente no era muy til.
ALMACENANDO EL NOMBRE COMPLETO DE UNA CLASE CUANDO USAMOS STI

Siempre que usemos models con namespace y STI, ActiveRecord slo almacena el nombre de la clase, sin el nombre del namespace (demodulized). Esto slo funcionar si todas las clases en el STI estan en el mismo namespace. Veamos un ejemplo:
c a s CletoIe <AtvRcr:Bs;e d l s olcintm cieeod:ae n c a s Cmcolcin:tm<CletoIe;e d l s oiCleto:Ie olcintm n ie = C m c o l c i n : t m n w tm o i C l e t o :I e . e ie. y e #= 'tm tmt p > Ie' ie2= C l e t o I e . i d ie. d tm o l c i n t m f n (tmi ) #rtrau err prqen peeecnrr eon n ro, o u o ud nota #l caeIe a ls tm
Este cambio agrega una nueva opcin que hace que ActiveRecord almacene el nombre completo de la clase. Para habilitar/deshabilitar esta caracterstica, ud. debe incluir o editar lo siguiente en su environment.rb.
A t v R c r :B s . t r _ u l s i c a s = t u c i e e o d:a es o e f l _ t _ l s r e
El valor por defecto es true.
EL MTODO TABLE_EXISTS?
Se agreg un nuevo mtodo para la clase AbstractAdapter: table_exists. Es muy simple de usar:
> A t v R c r :B s . o n c i n t b e e i t ? "sr" > c i e e o d : a e c n e t o . a l _ x s s (ues) = t u > r e
TIMESTAMPED MIGRATIONS
Cuando se est estudiando Rails o cuando estamos desarrolando algo slos, las migraciones parecen ser la mejor solucin a todos nuestros problemas. Pero cuando estamos trabajando en un proyecto con un equipo de desarrolladores de distintas partes del mundo, ud. descurbrir (si an no lo hizo) que las migrations no funcionan bien. Las nuevas migraciones (timestamped migrations) de Rails 2.1 vienen al rescate. Antes de la llegada de timestamped migrations, cada nueva migracin tena un nmero antepuesto al nombre de la migracin. Si dos migraciones eran generadas por distintos desarrolladores y no se comiteaba de inmediato, entonces podan terminar teniendo el mismo nmero de migracin pero con diferente informacin. En este punto su esquema_info est desactualizado y ud. tiene un conflicto. Hay varias formas de "intentar" resolver este problema. Se crearon muchos plugins con diferentes maneras de resolver esto. Ms all de los plugins disponibles, una cosa era clara: la antigua forma simplemente no funcionaba. Si ud. estuviese usando Git, entonces se podra complicar mucho ms, su equipo probablemente tenga algunas ramas (branches) con migraciones desactualizadas en todas ellas. Probablemente tenga serios conflictos a la ahora de hacer un merge de esas ramas (branches). Para resolver este gran problema, el core team de Rails cambi el funcionanmiento de las migraciones. En vez de anteponer cada archivo de migracin con un nmero, ahora se le antepone con un string basado en la hora UTC con el siguiente formato YYYYMMDDHHMMSS. As mismo se cre una nueva tabla llamada schema_migrations, esta almacena las migraciones ejecutadas hasta el momento. De esta manera, si alguien crea una migracin con un nmero bajo, rails har un rollback de las migraciones hasta la versin previa y luego se corrern todo de nuevo hasta la versin actual. Esto aparentemente, resuelve el problema de las migraciones. Hay una opcin para deshabilitar esta caraterstica, agregando esta lnea en el archivo envronment.rb:
cni. c i e r c r . i e t m e _ i r t o s = f l e ofga t v _ e o d t m s a p d m g a i n a s
Tambin hay algunas tareas de rake nuevas para "navegar" a travs de las migraciones:
12/50
20/04/12
rk d: i r t : p ae b m g a e u rk d: i r t : o n ae b m g a e d w
13/50
20/04/12
Chapter 3
ActiveSupport
Active Support es una coleccin de varias clases y extensiones de bibliotecas que fueron consideradas muy tiles para las aplicaciones Ruby on Rails. (wikipedia)
ACTIVESUPPORT::COREEXTENSIONS::DATE::CALCULATIONS
Time#end_of_day Retorna la fecha actual con la hora fijada en 11:59:59 PM. Time#end_of_week Retorna el fin de semana (Sunday 11:59:59 PM). Time#end_of_quarter Retorna un objeto date representando el fin del trimestre. En otras palabras, retorna el ltimo da de algunos de los siguientes meses: marzo, junio, septiembre o diciembre, dependiendo de la fecha actual. Time#end_of_year Retorna 31 de Diciembre a las 11:59:59 PM. Time#in_time_zone Este mtodo es similar a Time#localtime, excepto por el hecho de que usa Time.zone en vez de basarse en el timezone del sistema operativo. Se le puede pasar como parmetro tanto un objeto TimeZone como un String. Veamos algunos ejemplos:
T m . o e = 'aai i ez n Hwi' T m . t (00. n t m _ o e i e u c 20)i _ i e z n #= Fi 3 Dc19 1:00 HT-00 > r, 1 e 99 40:0 S 1:0 T m . t (00. n t m _ o e 'lsa) i e u c 20)i _ i e z n (Aak' #= Fi 3 Dc19 1:00 AS -90 > r, 1 e 99 50:0 KT 0:0
Time#days_in_month Se arregl un bug en el mtodo days_in_month, el cual retornaba un nmero incorrecto de das en febrero cuando no se le especificaba el ao. El cambio consiste en usar el ao actual como valor por defecto cuando no se le especifica el ao en la llamada al mtodo. Supongamos que estamos en un ao bisiesto, veamos:
Laigdvlpetevrnet(al 202 odn eeomn niomn Ris ..) > T m . a s i _ o t () > i ed y _ n m n h2 = 2 > 8 Laigdvlpetevrnet(al 210 odn eeomn niomn Ris ..) > T m . a s i _ o t () > i ed y _ n m n h2 = 2 > 9
DateTime#to_f La clase DateTime tiene un nuevo mtodo llamado to_f que retorna la fecha como un flotante representando el nmero de segundos desde el Unix epoch (poca unix, nmero de segundos desde el 1 de Enero de 1970 a la medianoche). Date.current La clase Date tiene un nuevo mtodo llamado current el cual se usa en vez de Date.today, por que este considera el timezone especificado en config.time_zone, que en caso de que estar especificado retorna Time.zone.today, de no ser as, entonces retorna Date.today.
14/50
20/04/12
FRAGMENT_EXIST?
Se agregaron dos nuevos mtodos a cache_store: fragment_exist? y exist?. El mtodo fragment_exist? hace exactamente lo que ud. esperara, verifica si un fragmento est cacheado, informado a travs de una clave existe. Bsicamente sustituyendo al famoso:
r a _ r g e t pt)n l e d f a m n (ah. i ?
El mtodo exist? se agreg a cache_store, mientras que fragment_exist? es un helper el cual ud. podra usar dentro de su controlador.
UTC O GMT?
Una pregunta simple, pero interesante. Hasta ahora Rails estuvo usando mucho la sigla UTC, pero cuando se ejecuta el mtodo to_s de TimeZone, este muestra GMT, no UTC. Esto es debido al hecho de que el acrnimo GMT es ms comn entre los usuarios finales. Si ud. mira en el panel de control de Windows, dnde se puede seleccionar el timezone, ver el que el acrnimo utilizado es GMT. Google y Yahoo tambin estn usando GMT dentro de sus productos.
T m Z n [Mso'. o s #>"GT0:0 Mso" i e o e 'ocw]t _ = (M+30) ocw
JSON ESCAPE
El mtodo json_escape funciona como html_escape. Es muy til cuando necesitamos mostrar strings JSON en una pgina HTML , por ejemplo, en un proceso de documentacin.
pt j o _ s a e "sa>0&a<1?) us s n e c p (i 0" #= i a\03 0\02 a\03 1? > s u0E u06 u0C 0
Podemos usar el atajo j en ERB:

< = j@esnt _ s n % % pro. o j o >
Si ud. desea escapar todo el cdigo JSON por defecto, incluya la lnea siguiente en su environment.rb:
A t v S p o te c p _ t l e t t e _ n j o =t u c i e u p r .s a e h m _ n i i s i _ s n r e
MEM_CACHE_STORE AHORA ACEPTA OPCIONES

La inclusin de Memcache-Client dentro de ActiveSupport::Cache facilit mucho las cosas, pero tambin elimin la flexibilidad permitiendo configurar nada ms que el nmero de IP del servidor de memcached. Jonathan Weiss hizo un parche que fue incluido en Rails, que permite opciones extras como estas:
A t v S p o t : a h . o k p s o e : e _ a h _ t r ,"oahs" c i e u p r :C c e l o u _ t r m m c c e s o e lclot A t v S p o t : a h . o k p s o e : e _ a h _ t r ,"oahs" '9.6..' c i e u p r :C c e l o u _ t r m m c c e s o e lclot, 121811, : a e p c = 'o' n m s a e > fo
o
cni. c i n c n r l e . r g e t c c e s o e = : e _ a h _ t r ,'oahs' ofga t o _ o t o l r f a m n _ a h _ t r m m c c e s o e lclot, { c m r s i n = t u ,: e u = t u ,: a e p c ='o' : o p e s o > r e d b g > r e n m s a e >fo}
TIME.CURRENT
Un nuevo mtodo para la clase Time. El mtodo current retorna dependiendo de si fue especificado antes config.time_zone, Time.zone.now, de otra manera retorna Time.now.
#rtrau vlrqedpned cni.iezn eon n ao u eed e ofgtm_oe T m .u r n i ec r e t
los mtodos since y ago tambin cambiaron sus valores de retorno, retornando un TimeWithZone en caso de que se especifique config.time_zone. Esto convierte al mtodo Time.current en el nuevo mtodo por defecto para obtener la hora actual, reemplazando a Time.now (el cual sigue existiendo, pero no tiene en cuenta el timezone especificado). Los mtodos datetime_select, select_datetime y select_time se actualizaron para que tengan como valor de retorno Time.current.
ELIMINANDO LOS ESPACIOS EN BLANCO CON EL MTODO SQUISH

Se agregaron dos mtodos al objeto String, squish y squish!.
15/50
20/04/12
Estos mtodos hacen lo mismo que el mtodo strip. Elimina los espacios en blanco del principio y del final de un texto. Tambin elimina los espacios en blanco no utilizados (espacios en blanco consecutivos) en el medio de un texto. Veamos un ejemplo:
A #> = A tx et tx et fl ul fl ul o f o f sae pcs sae pcs sae pcs s r p .t i
A tx et fl ul o f #> tx fl o sae = A et ul f pcs
s u s .q i h
16/50
20/04/12
Chapter 4
ActiveResource
ActiveResource es la capa responsable de la implementacin de sistemas RESTful del lado del cliente. A travs de ActiveResource es posible consumir servicios RESTful mediante el uso de objetos que actan como un proxy para los servicios remotos.
USANDO EL EMAIL COMO NOMBRE DE USUARIO.

Algunos servicios usan el e-mail como nombre de usuario, lo cual nos obliga a usar una URL como la siguiente:
ht: / ret. i e e @eoainc m p s @rci. o tp / ensoj m n z ngnto. o : a s tatsc m
Pero nos genera un problema. Por que tenemos dos (@), el intrprete se pierde cuando lee algo como esto. Por este motivo, Se exntendi ActiveResource un poco ms, con el fin de facilitar el uso de e-emails para la autenticacin. Ahora ud. puede hacer lo siguiente:
c a s Pro <AtvRsuc:Bs l s esn cieeore:ae sl. i e = "tp/tatscm efs t ht:/rci.o" sl. s r = "ret.iee@eoaincm efu e ensojmnzngnto.o" sl. a s o d = "as efp s w r ps" e d n
EL MTODO CLONE
Ahora podemos clonar un recurso existente:
ra = P r o . i d 1 yn e s n f n () ntra = ra. l n o_yn ync o e ntra. e ? #= tu o_ynn w > re
Note que el objeto copiado no ha clonado ningn atributo de la clase, apenas los atributos del recurso.
ra = P r o . i d 1 yn e s n f n () ra. d r s = S r e A d e s f n (,: e s n i = ra. d yna d e s t e t d r s .i d1 p r o _ d > yni ) ra. a h = { n t = "nAe isac" ynh s : o > a Rs ntne} ntra = ra. l n o_yn ync o e ntra. e ? o_ynn w ntra. d r s o_yna d e s ntra. a h o_ynh s
#= tu > re #= NMtoErr > oehdro #= {nt= "nAe isac" > :o > a Rs ntne}
TIMEOUTS
ActiveResource usa HTTP para acceder a la API de RESTful y por esto es suceptible a problemas con servidores lentos o servidores no alcanzables. En algunos casos, las llamadas a ActiveResource pueden expirar (timeout). Ahora ud. puede controlar el tiempo de expiracin con la propiedad timeout.
c a s Pro <AtvRsuc:Bs l s esn cieeore:ae sl. i e = "tp/aipol.o:00" efs t ht:/p.epecm30/ sl. i e u = 5#wis5scnsbfr epr eft m o t at eod eoe xie e d n
En el ejemplo de arriba configuramos un timeout de 5 segundos. Se recomienda un valor pequeo para permitirle a su sistema una falla rpida, previeniendo que una casacada de fallas deje su servidor fuera de servicio. Internamente, ActiveResource se basa la biblioteca Net:HTTP para hacer las peticiones HTTP. Cuando ud. define un valor por defecto para la propiedad timeout, el mismo valor es definido para la propiedad read_timeout de la instancia del objeto Net:HTTP que est usando en ese momento. El valor por defecto es 60 segundos.
17/50
20/04/12
Chapter 5
ActionPack
Est compuesto por ActionView (generacin de visualizacin para el usuario, por ej: HTML, XML, JavaScript, etc.) y ActionController (controla el flujo de la aplicacin) (wikipedia)
TIMEZONE
Definiendo un timezone por defecto Se agreg una nueva opcin al mtodo time_zone_select, ahora ud. puede poner un valor por defecto en caso de que el usuario no haya seleccionado ningn TimeZone, o cuando la columna en la base de datos es null. Para hacer esto, se cre la opcin :default que se puede usar de la siguiente manera:
t m _ o e s l c (ue" "iezn" n l : n l d _ l n = t u ) i e z n _ e e t "sr, tm_oe, i , i c u e b a k > r e t m _ o e s l c (ue" "iezn" n l i e z n _ e e t "sr, tm_oe, i , : e a l = "aii Tm (S&Cnd) ) d f u t > Pcfc ie U aaa" t m _ o e s l c ("sr,'iezn' T m Z n . s z n s i e z n _ e e t ue" tm_oe, i e o e u _ o e , : e a l = "aii Tm (S&Cnd)) d f u t > Pcfc ie U aaa"
En los casos dnde usemos la opcin :default, debe aparecer con el TimeZone especificado ya selecionado. El mtodo formatted_offset Se incluy el mtodo formatted_offset en las clases Time y DateTime para retornar con el formato +HH:MM la desviacin de la hora UTC. Por ejemplo, en nuestro timezone (Hora Brasilia) el valor de desviacin retornado por el mtodo sera un string con el valor: "-03:00". Veamos algunos ejemplos: Obteniendo la desviacin desde un DateTime:
dttm = D t T m . i i (00 1 1 0 0 0 Rtoa( 6 2) aeie a e i e c v l 20, , , , , , ainl- , 4) dttm. o m t e _ f s t aeief r a t d o f e #= "0:0 > -60" dttm. o m t e _ f s t f l e aeief r a t d o f e ( a s ) #= "00" > -60
Ahora desde Time:

T m . o a (00. o m t e _ f s t i e l c l 20)f r a t d o f e #= "0:0 > -60" T m . o a (00. o m t e _ f s t f l e i e l c l 20)f r a t d o f e ( a s ) #= "00" > -60
Note que este mtodo retorna un string, el cual puede ser formateado o no dependiendo del valor dado como parmetro. El mtodo with_env_tz El mtodo with_env_tz nos permite hacer tests con diferentes timezones de una manera muy simple:
d ft s _ o a _ f s t e e t l c l o f e wt_n_z'SEsen d ihevt U/atr' o asr_qa Rtoa( 5 2) D t T m . o a _ f s t seteul ainl- , 4, a e i e l c l o f e e d n wt_n_z'SCnrl d ihevt U/eta' o asr_qa Rtoa( 6 2) D t T m . o a _ f s t seteul ainl- , 4, a e i e l c l o f e e d n e d n
Este helper This helper was supposed to call with_timezone, but it was renamed for with_env_tz to avoid confusion with the timezone informed by using ENV['TZ'] and Time.zone. Time.zone_reset! Se elimin por que ya no se usa ms.
18/50
20/04/12
Time#in_current_time_zone Se modific para que retorne self cuando Time.zone es null. Time#change_time_zone_to_current Se modific para que retorne self cuando Time.zone es null. TimeZone#now El mtodo TimeZone#now se modific para que retorne un objeto ActiveSupport::TimeWithZone represetando la hora actual en el timezone configurado en Time.zone. Por ejemplo:
T m . o e = 'aai i ez n Hwi' #= "aai > Hwi" T m .o en w i ez n .o #= Wd 2 Jn20 2:42 HT-00 > e, 3 a 08 02:7 S 1:0
Compare_with_coercion Se cre el mtodo compare_with_coercion (con un alias para <=>) en las clases Time y DateTime, posibilitando la comparacin cronolgica entre las clases Time, DateTime y las instancias de ActiveSupport::TimeWithZone. Para una mejor comprensin, veamos los siguientes ejemplos:
T m . t (00 < > T m . t (99 1,3,2,5,5,99 #1 i e u c 20) = i e u c 19, 2 1 3 9 9 9) T m . t (00 < > T m . t (00 1 1 0 0 0 #0 i e u c 20) = i e u c 20, , , , , ) T m . t (00 < > T m . t (00 1 1 0 0 0 01)#i e u c 20) = i e u c 20, , , , , , 0) 1 T m . t (00 < > D t T m . i i (99 1,3,2,5,5)#1 i e u c 20) = a e i e c v l 19, 2 1 3 9 9 T m . t (00 < > D t T m . i i (00 1 1 0 0 0 #0 i e u c 20) = a e i e c v l 20, , , , , ) T m . t (00 < > D t T m . i i (00 1 1 0 0 1)#i e u c 20) = a e i e c v l 20, , , , , ) 1 T m . t (00 < > A t v S p o t : i e i h o e n w T m . t (99 1,3,2,5,5)) i e u c 20) = c i e u p r :T m W t Z n . e ( i e u c 19, 2 1 3 9 9 T m . t (00 < > A t v S p o t : i e i h o e n w T m . t (00 1 1 0 0 0 ) i e u c 20) = c i e u p r :T m W t Z n . e ( i e u c 20, , , , , ) T m . t (00 < > A t v S p o t : i e i h o e n w T m . t (00 1 1 0 0 1 ) i e u c 20) = c i e u p r :T m W t Z n . e ( i e u c 20, , , , , ) )
TimeWithZone#between? Se incluy el mtodo between? en la clase TimeWithZone para verificar si una instancia est entre dos fechas. Por ejemplo:
@w. e w e ? T m . t (991,12,95) tzb t e n ( i e u c 19,23,35,9, T m . t (0011001) i e u c 20,,,,,)
TimeZone#parse Este mtodo crea una nueva instancia de ActiveSupport::TimeWithZone a partir de un string. Por ejemplo:
T m . o e = "aai i ez n Hwi" #= "aai > Hwi" T m . o e p r e '991-11:00' i e z n . a s (19-23 40:0) #= Fi 3 Dc19 1:00 HT-00 > r, 1 e 99 40:0 S 1:0
T m .o en w i ez n .o #= Fi 3 Dc19 1:00 HT-00 > r, 1 e 99 40:0 S 1:0 T m . o e p r e '23:0) i e z n . a s (2:00' #= Fi 3 Dc19 2:00 HT-00 > r, 1 e 99 23:0 S 1:0
TimeZone#at Este mtodo crea una nueva instancia de ActiveSupport::TimeWithZone a partir del nmero de segundos desde la fecha Unix epoch. Por ejemplo:
T m . o e = "aai #= "aai i ez n Hwi" > Hwi" T m . t (00. o f #= 968800 i e u c 20)t _ > 4640. T m . o e a (4640.) i e z n . t 968800 #= Fi 3 Dc19 1:00 HT-00 > r, 1 e 99 40:0 S 1:0
Ms mtodos Los mtodos to_a, to_f, to_i, httpdate, rfc2822, to_yaml, to_datetime y eql? se agregaron a la clase TImeWithZone. Para ms informacin acerca de estos mtodos por favor lea la documentacin de Rails. Se prepar la clase TimeWithZone para Ruby 1.9 En Ruby 1.9 tendremos algunos mtodos nuevos en la clase Time, como por ejemplo:
T m .o i en w #= TuNv0 1:82 CT20 > h o 3 85:5 E 05
19/50
20/04/12
T m .o .u d y i en ws n a ? #= fle > as
Este mismo mtodo existe para cada da de la semana Otras cosa interesante es que el mtodo to_s del objeto Time tendr un valor de retorno diferente. Hoy cuando ejecutamos Time.new.to_s, obtenemos lo siguiente:
T m .e .o s i en wt _ #= "h Ot1 1:92 +2020" > Tu c 2 03:7 00 06
En Ruby 1.9 vamos a tener:

T m .e .o s i en wt _ #= "061-21:92 +20 > 20-01 03:4 00"
Que tiene que ver todo esto con Rails 2.1? Todo. Rails se est preparando para proveer estas modificaciones. La clase TimeWithZone, por ejemplo, slo tuvo algunas mejoras para funcionar con los mtodos del primer ejemplo.
AUTO LINK
El mtodo auto_link recibe cualquier texto como parmetro, y si el texto contiene alguna direccin de email o website, retorna el mismo texto, pero con hyperlinks. Por ejemplo:
a t _ i k "ot ti wbienw ht:/w.uynal.o" u o l n (G o hs est o: tp/wwrboriscm) #= G t ti wbienw ht:/w.uynal.o > o o hs est o: tp/wwrboriscm
Algunos sites, como Amazon, usan el smbolo "=" en sus URL. Este mtodo no reconoce este smbolo. Veamos como se comporta este mtodo en tal caso:
a t _ i k "tp/wwaao.o/etn/e=dbss_" u o l n (ht:/w.mzncmTsigrfp_b_r1) #= ht:/w.mzncmTsigrf > tp/wwaao.o/etn/e
Note que el mtodo corta el hyperlink exactamente antes del smbolo "=", antes de Rails 2.1 este smbolo estaba soportado. El mismo mtodo se actualiz para permitir el uso de URL con parntesis. Un ejemplo de URL coc parntesis:
ht: / nw k p d a o g wk/ pie(optrgahc) tp / e. i i e i . r / ii Srt_cmue_rpis
ETIQUETAS
Cuando creamos un nuevo formulario con scaffold ser creado con el siguiente cdigo:
< f r _ o (ps)d ||% % o m f r @ot o f > <> p < = fl b l : i l %<r/ % .a e t t e >b > < = ft x _ i l : i l % % .e t f e d t t e > <> p < = fl b l : o y %<r/ % .a e b d >b > < = ft x _ r a : o y % % .e t a e b d > <> p < = fs b i "pae % % . u m t Udt" > < e d% % n >
Se incluy el mtodo label. Este mtodo retorna un string con el ttulo de la columna dentro de un tag HTML <label>.
> fl b l : i l > .a e t t e = < ae f r "ottte> il< lbl > lbl o = ps_il" Tte / ae> > fl b l : i l ," sottte > .a e t t e A hr il" = < ae f r "ottte> sottte / ae> > lbl o = ps_il" A hr il< lbl > lbl: i l ," sottte,: l s = "il_ae" > ae t t e A hr il" c a s > ttelbl = < ae f r "ottte c a s "il_ae" Asottte / ae> > lbl o = ps_il" l s = ttelbl> hr il< lbl
Se di cuenta del parmetro for dentro del tag? "post_title" es el ttulo que contiene nuetro ttulo para el post. El tag <label> de hecho una etiqueta asociada al objeto post_title. Cuando alguien hace click sobre la etiqueta (que no es un link) el controlador HTML asociado recive el foco. Robby Russell escribi un post interesante en su blog acerca de este tema. Ud. lo puede leer en: http://www.robbyonrails.com/articles/2007/12/02/that-checkbox-needs-a-label Tambin se incluy el mtodo label_tag en FormTagHelper. Este mtodo funciona como label, pero de una forma ms simple:
> lbltg'ae > ae_a nm' = < ae f r "ae> ae / ae> > lbl o = nm" Nm< lbl
20/50
20/04/12
> lbltg'ae,'ornm' > ae_a nm' Yu ae = < ae f r "ae> ornm< lbl > lbl o = nm" Yu ae / ae> > lbltg'ae,n l : l s = 'ml_ae' > ae_a nm' i , c a s > sallbl = < ae f r "ae c a s "ml_ae" Nm< lbl > lbl o = nm" l s = sallbl> ae / ae>
El mtodo acepta la opcin :for, Veamos un ejemplo:

l b l : o t : i l ,n l : o = "yfr) a e (p s , t t e i , f r > m_o"
Esto va retornar algo como lo siguiente:

< ae f r "yfr> il< lbl lbl o = m_o" Tte / ae>
UNA NUEVA FORMA DE USAR PARTIALS

El uso de partials es algo muy comn para eliminar la duplicacin de cdigo en el desarrollo de software con Rails. Aqu hay un ejemplo:
< fr_o : s r : r = uespt d % % omfr u e , u l > sr_ah o > <=rne :ata = 'om % % edr pril > fr' > <=sbi_a 'rae % % umttg Cet' > < e d% % n >
Un Partial es un fragmento de cdigo (una plantilla). La ventaja de usar un partial es eliminar la duplicacin innecesaria de cdigo. Usar un partial es muy simple, puede comenzar con algo como esto: render :partial => "name". Y debe crear un archivo con el mismo nombre que su partial, pero anteponindole un guin bajo En el cdigo de arriba vimos como podemos usar un patial, en Rails 2.1 ud. va a poder hacer lo mismo pero una forma un poco diferente:
< f r _ o (ue)d ||% % o m f r @sr o f > <=rne :ata = f% % edr pril > > <=sbi_a 'rae % % umttg Cet' > < e d% % n >
En este ejemplo vamos a renderizar el partial "users/_form", el cual va a recibir una variable llamada "form" con las referencias creadas por FormBuilder. La vieja forma contina funcionando en Rails 2.1
NUEVOS ESPACIOS DE NOMBRES EN ATOM FEED

Conoce el mtodo atom_feed? Es una de las nuevas caractersticas de Rails 2.0, que facilita la creacin de Feeds de Atom. Veamos un ejemplo de como se usa: En el archivo index.atom.builder:
ao_edd |ed tmfe o fe| fe. i l (Nm d Jg" edt t e "oe o oo) fe. p a e (@ot. i s . r a e _ t ) edu d t d (pssf r t c e t d a ) f r ps i @ot o ot n pss fe. n r (ot d |nr| ede t y ps) o ety etyt t e ps. i l ) nr. i l (ott t e etyc n e t ps. o y : y e = 'tl) nr. o t n (otb d , t p > hm' etya t o d |uhr nr. u h r o ato| ato. a e "alsBad" uhrn m (Cro rno) e d n e d n e d n e d n
Qu es un Atom feed? Atom es el nombre de estilos y metadatos en formato XML. En otras palabras es un protocolo para publicar contenidos en Internet que son actualizados con frecuencia, como un blog por ejemplo. Los Feeds se publican siempre en XML y en Atom son identificados como tipo de medios application/atom+xml. En las primeras versiones de Rails 2.0 este mtodo aceptaba parmetros como: :language, :root_url and :url, puede obtener ms informacin acerca de estos mtodos en la documentacin de Rails. pero con la nueva modificacin, ahora podemos incluir nuevos espacios de nombre en el elemento raz del feed. Por ejemplo:
a o _ e d 'mn:p'= 'tp/www.r/07ap)d |ed t m f e (xlsap > ht:/w.3og20/p' o fe|
Va a retornar:
< edxl l n = e-S xls "tp/www.r/05Ao" fe m: a g "nU" mn= ht:/w.3og20/tm xls a p "tp/www.r/07ap> mn: p = ht:/w.3og20/p"
Modificando el ejemplo usado antes, podramos hacer esto:

a o _ e d {xlsap = 'tp/www.r/07ap, t m f e ('mn:p' > ht:/w.3og20/p' 'mn:pnerh = 'tp/a.o//pcoesac/./} d |ed xlsoeSac' > ht:/9cm-se/pnerh11') o fe|
21/50
20/04/12
fe. i l (Nm d Jg" edt t e "oe o oo) fe. p a e (@ot. i s . r a e _ t ) edu d t d (pssf r t c e t d a ) fe. a ! oeSac: o a R s l s 1) edt g (pnerh t t l e u t , 0 f r ps i @ot o ot n pss fe. n r (ot d |nr| ede t y ps) o ety etyt t e ps. i l ) nr. i l (ott t e etyc n e t ps. o y : y e = 'tl) nr. o t n (otb d , t p > hm' etyt g (apeie' T m . o ) nr. a ! 'p:dtd, i e n w etya t o d |uhr nr. u h r o ato| ato. a e "alsBad" uhrn m (Cro rno) e d n e d n e d n e d n
CACHE
Ahora todos los mtodos de fragment_cache_key retornan por defecto el namespace 'view/' como prefijo. Se eliminaron todos los caching store de ActionController::Caching::Fragments:: y ahora estn en ActiveSupport::Cache::. En este caso, si ud. a hecho una referencia a store, como por ejemplo: ActionController::Caching::Fragments::MemoryStore, va a tener que cambiarla por: ActiveSupport::Cache::MemoryStore. ActionController::Base.fragment_cache_store* no va ms, y ActionController::Base.cache_store** toma su lugar. Se incluy en ActiveRecord::Base el mtodo cache_key que facilita el modo de almacenamiento de cache de Active Records mediante la nueva biblioteca ActiveSupport::Cache::*. Funciona as:
> P o u tn wc c e k y > r d c .e .a h _ e = "rdcsnw > pout/e" > P o u t f n ()c c e k y > r d c . i d 5. a h _ e = "rdcs5 > pout/" > P r o . i d 5. a h _ e > e s n f n ()c c e k y = "epe52012100" > pol/-0724500
Se incluy ActiveSupport::Gzip.decompress/compress para facilitar el uso de como mapeo para Zlib. Ahora ud. puede usar las opciones de ambiente (environment) config.cache_store para especificar el valor por defecto del tipo de almacenamiento de cache. Como hemos mencionado si existe el directorio tmp/cache, el valor por defecto es FileStore, en otro caso se usar MemoryStore, puede configurarlo de la siguiente manera:
cni. a h _ t r ofgc c e s o e cni. a h _ t r ofgc c e s o e cni. a h _ t r ofgc c e s o e cni. a h _ t r ofgc c e s o e cni. a h _ t r ofgc c e s o e = = = = = : e o y s o e m m r _ t r : i e s o e "pt/occedrcoy f l _ t r , /aht/ah/ietr" : r _ t r ,"rb:/oahs:12 d b s o e duy/lclot99" : e _ a h _ t r ,"oahs" m m c c e s o e lclot M O n t r . e (prmtr) y w S o e n w "aaee"
Para hace las cosas ms fciles an, el comentario de abajo se incluye en environments/production.rb, en favor de recordarle estas opciones.
#Ueadfeetccesoei pouto s ifrn ah tr n rdcin #cni.ah_tr =:e_ah_tr ofgccesoe mmccesoe
APLICANDO FORMATO DE TTULO EN STRINGS.

Haba un bug cuando usbamos el mtodo String#titleize en un string que contena 's. El bug haca que el mtodo returne la 's en maysculas. Vea el ejemplo:
> "rnosbo"t t e z > bad' lg. i l i e = "rnoSBo" > Bad' lg
Vea el ejemplo que con el bug corregido:

> "rnosbo"t t e z > bad' lg. i l i e = "rnosBo" > Bad' lg
ACTION_NAME
Para saber cual vista fue invocada durante la ejecucin de su vista, podemos usar el mtodo action_name:
< = ato_ae% % cinnm >
El valor de retorno va a ser el mismo que usando params[:action], pero de una forma ms elegante.
CACHES_ACTION ACEPTA CONDICIONALES
22/50
20/04/12
El mtodo caches_action ahora acepta la opcin :if, permitiendo el uso de condicionales para especificar cuando una accin (action) puede ser cacheada (cached) Por ejemplo:
cce_cin: n e ,: f = P o . e {||! . e u s . o m t j o ? } ahsato i d x i > r cn w c cr q e t f r a . s n
En el ejemplo de arriba, la accin index ser cacheada nicamente si no es accedida por una peticin JSON.
CONDITIONAL IN THE CACHES_PAGE METHOD

The caches_page method now has the option to use conditionals (:if). See example:
#TeRis20wy h al . a cce_ae: n e ahspg i d x #I Ris21yucnue:foto n al . o a s i pin cce_ae: n e ,: f = P o . e {||! . e u s . o m t j o ? } ahspg i d x i > r cn w c cr q e t f r a . s n
FLASH.NOW NOW WORKS IN TESTS

Who didn't have headaches because of this ? The problem was that during tests we could never confirm if a message was stored in flash, because it was cleared by Rails before going to your test script. In rails 2.1 the problem was solved. Now you can include the following line in your tests:
asr_qa 'vlenw' fah'etnw] seteul >au_o<, ls[ts_o'
ACCESSING HELPERS OUTSIDE VIEWS

How often have you created a helper and wished you could use it inside your controller ? To achieve this functionality you had to included the helper module inside the controller, which made your code look ugly. In Rails 2.1 a proxy to access helpers outside views was developed. It works in a very simple way:
#T acs sml_omtmto,freape o ces ipefra ehd o xml A p i a i n o t o l r h l e s s m l _ o m t tx) p l c t o C n r l e . e p r . i p e f r a (et
Simple and Clean!
JSON
Rails now accepts POST's requests of JSON content. For example, you can send a POST request this way:
PS / ot OT pss {ps" {tte:"raigNw"} "ot: "il" Bekn es}
And everything goes to variable params. This works for example:

d fc e t e r a e @ot= P s . r a e prm[ p s ] ps o tc e t aas: o t # e d n
Some of you many not know JSON is a "competitor" for XML, and it is widely used for JavaScript data interchange because it's represented in this language. It takes its name from: JavaScript Object Notation.
PATH NAMES
My blog readers (http://www.nomedojogo.com) should know about my Custom Resource Name plugin. I think it'll die very soon... :( In rails you could already include the option :as in your routes (something I implemented in my plugin to keep compatibility). Now you will also have the :path_names option to change the name of your actions.
mpr s u c : c o l ,: s = 'soa' : a h n m s = {: e = 'oa } a. e o r e s h o s a > ecls, p t _ a e > n w > nv'
Of course, my plugin will remain being useful for users of earlier Rails versions.
DEFINING THE LOCATION OF YOUR ROUTES FILE

In Rails 2.1 you can define in which file your routes are stored, including the following line in your enviroment.rb:
cni. o t s c n i u a i n f l ofgr u e _ o f g r t o _ i e
This can be useful in a scenario where you have two separated front-ends that share the same modules, libraries and plugins. For example, getsatisfaction.com and api.getsatisfaction.com share the same models, but not the controllers, helpers and views.
23/50
20/04/12
getsatisfaction has its own routes file with optimizations to improve its SEO, while the API route's file doesn't know anything about SEO improvements.
SESSION(:ON)
Did you know it is possible to turn off sessions in rails? Here is how to do it:
c a s Apiainotolr<AtoCnrle:Bs l s plctoCnrle cinotolr:ae ssin: f eso o f e d n
Note that in my example I'm turning off sessions for all controllers (ApplicationController), but I could also do it for a single controller. If you want to have sessions on for a given controller in Rails 2.1 you can use the session method method passing the :on parameter:
c a s Uesotolr<Apiainotolr l s srCnrle plctoCnrle ssin: n eso o e d n
TESTING HELPERS IN A SIMPLE WAY

One very boring thing to do in earlier versions of Rails is testing the helpers. I already suffered a lot to ensure 100% of coverage, creating tests for some helpers. This became much simpler in Rails 2.1 with the ActionView::TestCase class. Look the example:
m d l PolHle o u e epeepr d f t t e tx) e i l (et c n e t t g : 1 tx) o t n _ a ( h , et e d n d fh m p g _ a h e o e a e p t pol_ah epept e d n e d n
Now look how we can do the same in Rails 2.1:

c a s PolHleTs <AtoVe:TsCs l s epeepret ciniw:etae d fs t p e e u A t o C n r l e :R u i g : o t s d a d |a| c i n o t o l r : o t n :R u e . r w o mp mpp o l 'epe,: o t o l r = 'epe,: c i n = 'ne' a. e p e pol' c n r l e > pol' a t o > idx mpc n e t 'cnrle/ato/i' a. o n c :otolr:cin:d e d n e d n d ft s _ i l e e t t t e asr_qa "h>uyo Ris/1" t t e "uyo Ris) seteul <1Rb n al<h>, i l (Rb n al" e d n d ft s _ o e a e p t e e t h m p g _ a h asr_qa "pol" hmpg_ah seteul /epe, oeaept e d n e d n
24/50
20/04/12
Chapter 6
ActionController
ActionController es la capa responsable de recibir las peticiones web y tomar decisiones con respecto a qu se debe ejecutar y renderizar o si se debe redirigir la peticin a otra accin Una accin es definida como mtodo pblico dentro de los controladores que estn automticamente disponibles a travs de las rutas.
ACTIONCONTROLLER::ROUTING
Map.root Ahora, podemos usar un alias con map.root para que sea mucho ms DRY. En las primeras versiones de rails ud. hacia esto:
mpn w s s i n : o t o l r = 'esos,: c i n = 'e' a. e _ e s o c n r l e > ssin' a t o > nw mpr o : o t o l r = 'esos,: c i n = 'e' a. o t c n r l e > ssin' a t o > nw
Ahora puede hacer lo mismo de la siguiente manera:

mpn w s s i n : o t o l r = 'esos,: c i n = 'e' a. e _ e s o c n r l e > ssin' a t o > nw mpr o : e _ e s o a. o t n w s s i n
Reconocimiento de Rutas La vieja implementacin del reconocimiento de rutas recorra todas la rutas una a una, lo que haca que terminara consumiendo mucho tiempo. Se desarroll una nueva y ms inteligente implementacin. Esta crea un rbol para las rutas y el reconocimiento de rutas se hace mediante un prefijo, dejando de lado las rutas similares. Esta aproximacin baja el tiempo de reconocimiento en aproximadamente 2.7 veces. Todas las nuevas implementaciones estn en el archivo recognition_optimisation.rb y los detalles de su funcionamiento estn en los comentarios. Vea la documentacin dentro del cdigo fuente para ms informacin. Assert_routing Ahora es posible testear una ruta con un mtodo HTTP. Vea el siguiente ejempo:
a s r _ o t n ( : e h d = 'u' s e t r u i g{ m t o > pt, : a h = 'pout31 } p t > /rdc/2' , {: o t o l r = "rdc" c n r l e > pout, : c i n = "pae, a t o > udt" : d = "2"} i > 31 )
Map.resources Image que tiene un sitio escrito en espaol, y quiere remodelar todas las rutas para que tambin para que se correspondan con el idioma. En otras palabras, en vez de tener:
ht: / w. y i e c m b / rdcs 13/ eiw tp / wwm s t . o . r pout/ 24 rves
quisiera tener algo as:

ht: / w. y i e c m b / rdco/ 24 cmnais tp / wwm s t . o . r pouts 13/ oetro
Esto era posible, pero no en de una forma simple y sin comprometer algunas de las convenciones de rails. Ahora tenemos la opcin :as dentro de map.resources para personalizar nuestras rutas. Mire el ejemplo para obtener la URL de arriba en espaol:
mpr s u c s : r d c s : s = 'rdco'd |rdc| a. e o r e p o u t , a > pouts o pout #poutrvespt(rdc)= rdc_eiw_ahpout = #'pouts13/oetro /rdco/24cmnais poutr s u c s : r d c _ e i w ,: s = 'oetro' rdc. e o r e p o u t r v e s a > cmnais e d n
25/50
20/04/12
ACTIONCONTROLLER::CACHING::SWEEPING
En las primeras versiones de Rails, cuando declarbamos un sweeper, tenamos que informar la clase usando smbolos:
c a s Lssotolr<Apiainotolr l s itCnrle plctoCnrle cce_cin: n e ,: h w : u l c : e d ahsato i d x s o , p b i , f e ccesepr: i t s e p r ah_wee l s _ w e e , : n y = [: d t : e t o ,: h r ] o l > e i , d s r y s a e e d n
Ahora es posible declarar explcitamente una clase en vez de usar un smbolo. Esto es necesario si ud. quiere que el sweeper est dentro de un mdulo. Adems de poder seguir usando smbolos para los dems casos, a partir de ahora puede hacer as:
c a s Lssotolr<Apiainotolr l s itCnrle plctoCnrle cce_cin: n e ,: h w : u l c : e d ahsato i d x s o , p b i , f e cceseprO e B r : w e e , ah_wee p n a :S e p r : n y = [: d t : e t o ,: h r ] o l > e i , d s r y s a e e d n
26/50
20/04/12
Chapter 7
ActionView
ActionView es la capa responsable de la generacin de interfaces visibles al usuario a travs de la conversin de plantillas ERB.
ACTIONVIEW::HELPERS::FORMHELPER
fields_for form_for con la opcin index. Los mtodos #fields_for y form_for reciban la opcin :index, eliminando la necesidad de utilizar :index => nil en cada objeto form. Mira los ejemplos: As es como sola ser el cdigo antes:
< fed_o "rjc[akatiue]],ts d ||% % ilsfr poetts_trbts[" ak o f > <=ftx_il :ae :ne = n l % % .etfed nm, idx > i > <=fhde_il :d :ne = n l % % .idnfed i, idx > i > <=fhde_il :huddsry :ne = n l % % .idnfed sol_eto, idx > i > < ed% % n >
Ahora luce de la siguiente forma:

< fed_o "rjc[akatiue]],ts, % ilsfr poetts_trbts[" ak : n e = n l d ||% i d x > i o f > <=ftx_il :ae% % .etfed nm > < = fh d e _ i l : d % % .i d n f e d i > <=fhde_il :huddsry% % .idnfed sol_eto > < e d% % n >
ACTIONVIEW::HELPERS::DATEHELPER
Ahora todos estos mtodos de mdulo para trabajar con fechas (date_select, time_select, select_datetime, etc.) aceptan opciones HTML. Mira un ejemplo usando date_select
< = dt_eet'tm,hpeig,: r e = [ d y ,: l s = 'obr% % aeslc ie''apnn' o d r > : a ] c a s > foa'>
date_helper El mtodo date_helper fue actualizado para que use Date.current en orden de definir su valor predeterminado.
ACTIONVIEW::HELPERS::ASSETTAGHELPER
register_javascript_expansion Este mtodo registra uno o ms archivos javascript para su inclusin cuando un smbolo, definido por el programador, es indicado como parmetro del mtodo javascript_include_tag. La idea es llamar a este mtodo dentro del archivo init.rb de tu plugin, en orden de registrar los archivos javascript que tu plugin ubica en la carpeta public/javascripts. Veamos como funciona:
#E e acioii.b n l rhv ntr A t o V e :H l e s : s e T g e p r r g s e _ a a c i t e p n i n c i n i w : e p r :A s t a H l e . e i t r j v s r p _ x a s o : o k y = [ha" "oy,"al] m n e > "ed, bd" ti" #E netrvsa n usa it: jvsrp_nld_a : o k y aaciticuetg m n e #Vmsaotnr ao bee: < cittp= tx/aacit sc "jvsrpsha.s> / cit srp ye "etjvsrp" r= /aacit/edj"< srp> < cittp= tx/aacit sc "jvsrpsbd.s> / cit srp ye "etjvsrp" r= /aacit/oyj"< srp> < cittp= tx/aacit sc "jvsrpsti.s> / cit srp ye "etjvsrp" r= /aacit/alj"< srp>
register_stylesheet_expansion Este mtodo hace exactamente lo mismo que que el mtodo ActionView::Helpers::AssetTagHelper#register_javascript_expansion, pero crea un smbolo para ser usado luego cuando se realicen llamadas al mtodo stylesheet_link_tag. Veamos un ejemplo:
27/50
20/04/12
#E e acioii.b n l rhv ntr A t o V e :H l e s : s e T g e p r r g s e _ t l s e t e p n i n c i n i w : e p r :A s t a H l e . e i t r s y e h e _ x a s o : o k y = [ha" "oy,"al] m n e > "ed, bd" ti" #E netrvsa n usa it: syehe_iktg: o k y tlsetln_a m n e #Vmsaotnr ao bee: < ikhe= /tlset/edcs ln rf "syehesha.s" mda "cen rl "tlset ei= sre" e= syehe" tp= tx/s"/ ye "etcs > < ikhe= /tlset/oycs ln rf "syehesbd.s" mda "cen rl "tlset ei= sre" e= syehe" tp= tx/s"/ ye "etcs > < ikhe= /tlset/alcs ln rf "syehesti.s" mda "cen rl "tlset ei= sre" e= syehe" tp= tx/s"/ ye "etcs >
ACTIONVIEW::HELPERS::FORMTAGHELPER
submit_tag Se agreg la opcin :confirm a los parmetros del mtodo #submit_tag. Esta opcin funciona de la misma forma que el mtodo link_to. Veamos un ejemplo:
s b i _ a (Sv cags,: o f r = "r yusr?) u m t t g 'ae hne' c n i m > Ae o ue"
ACTIONVIEW::HELPERS::NUMBERHELPER
number_to_currency El mtodo number_to_currency ahora acepta la opcin :format como parmetro, permitindonos dar formato al valor retornado. En versiones anteriores, cuando tenamos que dar formato a monedas locales, debamos incluir un espacio antes de la opcin :unit para que el formato retornado sea el correcto. Veamos un ejemplo:
#R e e smood l mnd d Bai. $ s l bl e a oea e rsl n m e _ o c r e c (.9 : e a a o = "" : e i i e = "" : n t = "$) u b r t _ u r n y 99, s p r t r > ,, d l m t r > ., u i > R" #= "$,9 > R99 n m e _ o c r e c (.9 : o m t = "u%" : e a a o = "" u b r t _ u r n y 99, f r a > % n, s p r t r > ,, : e i i e = "" : n t = "$) d l m t r > ., u i > R" #= "$99 > R ,9
Por otro lado, podemos personalizar de otras formas, por ejemplo:

n m e _ o c r e c (.9 : o m t = "ne rae baieo" : e a a o = "" u b r t _ u r n y 99, f r a > % n els rslrs, s p r t r > ,, : e i i e = "" : n t = "$) d l m t r > ., u i > R" #= ",9e ras > 99 m ei"
Cuando creas tu cadena de formateo, se puede especificar el siguiente parmetro:

% Pr l mnd u aa a oea % Pr e nmr n aa l eo
ACTIONVIEW::HELPERS::TEXTHELPER
excerpt El mtodo excerpt nos ayuda a encontrar una palabra dentro de una frase y nos devuelve la abreviatura de esa frase con el nmero de caracteres que se hayan especificado como parmetro antes y despus de la palabra agregando "" cuando sea necesario. Veamos un ejemplo:
e c r t 'hsi a eape,'n,5 x e p (Ti s n xml' a' ) #= "si a eap" > s n xm
Pero haba un problema. Si cuentas, vas a notar que el mtodo retorna 6 caracteres y no 5. Esto era un bug y se corrigi. Mira el ejemplo de la salida correcta de este mtodo:
e c r t 'hsi a eape,'n,5 x e p (Ti s n xml' a' ) #= "si a ea > s n xm"
simple_format El mtodo simple_format bsicamente recibe como parmetro cualquier texto y le da formato de una manera muy simple a HTML. Toma el texto y reemplaza los saltos de lnea (\n) por el tag HTML " ". Y cuando tenemos dos saltos de lnea, uno atrs del otro, separa el texto con tags "". En Rails 2.1 este mtodo recibe un parmetro adicional. Adems del texto, podemos informarle que atributo HTML nos gustaria que el tag "" incluyera. Veamos el ejemplo:
28/50
20/04/12
s m l _ o m t "el Mm" : l s = 'ecito' i p e f r a (Hlo o!, c a s > dsrpin) #= "pcasecitoHloMm<p" > < ls=dsrpin>el o!/>
Los atributos HTML sern agregados a todos los tags "" creados por este mtodo.
29/50
20/04/12
Chapter 8
Railties
CONFIG.GEM
Ahora es posible configurar todas las gemas necesarias para obtener un proyecto listo para su ejecucin usando una nueva caracterstica llamada config.gem. En el archivo environment.rb puedes especificar de qu gemas depende tu proyecto para ejecutarse correctamente. Veamos un ejemplo:
cni. e "j ofgg m b" cni. e "pio" : e s o = '.' ofgg m hrct, v r i n > 06, : o r e = "tp/cd.hteuksifnt s u c > ht:/oewyhlcytf.e" cni. e "w-3,: i = "w/3 ofgg m ass" l b > ass"
Para instalar todas las dependencias de una sola vez, utilizamos una tarea Rake:
#Isaatdslsgmsepcfcds ntl oa a ea seiiaa rk gm: n t l ae es i s a l
Tambin es posible listar cuales gemas estn siendo usadas en el proyecto ejecutando:
#Lsad tdslsdpneca itno oa a eednis rk gm ae es
Si una de las gemas tiene un archivo rails/init.rb y vos quers llevar la gema con tu aplicacin, puedes hacer:
#Cpal gm epcfcd avno/esnm_ogmxxx oi a ea seiiaa edrgm/oed_e-.. rk gm: n a k GM gmnm ae es u p c E= e_ae
Entonces, la gema ser copiada al directorio vendor/gems/gem_name-x.x.x. En caso de no especificar el nombre de la gema, Rails copiar todas las gemas al directorio vendor/gem
CONFIG.GEM EN PLUGINS
El comando config.gem est tambin disponible para ser utilizado con plugins. Hasta Rails 2.0, el archivo init.rb de un plugin sola lucir de la siguiente forma:
#ii.bdlpui oe_datetcto ntr e lgn pni_uhniain r q i e 'ai' e u r yds r q i e 'pnd e u r oei' A t o C n r l e :B s . e d : n l d ,OeIAtetcto c i n o t o l r:a es n i c u e pnduhniain
Pero en Rails 2.1 el archivo init.rb sera:

cni. e "uyoei" : i = "pnd,: e s o = ".." ofgg m rb-pnd, l b > oei" v r i n > 114 cni. e "uyyds, : i = "ai" ofgg m rb-ai" l b > yds, : e s o = ".." v r i n > 034 cni. f e _ n t a i e d ofga t r i i i l z o A t o C n r l e :B s . e d : n l d ,OeIAtetcto c i n o t o l r:a es n i c u e pnduhniain e d n
As que, cuando ejecute la tarea para instalar todas las gemas necesarias, stas estarn entre ellas.
GEMS:BUILD
La tarea gems:build compila todas las extensiones de las gemas que fueron instaladas a travs de gems:unpack. La sintaxis es la siguiente:
rk gm: u l #Pr tdslsgms ae es b i d aa oa a ea rk gm: u l GM mgm#Etyepcfcnouagm ae es b i d E= ye so seiiad n ea
NUEVO MENSAJE CUANDO SE INICIALIZA EL SERVIDOR

Hubo una pequea mejora en el inicio del servidor de Rails. Ahora se muestra cual versin est siendo cargada:
30/50
20/04/12
Ris21apiainsatn o ht: / ...:00 al . plcto trig n tp / 000030
RAILS.PUBLIC_PATH
Se agreg un acceso directo para recuperar el path del directorio "public" de un proyecto.
R i sp b i _ a h a l .u l c p t
RAILS.LOGGER, RAILS.ROOT, RAILS.ENV Y RAILS.CACHE

En Rails 2.1 en vez de usar las constantes: RAILS_DEFAULT_LOGGER, RAILS_ROOT, RAILS_ENV y RAILS_CACHE, usaremos:
#RISDFUTLGE AL_EAL_OGR R i sl g e a l .o g r #RISRO AL_OT R i sr o a l .o t #RISEV AL_N R i se v a l .n #RISCCE AL_AH R i sc c e a l .a h
RAILS.VERSION
En versiones anteriores para descubrir, en tiempo de ejecucin, cual es la versin de Rails en uso usabamos:
R i s : E S O :S R N a l :V R I N : T I G
En Rails 2.1 usamos:

R i sv r i n a l .e s o
OBTENIENDO INFORMACIN ACERCA DE UN PLUGIN

Esta es una de las nuevas caractersticas de Rails 2.1 que probablemente nunca use. Digo "probablemente", porque en algunos casos especficos puede ser til, por ejemplo, para saber la versin de un plugin. Para probarlo, necesitamos crear un archivo que se llame about.yml en el directorio del plugin, con algo como lo siguiente:
ato:Cro Bad uhr als rno vrin 120 eso: .. dsrpin Uadsrpinaec dlpui ecito: n ecic cra e lgn ul ht: / w. o e o o o c m r: tp / wwn m d j g . o
Podemos obtener esta informacin luego de esta manera:

pui = R i s : l g n n w pui_ietr) lgn a l :P u i . e (lgndrcoy pui. b u [ato" #= alsBad lgna o t "uhr] > Cro rno pui. b u [ul]#= tp/wwnmdjg.o lgna o t "r" > ht:/w.oeooocm
Si encuentras algn buen uso de esta carcterstica y la quieres compartir conmigo, tal vez cambie mi opinin acerca de su real necesidad.
31/50
20/04/12
Chapter 9
Rake Tasks, Plugins y Scripts
TAREAS
rails:update De ahora en ms, cada vez que se ejecute la tarea rake rails:freeze:edge, esta tambin ejecutar rails:update, actualizando los archivos de configuracin y los JavaScripts. Base de datos en 127.0.0.1 Un cambio fue realizado en el archivo database.rake que sola buscar unicamente en localhost bases de datos locales. Ahora considerar 127.0.0.1. Esto funciona para las tareas create y drop. El archivo database.rake tambin fue refactorizado para hacer el cdigo menos repetitivo. Congelando a una versin de Rails especfica. Hasta Rails 2.1 no era posible congelar a una versin de Rails especfica dentro de un proyecto. Slo se poda utilizar la Revisin como parmetro. En Rails 2.1, podemos congelar a una versin especfica con el siguiente comando:
rk ris f e z : d e RLAE 120 ae al: r e e e g EES= ..
TIMEZONE
rake time:zones:all Devuelve todas las zonas horarias conocidas para Rails, agrupadas por uso horario. Tambin se puede filtrar los valores retornados usando el parmetro ptico OFFSET, por ejemplo: OFFSET=-6. rake time:zones:us Muestra lista con todas las zonas horarias de Estados Unidos. La opcin OFFSET tambin es vlida en este contexto. rake time:zones:local Retorna todas las zonas horarias conocidas por Rails que estn en el mismo uso horario que tu sistema operativo.
SCRIPTS
plugin El comando script/plugin install ahora provee la opcin -e/--export que emite un svn export. Se agreg soporte para plugins alojados en repositorios GIT. dbconsole Este script hace lo mismo que script/console, solo que para la base de datos. En otras palabras, te conecta con el cliente por lnea de comando de tu base de datos. Mirando al cdigo, ste funcionara solamente con mysql, postgresql y sqlite(3). Cuando sea especificada otra base de datos en el archivo database.yml, el script mostrar: "not supported for this database type".
PLUGINS
Las Gemas ahora pueden ser plugins
32/50
20/04/12
Ahora, cualquier gema que tenga un archivo rails/init.rb puede ser instalado dentro del directorio vendor de tu proyecto Rails igual que un plugin. Usando generadores en plugins Es posible configurar Rails para buscar plugins en directorios diferentes a vendor/plugins, solo incluyendo esta lnea de cdigo en el archivo environment.rb.
cni. l g n p t s = [lbpuis,'edrpuis] ofgp u i _ a h 'i/lgn' vno/lgn'
Rails 2.0 tena un bug en esta configuracin que mostraba cuando un plugin tena generadores. Por ese bug, Rails solo encuentraba generadores en plugins que estuvieran dentro de vendor/plugins. En Rails 2.1 ese bug fue corregido.
33/50
20/04/12
Chapter 10
Prototype y script.aculo.us
PROTOTYPE
Rails 2.1 ahora usa Prototype versin 1.6.0.1. Este sirve como base de la versin 1.8.1 de script.aculo.us.
34/50
20/04/12
Chapter 11
Ruby 1.9
DETAILS
El foco principal de los cambios de Rails fue Ruby 1.9. Aspectos menores fueron analizados para incrementar la compatibilidad de Rails con la nueva versin de Ruby. Detalles como cambiar File.exists? por File.exist? no fueron dejados de lado. Adems, en Ruby 1.9, el mdulo Base64 (base64.rb) fue eliminado, por esa razn, todas las referencias fueron remplazadas por ActiveSupport::Base64.
NUEVOS MTODOS PARA LA CLASE DATETIME

Con el objetivo de mantener compatibilidad (duck-typing) con la clase Time, tres nuevos mtodos fueron agregados a la clase DateTime. Los mtodos son #utc, #utc? y #utc_offset. veamos un ejemplo de cada uno:
> dt = D t T m . i i (05 2 2,1,1,1,Rtoa( 6 2) > ae a e i e c v l 20, , 1 0 1 2 ainl- , 4) #>Mn 2 Fb20 1:11 -60 = o, 1 e 05 01:2 00 > dt. t > aeu c #>Mn 2 Fb20 1:11 +00 = o, 1 e 05 61:2 00 > D t T m . i i (05 2 2,1,1,1,Rtoa( 6 2). t ? > a e i e c v l 20, , 1 0 1 2 ainl- , 4)u c #>fle = as > D t T m . i i (05 2 2,1,1,1,0. t ? > a e i e c v l 20, , 1 0 1 2 )u c #>tu = re > D t T m . i i (05 2 2,1,1,1,Rtoa( 6 2). t _ f s t > a e i e c v l 20, , 1 0 1 2 ainl- , 4)u c o f e #>-10 = 260
35/50
20/04/12
Chapter 12
Debug
RUBY-DEBUG NATIVO
Fue habilitada nuevamente la opcin para utilizar ruby-debug en pruebas con Rails. Ahora, teniendo en cuenta que la gema debe estar instalada, slo se necesita el usar el mtodo debugger.
36/50
20/04/12
Chapter 13
Bugs y arreglos
AGREGAR COLUMNAS EN POSTGRESQL

Exista un bug cuando se usaba PostgreSQL. El bug ocurra cuando creabamos una migracin para agregar una columna en una tabla existente. Por ejemplo: Archivo: db/migrate/002_add_cost.rb
c a s Adot<AtvRcr:Mgain l s dCs cieeod:irto d fs l . p e e f u adclm : t m ,: o t : e i a ,: r c s o = 6 d_oun i e s c s , d c m l p e i i n > , : c l = 2 s a e > e d n d fs l . o n e e f d w rmv_oun: t m ,: o t eoeclm i e s c s e d n e d n
Note que estamos creando una columna con :precision => 6 y :scale => 2. Ahora ejecutamos rake db:migrate y vemos como se ve nuestra tabla en la base de datos: Column id descr price cost Type integer character varying(255) numeric(5,2) numeric Modifiers not null
Vea la columna "cost" que acabamos de crear. Es un numeric comn, pero debera ser como la columna "price" de arriba, ms precisamente un numeric(6,2). En Rails 2.1 este error no sucede ms y la columa se crea correctamente.
MIME TYPES
Se arregl un bug que no permita definir el atributo para request.format usando un smbolo. Ahora podemos usar el siguiente cdigo:
rqetf r a = : p o e eus. o m t i h n asr_qa : p o e rqetf r a seteul i h n , eus. o m t
BUG FIXES EN CHANGE_COLUMN

Se arregl un bug en el uso del mtodo change_column con :null => true en una columna creada usando :null => false. Debido a este bug no se realiz ningn cambio al usar este mtodo.
37/50
20/04/12
Chapter 14
Informacin adicional
PROTECCIN CONTRA CROSS SITE SCRIPTING

En Rails 2.0 el archivo application.rb era as:
c a s Apiainotolr<AtoCnrle:Bs l s plctoCnrle cinotolr:ae hle : l epr a l poetfo_ogr rtc_rmfrey e d n
Vea la llamada al mtodo protect_from_forgery. Escuch hablar sobre Cross Site Scripting? Este es el nombre de un fallo de seguridad que se puede encontrar en la mayora de los sitios y aplicaciones web que permiten a gente mala (estoy hablando de adolescentes que no tienen nada que hacer y tampoco tienen vida social) alterar el contenido de las pginas web, para llevar acabo 'fishing attacks', tomando el control del navegador a travs de cdigo javascript y en la mayora de las veces forzando el usuario a ejecutar el comando que ellos quieran. Este ltimo tipo de ataque se llama 'cross-site request forgery'. Cross Site Request Forgery es un tipo de ataque fuerza al usuario a ejecutar comandos si que este lo sepa. Y con el incremento del uso de ajax, las cosas empeoran. Actualmente, este mtodo es til para asegurar que todos los formularios de tu aplicacin estn recibiendo datos que vienen de la misma aplicacin, y no desde un link perdido en otro sitio. Esto se hace inlcuyendo un token basado en la sesin en todos los formularios y peticiones ajax generadas por Rails, y luego verificando la autenticidad de este token en el controlador. Recuerder que las peticiones GET no estn protegidas. Pero esto no es un problema si usamos slamente para obtener datos, y nunca para alterar o guardar nada en nuestra base de datos. Si ud. quiere aprender ms acerca de CSRF (Cross-Site Request Forgery) vaya a la siguiente direccin: http://www.nomedojogo.com/2008/01/14/como-um-garoto-chamado-samy-pode-derrubar-seu-site/isc.sans.org/diary.html? storyid=1750 http://www.nomedojogo.com/2008/01/14/como-um-garoto-chamado-samy-pode-derrubar-seu-site/isc.sans.org/diary.html? storyid=1750 Pero recuerde que esta no es una solucin definitiva al problema, o como decimos comunmente, no es una bala de plata.
USE METHOD_MISSING, SIN DEJAR CABOS SUELTOS

Debido a la naturaleza dinmica de Ruby, el mtodo respond_to? es crucial. Cuntas veces necesitamos verificar si un mtodo existe en el objeto que estamos manipulando, o si un objeto es lo que estamos esperando (is_a?)? Sin embargo hay algo muy importante que mucha gente olvida. Mire por ejemplo esta clase que usa el mtodo method_missing:
c a s Pro l s er d f m t o _ i s n (ehd * rs & lc) e e h d m s i g mto, ag, bok i mto. o s = /lda/ f ehdt _ ~ ^arr pt "ofof" us wowo! e s l e s p r u e e d n e d n e d n rx= P r o n w e e r .e rxl d a #>wowf e. a r r = ofo! rxl d a ! #>wowo! e. a r r = ofof rxl d a _ _ o r r #>wowo! e. a r r y c r e = ofof
Creo que ud conoce method_missing, o no? En el ejemplo de arriba estoy creando una instacia de la clase Perro y llamando a los mtodos ladrar, ladrar! y ladrarycorrer que no existen. Entonces el mtodo method_missing es invocado, donde uso una simple expresin regular para retornar "woofwoof!", en caso que el nombre del mtodo comience con ladrar. Pero veamos que pasa cuando intento usar el mtodo respond_to?:
38/50
20/04/12
rxr s o d t ? : a r r #>fle e. e p n _ o l d a = as rxl d a #>wowo! e. a r r = ofof
Retorna false, y tiene mucho sentido dado que el mtodo no existe realmente. Entonces es mi responsabilidad cambiar el mtodo respond_to? para que funcione correctamente con esta regla especial. Voy a modificar mi clase de la siguiente forma:
c a s Pro l s er MTD_ARR= /lda/ EOOLDA ^arr d f r s o d t ? mto) e e p n _ o (ehd r t r t u i mto. o s = MTD_ARR e u n r e f ehdt _ ~ EOOLDA s p r u e e d n d f m t o _ i s n (ehd * rs & lc) e e h d m s i g mto, ag, bok i mto. o s = MTD_ARR f ehdt _ ~ EOOLDA pt "ofof" us wowo! e s l e s p r u e e d n e d n e d n rx= D g n w e o .e rxr s o d t ? : a r r #>tu e. e p n _ o ( l d a ) = re rxl d a #>wowo! e. a r r = ofof
Ahora s! Este es un error muy comn que he visto en algunos cdigos, inclusive en el propio Rails. Intente ejecutar el mtodo respond_to? para verificar la existencia de mtodos como find_by_name, por ejemplo. Ruby es un lenguaje impresionante y altamente flexible, pero si no prestamos atencin podemos dejar cabos sueltos como este. Por supuesto que en Rails 2.1 este problema ya se solucion. Podemos usar respond_to? para verificar la existencia de mtodos como find_by_algo.
POSTGRESQL
En Rails 2.0, el adaptador para PostgreSQL tena soporte solamente para las versiones 8.1 hasta 8.3. Se agreg soporte para las versiones 7.4 hasta la 8.3.
39/50
20/04/12
Chapter 15
CHANGELOG
ACTIONMAILER
* Fixed that a return-path header would be ignored #7572 [joost] * Less verbose mail logging: just recipients for :info log level; the whole email for :debug only. #8000 [iaddict, Tarmo Tnav] * Updated TMail to version 1.2.1 [raasdnil] * Fixed that you don't have to call super in ActionMailer::TestCase#setup #10406 [jamesgolick]
ACTIONPACK
* InstanceTag#default_time_from_options overflows to DateTime [Geoff Buesing] * Fixed that forgery protection can be used without session tracking (Peter Jones) [#139] * Added session(:on) to turn session management back on in a controller subclass if the superclass turned it off (Peter Jones) [#136] * Change the request forgery protection to go by Content-Type instead of request.format so that you can't bypass it by POSTing to "# {request.uri}.xml" [rick] * InstanceTag#default_time_from_options with hash args uses Time.current as default; respects hash settings when time falls in system local spring DST gap [Geoff Buesing] * select_date defaults to Time.zone.today when config.time_zone is set [Geoff Buesing] * Fixed that TextHelper#text_field would corrypt when raw HTML was used as the value (mchenryc, Kevin Glowacz) [#80] * Added ActionController::TestCase#rescue_action_in_public! to control whether the action under test should use the regular rescue_action path instead of simply raising the exception inline (great for error testing) [DHH] * Reduce number of instance variables being copied from controller to view. [Pratik] * select_datetime and select_time default to Time.zone.now when config.time_zone is set [Geoff Buesing] * datetime_select defaults to Time.zone.now when config.time_zone is set [Geoff Buesing] * Remove ActionController::Base#view_controller_internals flag. [Pratik] * Add conditional options to caches_page method. [Paul Horsfall] * Move missing template logic to ActionView. [Pratik] * Introduce ActionView::InlineTemplate class. [Pratik] * Automatically parse posted JSON content for Mime::JSON requests. [rick]
PS / ot OT pss {ps" {tte:"raigNw"} "ot: "il" Bekn es} d fc e t e r a e @ot= P s . r a e prm[ p s ] ps o tc e t aas: o t #.. . e d n
* add json_escape ERB util to escape html entities in json strings that are output in HTML pages. [rick] * Provide a helper proxy to access helper methods from outside views. Closes #10839 [Josh Peek] e.g. ApplicationController.helpers.simple_format(text) * Improve documentation. [Xavier Noria, leethal, jerome] * Ensure RJS redirect_to doesn't html-escapes string argument. Closes #8546 [josh, eventualbuddha, Pratik] * Support render :partial => collection of heterogeneous elements. #11491 [Zach Dennis] * Avoid remote_ip spoofing. [Brian Candler]
40/50
20/04/12
* Added support for regexp flags like ignoring case in the :requirements part of routes declarations #11421 [NeilW] * Fixed that ActionController::Base#read_multipart would fail if boundary was exactly 10240 bytes #10886 [ariejan] * Fixed HTML::Tokenizer (used in sanitize helper) didn't handle unclosed CDATA tags #10071 [esad, packagethief] * Improve documentation. [Radar, Jan De Poorter, chuyeow, xaviershay, danger, miloops, Xavier Noria, Sunny Ripert] * Fixed that FormHelper#radio_button would produce invalid ids #11298 [harlancrystal] * Added :confirm option to submit_tag #11415 [miloops] * Fixed NumberHelper#number_with_precision to properly round in a way that works equally on Mac, Windows, Linux (closes #11409, #8275, #10090, #8027) [zhangyuanyi] * Allow the #simple_format text_helper to take an html_options hash for each paragraph. #2448 [Francois Beausoleil, thechrisoshow] * Fix regression from filter refactoring where re-adding a skipped filter resulted in it being called twice. [rick] * Refactor filters to use Active Support callbacks. #11235 [Josh Peek] * Fixed that polymorphic routes would modify the input array #11363 [thomas.lee] * Added :format option to NumberHelper#number_to_currency to enable better localization support #11149 [lylo] * Fixed that TextHelper#excerpt would include one character too many #11268 [Irfy] * Fix more obscure nested parameter hash parsing bug. #10797 [thomas.lee] * Added ActionView::Helpers::register_javascript/stylesheet_expansion to make it easier for plugin developers to inject multiple assets. #10350 [lotswholetime] * Fix nested parameter hash parsing bug. #10797 [thomas.lee] * Allow using named routes in ActionController::TestCase before any request has been made. Closes #11273 [alloy] * Fixed that sweepers defined by cache_sweeper will be added regardless of the perform_caching setting. Instead, control whether the sweeper should be run with the perform_caching setting. This makes testing easier when you want to turn perform_caching on/off [DHH] * Make MimeResponds::Responder#any work without explicit types. Closes #11140 [jaw6] * Better error message for type conflicts when parsing params. Closes #7962 [spicycode, matt] * Remove unused ActionController::Base.template_class. Closes #10787 [Pratik] * Moved template handlers related code from ActionView::Base to ActionView::Template. [Pratik] * Tests for div_for and content_tag_for helpers. Closes #11223 [thechrisoshow] * Allow file uploads in Integration Tests. Closes #11091 [RubyRedRick] * Refactor partial rendering into a PartialTemplate class. [Pratik] * Added that requests with JavaScript as the priority mime type in the accept header and no format extension in the parameters will be treated as though their format was :js when it comes to determining which template to render. This makes it possible for JS requests to automatically render action.js.rjs files without an explicit respond_to block [DHH] * Tests for distance_of_time_in_words with TimeWithZone instances. Closes #10914 [ernesto.jimenez] * Remove support for multivalued (e.g., '&'-delimited) cookies. [Jamis Buck] * Fix problem with render :partial collections, records, and locals. #11057 [lotswholetime] * Added support for naming concrete classes in sweeper declarations [DHH] * Remove ERB trim variables from trace template in case ActionView::Base.erb_trim_mode is changed in the application. #10098 [tpope, kampers] * Fix typo in form_helper documentation. #10650 [xaviershay, kampers] * Fix bug with setting Request#format= after the getter has cached the value. #10889 [cch1] * Correct inconsistencies in RequestForgeryProtection docs. #11032 [mislav] * Introduce a Template class to ActionView. #11024 [lifofifo] * Introduce the :index option for form_for and fields_for to simplify multi-model forms (see http://railscasts.com/episodes/75). #9883 [rmm5t] * Introduce map.resources :cards, :as => 'tarjetas' to use a custom resource name in the URL: cards_path == '/tarjetas'. #10578 [blj]
41/50
20/04/12
* TestSession supports indifferent access. #7372 [tamc, Arsen7, mhackett, julik, jean.helou] * Make assert_routing aware of the HTTP method used. #8039 [mpalmer] e.g. assert_routing({ :method => 'put', :path => '/product/321' }, { :controller => "product", :action => "update", :id => "321" }) * Make map.root accept a single symbol as an argument to declare an alias. #10818 [bscofield] e.g. map.dashboard '/dashboard', :controller=>'dashboard'
mpr o a. o t : a h o r d s b a d
* Handle corner case with image_tag when passed 'messed up' image names. #9018 [duncanbeevers, mpalmer] * Add label_tag helper for generating elements. #10802 [DefV] * Introduce TemplateFinder to handle view paths and lookups. #10800 [Pratik Naik] * Performance: optimize route recognition. Large speedup for apps with many resource routes. #10835 [oleganza] * Make render :partial recognise form builders and use the _form partial. #10814 [djanowski] * Allow users to declare other namespaces when using the atom feed helpers. #10304 [david.calavera] * Introduce send_file :x_sendfile => true to send an X-Sendfile response header. [Jeremy Kemper] * Fixed ActionView::Helpers::ActiveRecordHelper::form for when protect_from_forgery is used #10739 [jeremyevans] * Provide nicer access to HTTP Headers. Instead of request.env["HTTP_REFERRER"] you can now use request.headers["Referrer"]. [Koz] * UrlWriter respects relative_url_root. #10748 [Cheah Chu Yeow] * The asset_host block takes the controller request as an optional second argument. Example: use a single asset host for SSL requests. #10549 [Cheah Chu Yeow, Peter B, Tom Taylor] * Support render :text => nil. #6684 [tjennings, PotatoSalad, Cheah Chu Yeow] * assert_response failures include the exception message. #10688 [Seth Rasmussen] * All fragment cache keys are now by default prefixed with the "views/" namespace [DHH] * Moved the caching stores from ActionController::Caching::Fragments::* to ActiveSupport::Cache::*. If you're explicitly referring to a store, like ActionController::Caching::Fragments::MemoryStore, you need to update that reference with ActiveSupport::Cache::MemoryStore [DHH] * Deprecated ActionController::Base.fragment_cache_store for ActionController::Base.cache_store [DHH] * Made fragment caching in views work for rjs and builder as well #6642 [zsombor] * Fixed rendering of partials with layout when done from site layout #9209 [antramm] * Fix atom_feed_helper to comply with the atom spec. Closes #10672 [xaviershay]
Tetg cetdd n t cnanadt (tp / fevldtro g dc/ ro/ n a i T G h m ) h as rae o o oti ae ht: / edaiao. r / os err I v l d A . t l Isaen t gaate uiu D r o urned nqe Adfutsl ln wsn t poie,cnrr t tedcmnain eal ef ik a o rvdd otay o h ouetto NT: Ti cagstg f r eitn ao etis bta latte vldt nw OE hs hne as o xsig tm nre, u t es hy aiae o.
* Correct indentation in tests. Closes #10671 [l.guidi] * Fix that auto_link looks for ='s in url paths (Amazon urls have them). Closes #10640 [bgreenlee] * Ensure that test case setup is run even if overridden. #10382 [Josh Peek] * Fix HTML Sanitizer to allow trailing spaces in CSS style attributes. Closes #10566 [wesley.moxam] * Add :default option to time_zone_select. #10590 [Matt Aimonetti]
ACTIVERECORD
* Add ActiveRecord::Base.sti_name that checks ActiveRecord::Base#store_full_sti_class? and returns either the full or demodulized name. [rick] * Add first/last methods to associations/named_scope. Resolved #226. [Ryan Bates] * Added SQL escaping for :limit and :offset #288 [Aaron Bedra, Steven Bristol, Jonathan Wiess] * Added first/last methods to associations/named_scope. Resolved #226. [Ryan Bates] * Ensure hm:t preloading honours reflection options. Resolves #137. [Frederick Cheung]
42/50
20/04/12
* Added protection against duplicate migration names (Aslak Hellesy) [#112] * Base#instantiate_time_object: eliminate check for Time.zone, since we can assume this is set if time_zone_aware_attributes is set to true [Geoff Buesing] * Time zone aware attribute methods use Time.zone.parse instead of #to_time for String arguments, so that offset information in String is respected. Resolves #105. [Scott Fleckenstein, Geoff Buesing] * Added change_table for migrations (Jeff Dean) [#71]. Example:
cag_al : i e s d || hnetbe v d o o t tt m s a p .i e t m s #ad cetda,udtda ds rae_t pae_t tb l n s t : o t .e o g _ o g a #ad ga_ditgr ds oti nee ts r n : a e : m i ,: i i = 2 .t i g n m , e a l l m t > 0 #ad nm adealbt wt a2 ca lmt ds ae n mi oh ih 0 hr ii tr m v : a e : m i .e o e n m , e a l #rmvstenm adealclms eoe h ae n mi oun e d n
* Fixed has_many :through .create with no parameters caused a "can't dup NilClass" error (Steven Soroka) [#85] * Added block-setting of attributes for Base.create like Base.new already has (Adam Meehan) [#39] * Fixed that pessimistic locking you reference the quoted table name (Josh Susser) [#67] * Fixed that change_column should be able to use :null => true on a field that formerly had false [Nate Wiger] [#26] * Added that the MySQL adapter should map integer to either smallint, int, or bigint depending on the :limit just like PostgreSQL [DHH] * Change validates_uniqueness_of :case_sensitive option default back to true (from [9160]). Love your database columns, don't LOWER them. [rick] * Add support for interleaving migrations by storing which migrations have run in the new schema_migrations table. Closes #11493 [jordi] * ActiveRecord::Base#sum defaults to 0 if no rows are returned. Closes #11550 [kamal] * Ensure that respond_to? considers dynamic finder methods. Closes #11538. [floehopper] * Ensure that save on parent object fails for invalid has_one association. Closes #10518. [Pratik] * Remove duplicate code from associations. [Pratik] * Refactor HasManyThroughAssociation to inherit from HasManyAssociation. Association callbacks and _ids= now work with hm:t. #11516 [rubyruy] * Ensure HABTM#create and HABTM#build do not load entire association. [Pratik] * Improve documentation. [Xavier Noria, Jack Danger Canty, leethal] * Tweak ActiveRecord::Base#to_json to include a root value in the returned hash: {"post": {"title": ...}} [rick]
P s . i d 1. o j o #= {tte:.. o t f n ()t _ s n > "il" .} cni. c i e r c r . n l d _ o t i _ s n = t u ofga t v _ e o d i c u e r o _ n j o r e P s . i d 1. o j o #= {ps" {tte:..} o t f n ()t _ s n > "ot: "il" .}
* Add efficient #include? to AssociationCollection (for has_many/has_many :through/habtm). [stopdropandrew] * PostgreSQL: create_ and drop_database support. #9042 [ez, pedz, nicksieger] * Ensure that validates_uniqueness_of works with with_scope. Closes #9235. [nik.wakelin, cavalle] * Partial updates include only unsaved attributes. Off by default; set YourClass.partial_updates = true to enable. [Jeremy Kemper] * Removing unnecessary uses_tzinfo helper from tests, given that TZInfo is now bundled [Geoff Buesing] * Fixed that validates_size_of :within works in associations #11295, #10019 [cavalle] * Track changes to unsaved attributes. [Jeremy Kemper] * Switched to UTC-timebased version numbers for migrations and the schema. This will as good as eliminate the problem of multiple migrations getting the same version assigned in different branches. Also added rake db:migrate:up/down to apply individual migrations that may need to be run when you merge branches #11458 [jbarnette] * Fixed that has_many :through would ignore the hash conditions #11447 [miloops] * Fix issue where the :uniq option of a has_many :through association is ignored when find(:all) is called. Closes #9407 [cavalle] * Fix duplicate table alias error when including an association with a has_many :through association on the same join table. Closes #7310 [cavalle] * More efficient association preloading code that compacts a through_records array in a central location. Closes #11427 [danger] * Improve documentation. [Radar, Jan De Poorter, chuyeow, xaviershay, danger, miloops, Xavier Noria, Sunny Ripert]
43/50
20/04/12
* Fixed that ActiveRecord#Base.find_or_create/initialize would not honor attr_protected/accessible when used with a hash #11422 [miloops] * Added ActiveRecord#Base.all/first/last as aliases for find(:all/:first/:last) #11413 [nkallen, thechrisoshow] * Merge the has_finder gem, renamed as 'named_scope'. #11404 [nkallen]
c a s Atce<AtvRcr:Bs l s ril cieeod:ae nmdsoe: u l s e ,: o d t o s = { p b i h d = t u } ae_cp p b i h d c n i i n > : u l s e > r e nmdsoe: o u a ,: o d t o s = .. ae_cp p p l r c n i i n > . e d n A t c ep b i h dp g n t (p g = 1 r i l .u l s e .a i a e: a e > ) A t c ep b i h dp p l rc u t r i l .u l s e .o u a .o n A t c ep p l rf n (f r t r i l .o u a .i d: i s ) A t c e p p l r f n ( a l : o d t o s = {.} r i l .o u a .i d: l , c n i i n > ..)
See http://pivots.pivotallabs.com/users/nick/blog/articles/284-hasfinder-it-s-now-easier-than-ever-to-create-complex-re-usable-sqlqueries * Add has_one :through support. #4756 [thechrisoshow] * Migrations: create_table supports primary_key_prefix_type. #10314 [student, thechrisoshow] * Added logging for dependency load errors with fixtures #11056 [stuthulhu] * Time zone aware attributes use Time#in_time_zone [Geoff Buesing] * Fixed that scoped joins would not always be respected #6821 [Theory/Danger] * Ensure that ActiveRecord::Calculations disambiguates field names with the table name. #11027 [cavalle] * Added add/remove_timestamps to the schema statements for adding the created_at/updated_at columns on existing tables #11129 [jramirez] * Added ActiveRecord::Base.find(:last) #11338 [miloops] * test_native_types expects DateTime.local_offset instead of DateTime.now.offset; fixes test breakage due to dst transition [Geoff Buesing] * Add :readonly option to HasManyThrough associations. #11156 [miloops] * Improve performance on :include/:conditions/:limit queries by selectively joining in the pre-query. #9560 [dasil003] * Perf fix: Avoid the use of named block arguments. Closes #11109 [adymo] * PostgreSQL: support server versions 7.4 through 8.0 and the ruby-pg driver. #11127 [jdavis] * Ensure association preloading doesn't break when an association returns nil. ##11145 [GMFlash] * Make dynamic finders respect the :include on HasManyThrough associations. #10998. [cpytel] * Base#instantiate_time_object only uses Time.zone when Base.time_zone_aware_attributes is true; leverages Time#time_with_datetime_fallback for readability [Geoff Buesing] * Refactor ConnectionAdapters::Column.new_time: leverage DateTime failover behavior of Time#time_with_datetime_fallback [Geoff Buesing] * Improve associations performance by using symbol callbacks instead of string callbacks. #11108 [adymo] * Optimise the BigDecimal conversion code. #11110 [adymo] * Introduce the :readonly option to all associations. Records from the association cannot be saved. #11084 [miloops] * Multiparameter attributes for time columns fail over to DateTime when out of range of Time [Geoff Buesing] * Base#instantiate_time_object uses Time.zone.local() [Geoff Buesing] * Add timezone-aware attribute readers and writers. #10982 [Geoff Buesing] * Instantiating time objects in multiparameter attributes uses Time.zone if available. #10982 [rick] * Add note about how ActiveRecord::Observer classes are initialized in a Rails app. #10980 [fxn] * MySQL: omit text/blob defaults from the schema instead of using an empty string. #10963 [mdeiters] * belongs_to supports :dependent => :destroy and :delete. #10592 [Jonathan Viney] * Introduce preload query strategy for eager :includes. #9640 [Frederick Cheung, Aleksey Kondratenko, codafoo] * Support aggregations in finder conditions. #10572 [Ryan Kinderman] * Organize and clean up the Active Record test suite. #10742 [John Barnette]
44/50
20/04/12
* Ensure that modifying has_and_belongs_to_many actions clear the query cache. Closes #10840 [john.andrews] * Fix issue where Table#references doesn't pass a :null option to a *_type attribute for polymorphic associations. Closes #10753 [railsjitsu] * Fixtures: removed support for the ancient pre-YAML file format. #10736 [John Barnette] * More thoroughly quote table names. #10698 [dimdenis, lotswholetime, Jeremy Kemper] * update_all ignores scoped :order and :limit, so post.comments.update_all doesn't try to include the comment order in the update statement. #10686 [Brendan Ribera] * Added ActiveRecord::Base.cache_key to make it easier to cache Active Records in combination with the new ActiveSupport::Cache::* libraries [DHH] * Make sure CSV fixtures are compatible with ruby 1.9's new csv implementation. [JEG2] * Added by parameter to increment, decrement, and their bang varieties so you can do player1.increment!(:points, 5) #10542 [Sam] * Optimize ActiveRecord::Base#exists? to use #select_all instead of #find. Closes #10605 [jamesh, fcheung, protocool] * Don't unnecessarily load has_many associations in after_update callbacks. Closes #6822 [stopdropandrew, canadaduane] * Eager belongs_to :include infers the foreign key from the association name rather than the class name. #10517 [Jonathan Viney] * SQLite: fix rename_ and remove_column for columns with unique indexes. #10576 [Brandon Keepers] * Ruby 1.9 compatibility. #10655 [Jeremy Kemper, Dirkjan Bussink]
ACTIVERESOURCE
2.1.0 (May 31st, 2008)* * Fixed response logging to use length instead of the entire thing (seangeo) [#27] * Fixed that to_param should be used and honored instead of hardcoding the id #11406 [gspiers] * Improve documentation. [Radar, Jan De Poorter, chuyeow, xaviershay, danger, miloops, Xavier Noria, Sunny Ripert] * Use HEAD instead of GET in exists? [bscofield] * Fix small documentation typo. Closes #10670 [l.guidi] * find_or_create_resource_for handles module nesting. #10646 [xavier] * Allow setting ActiveResource::Base#format before #site. [rick] * Support agnostic formats when calling custom methods. Closes #10635 [joerichsen] * Document custom methods. #10589 [Cheah Chu Yeow] * Ruby 1.9 compatibility. [Jeremy Kemper]
ACTIVESUPPORT
* TimeZone#to_s shows offset as GMT instead of UTC, because GMT will be more familiar to end users (see time zone selects used by Windows OS, google.com and yahoo.com.) Reverts [8370] [Geoff Buesing] * Hash.from_xml: datetime xml types overflow to Ruby DateTime class when out of range of Time. Adding tests for utc offsets [Geoff Buesing] * TimeWithZone #+ and #- : ensure overflow to DateTime with Numeric arg [Geoff Buesing] * Time#to_json: don't convert to utc before encoding. References #175 [Geoff Buesing] * Remove unused JSON::RESERVED_WORDS, JSON.valid_identifier? and JSON.reserved_word? methods. Resolves #164. [Cheah Chu Yeow] * Adding Date.current, which returns Time.zone.today if config.time_zone is set; otherwise returns Date.today [Geoff Buesing] * TimeWithZone: date part getter methods (#year #mon #day etc) are defined on class; no longer relying on method_missing [Geoff Buesing] * Time.zone.parse return nil for strings with no date information [Geoff Buesing] * Time.zone.parse respects offset information in string. Resolves #105. [Scott Fleckenstein, Geoff Buesing] * Added Ruby 1.8 implementation of Process.daemon
45/50
20/04/12
* Duration #since and #ago with no argument (e.g., 5.days.ago) return TimeWithZone when config.time_zone is set. Introducing Time.current, which returns Time.zone.now if config.time_zone is set, otherwise just returns Time.now [Geoff Buesing] * Time#since behaves correctly when passed a Duration. Closes #11527 [kemiller] * Add #getutc alias for DateTime#utc [Geoff Buesing] * Refactor TimeWithZone: don't send #since, #ago, #+, #-, #advance through method_missing [Geoff Buesing] * TimeWithZone respects config.active_support.use_standard_json_time_format [Geoff Buesing] * Add config.active_support.escape_html_entities_in_json to allow disabling of html entity escaping. [rick] * Improve documentation. [Xavier Noria] * Modified ActiveSupport::Callbacks::Callback#call to accept multiple arguments. * Time #yesterday and #tomorrow behave correctly crossing DST boundary. Closes #7399 [sblackstone] * TimeWithZone: Adding tests for dst and leap day edge cases when advancing time [Geoff Buesing] * TimeWithZone#method_missing: send to utc to advance with dst correctness, otherwise send to time. Adding tests for time calculations methods [Geoff Buesing] * Add config.active_support.use_standard_json_time_format setting so that Times and Dates export to ISO 8601 dates. [rick] * TZInfo: Removing unneeded TimezoneProxy class [Geoff Buesing] * TZInfo: Removing unneeded TimezoneIndexDefinition, since we're not including Indexes::Timezones [Geoff Buesing] * Removing unnecessary uses_tzinfo helper from tests, given that TZInfo is now bundled [Geoff Buesing] * Bundling abbreviated version of TZInfo gem 0.3.8: only the classes and zone definitions required to support Rails time zone features are included. If a recent version of the full TZInfo gem is installed, this will take precedence over the bundled version [Geoff Buesing] * TimeWithZone#marshal_load does zone lookup via Time.get_zone, so that tzinfo/Olson identifiers are handled [Geoff Buesing] * Time.zone= accepts TZInfo::Timezone instances and Olson identifiers; wraps result in TimeZone instance [Geoff Buesing] * TimeWithZone time conversions don't need to be wrapped in TimeOrDateTime, because TZInfo does this internally [Geoff Buesing] * TimeWithZone#usec returns 0 instead of error when DateTime is wrapped [Geoff Buesing] * Improve documentation. [Radar, Jan De Poorter, chuyeow, xaviershay, danger, miloops, Xavier Noria, Sunny Ripert] * Ensure that TimeWithZone#to_yaml works when passed a YAML::Emitter. [rick] * Ensure correct TimeWithZone#to_date [Geoff Buesing] * Make TimeWithZone work with tzinfo 0.2.x: use TZInfo::Timezone#zone_identifier alias for #abbreviation, silence warnings on tests. Raise LoadError when TZInfo version is < 0.2 by sniffing for TZInfo::TimeOrDateTime constant. Move all tzinfo-dependent TimeZone tests into uses_tzinfo block [Geoff Buesing] * Time, DateTime and TimeWithZone #in_time_zone defaults to Time.zone. Removing now unneeded #in_current_time_zone [Geoff Buesing] * TZInfo caches Timezone instances in its own internal hash cache, so TimeZone::MAPPING doesn't need to cache them as well [Geoff Buesing] * Adding TimeZone#parse [Geoff Buesing] * Adding TimeZone#at and DateTime#to_f [Geoff Buesing] * TimeWithZone responds to Ruby 1.9 weekday-named query methods [Geoff Buesing] * TimeWithZone caches TZInfo::TimezonePeriod used for time conversion so that it can be reused, and enforces DST rules correctly when instance is created from a local time [Geoff Buesing] * Fixed that BufferedLogger should create its own directory if one doesn't already exist #11285 [lotswholetime] * Fix Numeric time tests broken by DST change by anchoring them to fixed times instead of Time.now. Anchor TimeZone#now DST test to time specified with Time.at instead of Time.local to work around platform differences with Time.local and DST representation [Geoff Buesing] * Removing unneeded #change_time_zone method from Time, DateTime and TimeWithZone [Geoff Buesing] * TimeZone #local and #now correctly enforce DST rules [Geoff Buesing] * TimeWithZone instances correctly enforce DST rules. Adding TimeZone#period_for_utc [Geoff Buesing] * test_time_with_datetime_fallback expects DateTime.local_offset instead of DateTime.now.offset [Geoff Buesing]
46/50
20/04/12
* Adding TimeWithZone #marshal_dump and #marshal_load [Geoff Buesing] * Add OrderedHash#to_hash [josh] * Adding Time#end_of_day, _quarter, _week, and _year. #9312 [Juanjo Bazan, Tarmo Tnav, BigTitus] * Adding TimeWithZone#between? [Geoff Buesing] * Time.=== returns true for TimeWithZone instances [Geoff Buesing] * TimeWithZone #+ and #- behave consistently with numeric arguments regardless of whether wrapped time is a Time or DateTime; consistenty answers false to #acts_like?(:date) [Geoff Buesing] * Add String#squish and String#squish! to remove consecutive chunks of whitespace. #11123 [jordi, Henrik N] * Serialize BigDecimals as Floats when using to_yaml. #8746 [ernesto.jimenez] * Adding TimeWithZone #to_yaml, #to_datetime, #eql? and method aliases for duck-typing compatibility with Time [Geoff Buesing] * TimeWithZone #in_time_zone returns +self+ if zone argument is the same as #time_zone [Geoff Buesing] * Adding TimeWithZone #to_a, #to_f, #to_i, #httpdate, #rfc2822 [Geoff Buesing] * Pruning unneeded TimeWithZone#change_time_zone_to_current [Geoff Buesing] * Time#zone=, #in_time_zone and #change_time_zone accept a Duration [Geoff Buesing] * Time#in_time_zone handles Time.local instances correctly [Geoff Buesing] * Pruning unneeded Time#change_time_zone_to_current. Enhanced docs to #change_time_zone to explain the difference between this method and #in_time_zone [Geoff Buesing] * TimeZone#new method renamed #local; when used with Time.zone, constructor now reads: Time.zone.local() [Geoff Buesing] * Added Base64.encode64s to encode values in base64 without the newlines. This makes the values immediately usable as URL parameters or memcache keys without further processing [DHH] * Remove :nodoc: entries around the ActiveSupport test/unit assertions. #10946 [dancroak, jamesh] * Add Time.zone_default accessor for setting the default time zone. Rails::Configuration.time_zone sets this. #10982 [Geoff Buesing] * cache.fetch(key, :force => true) to force a cache miss. [Jeremy Kemper] * Support retrieving TimeZones with a Duration. TimeZone[-28800] == TimeZone[-480.minutes]. [rick] * TimeWithZone#- added, so that #- can handle a Time or TimeWithZone argument correctly [Geoff Buesing] * with_timezone test helper renamed with_env_tz, to distinguish between setting ENV['TZ'] and setting Time.zone in tests [Geoff Buesing] * Time#- coerces TimeWithZone argument to a Time instance so that difference in seconds can be calculated. Closes #10914 [Geoff Buesing, yyyc514] * Adding UTC zone to TimeZone; TimeWithZone no longer has to fake UTC zone with nil [Geoff Buesing] * Time.get_zone refactored to private method, given that the encapsulated logic is only useful internally [Geoff Buesing] * Time.zone uses thread-local variable for thread safety. Adding Time.use_zone, for overriding Time.zone locally inside a block. Removing unneeded Time.zone_reset! [Geoff Buesing] * TimeZone#to_s uses UTC rather than GMT; reapplying change that was undone in [8679]. #1689 [Cheah Chu Yeow] * Time.days_in_month defaults to current year if no year is supplied as argument #10799 [Radar], uses Date.gregorian_leap? to determine leap year, and uses constant lookup to determine days in month [Geoff Buesing] * Adding Time and DateTime #compare_with_coercion, which layers behavior on #<=> so that any combination of Time, DateTime and ActiveSupport::TimeWithZone instances can be chronologically compared [Geoff Buesing] * TimeZone#now returns an ActiveSupport::TimeWithZone [Geoff Buesing] * Time #in_current_time_zone and #change_time_zone_to_current return self when Time.zone is nil [Geoff Buesing] * Remove unneeded #to_datetime_default_s alias for DateTime#to_s, given that we inherit a #to_default_s from Date that does exactly the same thing [Geoff Buesing] * Refactor Time and DateTime #to_formatted_s: use ternary instead of nested if/else [Geoff Buesing] * Adding Time and DateTime #formatted_offset, for outputting +HH:MM utc offset strings with cross-platform consistency [Geoff Buesing] * Adding alternate_utc_string option to TimeZone#formatted_offset. Removing unneeded TimeZone#offset. [Geoff Buesing]
47/50
20/04/12
* Introduce ActiveSupport::TimeWithZone, for wrapping Time instances with a TimeZone. Introduce instance methods to Time for creating TimeWithZone instances, and class methods for managing a global time zone. [Geoff Buesing] * Replace non-dst-aware TimeZone class with dst-aware class from tzinfo_timezone plugin. TimeZone#adjust and #unadjust are no longer available; tzinfo gem must now be present in order to perform time zone calculations, via #local_to_utc and #utc_to_local methods. [Geoff Buesing] * Extract ActiveSupport::Callbacks from Active Record, test case setup and teardown, and ActionController::Dispatcher. #10727 [Josh Peek] * Introducing DateTime #utc, #utc? and #utc_offset, for duck-typing compatibility with Time. Closes #10002 [Geoff Buesing] * Time#to_json uses Numeric#to_utc_offset_s to output a cross-platform-consistent representation without having to convert to DateTime. References #9750 [Geoff Buesing] * Refactor number-to-HH:MM-string conversion logic from TimeZone#formatted_offset to a reusable Numeric#to_utc_offset_s method. [Geoff Buesing] * Continue evolution toward ActiveSupport::TestCase. #10679 [Josh Peek] * TestCase: introduce declared setup and teardown callbacks. Pass a list of methods and an optional block to call before setup or after teardown. Setup callbacks are run in the order declared; teardown callbacks are run in reverse. [Jeremy Kemper] * Added ActiveSupport::Gzip.decompress/compress(source) as an easy wrapper for Zlib [Tobias Luetke] * Included MemCache-Client to make the improved ActiveSupport::Cache::MemCacheStore work out of the box [Bob Cottrell, Eric Hodel] * Added ActiveSupport::Cache::* framework as an extraction from ActionController::Caching::Fragments::* [DHH] * Fixed String#titleize to work for strings with 's too #10571 [trek] * Changed the implementation of Enumerable#group_by to use a double array approach instead of a hash such that the insert order is honored [DHH/Marcel] * remove multiple enumerations from ActiveSupport::JSON#convert_json_to_yaml when dealing with date/time values. [rick] * Hash#symbolize_keys skips keys that can't be symbolized. #10500 [Brad Greenlee] * Ruby 1.9 compatibility. #1689, #10466, #10468, #10554, #10594, #10632 [Cheah Chu Yeow, Pratik Naik, Jeremy Kemper, Dirkjan Bussink, fxn] * TimeZone#to_s uses UTC rather than GMT. #1689 [Cheah Chu Yeow] * Refactor of Hash#symbolize_keys! to use Hash#replace. Closes #10420 [ReinH] * Fix HashWithIndifferentAccess#to_options! so it doesn't clear the options hash. Closes #10419 [ReinH]
RAILTIES
* script/dbconsole fires up the command-line database client. #102 [Steve Purcell] * Fix bug where plugin init.rb files from frozen gem specs weren't being run. (pjb3) [#122 state:resolved] * Made the location of the routes file configurable with config.routes_configuration_file (Scott Fleckenstein) [#88] * Rails Edge info returns the latest git commit hash [Francesc Esplugas] * Added Rails.public_path to control where HTML and assets are expected to be loaded from (defaults to Rails.root + "/public") #11581 [nicksieger] * rake time:zones:local finds correct base utc offset for zones in the Southern Hemisphere [Geoff Buesing] * Don't require rails/gem_builder during rails initialization, it's only needed for the gems:build task. [rick] * script/performance/profiler compatibility with the ruby-prof >= 0.5.0. Closes #9176. [Catfish] * Flesh out rake gems:unpack to unpack all gems, and add rake gems:build for native extensions. #11513 [ddollar]
rk gm: n a k ae es u p c rk gm: n a k GM mgm ae es u p c E= ye rk gm: u l ae es b i d rk gm: u l GM mgm ae es b i d E= ye #upcsalgm nak l es #upcsol tegm'ye' nak ny h e mgm #bid alupce gm uls l nakd es #bid ol tegm'ye' uls ny h e mgm
* Add config.active_support for future configuration options. Also, add more new Rails 3 config settings to new_rails_defaults.rb [rick] * Add Rails.logger, Rails.root, Rails.env and Rails.cache shortcuts for RAILS_* constants [pratik] * Allow files in plugins to be reloaded like the rest of the application. [rick]
48/50
20/04/12
Enables or disables plugin reloading.

cni. e o d _lgn = t u ofgr l a \puis r e
You can get around this setting per plugin. If #reload_plugins? == false (DEFAULT), add this to your plugin's init.rb to make it reloadable:
D p n e c e . o d o c _ a h . e e e lb_ah e e d n i sl a _ n e p t sd l t i\pt
If #reload_plugins? == true, add this to your plugin's init.rb to only load it once:
D p n e c e . o d o c _ a h < lbpt e e d n i s l a _ n e p t s < i_ah
* Small tweak to allow plugins to specify gem dependencies. [rick]

#ODoe\i\atetcto pui ii.b L pn_d_uhniain lgn ntr r q i e 'ai' e u r yds r q i e 'pnd e u r oei' A t o C n r l e :B s . e d : n l d ,OeIAtetcto c i n o t o l r:a es n i c u e pnduhniain #NW E cni. e "uyoei" : i = "pnd,: e s o = ".." ofgg m rb-pnd, l b > oei" v r i n > 114 cni. e "uyyds, : i = "ai" ofgg m rb-ai" l b > yds, : e s o = ".." v r i n > 034 cni. f e _ n t a i e d ofga t r i i i l z o A t o C n r l e :B s . e d : n l d ,OeIAtetcto c i n o t o l r:a es n i c u e pnduhniain e d n
* Added config.gem for specifying which gems are required by the application, as well as rake tasks for installing and freezing gems. [rick]
R i s : n t a i e . u d |ofg a l :I i i l z r r n o cni| cni. e "j ofgg m b" cni. e "pio" : e s o = '.' : o r e = "tp/cd.hteuksifnt ofgg m hrct, v r i n > 06, s u c > ht:/oewyhlcytf.e" cni. e "w-3,: i = "w/3 ofgg m ass" l b > ass" e d n #Ls rqie gm. it eurd es rk gm ae es #Isalalrqie gm: ntl l eurd es rk gm: n t l ae es i s a l #Upc seiidgmt vno/esgm_aexxx nak pcfe e o edrgm/e\nm-.. rk gm: n a k GM b ae es u p c E= j
* Removed the default .htaccess configuration as there are so many good deployment options now (kept it as an example in README) [DHH] * config.time_zone accepts TZInfo::Timezone identifiers as well as Rails TimeZone identifiers [Geoff Buesing] * Rails::Initializer#initialize_time_zone raises an error if value assigned to config.time_zone is not recognized. Rake time zone tasks only require ActiveSupport instead of entire environment [Geoff Buesing] * Stop adding the antiquated test/mocks/* directories and only add them to the path if they're still there for legacy reasons [DHH] * Added that gems can now be plugins if they include rails/init.rb #11444 [jbarnette] * Added Plugin#about method to programmatically access the about.yml in a plugin #10979 [lazyatom]
pui = R i s : l g n n w pt\t\m\pui) lgn a l :P u i . e (ah_o_y_lgn pui. b u [ato" #= "ae Aa" lgna o t "uhr] > Jms dm pui. b u [ul]#= "tp/itrlhnt lgna o t "r" > ht:/neba.e"
* Improve documentation. [Radar, Jan De Poorter, chuyeow, xaviershay, danger, miloops, Xavier Noria, Sunny Ripert] * Added config.time_zone = 'UTC' in the default environment.rb [Geoff Buesing] * Added rake tasks time:zones:all, time:zones:us and time:zones:local for finding time zone names for config.time_zone option [Geoff Buesing] * Add config.time_zone for configuring the default Time.zone value. #10982 [Geoff Buesing] * Added support for installing plugins hosted at git repositories #11294 [danger] * Fixed that script/generate would not look for plugin generators in plugin_paths #11000 [glv] * Fixed database rake tasks to work with charset/collation and show proper error messages on failure. Closes #11301 [matt] * Added a -e/--export to script/plugin install, uses svn export. #10847 [jon@blankpad.net)] * Reshuffle load order so that routes and observers are initialized after plugins and app initializers. Closes #10980 [rick] * Git support for script/generate. #10690 [ssoroka]
49/50
20/04/12
* Update scaffold to use labels instead of bold tags. Closes #10757 [zach-inglis-lt3] * Resurrect WordNet synonym lookups. #10710 [tom./, matt] * Added config.cache_store to environment options to control the default cache store (default is FileStore if tmp/cache is present, otherwise MemoryStore is used) [DHH] * Added that rails:update is run when you do rails:freeze:edge to ensure you also get the latest JS and config files #10565 [jeff] * SQLite: db:drop:all doesn't fail silently if the database is already open. #10577 [Cheah Chu Yeow, mrichman] * Introduce native mongrel handler and push mutex into dispatcher. [Jeremy Kemper] * Ruby 1.9 compatibility. #1689, #10546 [Cheah Chu Yeow, frederico]
50/50

Gastonramos.com

Caricato da

Informazioni sul documento

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Gastonramos.com

Caricato da

Copyright:

Formati disponibili

20/04/12

Ruby on Rails 2.1

Ruby on Rails 2.1

Carlos Brando Marcos Tapajs

Copyright 2008 Carlos Brando. All Rights Reserved.

Primer Edicin: Junio 2008

Carlos Brando Website: www.nomedojogo.com Marcos Tapajs Website: www.improveit.com.br/en/company/tapajos

hsmn : o t c _ a d ,: s = : o t c a_ay c n a t c r s a > c n a t e d n

TESTEANDO NAMED_SCOPE CON PROXY_OPTIONS

USANDO FIRST Y LAST CON NAMED_SCOPE

Tambin se puede usar new, edit y formatted como prefijos:

e i _ o y o p i _ a h @ot d t p l m r h c p t (ps) #>/ot//dt = pss1ei f r a t d p l m r h c p t (@ot : d ] o m t e _ o y o p i _ a h [ps, p f ) #>/ot/.d = pss1pf

RELACIONES DE SLO LECTURA

MTODOS ADD_TIMESTAMPS Y REMOVE_TIMESTAMPS

ACTIVERECORD::BASE.CREATE ACEPTA BLOQUES

Esto tambin funciona para las asociaciones:

Note que cuando el objeto se guarda su estado de alterado cambia:

SMALLINT, INT O BIGINT EN MYSQL?

OPCIONAL :SELECT EN HAS_ONE Y BELONGS_TO

ALMACENANDO EL NOMBRE COMPLETO DE UNA CLASE CUANDO USAMOS STI

El valor por defecto es true.

Podemos usar el atajo j en ERB:

MEM_CACHE_STORE AHORA ACEPTA OPCIONES

ELIMINANDO LOS ESPACIOS EN BLANCO CON EL MTODO SQUISH

A tx et fl ul o f #> tx fl o sae = A et ul f pcs

USANDO EL EMAIL COMO NOMBRE DE USUARIO.

Ahora desde Time:

En Ruby 1.9 vamos a tener:

El mtodo acepta la opcin :for, Veamos un ejemplo:

Esto va retornar algo como lo siguiente:

UNA NUEVA FORMA DE USAR PARTIALS

NUEVOS ESPACIOS DE NOMBRES EN ATOM FEED

Modificando el ejemplo usado antes, podramos hacer esto:

APLICANDO FORMATO DE TTULO EN STRINGS.

Vea el ejemplo que con el bug corregido:

CACHES_ACTION ACEPTA CONDICIONALES

CONDITIONAL IN THE CACHES_PAGE METHOD

FLASH.NOW NOW WORKS IN TESTS

ACCESSING HELPERS OUTSIDE VIEWS

Simple and Clean!

And everything goes to variable params. This works for example:

DEFINING THE LOCATION OF YOUR ROUTES FILE

TESTING HELPERS IN A SIMPLE WAY

Now look how we can do the same in Rails 2.1:

Ahora puede hacer lo mismo de la siguiente manera:

quisiera tener algo as:

Ahora luce de la siguiente forma:

Por otro lado, podemos personalizar de otras formas, por ejemplo:

Cuando creas tu cadena de formateo, se puede especificar el siguiente parmetro:

Pero en Rails 2.1 el archivo init.rb sera:

NUEVO MENSAJE CUANDO SE INICIALIZA EL SERVIDOR

Ris21apiainsatn o ht: / ...:00 al . plcto trig n tp / 000030

RAILS.LOGGER, RAILS.ROOT, RAILS.ENV Y RAILS.CACHE

En Rails 2.1 usamos:

OBTENIENDO INFORMACIN ACERCA DE UN PLUGIN

Podemos obtener esta informacin luego de esta manera:

Rake Tasks, Plugins y Scripts

NUEVOS MTODOS PARA LA CLASE DATETIME

AGREGAR COLUMNAS EN POSTGRESQL

BUG FIXES EN CHANGE_COLUMN

PROTECCIN CONTRA CROSS SITE SCRIPTING

USE METHOD_MISSING, SIN DEJAR CABOS SUELTOS

rxr s o d t ? : a r r #>fle e. e p n _ o l d a = as rxl d a #>wowo! e. a r r = ofof

Enables or disables plugin reloading.