JAX-RS (@ApplicationPath,@Path,@PathParam)

     Bu yazımızda kendi rest servislerimizi java ile nasıl kodlayacağımızı öğreneceğiz.İlk projemiz olduğu için herşeyi göstermek istiyorum.

    Java da iki tür web servis bulunur.

1)JAX-RS (JAVA API FOR RESTful SERVICES)
2)JAX-WS(JAVA API FOR XML WEB SERVICES)

Bizler RESTful web servisleri yazacağızBu servislerimiz  yazarken kullanabileceğimiz kütüphaneler ise

1)Jersey
2)RESTEasy
3)ApacheCXF
4)Restlet

Bizler rest servislerimizi yazarken Jersey kütüphanesinden faydalanacağız.İleride diğer kütüphaneleri de kullanıp hangisinin nerede daha avantajlı olduğuna hep birlikte karar vereceğiz.Hadi başlayalım.


    Projelerimizi Apache Maven kullanarak yazacağız.İleride birçok kütüphane kullanacağız ve bu kütüphaneleri tek tek indirip projemize jar dosyası olarak eklemek yerine, eklemek istediğimiz kütühanenin bağımlılığını (dependencies) buradan bulup pom.xml dosyasına ekleyeceğiz .Maven bu kütüphaneleri projemize ekleyecek.Daha sonra bir web servisi yazdığımız için bir server'a ihtiyacımız var.Herhangi bir local server işinizi görecektir.Ben payara server kullanıyorum.Ben projelerimi NetBeans üzerinde geliştiriyorum.Sizler Eclipse,Intellij,NetBeans veya dilediğiniz bir IDE üzerinde geliştirebilirsiniz.

İlk olarak bir maven web application oluşturuyoruz.

Projemize isim verip hangi server üzerinde çalışacağını belirledikten sonra projemizi oluşturmuş oluyoruz.

      

Daha sonra Project Files klasöründe bulunan pom.xml dosyasına Jersey bağımlılıklarını ekliyoruz.

ApplicationConfig adında bir java sınıfı oluşturuyoruz.Bu sınıf yazdığımız servisin yolunu gösterecek ve yazdığımız servisi buradan kontrol edeceğiz.Birden fazla web servisi yazmanız gerekiyor olabilir ve bu servisler birbiri ile bağlantı halinde olabilir.Bu sınıfımızda @ApplicationPath ek açıklamasını(annotation) kullanacağız.Burada bizim root path'imiz bulunacak ve Application sınıfını extend etmeliyiz.Bu şekilde...

Bu aşamadan sonra web servisimizi yazmaya başlayabiliriz.Burada dikkat etmenizi istediğim yerler olacak.Bunlardan ilk'i servisimizin yaptığı işi path'ler ile yazarken isimlendirmeye çok dikkat etmeniz.Bu isimlendirmeleri yaparken örneğin http://localhost:8080/api/orders tüm siparişleri göstermesi.http://localhost:8080/api/orders/{orderId}(buraya herhangi bir id değeri gelecek) dediğinde ise girilen id numarasına ait sipariş gelmelidir.Anlatmak istediğim şey siz RESTful ile bir web servisi yazacağınızda bu servisi kullanacak olan insanın herhangi bir dokümantasyon olmadan çok rahat bir şekilde kullanabilmesi gerekiyor.Bu yüzden isimlendirmelere çok dikkat etmeliyiz.Şimdi servisimizi yazmaya başlayalım.Başlangıç olarak böyle bir servis yazalım.http://localhost:8080/api/me/gokhan dediğimizde bize cevap olarak Hoşgeldin GOKHAN desin.Hadi başlayalım.ApplicationConfig sınıfının bulunduğu package'a MerhabaService adında bir sınıf oluşturalım.Sınıfımızı oluşturduktan sonra @Path("/me") açıklamasıyla sınıfımızın yolunu belirliyoruz.Bu aşamadan sonra fonksiyonlarımızı yazmaya başlayacağız.Bir önceki yazımızda HTTP request metodlarından bahsetmiştik.Şimdilik sadece @GET açıklamasını kullanacağız.String değer döndüren getMerhaba adında bir fonksiyon yazalım.Bu fonksiyona @GET methodu ile erişilecek ve @Path("/{name}") kullanıcı tarafından girilecek.Sınıfımızın yolunu belirlerken herhangi birşey kullanmadığımız için GET isteğinde direkt me diye geçmeli
http://localhost:8080/api/me/kullanıcı-tarafından-girilen-isim daha sonra fonksiyonumuz Merhaba girilen isim şeklinde bir değer döndüreceği için bu değeri parametre olarak almamız gerekiyor bunun içinde @PathParam("name") açıklmasını kullanıyoruz.Geriye aldığımız string değerini toUpperCase() fonksiyonuyla büyütüp döndürmek.





İYİ ÇALIŞMALAR


UYGULAMALI JAVASCRIPT-2

   Arkadaşlar merhaba.JavaScript dünyasını  tanımaya devam ediyoruz.Anlamadığınız yer olursa (yorum olarak) sorabilirsiniz.

<!DOCTYPE html>
<!--
To change this license header, choose License Headers in Project Properties.
To change this template file, choose Tools | Templates
and open the template in the editor.
-->
<html>
    <head>
    <title>Project-2</title>
    <script>
        var scope="global scope";
        function checkscope(){
           var scope="local scope";
            function nested(){
                var scope="nested scope";
                return scope;
        }
        return nested();
    }
        document.write("1- "+checkscope()+"|||");
       //--------------------------------------
        function test(o){
            var i=0;
            if(typeof o=="object"){
                var j=0;
                for(var k=0;k<10;k++){
                    document.write(k);
                }
                   document.write(k);
               
            }
            document.write(j+"|||");//undefined !
        }
       
        test("object");
        //---------------------------------
       
        var a=[1,2,3,4];
        for(var i=0;i<a.length;i++)document.write(a[i]);document.write("|||"+a.length+"|||");
        delete a[3];
        a[4]=5;
        for(var i=0;i<a.length;i++)document.write(a[i]);document.write("|||"+a.length+"|||");
        //----------------------------------
        try{
          sadfasdfasd
        }catch(ex){document.write("|||ERROR!!!");}
        finally{
            document.write("|||Kodlamak Guzel...|||");
        }
        //--------------------------------------------
       
        //Bu özelliği çok kullanışlı.JavaScript cahili olduğum için
        //bunu bilmiyordum :) neyse bilmemek ayıp değil öğrenmemek ayıptır...
        var book={
                "man title":"JavaScript",
                'sub-title':"The Definitive Guide (source :) )",
                "for" : "all audiences",
                author : {
                    firstname:"David",
                    surname:"Flanagan"
                }
        }
        var name=book.author.firstname;
        var title=book["man title"];
        document.write(name+"|||"+title+"|||");
        //------------------------------------------------
        var customer=[1,2,3,4];
        var addr = "";
        for(i = 0; i < 4; i++) {
            addr += customer["address" + i] + '\n';
        }
        //-------------------------------------------------
        //inheritance
        var o={};
        o.x=1;
        var p=inherit(o);
        p.y=2;
        var q=inherit(p);
        q.z=3;
        var s=q.toString();
        //-------------------------------------------------
        var o = { x: 1 }
        o.hasOwnProperty("x");//true
        o.hasOwnProperty("y");//false
        o.hasOwnProperty("toString");//false
        //--------------------------------------------------
        function keys(o){
                if(typeof o!="object") throw TypeError();
                var result=[];
               
                for(var prop in o){
                    if(o.hasOwnProperty(prop))
                        result.push(prop);
                }
                return result;
        }
        //--------------------------------------------------
        //getter && setter
        var random={
            set octet(n){this.n=n;},
            get octet(){return Math.floor(Math.random()*366);}
        }      
    </script>
   
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
</head>
<body>

</body>
</html>


//Çıktımız

REST MİMARİSİ VE RESTful WEB SERVİSLERİ

     REST (Representational State Transfer) Türkçe anlamıyla Temsili Durum Transferi olarak adlandırılan,web protokolleri ve teknolojilerini kullanan bir dağıtık sistemdir.Peki dağıtık sistem nedir ? Dağıtık sistem,bilgisayarın veya sunucuların birbirleriyle bir bütün olarak çalışmalarına denir.REST,bir veri transfer yöntemidir.HTTP üzerinden çalışan REST,basit sorgular ile verilere kolay erişim sağlamakla beraber hızlıdır.REST,bu verileri XML veya JSON formatında taşır.Çoğu zaman JSON tercih edilir.Bunun nedeni JSON'un XML'e göre insanlar tarafından daha basit okunabilmesi ve verileri daha küçük boyutlarda tutabilmesidir.


   RESTful web servisleri ise REST standartlarına uygun olarak yazılan web servislerine denir.Bu yazımızdan sonra JAX-RS ile kendi web servislerimizi nasıl yazacağımızı öğreneceğiz.REST standartlarına uygun yazılan web servislerine RESTful demiştik.Peki nedir bu web servisleri ? Web servisleri,HTTP protokolü ile hizmet veren uygulamalardır.Yazılan metodlar bir sunucu üzerinde çalıştırıldıktan sonra bir response mesajı üretir.Yani siz bir request mesajına karşılık bir response mesajı alırsınız.Biz bu servisleri yazarken istemcinin verilere hızlı ve kolay bir şekilde ulaşmasını sağlarız.Örnek olarak ben size RESTful bir web servisi yazarım.Bu servis size güncel hava durumu bilgilerini  sunar.Sizde yaptığınız HTTP request mesajları ile bu verileri anlık olarak çekersiniz.4 tip HTTP istek metodu vardır.Bunlar GET,POST,PUT ve DELETE.RESTful servislerde 


  1. GET=veri getirme
  2. POST=veri ekleme
  3. PUT=veri güncelleme
  4. DELETE=veri silme 
olarak kullanılır.Siz bu isteklerden birini yaparsınız ve size bir response mesajı döner ve bu response mesajlarının birer durum kodu olur.Bu durum kodları ise client'ı bilgilendirmek içindir.HTTP durum kodlarını buradan inceleyebilirsiniz.Wireshark uygulaması ile HTTP request ve response paketlerinin yapılarını şekilde görüldüğü gibidir.

       Elimizde kan bağışı yapmak isteyen insanların bulunduğu bir veritabanımızın olduğunu varsayalım.Bu bilgilerin bir RESTful web servisi ile erişime açık olduğunu varsayalım.Biz bu servise yapacağımız bir HTTP isteği ile kan bağışçılarının isimlerini çekebiliriz.Bu bağışçılara yenilerini ekleyebilir,silebilir veya güncelleyebilir.Örneğin bu şekilde yapılan bir istek
"GET/bagisci/3" (URI-Uniform Resource Identifier) şekilinde 3 numaralı id'ye sahip bağışçının bilgilerini getirir veya GET/bagisci?sehir=Ankara(QueryString) gibi bir sorgu Ankarada bulunan bağışçıların listesini getirir.Gördüğünüz gibi çok esnek,genişletilebilir,rahat ve hızlı bir kullanıma sahip.REST ve RESTful kavramlarını kısaca öğrenmiş olduk.



İYİ ÇALIŞMALAR...












UYGULAMALI JAVASCRIPT-1

       Herkese merhaba.Bu yazımızda javascript'e çok hızlı bir giriş yapacağız.Değişkenler,bazı kütüphanelerinin fonksiyonlarının kullanımı,döngüler,diziler vb.İlk yazılarımı bu şekilde,bir projenin içinde,birçok şeyi öğrenebileceğimiz gibi yapmak istedim.Buyrun ilkine bir göz atın.Bir önceki yazımızda da belirttiğim gibi bir programlama dilini orta düzeyde biliyorsanız,aşağıdaki kodları çok rahat anlayacaksınızdır.

<!DOCTYPE html>
<html>
    <head>
    <title>
           JAVASCRIPT-1
    </title>
    <script>
        function deneme(){
            return true;
        }
        var a=Math.sqrt(16);
        var b=Math.random();//0,1 arası bir sayi seçiyor.. Örneğin 0.243563
        var c=Math.pow(3,3);
        b=(b*100)%10;
        var d=new Date(2010,0,1,13,09,70);
        var e="Hello World";
       
        var f="Black";
        var k="15";
        var sayi=parseInt(k);
        var yeniDeger=5+sayi;
        var o={x:1};
        o.x=4;
        o.y=3;
        var a=[1,2,3,4,5];
        a[0]=4;
        a[5]=1; //diziye yeni bir değer ekler.Javada hata !
       
        var i=10;
        i="ten"; // :) Bu yanını çok seviyorum.PHP'de de aynı şekilde :) bence
                 //tüm dillerde olması gereken bir özellik :)
       
        if((a==4 && b>=5) || (a!=2 && b==3)){
            f="White";
        }
        else if(a!=4)
            f="Black & White";
       
        for(var i=0;i<4;i++){
            a--;
        }
       
        while(b>0){
            //...
        }
        do{
            if(c<=0)
                break;
                   // ...
        }while(c>=0)
       
        document.write("a:"+a+"|b:"+Math.ceil(b)+"|c:"+c+"|dsaat :"+d.getHours()+" |dsaniye:"+d.getSeconds()+" |e0:"+e.charAt(0)+"|ebuyut:"+e.toUpperCase()+"|efontColor:"+e.fontcolor()+"

|eRepeat"+e.repeat(2)+"|f:"+f+"|denemeFunction:"+deneme()+"
|parseYeniDeger"+yeniDeger);
    </script>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
</head>

<body>
<!--<button onclick="alert('Thank you')">Click Me</button>-->
</body>
</html>


//Çıktımızda bu şekilde




     İYİ ÇALIŞMALAR...

JAVASCRIPT DÜNYASINA İLK ADIM

JAVASCRIPT'E GİRİŞ
      Herkese iyi çalışmalar.Bugünden başlayarak,bir hafta içerisinde bir programlama dilini orta düzeyde bildiğinizi varsayarak birsürü örnek paylaşmaya çalışacağım.Böylece javascript'e hızlı uyum sağlayacak ve frameworklerini kullanarak web projelerimize güç katacağız.Bu örneklerin yeterli olduğunu düşündüğümde ise javascript'in heryerde duyabileceğiniz o meşhur frameworkler'i ile çalışacağız.Bu paylaşımlarıma başlarken,javascript hakkında çok az bir bilgim olduğunu belirtmek isterim.İlk yazımızda JavaScript'in ne olduğuna bir göz atalım.

JAVASCRIPT NEDİR ?
      JavaScript,web tarayıcılarında kullanılmakta olan dinamik bir programlama dilidir.JavaScript'i HTML kodlarımıza gömeriz.Web sitemizin daha dinamik ve daha güzel görünmesini sağlarız.JavaScript client tarafından yorumlanır,örneğin bir web browser.Daha sonra sunucu tarafında çalışan node js'ye de değineceğiz.Değişkenleri tiplerine göre ayırmaz(int,string vb).JavaScript'i <script>.......</script> taglar'ı arasına yazabiliriz veya başka bir dosyada yazdığımız javascript kodunu projemize dahil edebiliriz. 

<script type="text/javascript" src="code.js"></script>

JavaScript'in ne olduğunu kısaca öğrenmiş olduk.Bir sonraki yazımızdan itibaren uygulamalarımıza başlayıp hızlı bir şekilde uyum sağlamaya,programlama gücümüze güç katacak frameworkleri kullanmaya başlayacağız.



İyi çalışmalar...

















Spring Boot Uygulamasını Heroku üzerinde Deploy Etme

Bu yazımızda sizlere spring boot ile yazılmış basit bir Rest api'nin heroku üzerinde nasıl deploy edebileceğimizi göstereceğim. Önce ...