Rinominazione e deprezzamento dei comandi

Tradotto automaticamente da Deepl

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.

Avatar
- Product Marketing Manager - Intissar è entrata in 4D nel 2017 come Product Marketing Manager. Lavora a stretto contatto con i team di prodotto, marketing, ingegneria e supporto tecnico per evidenziare il "perché", il "come" e il "cosa" delle nuove funzionalità e di quelle aggiornate a diversi pubblici. Questa vicinanza le consente di creare strutture di messaggistica e di scrivere contenuti approfonditi ed esempi di codice per il blog e il sito web di 4D. Dopo aver conseguito la laurea in Informatica presso l'università VINCI, Intissar ha lavorato in diverse startup come ingegnere informatico. La sua esperienza pratica comprende le specifiche, la progettazione e lo sviluppo del software, la formazione e il supporto agli utenti e la gestione del team.