rails. leksykon kieszonkowy full.pdf

REST ................................................................................................ 149

ActionMailer .................................................................................. 155

Usugi sieciowe .............................................................................. 159

Logowanie ...................................................................................... 165

ActiveResource .............................................................................. 169

Dodatki ............................................................................................ 171

Capistrano ....................................................................................... 171

TextMate ........................................................................................ 179

Metody pomocnicze .......................................................................181

Skorowidz ..................................................................................... 215

Rails. Leksykon kieszonkowy

Polecenia oraz konfiguracja Rails

Po zainstalowaniu Rails mona uy polecenia rails do gene-

rowania nowych aplikacji Rails z domyln struktur katalogów

oraz konfiguracj dla okrelonej cieki.

By utworzy aplikacj Rails o nazwie myapp , naley wpisa:

rails myapp

Po wykonaniu tego polecenia zobaczymy list katalogów oraz

plików wygenerowanych przez nie. To nasza aplikacja Rails;

myapp bdzie folderem gównym, inaczej RAILS ROOT.

Uycie oraz opcje

Pomoc dla polecenia rails mona uzyska za pomoc:

rails --help

Uycie

rails [ /cieka/do/aplikacji ][ opcje ]

Opcje

-r, --ruby= cieka

cieka do wybranych plików binarnych jzyka Ruby.

-d, --database= nazwa

Konfiguracja dla okrelonej bazy danych (na przykad mysql ,

oracle , postgresql , sqlite2 , sqlite3 ).

-f, --freeze

Zamroenie Rails w katalogu vendor/rails z gemów ge-

nerujcych szkielet.

-v, --version

Pokazuje numer wersji Rails i koczy dziaanie.

Rails. Leksykon kieszonkowy

-p, --pretend

Jest wykonywane, ale nie wprowadza adnych zmian.

--force

Nadpisuje istniejce pliki.

-s, --skip

Pomija istniejce pliki.

-q, --quiet

Blokuje wywietlanie normalnych danych wyjciowych.

-t, --backtrace

Debugowanie; w przypadku bdów pokazuje lad wyko-

nanych czynnoci.

-c, --svn

Modyfikuje pliki z uyciem Subversion ( svn musi by w ciece).

Struktura plików Rails

Po wygenerowaniu aplikacji Rails utworzone zostaj domylny

katalog oraz struktura plików (tabela 1.1).

Tabela 1.1. Struktura plików aplikacji Rails

cieka

Opis

app

Przechowuje kod specyficzny dla okrelonej aplikacji.

app/controllers

Przechowuje kontrolery, które dla automatycznego

odwzorowania adresów URL powinny mie nazwy takie jak

user_controller.rb . Wszystkie kontrolery powinny pochodzi

od ApplicationController , który z kolei pochodzi

od ActionController::Base.

app/models

Przechowuje modele, które powinny nosi nazwy takie jak product.rb .

Wikszo modeli pochodzi od ActiveRecord::Base .

app/views

Przechowuje pliki szablonów dla widoków. Powinny one nosi

ustandaryzowane nazwy, takie jak users/index.html.erb

w przypadku akcji UsersController index . Wszystkie

widoki wykorzystuj skadni eRuby.

Polecenia oraz konfiguracja Rails

Tabela 1.1. Struktura plików aplikacji Rails — cig dalszy

cieka

Opis

app/views/

layouts

Przechowuje pliki szablonów dla ukadów dokumentów, jakie maj

by wykorzystane z widokami. Przypomina to metod wspólnego

nagówka czy stopki opakowujcych widoki. W widokach definiuje

si ukad dokumentu za pomoc ukadu :default i tworzy plik

o nazwie default.html.erb . Wewntrz default.html.erb wywouje si

<%= yield %> w celu wygenerowania widoku z uyciem

okrelonego ukadu dokumentu.

app/helpers

Przechowuje metody pomocnicze, które powinny nosi nazwy

takie jak users_helper.rb . S one generowane automatycznie, kiedy

dla kontrolerów wykorzystuje si polecenie script/generate .

Metody pomocnicze mona wykorzysta do opakowania

funkcjonalnoci przeznaczonej dla widoków w metody.

config

Pliki konfiguracyjne dla rodowiska Rails, mapy tras, bazy danych

oraz innych zalenoci.

Zawiera schemat bazy danych znajdujcy si w schema.rb.db/

migrate . Zawiera wszystkie sekwencje migracji dla schematu.

doc

W tym katalogu przechowywana bdzie dokumentacja aplikacji

po jej wygenerowaniu za pomoc rake doc:app.

lib

Biblioteki specyficzne dla aplikacji. Tak naprawd kady rodzaj

wasnego kodu, który nie jest kontrolerem, modelem ani metod

pomocnicz. Katalog ten znajduje si w ciece adowania.

public

Katalog dostpny dla serwera WWW. Zawiera podkatalogi

przeznaczone dla obrazków, arkuszy stylów oraz skryptów JavaScript.

Zawiera równie dyspozytor (ang. dispatcher ) i domylne pliki HTML.

Powinien by ustawiony jako DOCUMENT ROOT serwera WWW.

script

Skrypty pomocnicze suce do automatyzacji oraz generacji.

test

Testy jednostkowe oraz funkcjonalne wraz z fiksturami. Kiedy

wykorzystuje si skrypty script/generate , pliki szablonów

testów zostaj dla nas wygenerowane i umieszczone w tym katalogu.

vendor

Biblioteki zewntrzne, od których uzaleniona jest nasza

aplikacja. Zawiera równie podkatalog plugins . Katalog ten

znajduje si w ciece adowania.

Rails. Leksykon kieszonkowy

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika: