Come sviluppatori, tutti apprezziamo l’efficienza e la semplicità delle nostre routine di codifica. Meno sequenze di tasti dobbiamo ricordare, meglio è!
Per questo motivo, in 4D 20 R7 stiamo rivedendo e perfezionando i nomi dei comandi, eliminando quelli obsoleti, per renderli più brevi, coerenti e allineati ai moderni standard di sviluppo.
Perché questo cambiamento?
Nel corso del tempo, alcuni nomi di comandi sono diventati inutilmente lunghi o incoerenti. L’obiettivo di questo aggiornamento è di risolvere questi problemi allineando i nomi dei comandi a una regola chiara:
Utilizzare “Get ” solo quando esiste un comando corrispondente “Set“.
Ad esempio, è possibile “Ottenere” un valore se è possibile anche “Impostare”.
Considerate questi esempi:
- Random invece di Get random (poiché non è possibile impostare un valore casuale).
- Current process invece di Get current process (non è possibile impostare il processo corrente).
Inoltre, alcuni comandi hanno superato la loro utilità e sono stati sostituiti da alternative più potenti. Questi comandi obsoleti vengono ufficialmente deprecati per incoraggiare gli sviluppatori a usare le versioni aggiornate con funzionalità migliori.
Rinominazione dei comandi
Abbiamo identificato 22 comandi che devono essere rinominati. Questi comandi hanno attualmente un prefisso “Get”, ma non ne hanno necessariamente bisogno perché non esiste un comando “Set” corrispondente.
Ecco un elenco dei nomi attuali e aggiornati:
Comando attuale |
Nuovo comando |
---|---|
Get action info | Action info |
GET ACTIVITY SNAPSHOT | ACTIVITY SNAPSHOT |
Get application info | Application info |
GET BACKUP INFORMATION | BACKUP INFO |
Get call chain | Call chain |
Get database measures | Database measures |
Get last field number | Last field number |
Get last query path | Last query path |
Get last query plan | Last query plan |
Get last table number | Last table number |
Get license info | License info |
Get license usage | License usage |
Get localized document path | Localized document path |
Get localized string | Localized string |
Get locked records info | Locked records info |
GET MEMORY STATISTICS | MEMORY STATISTICS |
Get Monitored Activity | Monitored activity |
GET MOUSE | MOUSE POSITION |
GET RESTORE INFORMATION | RESTORE INFO |
Get system info | System info |
Get table fragmentation | Table fragmentation |
Session storage by id | Session storage |
Comandi deprecati
Oltre alla ridenominazione dei comandi, alcuni di quelli obsoleti sono stati deprecati. Questi comandi non sono più rilevanti o sono stati sostituiti da alternative più robuste, che spesso offrono funzionalità e prestazioni migliori.
Ecco un elenco dei comandi deprecati, insieme ai loro moderni sostituti:
Nome deprecato |
Sostituzione |
---|---|
_O_GET LAST ERROR STACK | Last errors |
_O_PROCESS PROPERTIES | Process info |
_O_GET SERIAL INFORMATION | License info |
_O_SET SCREEN DEPTH | (non più necessario) |
Quali sono le conseguenze?
Per chi lavora in modalità binaria o utilizza l’opzione “Includi i token nei file sorgente del progetto”, non è necessario intervenire. Il processo di tokenizzazione gestisce automaticamente queste modifiche, garantendo un funzionamento regolare senza interventi manuali.
Se non si utilizzano i token, è necessario cercare e sostituire manualmente i nomi dei comandi deprecati nel codice. Sebbene questo richieda un certo sforzo iniziale, è essenziale per mantenere il codice pulito e a prova di futuro.
Tuttavia, sappiamo che non tutti gli sviluppatori utilizzano i token. Riconosciamo che la modifica dei nomi può essere una sfida per coloro che non lo fanno. Aggiornare manualmente il codice con strumenti di ricerca e sostituzione non è l’ideale, anche se i moderni editor di testo semplificano il processo con la funzionalità di “ricerca nei file”.
Ecco perché non cambiamo spesso i nomi dei comandi. Piuttosto, raccogliamo gli aggiornamenti nel tempo e li implementiamo in lotti più grandi, come stiamo facendo ora, per prepararci a 4D 21. Visti i numerosi miglioramenti apportati al linguaggio 4D, riteniamo fondamentale affrontare i nomi dei comandi confusi o obsoleti per garantire chiarezza e coerenza in futuro.
Per ulteriori dettagli, visitate il nostro centro di documentazione o partecipate alla discussione sui forum 4D. Siamo a disposizione per aiutarvi a gestire questi cambiamenti e garantire una transizione senza problemi.