Merhabalar arkadaşlar.

Bu yazıda Spring Boot kullanarak bir adet Spring Rest Post örneği yapacağız.

Daha önce Spring Rest GET Örneği yazımızda Spring Boot ile Spring Rest GET örneği yaparken ortamımızı hazırlamıştık ve sınıflarımızı yazmıştık. Bu yazı da o yazının bir devamı niteliğinde olacak. Bu nedenle ortam hazırlığı vs. konularına girmiyorum. Şimdi POST işlemi için yapmamız gerekene bakalım.

Ben bu yazıda kullanmak için MySQL veritabanı sunucusunda SpringRestPost adından bir veritabanı oluşturdum ve içinede de person adında şöyle bir tablo oluşturdum.

Web servisi yazdıktan sonra Postman ile istek yapıp kaydın düşüp düşmediğine bakacağız.

Şimdi ilk olarak PersonRegisterPojo adında yeni bir sınıf oluşturuyoruz. Bu sınıfı oluşturmaktaki amaç kullanıcıya döndürelecek response içerisinde hem gelen Person objesini hem de bizim ilave alan(lar)ımızı kullanmak olacaktır.

PersonRegisterPojo.java

package pojo;

public class PersonRegisterPojo {
	String registeringResult;
	Person person;

	public Person getPerson() {
		return person;
	}

	public void setPerson(Person person) {
		this.person = person;
	}

	public String getRegisteringResult() {
		return registeringResult;
	}

	public void setRegisteringResult(String registeringResult) {
		this.registeringResult = registeringResult;
	}

}

PersonRegisterPojo sınıfı içerisinde POST ile gelen verilerin veritabanına yazılması işleminin neticesini tutacak bir String ve gelen Person objesini tutacak person değişkeni yer alıyor.

PostExampleController.java

package postExample;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.SQLException;

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

import pojo.Person;
import pojo.PersonRegisterPojo;

@RestController
public class PostExampleController {
	@RequestMapping(value = "/postPerson", method = RequestMethod.POST)
	public ResponseEntity<PersonRegisterPojo> postPerson(@RequestBody Person person) {

		PersonRegisterPojo registerPojo = new PersonRegisterPojo();
		registerPojo.setPerson(person);

		PreparedStatement ps = null;
		Connection con = null;
		try {
			Class.forName("com.mysql.jdbc.Driver");
			con = DriverManager.getConnection(
					"jdbc:mysql://localhost:3306/SpringRestPost?useUnicode=true&characterEncoding=UTF-8", "root", "");
			String sql = "INSERT INTO person(id,name,surname,	neighborhood,borough, city,	country) VALUES(?,?,?,?,?,?,?)";
			ps = con.prepareStatement(sql);
			ps.setString(1, person.getId());
			ps.setString(2, person.getName());
			ps.setString(3, person.getSurname());
			ps.setString(4, person.getAddress().getNeighborhood());
			ps.setString(5, person.getAddress().getBorough());
			ps.setString(6, person.getAddress().getCity());
			ps.setString(7, person.getAddress().getCountry());
			ps.executeUpdate();
			registerPojo.setRegisteringResult("Kyıt Başarı İle Eklendi");

		} catch (ClassNotFoundException | SQLException exception) {
			registerPojo.setRegisteringResult("Kayıt Sırasında Bir Hata Meydana Geldi! " + exception);
			exception.printStackTrace();
		} finally {
			try {
				if (con != null) {
					con.close();
				}
				if (ps != null) {
					ps.close();
				}
			} catch (SQLException sqlException) {
				sqlException.printStackTrace();
			}
		}

		return new ResponseEntity<PersonRegisterPojo>(registerPojo, HttpStatus.OK);
	}
}
  • PostExampleController sınıfımız ilk olarak @RestController notasyonu ile işaretli.
  • Post işlemini gerçekleştirecek postPerson metodumuz @RequestMapping notasyonu ile işaretli ve bu notasyona bu metodun hangi URL isteklerine cevap vereceğini tanımlayan RequestMapping ve hangi görevi yerine getireceğini gösteren method parametreleri geçiriliyor.
  • postPerson metodu parametre alma kısmında @RequestBody notasyonu ile işaretli bir Person nesnesi alıyor. Burada metot default olarak bir JSON bekliyor ve gelen JSON’dan bir Person nesnesi oluşturulacak.
  • Metot içerisinde ise PersonRegisterPojo nesnesi elde ediyoruz ve gelen Person’ı bu PersonRegisterPojo nesnesinin içine koyuyoruz.
  • Kodun devam eden kısmında JDBC ile SpringRestPost veritabanına kayıt açılıyor ve person tablosuna kayıt yollanmaya çalışılıyor. Eğer kayıt işlemi başarılı olursa PersonRegisterPojo nesnesinin registeringResult alanına kaydın başarılı olduğuna dair mesaj geçiliyor. Eğer kayıt sırasında bir hata olursa da hata mesajı registeringResult alanına koyuluyor.
  • Son kısımda ise PersonRegisterPojo sınıfını kullanarak bir ResponseEntity nesnesini oluşturup döndürüyoruz. Burada da default olarak JSON şeklinde cevap döndürülecek.

Şimdi projeye sağ tıklayıp Rus As kısmından Maven Build‘i seçelim ve şu komutu girelim. Akabinde Run butonuna tıklayalım.

Started Application in … seconds yazısını gördükten sonra Postman uygulamasını açalım.

Postman içerisinde kullanıcalacak HTTP metodu olarak POST’u seçiyoruz ve URL olarak http://localhost:8080/SpringRestTutorial/postPerson adresini veriyoruz. Akabinde Body tabına tıklıyoruz ve raw seçeneğini seçiyoruz. raw’ın olduğu satırın en sağ kısmından da JSON (application/json) seçeneğini seçiyoruz. TextArea alanına da web servisin beklediği şekilde bir JSON yazıyoruz. Beklediği şekildeden kasıt ise önceki yazıdaki Person sınıfı alanlarını taşıyan bir JSON olmasıdır. Burada adress alanının iç içe olduğuna dikkat etmek gerekir. Biz şöyle bir JSON gönderiyoruz:

{  
   "id":"1",
   "name":"Onur",
   "surname":"Özcan",
   "address":{  
      "neighborhood":"Cennet Mah.",
      "borough":"K.Çekmece",
      "city":"İstanbul",
      "country":"TÜRKİYE"
   }
}

Sol üstteki Send butonuna tıkladığımızda Postman bizim için web servise, verdiğimiz JSON’ı post edecek ve alttaki TextArea alanında POST işleminin neticesi yazacak. Ben butona tıkladığımda kaydın başarı ile ekleniğine dair Response döndü.

Veritabanına gidip baktığımda da kaydın aynen eklendiğini görüyorum.

Şimdi az önce gönderdiğimiz JSON’ın id alanı aynı kalsın ve içeriğini biraz değiştirelim. Sonra Postman’e bu JSON’ı verip POST edelim.

{  
   "id":"1",
   "name":"Alican",
   "surname":"Akkuş",
   "address":{  
      "neighborhood":"Cennet Mah.",
      "borough":"K.Çekmece",
      "city":"İstanbul",
      "country":"TÜRKİYE"
   }
}

Aşağıdaki resimde göreceğiniz gibi bir duplicate hatası alacağız çünkü id alanı bir PrimaryKey alan ve tekrarlı veriye izin vermez. Bu nedenle de JDBC hata veriyor. Biz de hatayı dönen JSON içinde görüyoruz.

Bu yazıda anlatacaklarım bu kadar arkadaşlar. Başka bir yazıda görüşene kadar sağlıcakla kalın.

Selam ve Sevgilerimle