Java JAX-RS ile HTTP POST, GET, QueryParam, PathParam

Merhaba arkadaşlar bu yazıda JAX-RS ile HTTP POST, GET, QueryParam ve PathParam kullanımlarını inceleyeceğiz. Bir önceki yazıda JAX-RS API ile ilgili giriş bilgileri verilmiştir.

29.09.2014

Yazar: Batuhan Düzgün (Google+)

Kategori: Java

3984

Merhaba arkadaşlar bu yazıda JAX-RS ile HTTP POST, GET, QueryParam ve PathParam kullanımlarını inceleyeceğiz. Bir önceki yazıda JAX-RS API ile ilgili giriş bilgileri verilmiştir.

Giriş

JAX-RS API ile birlikte HTTP protokolünün sunduğu imkanlardan yararlanıp REST servisleri yazılabilir. Yapılacak olan uygulamada POST ve GET yöntemleriyle HTTP istekleri dair örnekler yapılacaktır. Ayrıca “QueryParam” ve “PathParam” örnekleri ile URL üzerinden veri aktarımı anlatılacaktır.

Eclipse IDE Dynamic Web Project Oluşturulması

Eclipse IDE üzerinden Dynamic Web Project oluşturulur. JAX-RS implementasyonu olan Jersey API’ye ait JAR dosyaları “WEB-INF” altındaki lib klasörüne eklenir. Bu JAR dosyaları “Web App Libraries” altına otomatik olarak eklenir.

HTTP GET Yöntemiyle PathParam Kullanımı

“PathParam” ile URL üzerinde “Path” ifadesinde belirtilen anahtar kelime yerine çeşitli verileri gönderebilmeyi sağlar.

// Path etiketi icinde anahtar kelime { } parantezleri arasina yazilir.
	@Path("/{userName}")
	@GET
	@Produces(MediaType.TEXT_PLAIN)
	// PathParam etiketindeki anahtar kelime Path etiketiyle ayni olmalidir.
	public String getHelloFromSummerProject(@PathParam("userName") String userName) {
		
		//URL uzerinden PathParam vasitasiyla gonderilen veri burada kontrol edilecektir.
		//Gelen veriye gore ilgili mesaj cevap olarak geri dondurulur.
		if(userName.equals("batux") == true) {
			return "The founder of Summer Framework Project !";
		}
		else if(userName.equals("fatix") == true) {
			return "The Project Manager of Summer Mobile Framework !";
		}
		else {
			return "The Developer of Summer Framework !";
		}
		
	}

HTTP GET ile Kayıt Listesi

Bu kod parçasında liste halindeki veri HTTP GET yöntemiyle birlikte karakter katarı (String) olarak döndürülecektir.

// HTTP URL uzerinde kayit listesini alabilmek icin 'GetAllNames' seklinde bir URL pattern girmelidir.
	@Path("/GetAllNames")
	// Hangi HTTP yonteminin kullanilacagi belirtilir. GET yonetimi kullanilir.
	@GET
	@Produces("application/json")
	public String getAllNames() {
		
		if(clubs == null) {
			clubs = new ArrayList<String>();
			clubs.add("Batuhan");
			clubs.add("Cansu");
			clubs.add("Barkin");
			clubs.add("Zeynep");
			clubs.add("Fuat");
		}
		return clubs.toString();
	}

HTTP GET QueryParam Kullanımı

HTTP GET yöntemi kullanıldığında URL üzerinden veri taşıması yapılabilir. İşte URL üzerinden veri gönderimini sağlayan yapı “QueryParam” ifadesidir. “DefaultValue” etiketi ise ilgili parametreye değer atanmaması üzerine varsayılan bir veri ataması yapar.

@Path("/GetFilteredNames")
	@GET
	@Produces(MediaType.TEXT_PLAIN)
	//'DefaultValue' etiketi ile 'name' isimli sorgu parametresinin degeri bos gecilmis olursa diye varsayilan bir deger belirtilir.
	//'QueryParam' ifadesi ile birlikte HTTP GET ile gecilebilecek parametre ismi verilir. 
	public String getFilteredName(@DefaultValue("Batuhan") @QueryParam("name") String username) {
		
		if(clubs == null) {
			clubs = new ArrayList<String>();
			clubs.add("Batuhan");
			clubs.add("Cansu");
			clubs.add("Barkin");
			clubs.add("Zeynep");
			clubs.add("Fuat");
		}
		
		//HTTP GET yontemiyle sorgulanmak uzere gonderilen veri liste icinde aranir.
		//Sorgu sonucunda bulunan kayit dondurulur veya yok ise uygun bir mesaj dondurulur.
		String foundName = "Not found your name in list !";
		for (Iterator<String> iterator = clubs.iterator(); iterator.hasNext();) {
			String name = iterator.next();
			if(name.equals(username)) {
				foundName = name;
				break;
			}
		}
		return foundName;
	}

HTTP POST Yöntemi Kullanımı

HTTP POST yönteminde URL üzerinden parametre ile gönderim yapılamaz. HTTP POST yöntemi HTML formlardan veri gönderimi yapılırken sıkça kullanılır. Böylece giden gelen veri URL üzerinde görülmez. Böylece HTTP GET yöntemine göre biraz daha güvenli bir veri transferi sağlanmış olur.

“WebContent” klasörü içine PostPage.html isminde bir sayfa hazırlanır.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Strict//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Insert title here</title>
</head>
<body>

<form action="http://localhost:8088/lab-RestService/rest/HelloService/PostMethod" method="post">
	Employee name: <input type="text" name="empname" tabindex="1">  
	Employee address: <input type="text" name="empaddress" tabindex="2"> 
	Manager name: <input type="text" name="managername" tabindex="3">
	<input name="button" type="submit"></input>
</form>

</body>
</html>

REST Servis tarafında ise aşağıdaki kod bloğu yazılır.

@Path("/PostMethod")
	@POST
	@Consumes(MediaType.APPLICATION_FORM_URLENCODED)
	//'FormParam' etiketi ile birlikte HTML sayfa uzerinde yer alan herhangi bir alaninin verisine ulasilabilir.
	//Form tarafindan gonderilen veriye erismek icin form uzerindeki bilesenlerin id degerleri kullanilir.
	public String getPostValue(@FormParam("managername") String managername) {
		System.out.println(managername);
		return managername;
	}

Post işleminden sonra REST servisten dönen cevaptır.

Umarım yararlı bir yazı olmuştur. Bir sonraki makalemde görüşmek dileğiyle ...

Batuhan Düzgün

Bilgisayar Mühendisi

Endüstri Mühendisi

Yazar Hakkında

Batuhan Düzgün

www.batuhanduzgun.net

1988 Akhisar doğumludur. Sakarya Üniversitesi Bilgisayar Mühendisliği ve Endüstri Mühendisliği bölümlerinden 2011 yılında mezun olmuştur. Eskisehir OsmanGazi Universitesi'nde Endustri Muhendisligi Tezli Yuksek Lisansi programinda ogrenim yasantisina devam etmektedir. 1 senedir aktif çalışma hayatı içindedir. Mobil Teknolojiler, GSM Ağları, Bilgisayar Ağları, TCP/IP, Ethernet, HTTP, SMPP protokolleri, .NET ile yazılım geliştirme, veritabanı yönetim sistemleri ve Java gibi bir çok konuda çalışma ve proje gerçekleştirmiştir. Son zamanlarda özellikle Kurumsal Java konusuna çalışmaktadır.

Yazar Hakkında

Sosyal Medya

0 Yorum

Yorum Yaz / Soru Sor

Son Yorumlar

En Güncel Sorular

En Son Cevap Verilen Sorular

Twitter

En Çok Okunanlar

Sponsorlar