Bagaimana dan mengapa memutuskan antara metode penamaan dengan awalan "get" dan "find"

Saya selalu mengalami kesulitan mencari tahu apakah saya harus menyebutkan metode tertentu dimulai dengan getSomethingversus findSomething.

Masalahnya terletak pada pembuatan pembantu untuk API yang dirancang dengan buruk. Ini biasanya terjadi ketika mendapatkan data dari suatu objek, yang membutuhkan objek sebagai parameter. Ini adalah contoh sederhana:

public String getRevision(Item item) {
    service.load(item, "revision");
    // there is usually more work to do before getting the data..
    try {
        return item.get_revision();
    }
    catch(NotLoadedException exception) {
        log.error("Property named 'property_name' was not loaded", exception);
    }
    return null;
}

Bagaimana dan mengapa harus memutuskan antara memberi nama metode ini sebagai getRevision()atau findRevision()?

Saya menggunakan Getketika saya tahu waktu pengambilan akan sangat singkat (seperti dalam pencarian dari tabel hash atau btree).

Findmenyiratkan proses pencarian atau algoritma komputasi yang membutuhkan periode waktu "lebih lama" untuk dieksekusi (untuk beberapa nilai arbitrer lebih lama).

Saya akan mengatakan itu findmungkin gagal tetapi gettidak seharusnya.

Mengutip percakapan yang sering saya lakukan dengan anak-anak saya:

saya: Hei nak! Pergi cari aku beberapa baterai

anak: Tapi di mana mereka?

saya: Itu sebabnya saya bilang pergi mencari mereka. Jika saya tahu di mana mereka berada, saya akan memberitahu Anda untuk mengambilnya . Atau Anda bisa bertanya pada ibumu.

Gagasan yang sama berlaku:

• gunakan "dapatkan" untuk metode yang mengembalikan sepotong informasi yang tersedia dengan harga murah (dan mungkin dapat diuraikan atau dioptimalkan), atau untuk sepotong informasi yang dimiliki secara unik oleh objek ini.

• gunakan "find" untuk metode yang berfungsi untuk mendapatkan informasi, atau menggunakan objek lain untuk menemukannya.

Find menyiratkan tidak memiliki hasil, seperti ketika menjalankan query database dengan beberapa parameter yang dapat berubah di antara panggilan. Dapatkan, di sisi lain, menyiratkan hasil yang diketahui metode sebelumnya atau tidak akan berubah setelah diketahui, bahwa tidak ada parameter untuk panggilan.
Jadi, saya akan menggunakan misalnya Customer findCustomerById (long customerId) dan Customer getCustomer ()

Saya menerapkan pola berikut:

• Foo GetFoo() tidak dapat mengembalikan nol dan kompleksitasnya adalah O (log (n)) atau kurang
• bool TryGetFoo(out Foo) dapat mengembalikan nol dan kompleksitasnya adalah O (log (n)) atau kurang
• Foo FindFoo() tidak dapat mengembalikan nol dan kompleksitasnya lebih dari O (log (n))
• bool TryFindFoo(out Foo) dapat mengembalikan nol dan kompleksitasnya lebih dari O (log (n))

Dengan begitu kode ini cukup jelas tentang maksud dan kompleksitas yang dapat Anda harapkan.

Biasanya, Getters adalah untuk daftar langsung atau akses kamus / set.
Pencari adalah pencarian dalam, pemindaian daftar lengkap, dll ...

Dalam kasus Anda:

public bool TryGetRevision( Item item, out String revision ) 
{
    service.load( item, "revision" );
    // there is usually more work to do before getting the data..
    try 
    {
        revision = item.get_revision();
        return true;
    }
    catch( NotLoadedException exception )
    {
        log.error( "Property named 'property_name' was not loaded", exception );
        revision = "";
        return false;
    }
}

getcocok dalam kasus apa pun _ pada kenyataannya sering diasumsikan bahwa untuk mendapatkan sesuatu yang Anda perlu menemukan itu terlebih dahulu. Jadi, jika Anda tidak yakin, gunakan get.

Saya akan menggunakan finduntuk metode seperti findMinimum()atau findOptimal(), yaitu di mana ada beberapa algoritma khusus yang menghitung nilai kembali, dan tidak hanya membuat permintaan ke DB, sistem file, server jauh, dll untuk menerima beberapa data.

Jangan gunakan temukan atau dapatkan awalan. Ini adalah pelanggaran UniformAccessPrinciple yang dibuat oleh bertrand meyer. Mengapa tidak membuat metode seperti berikut:

public String revision(Item item)

Saya biasanya akan menggunakan Getuntuk mengambil sebuah objek / nilai, dan Finduntuk mengambil nya lokasi (dalam array, misalnya).

misalnya:

object o = obj.GetItem( 'name');

integer i = somearray.Find( 'name');

Bagi saya, findmenyiratkan mungkin ada lebih dari satu hasil yang ada. getmenyiratkan hanya satu.