Tarih : 20-10-2009 | Yazan : Hüseyin Bora | Kategori : Faces ORM, PHP, PHP ORM
Varlık sınıflarını kendiniz yazmak zorunda değilsiniz siz sadece veritabanınızı tasarlayın bu program varlık sınıflarını sizin için oluşturacaktır. Ancak tablolar arasıdaki ilişkileri tablolarınızı oluştururken tanımlayım bu program ilişkileri tanır.
http://php-faces.googlecode.com/files/generator.zip programı bu adresten indirebilirsinin unutmadan programın çalışabilmesi için sisteminizde JVM bulunmalı! generator.jar isimli dosyayı çalıştırdığınızda kaşınıza aşağıdaki gibi bir pencere gelecek buradan gerekli ayarlamaları yapıp generate butonuna basın ve varlık sınıflarının kayıt edileceği dizini secin. Bundan sonra PHP faces entity generator programının sizin için nasıl PHP kodladığını görün.
PHP ORM Faces ORM nedir? İlişkisel Nesne Eşleştirme (Object Relation Mapping) basit bir anlatımla veritabanındaki tablolara karşılık gelen sınıflar ve bu sınıfların özelliklerine göre SQL cümleleri üretebilen bir yazılım mimarisidir diyebiliriz.
Tablolarımıza karşılık gelen bu sınıflara genel anlamda Varlık(Entity) sınıfları adını veriyoruz. Nesne yönelimli programlamada her şey birer nesne olarak düşünülmeli O halde veri tabanındaki işlemlerimizde nesneler olarak düşünmeliyiz. İşte burada ORM bize veritabanındaki tablolarımızı nesneleştirmemizi ve CRUD(create, read, update, delete) işlemlerimizi bir nevi basitleştirmemizi sağlamakta.
Örnek vermek gerekirse veritabanımızda urun adında bir tablo olduğunu ve urun tablosu için PHP tarafında Urun adında bir varlık sınıfımızın olduğunu varsayalım. Veri tabanındaki urun tablosuna yeni bir urun eklemek için
$urun = new Urun();
$urun->adi=”CPU”
$urun->fiyat=”124”;
$urun->save();
PHP Faces ORM yapısından faydalana bilmeniz için PHP PDO eklentisini aktif durumda olmalı.
PDO eklentisini php.ini dosyasından aktif duruma getirebilirsiniz. windows işletim sistemi için uzantılar. dll şeklinde olacak şekilde ayarlanmalı.
Ayrıca PHP Faces ORM yı tek başına yani Faces frameworkten bağımsız bir şekilde de kullanabilirsiniz bu makalede yazılanları hem framework dâhilinde hemde sadece orm kullanarak gerçekleştirebilirsiniz.
PHP Faces ORM katmanının frameworkten ayrılmış hali için indirme bağlantısı aşağıda hemen zip dosyalarını çıkarıp çalışmaya başlayabilirsiniz.
Varlık sınıfları
Veritabanındaki tablolarınıza karşılık gelen varlık sınıfları Entity sınıfından genişletilir.
Tablonuzu varlık sınıfı ile eşleştirirken Açıklama Notu (Annotation) kullanırsınız bu hem kodunuzun okunabilirliğini sağlar hem de XML gibi başka bir dosyadan okumanın maliyetine katlanmaz kısacası XML ile eşlemeden daha verimlidir diyebiliriz.
Açıklama Notları ile Sınıfları eşleştirmek
PHP de Annotation kavramı henüz yerleşmemesine karşın Reflicaiton ile açıklama notları kullanılabilir.
Annotationlar açıklama satırları arasına @ et işareti kullanmak sureti ile oluşturulur.
Örneğin PHP Faces ORM da tablonuz ile sınıfınızı eşlemek için sınıf tanımlamasının üzerine @table notu eklenir. @Table notunun kullanımı aşağıdaki gibidir.
Yukarıdaki açıklama satırı ile Urun sınıfını veritabanındaki urun tablosuyla eşleştirmiş olduk.
Veritabanındaki tabloların sütunları ile varlık sınıflarının private üyeleri eşleşebilir sütunlar ile sınıf üyelerinin eşleşmesini sağlamak için sınıf üyesinin tanımlandığı yerin üzerine @Column notu eklenerek kullanılır. Örneğin ürün tablosunda id, fiyat, ad sütunları bulunduğunu varsayarak.
Varlık sınıfımıza bulunması gereken iki önemli metot vardır get ve set metotları. Bu metotların eklenme sebebi ORM Update gibi SQL cümleleri oluştururken hangi bilgilin değiştirildiğini bilmek zorunda olmasıdır. Örneğin sadece adını değiştirdiğimiz bir ürünün id ve fiyat sütunlarının güncellenmemesi gerekmektedir. Kısacası ORM Hangi Sınıfların hangi alanlarının update edilmesi gerektiğini anlamalıdır. Gereksiz güncellemelerle sistemi yormamalıdır.
Get ve Set metodları aşağıdaki sınıf içerisindeki gibi kullanılabilir.
/**
* @Table(name ="urun")
*/class Urun extends Entity{/**
@Column(name ="id")
*/
private $no;
/**
@Column(name ="fiyat")
*/
private $fiyat;
/**
@Column(name ="ad")
*/
private $adi;
public function set($name, $value){$this->$name= $value;}
public function get($name){
return $this->$name;}}
Birincil anahtar eşleştirmesi@Id notunun eşleşecek olan sınıf üyesinin tanımlandığı yerin üzerine yazılması sureti ile gerçekleştirilir. Urun @Id notu eklenmiş son hali aşağıdaki aşağıda ki gibi olacaktır
/**
* @Table(name ="urun")
*/class Urun extends Entity{/**
@Id
@Column(name ="id")
*/
private $no;
/**
@Column(name ="fiyat")
*/
private $fiyat;
/**
@Column(name ="ad")
*/
private $adi;
public function set($name, $value){$this->$name= $value;}
public function get($name){
return $this->$name;}}
Basitlik olması adına bu örneğimizi PHP Faces framework haricinde uygulama yolunu seçiyorum dilerseniz bu örnekleri bir controller içerisinde de uygulayabilirsiniz.
Veri tabanı ile bağlantının yapılandırılması
http://php-orm-persistence.googlecode.com/files/php-orm.zip adresinden indirdiğiniz klasör içerisindeki config.php dosyasını düzenlemek üzere bir editor yardımı ile açıyoruz. Ve aşağıdaki satırları kendi veritabanı yapılandırmamıza göre değiştiriyoruz.
define("DB_CONNECTION_STRING","mysql:host=localhost;dbname=veritabaniadi");//sunucunuz ve veritabanı adı
define("DB_USER","root");//veritabanı kullanıcı adı
define("DB_PASS","abc345");//veri tabanı parolası
define("DB_CONNECTOR","PDO");//bu satırı değiştirmeyin
>require_once "facespersistence/persistence.php";// PHP ORM Persistence kütüphanesi
Şimdi yeni bir php dosyası içerisine index.php olabilir yukarıda oluşturduğumuz Urun varlık sınıfını içeren urun.php ve config.php dosyalarını dahil ediyoruz.
PHP Faces varlık sınıflarını yönetebilmemiz için EntityManager adında bir sınıf sunmakta sorgulama kaydetme, silme gibi tüm işlemlerimizi bu sınıf yardımı ile gerçekleştiriyoruz. EntityManager’ın örneğini elde etmek için static getInstance metodunu kullanabilirsiniz.
EnitityManeger’ın find metodu parametre olarak varlık sınıfı adi ve varlık sınıfını tanımlarken @Id ile tanımladığımız birincil anahtar değerlerini kabul eder. Veritabanında verilen değerle göre sorgulama yapar sorgulama sonucu bir kayıt bulunursa birinci parametre olarak verilen sınıf isminde veritabanındaki verilerle eşleşen bir nesne döndürür.
Örnek
Urun tablosundan bir kayıt seçmek ve seçilen kayıt’ı güncelleştirmek
Hem yeni bir kayıt eklemek hem de var olan bir kayıt’ı güncellemek için save metodunun kullanılması sizi şaşırtmasın ORM hangi kayıtın veri tabanından depolandığının bilincindedir.
Faces Orm da Varlık sınıfları arasında ilişkiler
Varlık sınıfları arasındaki ilişkiler veritabanını tasarlarken yaptığınız ilişkilendirmelere benzer Varlık sınıflarında tanımladığınız ilişkilerin tablolarda bulunması da gerekmez.
PHP faces daki 4 adet ilişkisel annotation vardır
@OneToOne (bire bir)
@OneToMany (bire çok)
@ManyToOne (bir çok a bir)
@ManyToMany (bir çok a bir çok)
Yukarıdaki dört annotationnında üç adet parametreleri bulunmaktadır
mappedBy = “Sınıf adı”
pk = ” birincil anahtar ”
fk = ” yabancı anahtar”
Urun tablomuzda yorumlar adında bir tabloya bir e çok ilişki bulunduğunu ve yorumlar adında da bir varlık sınıfımızın olduğunu varsayalım.
bire çok ve birçok a birçok ilişkilerde çok olan taraf bir ArrayObject olarak tanımlanmalıdır.
Yukarıdaki Tek bir save satırı veritabanında 3 SQL cümlesi işletilir Yukarıda bahsettiğim gibi ORM hangi sınıfların veritabanından hangi sınıfların dışarıdan oluşturulduğunu algılayabilme kabiliyetine sahip olmalıdır. Sonuçda urun nesnesi için update, urun sınıfın new ile oluşturulmuş her bir yorum nesnesi için insert cümleleri oluşturulur ve işletilir.
Yorumları aşağıdaki gibi listeleyebiliriz
Foreach($urun->yorumlar as $oku)
Echo $oku->yorum;
Yorum sınıfı urun sınıfın üyesi Urun sınıfı da yorum sınıfının üyesidir yorum nesnelerinden de urun’e ulaşılabilir. Tüm ilişkili varlık sınıfı nesneleri birbiriyle öz yinelemeli bir tekrar içindedirler ve bir birlerinin örneklerini referans olarak barındırırlar
Tarih : 16-10-2009 | Yazan : Hüseyin Bora | Kategori : Faces ORM, PHP, PHP ORM
PHP ORM
PHP Faces ORM tek başına kullanabilirsiniz bunun için öncelikle aşağıdaki adresten ORM çatısını indirin. İlgili dosyaları bir dizine çıkarın ve kullanacağınız sunucuya taşıyın.
Faces ORM ile birlikte importmodels(”models”); fonksiyonu gelmekte aşağıdaki örneği inceleyin.
require_once "config.php";
importmodels("models");
$session = EntityManager::getInstance();
$query =$session->createQuery("select u from Urun u where u.no=10");
$query->execute();
$urunler =$query->getSingle();echo"<pre>";print_r($urunler);echo"</pre>";
$urun = new Urun();
$elma->ad="Elma";
$elma->fiyat="11.23";
$session->save($elma);
Doğrulayıcı(Validator) sınıfları durağan(static) metotları kullanan sınıflardır. işlerinizi kolaylaştırması ve yazılımın bütünleşik parçalar halinde kolektif bir yapıda çalışmasına olanak sağlar.
Bir doğrulama metodunun tanımlaması aşağıdaki gibidir
static function required(Component $c,Component $m,$message,$success)
Birinci parametre “Component $c” doğrulama işleminin yapıldığı bileşen
İkinci parametre “Component $m” mesajların yazdırılacağı bileşen
Üçüncü parametre uyarı mesajı
Dördüncü parametre doğrulama mesajı
Örneğin yeni üye kaydı için bir üye kayıt formumuzun olduğunu ve aynı ismi taşıyabilecek sadece bir üye olduğunu düşünelim.
Bunun için Uyekontrol adında bir sınıf oluşturup varmi ismini taşıyan bir doğrulama metodu ekliyorum
class uyekontrol
{
static function varmi(Component $c,Component $m,$message,$success){
$sorgu = EntityManager::getInstance()->createQuery("select u from uyeler u where uye.adi =:uyead");
$sorgu->bindParam("uyeadi", $c->getText);
$sorgu->execute();
$sonuc =$sorgu->getSingle();
if($sonuc!=null){
$m->setText($message);
return >true;}
$m->setText($success);
return >true;}}
Şimdi oluşturduğumuz doğrulama sınıfını view (görünüm) içerisinde kullanalım
<faces><@import prefix="f" taglib="phpf.ui.*"/><f:form method="post" name="uyeform">
Uye adi :<f:textbox
name="uyeadi"
validator="uyekontrol"
rule="varmi"
success="Uye adi doğrulandı "
message=" Daha önce bu isimde bir üye kayıt olmuş farklı bir isim deneyin! "
messagefor="msgbox"
/><f:message id="msgbox"/><f:button name="kaydet" text="Gönder" onclick="actionevent" forname="uyeform"/></f:form></faces>
Validador sınıfımızı controller içerisinde import ediyoruz
import("phpf.controllers.facete");
import("dbf.persistence");
import("dogrulayicilar.uyekontrol",true);//uygulama dizini
class Controller extends Facete{function Controller(){
parent::Facete();$this->render("uyekayit.phpf");}function kaydetClicked($evt){
$uye = new uye();
$uye->adi =$this->uyeadi->text;
$uye->save();}}
Tarih : 10-09-2009 | Yazan : Hüseyin Bora | Kategori : Faces ORM, PHP Faces
FQL varlık nesneleri üzerinde sorgulama yapmanıza olanak tanıyan SQL e benzer bir sorgulama dilidir. FQL Sorguları PHP Faces Framework tarfından doğal SQL sözcüklerine dönüştürülür.
SELECT İfadesi
SELECT takmaisim FROM sıfıfadıtakmaisim WHERE having vb..
Örnekler
SELECT b fromBlog b
SELECT c fromCategories c
SELECT b fromBlog b WHERE bi.id =1
SELECT b fromBlog b WHERE bi.id =1and b.name=‘www’
SELECT b fromBlog b limit 0,5
SELECT c fromCategories c GROUP BY c.id HAVING AVG(c.id)>1
entity manager ile beraber FQL kullanımı
$query=$this->em->createQuery("SELECT b from Blog b WHERE b.comment.id >1");
$query->execute();
$blogs = $query->getResultList();
FQL ile birlikte SQL fonksiyonları kullanımı
SELECT COUNT(b.id) FROM Blog b
SELECT MAX(b.id) FROM Blog b
entity manager ile beraber kullanımı
$query=$this->em->createQuery("SELECT count(b.id) from bir b");
$query->execute();echo"count=".$query->getSingle()."<br>";
