URL Bileşenlerinden URL Oluşturma Rehberi
URL Builder’da bileşen alanlarını doldurarak bir URL metni oluşturabilir ve sorguyu yapılandırılmış parametre bilgisiyle birlikte inceleyebilirsiniz. Başlangıç değerleriyle çalışmak, bileşenlerin sonuç üzerindeki etkisini görmenin en kolay yoludur.
Bileşenleri tanıma
URL Builder, bir adresi oluşturan parçaları ayrı alanlarda düzenleyip tek bir sonuçta birleştirmenizi sağlar. Şema, alan adı, port, yol, parametre, sorgu ve parça bileşenlerini birlikte incelemek istediğinizde kullanılabilir. Böylece hangi değerin sonucun hangi bölümünü etkilediğini daha kolay karşılaştırabilirsiniz. Araç, bileşenlerden URL metni oluşturma işine odaklanır; adresi açma, erişilebilirliğini denetleme veya bir yerden içerik alma amacı taşımaz. Sorgu alanına girilen metin ayrıca yapılandırılmış sorgu parametresi bilgisine ayrılır. Bu ayrım, yalnızca yazdığınız sorgunun nasıl parçalandığını incelemenize yardımcı olur. Bir adresin kullanılabilirliğini değerlendirmek için bu sonucu tek başına kanıt olarak görmeyin. Değerleri değiştirirken özellikle yolun başındaki eğik çizgi ile portun sonuçta görünüp görünmediğine dikkat edin. Varsayılanlarla başlamak, alanların görevini öğrenmek ve daha sonra tek bir bileşeni değiştirerek farkı gözlemlemek için pratik bir yöntemdir. Sonuç alanını okurken metni bir bütün olarak değil, seçtiğiniz bileşenlerin birleşimi olarak değerlendirin.
URL oluşturma akışı
-
Şema alanında sunulan
httpsveyahttpseçeneklerinden birini seçin. Bir seçim yapmadan ilerlerseniz başlangıç değerihttpsolur. -
Alan adı alanına kullanmak istediğiniz metni yazın. Bu alan başlangıçta
example.comdeğerini taşır; kendi senaryonuza göre değiştirebilirsiniz. -
Port alanını yalnızca sonuçta port göstermek istediğinizde düzenleyin. Başlangıç değeri
0değeridir. Girilen değer tam sayıya dönüştürüldüğünde sıfırdan büyükse alan adının arkasına eklenir;8080değeri kullanıldığında port bölümülocalhost:8080biçiminde görünebilir. -
Yol alanını kontrol edin. Başlangıç değeri
/işaretidir. Girdiğiniz metin eğik çizgiyle başlamıyorsa araç, birleştirme öncesinde başına/ekler. Bu nedenleapigirişi sonuçta/apiyolu olarak ele alınır. -
Parametre ve parça alanlarını ihtiyacınıza göre doldurun. Her iki alan da boş metinle başlar.
-
Sorgu alanındaki değeri inceleyin veya kendi sorgu metninizi girin. Başlangıç metni
key=value&lang=enbiçimindedir. Araç bu metni sonuca ekler ve ayrıca yapılandırılmış parametre bilgisi çıkarır. -
Oluşturulan sonucu, değiştirdiğiniz alanla karşılaştırın. Önce tek bir bileşeni değiştirmeniz, ortaya çıkan farkın kaynağını daha net görmenizi sağlar.
Çıktıyı doğru okuma
Sonuç, seçtiğiniz şema ile diğer bileşenlerin bir araya getirilmesiyle oluşur. Başlangıç değerlerini koruduğunuzda şema https, alan adı example.com, port 0, yol /, sorgu da key=value&lang=en olarak değerlendirilir; parametre ve parça bölümleri boş kalır. Bu değerlerin birleşimi, aracın doğrulanmış varsayılan sonucunu oluşturur. Şema, alan adı veya yol değiştirildiğinde ilgili bölümün sonuçta değişmesi beklenir. Pozitif bir port değeri girildiğinde port, alan adından sonra görünür; sıfır değeri ise port eklenmemesiyle sonuçlanır. Yolun başında eğik çizgi bulunmuyorsa sonuca eklenen işaret, yol bölümünün düzenli biçimde ayrılmasını sağlar. Sorgu için gösterilen yapılandırılmış bilgiler, girilen metnin parametreler halinde ele alındığını anlatır. Bununla birlikte sonuç, girdinin geçerli, kodlanmış, erişilebilir veya başka bir sistemden geçirilip aynı biçimde döneceğini kanıtlamaz. Bu yüzden sonucu biçimsel birleştirme ve sorgu ayrıştırma çıktısı olarak okuyun; çalışırlık denetimi yerine kullanmayın. Farkları anlamak için her değişiklikten sonra ilgili bileşenin sonuçtaki konumunu kontrol edin.
Uygulamalı örnek
Bir geliştirici, test ortamındaki API yolunu ve port bilgisini içeren bir adres biçimini karşılaştırmak ister; bunun için bileşenleri ayrı alanlarda düzenler.
Şemayı http, alan adını test.com, yolu api, portu 8080 ve sorguyu key=value olarak girin; ardından sonuçta yol ön ekini, port bölümünü ve sorgu bilgisini inceleyin. Tam bir adres değeri beklemek yerine her parçanın kendi yerini kontrol edin; böylece yapılan değişikliğin etkisini ayırt edebilirsiniz.
Sonuçta şema http, alan adı test.com, yol /api ve pozitif port kullanıldığında alan adının arkasında :8080 bölümü görünür. key=value sorgusu ayrıca yapılandırılmış parametre bilgisi olarak sunulur.
Sınırlamalar
- Sonuç bileşenleri birleştirir, fakat adresin geçerliliğini, kodlamasını veya erişilebilirliğini doğrulamaz.
Sık yapılan hatalar
apigirişinin eksik olduğunu sanmak gereksizdir; araç başına eğik çizgi ekler. Sonuçta yol bölümünün/apiolarak göründüğünü kontrol edin.
Sık sorulan sorular
Varsayılan URL nasıl oluşturulur?
Değerleri değiştirmeden bırakırsanız şema https, alan adı example.com, port 0 ve yol / olur. Sorgu başlangıçta key=value&lang=en metnini taşır; parametre ile parça alanları boş kalır ve bu parçalar doğrulanmış varsayılan sonucu oluşturur.
URL’ye port nasıl eklenir?
Port alanına girilen değer tam sayıya dönüştürüldüğünde sıfırdan büyükse port alan adından sonra eklenir. Örneğin 8080, sonuçta localhost:8080 biçiminde görülebilir; başlangıçtaki 0 değeri port eklemez.
Oluşturulan URL’nin çalıştığı kontrol edilir mi?
Bu işlem erişilebilirlik kontrolü yapmaz. Araç, bileşenlerden metin oluşturur ve sorguyu parametre bilgisine ayırır; bu nedenle ortaya çıkan adresin açılacağını göstermez veya ağ üzerinden deneme yapmaz.