Pertanyaan yang diberi tag «api-design»

Saya sedang mengerjakan pembungkus C ++ API yang menyediakan akses ke penyimpanan data (Hazelcast) dalam fungsi C, sehingga penyimpanan data juga dapat diakses dari kode C-only. API Hazelcast C ++ untuk datastructure Map terlihat seperti ini: auto map = hazelcastClient->client->getMap<int, string>(mapName); map.put(key, value); Itu menggunakan jenis template untuk keydan valueparameter. …

9 c++  c  api-design 

Katakanlah Anda memiliki semacam struktur data, yang bertahan dalam beberapa jenis database. Untuk kesederhanaan, sebut saja struktur data ini Person. Anda sekarang ditugaskan untuk merancang API CRUD, yang memungkinkan aplikasi lain untuk membuat, membaca, memperbarui, dan menghapus Person. Untuk mempermudah, mari kita asumsikan bahwa API ini diakses melalui beberapa jenis …

9 design  api  web-services  api-design  crud 

Biasanya pendengar acara tidak boleh hidup lebih lama dari objek yang mendaftarkan mereka. Apakah ini berarti bahwa pendengar acara harus dipegang oleh referensi lemah secara default (disimpan dalam koleksi lemah oleh objek yang didaftarkan oleh pendengar objek)? Apakah ada kasus yang valid ketika pendengar harus hidup lebih lama dari penciptanya? …

9 api-design  event 

Misalkan Anda memiliki proyek besar yang didukung oleh basis API. Proyek ini juga mengirimkan API publik yang dapat digunakan pengguna (ish). Terkadang Anda perlu membuat perubahan pada basis API yang mendukung proyek Anda. Misalnya, Anda perlu menambahkan fitur yang memerlukan perubahan API, metode baru, atau membutuhkan perubahan salah satu objek, …

9 versioning  api-design 

Tolong selesaikan argumen antara saya dan seorang teman. Kami sedang merancang API produk. Entitas Produk kami terlihat seperti ini { "Id": "", "ProductName": "", "StockQuantity": 0 } Penjualan produk ditangani oleh pihak ke-3 dan mereka wajib memberi tahu kami dengan jumlah yang dibeli sehingga StockQuantitybidangnya dapat dikurangi. Pendekatan saya: PUT …

8 design  design-patterns  rest  api-design  rpc 

Saya pikir salah satu titik sakit terbesar dalam bekerja dengan layanan microsoft adalah memastikan bahwa API didokumentasikan dengan baik dan API tidak mengubah perilaku mereka tanpa mempengaruhi aplikasi hilir. Masalah ini menjadi bertambah ketika Anda memiliki banyak layanan yang saling bergantung satu sama lain. Mungkin pada saat itu Anda melakukan …

8 api-design  documentation  microservices 

Ketika mendesain Layanan Web RESTful haruskah API dirancang untuk bekerja ID untuk Strings untuk nilai-nilai yang diteruskan bolak-balik antara server? Berikut ini sebuah contoh: Katakanlah saya memiliki sumber daya Karyawan, yang memiliki status dan atribut gender. Dalam Status database dan Jenis Kelamin serta tabel terpisah dan dengan demikian memisahkan objek …

8 rest  api-design  json 

Dari komentar Roy Fielding pada artikelnya sendiri mengutuk apis REST palsu : API yang benar-benar tenang seperti hypertext. Setiap unit informasi yang dapat dialamatkan membawa alamat, baik secara eksplisit (misalnya, atribut tautan dan id) atau secara implisit (misalnya, diturunkan dari definisi jenis media dan struktur representasi). Hasil kueri diwakili oleh …

8 rest  api  api-design 

Pertanyaan ini telah mengganggu saya selama beberapa hari, dan rasanya seperti beberapa praktik yang saling bertentangan. Contoh Iterasi 1 public class FooDao : IFooDao { private IFooConnection fooConnection; private IBarConnection barConnection; public FooDao(IFooConnection fooConnection, IBarConnection barConnection) { this.fooConnection = fooConnection; this.barConnection = barConnection; } public Foo GetFoo(int id) { Foo …

8 c#  unit-testing  api-design  dependency-injection  solid 

Di masa lalu, saya menggunakan cara standar untuk menambahkan @Deprecatedanotasi ke metode API yang akan dihapus di versi yang lebih baru. Sekarang saya sedang mempersiapkan versi utama untuk perpustakaan, dengan banyak bagian API dihapus dan diganti namanya. Untuk membuat transisi lebih mudah bagi pengguna yang sudah ada, mungkin bisa bermanfaat …

8 java  api-design  libraries  versioning 

Saya melihat bahwa semakin banyak API baru menggunakan token halaman untuk memungkinkan pengguna berpindah antar halaman hasil yang mengandung banyak item. Namun dari sudut pandang desainer API, saya tidak jelas tentang apa manfaat menggunakan token jika dibandingkan dengan membiarkan pengguna menentukan berapa banyak item yang ingin dilewati. Jadi inilah pertanyaanku …

8 programming-practices  rest  api-design 

Dalam API kami, kami memiliki beberapa tipe data pusat yang perlu "didekorasi" (dapat dikatakan) setelah pengambilan dari database dengan nilai yang dihitung. Basis data diakses melalui ORM yang mengikuti dinamika Table / Entity yang sangat terinspirasi oleh lapisan basis data CakePHP 3, di mana objek Table digunakan sebagai perantara antara …

8 database  data-structures  functional-programming  api-design  orm 

Dalam aplikasi utama REST API yang mencakup beberapa domain terkait, apakah lebih masuk akal untuk membagi sumber daya menjadi 'area' berdasarkan domain bisnis tempat mereka berada atau lebih baik mempertahankan model tunggal? Misalnya, ada sub-domain 'Penjualan' dan 'Persediaan'. Pengguna sistem biasanya hanya peduli pada satu domain saja, tetapi pengecualian dimungkinkan. …

8 architecture  rest  api-design