RESTful Web Hizmetleri - Adresleme
Adresleme, bir kaynağı veya sunucuda bulunan birden çok kaynağı bulmayı ifade eder. Bir kişinin posta adresini bulmak da benzerdir.
REST mimarisindeki her kaynak, kendi URI'si (Tekdüzen Kaynak Tanımlayıcısı) ile tanımlanır. Bir URI aşağıdaki biçimdedir -
<protocol>://<service-name>/<ResourceType>/<ResourceID>Bir URI'nin amacı, web hizmetini barındıran sunucuda bir kaynak (lar) bulmaktır. Bir talebin bir diğer önemli özelliği, kaynak üzerinde gerçekleştirilecek işlemi tanımlayan VERB'dir. Örneğin, RESTful Web Services - First Application bölümünde, URIhttp://localhost:8080/UserManagement/rest/UserService/users ve FİİL GET'tir.
Standart URI Oluşturma
Aşağıdakiler, bir URI tasarlarken dikkate alınması gereken önemli noktalardır -
Use Plural Noun- Kaynakları tanımlamak için çoğul isim kullanın. Örneğin, kullanıcıları kaynak olarak tanımlamak için kullanıcıları kullandık.
Avoid using spaces- Uzun bir kaynak adı kullanırken alt çizgi (_) veya kısa çizgi (-) kullanın. Örneğin, yetkili% 20users yerine yetkili_users kullanın.
Use lowercase letters - URI büyük / küçük harf duyarlı olmasa da, url'yi yalnızca küçük harflerle tutmak iyi bir uygulamadır.
Maintain Backward Compatibility- Web Hizmeti bir kamu hizmeti olduğundan, bir kez halka açık hale getirilen bir URI her zaman erişilebilir olmalıdır. URI'nin güncellenmesi durumunda, eski URI'yi 300 HTTP Durum kodunu kullanarak yeni bir URI'ye yönlendirin.
Use HTTP Verb- Kaynak üzerindeki işlemleri yapmak için her zaman GET, PUT ve DELETE gibi HTTP Fiillerini kullanın. URI'de işlem adını kullanmak iyi değildir.
Misal
Aşağıda, bir kullanıcıyı getirmek için zayıf bir URI örneği verilmiştir.
http://localhost:8080/UserManagement/rest/UserService/getUser/1Aşağıda, bir kullanıcıyı getirmek için iyi bir URI örneği verilmiştir.
http://localhost:8080/UserManagement/rest/UserService/users/1