Ingegneria software readability

4

Dovremmo rinominare metodi sovraccarichi?

Supponi un'interfaccia contenente questi metodi: Car find(long id); List<Car> find(String model); È meglio rinominarli in questo modo? Car findById(long id); List findByModel(String model); In effetti, qualsiasi sviluppatore che utilizza questa API non dovrà guardare l'interfaccia per conoscere i possibili argomenti dei find()metodi iniziali . Quindi la mia domanda è più …

14 design naming readability method-overloading

4

Ci sono degli svantaggi reali nel concatenamento di metodi autoreferenziali?

Di recente ho suggerito di implementare un metodo di concatenamento per una determinata classe in un determinato progetto in modo da migliorare la leggibilità del codice. Ho ottenuto una risposta "le interfacce fluide non devono essere implementate solo per comodità, ma per la semantica" e il mio suggerimento è stato …

14 architecture coding-standards readability method-chaining

4

Come devo scrivere un test per un metodo puro che non restituisce nulla?

Ho un sacco di classi che si occupano della validazione dei valori. Ad esempio, una RangeValidatorclasse controlla se un valore è compreso nell'intervallo specificato. Ogni classe di validazione contiene due metodi is_valid(value):, che restituisce Trueo Falsedipende dal valore e ensure_valid(value)che verifica un valore specificato e non fa nulla se il …

13 unit-testing exceptions readability

4

Quale modo di terminare il ciclo di lettura è l'approccio preferito?

Quando devi iterare un lettore in cui il numero di elementi da leggere è sconosciuto e l'unico modo per farlo è quello di continuare a leggere fino a raggiungere il traguardo. Questo è spesso il posto in cui hai bisogno di un ciclo infinito. C'è sempre trueciò che indica che …

13 c# code-quality readability

6

I sigilli rendono più semplice la lettura del codice sorgente?

Nella maggior parte dei linguaggi di programmazione, le variabili non hanno caratteri identificativi come in PHP. In PHP devi aggiungere il prefisso a una variabile con il $carattere. Esempio; var $foo = "something"; echo $foo; Sto sviluppando un nuovo linguaggio di scripting per un'applicazione aziendale e i miei utenti target …

13 programming-languages readability

1

Come scrivere il codice Clojure leggibile?

Sono nuovo di Clojure. Riesco a capire il codice che scrivo ma diventa troppo difficile capirlo in seguito. Diventa difficile abbinare le parentesi. Quali sono le convenzioni generiche da seguire riguardo alle convenzioni di denominazione e al rientro in varie situazioni? Ad esempio, ho scritto un esempio di destrutturazione per …

13 readability clojure

4

Enfatizzare la negazione

Stavo solo scrivendo un'istruzione if con nomi di proprietà abbastanza lunghi e ho riscontrato questo problema. Supponiamo che abbiamo un'istruzione if come questa: if(_someViewModelNameThatIsLong.AnotherPropertyINeedToCheck == someValue && !_someViewModelNameThatIsLong.ThisIsABooleanPropertyThatIsImportant) { //Do something } La seconda proprietà è di tipo booleano e non ha senso avere lo stetement simile if(boleanValue == true) …

13 readability

5

Leggibilità della programmazione funzionale [chiuso]

Chiuso . Questa domanda deve essere più focalizzata . Al momento non accetta risposte. Vuoi migliorare questa domanda? Aggiorna la domanda in modo che si concentri su un problema solo modificando questo post . Chiuso 2 anni fa . Sono curioso di questo perché ricordo prima di imparare qualsiasi linguaggio …

13 object-oriented functional-programming readability

4

È sbagliato usare i flag per "raggruppare" le enumerazioni?

La mia comprensione è che gli [Flag]enum sono in genere utilizzati per cose che possono essere combinate, in cui i singoli valori non si escludono a vicenda . Per esempio: [Flags] public enum SomeAttributes { Foo = 1 << 0, Bar = 1 << 1, Baz = 1 << 2, …

12 c# .net readability enum

5

Ripetizione del codice vs metodo multi-responsabile

Cerco di seguire il principio di responsabilità singola (SRP) e anche di omettere le ripetizioni del codice. Tuttavia ci sono spesso luoghi in cui ci sono ripetizioni di codice che non sono altro che blocchi di codice di invocazioni che sono resistenti all'estrazione in almeno un metodo chiamato significativo: DoAction1(); …

11 refactoring readability single-responsibility code-reuse

3

"Statico" come indizio semantico sull'apolidia?

Di recente ho intrapreso un refactoring di un progetto di medie dimensioni in Java per tornare indietro e aggiungere test unitari. Quando mi sono reso conto che dolore è stato deridere i singoli e la statica, ho finalmente "capito" quello che ho letto su di loro tutto questo tempo. (Sono …

11 coding-standards readability coding-style static-methods

6

Cosa è più gestibile: assegnazione booleana tramite if / else o espressione booleana?

Quale sarebbe considerato più mantenibile? if (a == b) c = true; else c = false; o c = (a == b); Ho provato a cercare in Codice completo, ma non riesco a trovare una risposta. Penso che il primo sia più leggibile (puoi letteralmente leggerlo ad alta voce), che …

11 .net code-quality readability maintainability clean-code

6

Devo rendere il mio codice più leggibile dagli altri programmatori del mio team

Sto lavorando a un progetto in Delphi e sto creando un programma di installazione per l'applicazione, ci sono tre parti principali. Installazione / disinstallazione di PostgreSQL installazione / disinstallazione di myapplication (l'installazione di myapplication viene creata utilizzando nsi). Creazione di tabelle in Postgres tramite script (file batch). Ogni cosa funziona …

11 code-quality readability logging

10

Le funzioni "matematiche" dovrebbero seguire la notazione matematica?

Suppongo che questa domanda verrà immediatamente contrassegnata come soggettiva, ma quale pensi sia meglio: double volume(double pressure, double n_moles, double temperature) { return n_moles * BOLTZMANN_CONSTANT * temperature / pressure; } o double volume(double P, double n, double T) { return n*R*T/P; } In altre parole, le funzioni che implementano …

11 math coding-style readability

12

Mantenibilità della logica booleana - Annidamento se sono necessarie istruzioni?

Quale di questi è meglio per la manutenibilità? if (byteArrayVariable != null) if (byteArrayVariable .Length != 0) //Do something with byteArrayVariable O if ((byteArrayVariable != null) && (byteArrayVariable.Length != 0)) //Do something with byteArrayVariable Preferisco leggere e scrivere il secondo, ma ricordo di aver letto in codice completo che fare …

11 programming-practices coding-standards maintenance readability

Domande taggate «readability»