«api-design» etiketlenmiş sorular

Uygulama Programlama Arayüzü (API) Tasarımı, genel amaçlı veya genel kullanıma yönelik kütüphaneler oluşturmak için en iyi uygulamaları tartışır.

4
MVC ve RESTful API hizmeti
MVC oldukça basittir. Bir Model, bir Denetleyici ve bir Görünüm var. Bir web sitesi oluşturduğumuzda, hepsi ' istemci sunucuya REST anahtar kelime isteği gönderir -> sunucu istenen URL'yi denetleyici eylemiyle eşleştirir -> sonra veri toplama / işleme için modelleri çağıran sonucu alır -> ve sonucu istemciye HTML sayfası (görünüm) olarak …

3
CRUD dışı işlemleri gerçekleştirmek için bir REST API nasıl tasarlanır?
SOĞUK tabanlı hizmetler kümesi RESTful API dönüştürmek çalışıyorum. İşlem adlarını analiz ederek kaynakları belirleyerek başladım ve kaynağı aldım Subscription. Aboneliğin durumunu güncellemem POSTgerektiğinde, kaynaklara doğrudan erişemediğim için sunucuya bir istek gönderemiyorum , ancak özelliklerini güncellemek için bazı RPC tarzı işlemleri çağırmam gerekiyor. Ayrıca, yalnızca ve yalnızca aboneliğin durumunu "etkin" olarak …

3
Sezgisel olmayan C # String.Split () uygulamasının arkasındaki nedenler
C # stringbaşka bir bölmek istiyorsanız stringben böyle bir şey yapmak zorunda: testString.Split(new string[] { "anotherString" }, StringSplitOptions.None); Aşırı yüklenmiş String.SplitMSDN Dokümantasyonundan uygulamayı ve neden böyle bir çağrı yapılması gerektiğini görebiliriz. Python'dan geliyor, böyle bir çağrının neden gerekli olduğunu doğru bir şekilde anlamak benim için zor. Yani Regex.SplitPython uygulamasından benzer …

2
Uyarı Sistem Mimarisi
Çeşitli programlardan gelen uyarı mesajlarını işleyen ve bu uyarıları e-posta yoluyla tüketicilere indirgeyen bir sistem oluşturmak istiyorum. Tüm bunlar tek bir dahili ağ üzerinden sağlanacaktır. Bence temel mimarinin şöyle görünmesini istiyorum: Şu anda sahip olduğum temel endişe benim "API-çeşit" ne olacak "Message Handler" bit. Bu sistemin tüm bileşenlerinin veritabanına tüm …

1
Null-Safe Operatörleri (örn. “Elvis operatörü”) Java 7'nin “Project Coin” inin bir parçası olarak neden reddedildi?
Java 7'nin "Project Coin" i için önerilen özelliklerden biri "Elvis operatörü" idi. Bir bir 2009 JavaOne sunum raporu Projesi Coin gibi tanımladı: Bu sunumda yer alan "küçük özelliklerden" biri üçlü operatörün daha özlü bir versiyonu olan "Elvis operatörü" dür. Kendimi geleneksel Java kullanırken Groovy'nin bazı özelliklerini eksik buluyorum ve bu …
10 java  api-design 

4
Hata mesajına ilgili belgelere bir bağlantı eklensin mi?
Harici geliştiriciler tarafından kullanılan ticari bir kütüphane ve kod örnekleri oluşturuyoruz. Kütüphanenin nasıl kullanılacağını kapsamlı bir şekilde açıklayan (kapalı, kayıtlı kullanıcılar tarafından kullanılabilir) belgelere sahibiz. Geliştiricilerin çoğu ilk kez kullanıldığından, birçok temel hata ile karşılaşılır. Hata günlüğüne belgelere bağlantılar eklemek uygun mu? Olası olumsuz yanları nelerdir? Birkaçını öngörebilirim, ancak aşağıdakilerin …

2
Oracle Java eğitiminde neden "tartışma" olarak adlandırılan denetlenmeyen ve denetlenmeyen istisnalar denetleniyor?
Java için yeniyim ve istisnalarla ilgili belgelerini okuyordum . ve özellikle Denetlenmeyen İstisnalar - Tartışma sayfası. Sonuç olarak: Bir istemcinin bir istisnadan kurtarması makul olarak isteniyorsa, denetlenen bir istisna yapın. İstemci özel durumdan kurtarmak için hiçbir şey yapamazsa, denetlenmeyen bir özel durum haline getirin. Makaleyi anlamıyorum. "Tartışma" ne hakkında? Basit …

2
'Demeter Yasası' genel / API yöntemi imzalarına uygulanabilir mi?
Bu yöntemleri kullanan istemci kodlarının kırılmasını önlemek için API / genel yöntem imzasındaki değişikliklerin minimum düzeyde olması gerektiği göz önüne alındığında , Demeter Yasası'nın bunlara daha az uygulanabilir olup olmadığını merak ediyordum . Basit bir örnek: class Account() { double balance; public void debit(Transaction t) { balance -= t.getAmount(); } …

5
C dilinde API tasarım tuzakları [kapalı]
Kapalı . Bu soru görüş temelli . Şu anda cevapları kabul etmiyor. Bu soruyu geliştirmek ister misiniz? Bu yayını düzenleyerek gerçekler ve alıntılarla yanıtlanabilmesi için soruyu güncelleyin . 4 yıl önce kapalı . C API'larında sizi çıldırtan bazı kusurlar nelerdir (standart kütüphaneler, üçüncü taraf kütüphaneleri ve bir projenin içindeki başlıklar …
10 c  api-design  pitfalls 


2
Bir API'nın yetkisiz kullanımını nasıl önleyebilirim?
Bir "widget", ortakları bazı UI görüntülemek ve API bizim çağrı yapmak için web sitelerine gömmek bir komut dosyası tasarlamak zorunda. Temel olarak, bu sitelerdeki verilerimizi API çağrılarımızda sağladıkları bazı kimliklere dayanarak görüntüler. Bundan kaçınmak istediğimiz, API'yı kötüye kullanan ve kataloğumuzun tamamını kazımak için kullanan birisidir. Betiğimizi yerleştiren her iş ortağına, …

3
Ayrıştırma hatası durumunda ayrıntılı bilgi sağlayan bir TryParse yöntemini nasıl tasarlayabilirim?
Kullanıcı girişini ayrıştırırken genellikle istisnaları atmamak ve yakalamak değil, daha ziyade doğrulama yöntemlerini kullanmanız önerilir. .NET BCL'de bu, örneğin int.Parse(geçersiz veriler için bir istisna atar) ve int.TryParse( falsegeçersiz verilerde geri dönüşler ) arasındaki fark olacaktır. Kendim tasarlıyorum Foo.TryParse(string s, out Foo result) yöntemi ve dönüş değeri hakkında emin değilim. bool.NET'in …
9 c#  .net  api-design 

3
Bir API nesne tanımının 3. taraf referans kimliklerini özellik olarak içermesi kötü bir uygulama mudur?
Bunun gibi: Campaign: type: object properties: id: type: string description: "A GUID identifier" referenceId: type: string description: "A consumers identifier they have used to map their own systems logic to this object." name: type: string description: "'Great Campaign 2017' as an example" ReferenceId hakkında endişeliyim . Sistem etki alanı, veri …

2
Sonlu seçenek kümesine ekleme; API kırılma değişikliği?
Aşağıdaki yanıt modelini veren bir HTTP API uç noktası alın: { "type": "Dog", "name": "Jessi", ... } typeAlan biri olarak belgelerinde tarif edilmiştir Dog, Catya da Fish. Yeni bir seçenek eklemek, örneğin Rat, bir API değişikliği olarak kabul edilir mi? Sonlu bir listeye (bir geliştiricinin açabileceği) bir seçenek eklemek bir …
9 rest  api  api-design  json 

3
REST ifadesinde, bir kaynak ile temsil arasındaki fark nedir?
HTTP işleminden durumun gösterilmesi ve bir durumdan diğerine geçiş olarak hizmet işlemlerinin modellenmesini sağlayan REST anlayışım. Topluluk tarafından saygı duyulan akıllı bir geliştirici / mimar olduğunu bildiğim Jimmy Bogard'ın bu makalesini okuduğum zamana kadar kaynakları her zaman hizmet tarafı devletin temsili olarak anladım . Söz konusu yayından belirli bir ifade …
9 rest  api  api-design 

Sitemizi kullandığınızda şunları okuyup anladığınızı kabul etmiş olursunuz: Çerez Politikası ve Gizlilik Politikası.
Licensed under cc by-sa 3.0 with attribution required.