“Get” ve “find” önekleriyle adlandırma yöntemleri arasında nasıl ve neden karar vermelisiniz?

getSomethingVersus ile başlayan belli bir yöntemi isimlendirmem gerekip gerekmediğini anlamakta her zaman sorun yaşarım findSomething.

Sorun , iyi tasarlanmamış API'ler için yardımcıların oluşturulmasında yatmaktadır . Bu genellikle, nesneyi parametre olarak gerektiren bir nesneden veri alınırken oluşur. İşte basit bir örnek:

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;
}

Bu yöntemi getRevision()veya olarak adlandırmak arasında nasıl ve neden karar vermelisiniz findRevision()?

GetAlma süresinin çok kısa olacağını bildiğimde kullanıyorum (karma tablodan veya btree'den bir aramada olduğu gibi).

Find"uzun" bir keyfi değer için) yürütülmesi için "daha uzun" bir süre gerektiren bir arama işlemi veya hesaplama algoritması anlamına gelir .

Bunun findbaşarısız olabileceğini söyleyebilirim ama getolmamalıyım.

Çocuklarımla sık sık yaptığım bir konuşmayı alıntılamak için:

ben: Hey evlat! Git bana biraz pil bul

kid: Peki neredeler?

ben: Bu yüzden sana gidip onları bulmanı söyledim. Nerede olduklarını bilseydim, gitmeni söyledim olurdu olsun onları. Ya da annene sorabilirsin.

Aynı fikir:

• ucuza elde edilebilir bir bilgi parçası döndüren bir yöntem için (ve büyük olasılıkla inline edilmiş veya başka şekilde optimize edilmiş olabilir) veya bu nesneye ait olmayan bir bilgi parçası için "get" kullanın.

• bilgi bulmak için işe yarayan bir yöntem için "bul" u kullanın veya bulmak için başka nesneler kullanın.

Bulma, aramalar arasında değişebilecek bazı parametrelerle bir veritabanı sorgusu çalıştırırken olduğu gibi sonucun bulunmadığı anlamına gelir. Öte yandan, Get, sonuçların önceden yöntem tarafından bilindiğini ya da bir kez bilinmediğinde, çağrıda hiçbir parametre olmadığı anlamına gelir.
Bu nedenle, örneğin Müşteri findCustomerById (uzun customerId) ve Customer getCustomer () kullanırdım

Aşağıdaki modeli uyguladım:

• Foo GetFoo() null döndüremez ve karmaşıklığı O (log (n)) veya daha azdır
• bool TryGetFoo(out Foo) null değerini döndürebilir ve karmaşıklığı O (log (n)) veya daha azdır.
• Foo FindFoo() null döndüremez ve karmaşıklığı O'dan büyüktür (log (n))
• bool TryFindFoo(out Foo) null değerini döndürebilir ve karmaşıklığı O değerinden fazladır (log (n))

Bu şekilde kod niyet ve beklediğiniz karmaşıklık konusunda oldukça açık.

Genellikle, Getters doğrudan liste veya sözlük / set erişimi içindir.
Bulucular derin arama, listenin tam taraması vb.

Senin durumunda:

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;
    }
}

getHer durumda uygundur _ aslında, bir şeyi almak için önce onu bulmanız gerekeceği varsayılır. Bu yüzden emin değilseniz kullanın get.

Ben kullanırım findgibi yöntemler için findMinimum()veya findOptimal()dönüş değerini hesaplar ve sadece bazı verileri almak için DB, dosya sistemi, uzak sunucu, vb bir istek yapmaz bazı özel algoritma olduğu yerde yani.

Bul veya önek almayın. Bu, bertrand meyer tarafından icat edilen UniformAccessPrinciple ihlalidir . Neden aşağıdaki gibi bir yöntem oluşturmuyorsunuz:

public String revision(Item item)

Genellikle Getbir nesneyi / değeri Findalmak ve konumunu (örneğin bir dizide) almak için kullanacağım .

örneğin:

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

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

Bana göre, findbirden fazla sonucun mevcut olabileceği anlamına gelir. getsadece birini ifade eder.