# Diferencias con 1.x **Principio**: la salida observable de 2.0 es la misma que la de 1.x. Cada cambio se validó contra el motor 1.x original: 248 programas de conformidad, 790 casos de una aplicación web real con base de datos detrás de nginx (0 diferencias del motor), 690 casos del parser multipart, más de 860 mil casos de JSON y los kits de bases de datos en los cuatro motores. Las únicas diferencias son **intencionales** y están en esta página. Casi todas corrigen defectos de 1.x y se aplicaron **sin opción** para volver al comportamiento anterior. Lo que ya no existe está en [Lo que ya no existe](/es/devkron/2.0/migracion/retirado.md). ## Lenguaje y motor | Tema | 1.x | 2.0 | |---|---|---| | Lectura de números en servidores con coma decimal (es-CO, es-VE, es-ES) | `1.5` se leía `15`; `val("2.25")`, `225` | siempre punto decimal ([Cultura](/es/devkron/2.0/migracion/cultura.md)) | | `format`, `date_str`, marcas `#` | cultura del proceso | cultura de presentación configurable; mismo resultado que 1.x en el mismo servidor si la entrada era la misma | | Formatear y volver a leer (`parse.num(format(…))`) en es-CO/es-ES | "funcionaba" | da 0: vea el [riesgo](/es/devkron/2.0/migracion/cultura.md) | | `toupper`/`tolower` en cultura turca | `i` → `İ` | invariantes | | `@set(campo, valor)` de `functions.dkh` | siempre fallaba: `Variable 'isset' no definida` | funciona | | `include` en ejecución dentro de un ciclo | se ejecutaba 1+2+…+N veces | una vez por iteración | | `#include` como último token de un archivo incluido | `{9999} … Object reference not set…` | funciona | | `#include "sub/x.dkh"` buscado por `#path` en Linux | `No se puede encontrar el archivo sub\x.dkh` | se encuentra | | `_new(tipo, a, b)` | omitía el último argumento del constructor | los pasa todos | | función externa mapeada llamada por `namespace`, `alias` o `using` | `KeyNotFoundException` | funciona | | `a, b << r` con un campo que es objeto | la referencia se perdía después del siguiente `do` (`null`) | se conserva | | `case`/`default` fuera de un `switch`; error en la expresión de `switch` | `Stack empty.` | `La sentencia 'case' debe estar dentro de un bloque 'switch'`; el error real de la expresión | | `#path` sin cadena, `#include "x" palabra` | el análisis seguía en silencio | error `{131}` | | error de sintaxis 128 | decía `[102]` | dice `[128]` | | mensaje de error de `runcode` | "Error al invocar runscript" | "Error al invocar runcode" | | `write_bytes` con algo que no es `byte[]` | informaba siempre `System.Decimal` | informa el tipo real | | `include` con una expresión vacía | `No se pudo encontrar el archivo: ` | `La expresión no produjo un nombre de archivo` | | `runcode` con un `#include` | `Value cannot be null. (Parameter 'path1')` | el include se resuelve | | recursión máxima | ~1,989 niveles | ~2,946 niveles | | plantillas GT (`dklgt/main-template`, `#include … with/build`) | funcionaban | retiradas: error claro ([Lo que ya no existe](/es/devkron/2.0/migracion/retirado.md)) | | JSON cíclico o demasiado anidado en `to.json`/`from.json` | abortaba el proceso completo | excepción normal, que se captura con `exception` | | carácter que el analizador no reconoce en el código | el programa se quedaba colgado | error de sintaxis | | función .NET mapeada (también las de `functions.dkh`) con un argumento que es una función de usuario que falla, p. ej. `log._append(log.file(), texto)` con `log.file()` fallando | se llamaba con el valor que devolvió la que falló (`0`: se creaba un archivo `0`) y después se saltaba al `exception` | desde 2.0.5.0 no se llama y se salta al `exception`, igual que cuando falla una función base (2.0.0–2.0.4, igual que 1.x) | | `_import_library` en Linux con una ruta escrita con `\`, p. ej. `ruta + "\\" + "x.dll"` | cargaba | 2.0.0–2.0.4: `Could not load file or assembly`; desde 2.0.5.0, si la ruta no existe tal cual se prueba con `/` | | `_import_library` con una ruta relativa con carpeta (`"bin/x.dll"`, `"web/sitio/../../x.dll"`) | fallaba: `… is not an absolute path` | desde 2.0.5.0 se resuelve contra la carpeta de trabajo; un nombre sin carpeta se sigue buscando junto a `dkl` | Por ejemplo, un registro que se contiene a sí mismo: ```dkl #include "dkli.dkh" #! program "ejemplo" { #include "functions.dkh" #include "serialize.dkh" new a {$$ "x": 1 $$} a<"yo*">: a do print(to.json(a)) exception { do print(last_error()) do clear_exceptions() } do print("sigue") } ``` ```text {1} Error en 'to.json. (JSON: referencia circular, un objeto se contiene a sí mismoException has been thrown by the target of an invocation.) [ejemplo.dkl][Ln= 9] sigue ``` Y la referencia de `<<` que ya no se pierde: ```dkl #include "dkli.dkh" #! program "ejemplo" { #include "functions.dkh" #include "serialize.dkh" new p {$$ "nombre": "Juan", "h": {"x": 1} $$} nombre, h << p do print(nombre) do print(to.json(h)) do print(to.json(h)) } ``` ```text Juan {"x":1} {"x":1} ``` En 1.x la última línea era `null`. La sintaxis nueva (bloques `$$`, flechas, `$`, funciones `list.*`) está en [Novedades](/es/devkron/2.0/introduccion/novedades.md) y en la [Referencia del lenguaje](/es/devkron/2.0/lenguaje/). ## Lanzador `dkl` | Tema | 1.x | 2.0 | |---|---|---| | código de salida | siempre 0 | 1 si hubo un error no manejado, de sintaxis, archivo inexistente o argumento inválido | | `-output:C:\x\y.html`, `-log:C:\x` | se cortaba en el segundo `:` | las rutas absolutas de Windows funcionan | | licencia en modo consola | se leía y descifraba en cada ejecución | solo se lee si ya hay otra instancia (el único caso en que decide algo); mismo resultado, ~20 ms menos | | opciones nuevas | — | `-culture`, `-compile`, `-native-cache-dir:`, `-tree-output`, `-tree-cache`, `-tree-cache-dir:` ([Consola](/es/devkron/2.0/instalacion/consola.md)) | ## Estado entre ejecuciones (FastCGI y `runscript`) | Tema | 1.x | 2.0 | |---|---|---| | `#path` agregado por una petición | lo veían las siguientes peticiones del proceso | solo dura esa ejecución | | `errordet()` | global del proceso | por ejecución | | objetos que quedan vivos al terminar (conexiones, streams) | se quedaban abiertos | se llama `Dispose` al terminar cada ejecución o petición | | lo que deja un `runscript`/`runcode` al terminar | lo que nadie usa lo recoge el recolector de memoria | 2.0.0–2.0.4: se retenía todo hasta el final de la ejecución principal (memoria y conexiones en procesos largos); desde 2.0.5.0, como 1.x, y lo que quedó en un objeto del programa que lo llamó se libera al final ([Aislamiento](/es/devkron/2.0/migracion/aislamiento.md)) | | `print` de un programa que corre bajo FastCGI, fuera de la respuesta | se perdía | llega a la salida estándar del proceso (el *journal* de systemd) desde 2.0.3; se conserva así | | trabajadores de la biblioteca `dkl.async.dll` de 1.x | en la práctica corrían pocos a la vez | corren en paralelo los que permita el sistema: un lote grande que abre conexiones puede pasar del tope del *pool* (100); acote el lote o use `threads.dkh` | | funciones anidadas en el programa de nivel superior | fallaban desde la **segunda** ejecución del proceso | funcionan en todas | | `adapters.xml`, `connections.xml` | solo en el directorio de trabajo | también junto a `dkl` | Detalle y lo que **no** cambió (funciones anidadas en páginas web) en [Aislamiento por petición](/es/devkron/2.0/migracion/aislamiento.md). ## Servidor FastCGI `@http_context` es **idéntico llave por llave** (verificado volcando `to.json(@http_context)` completo en ambos motores). Diferencias del servidor: | # | 1.x | 2.0 | |---|---|---| | D1 | se perdía el **último parámetro FastCGI** de cada petición (con nginx, el último encabezado del navegador: `HTTP_CONTENT_LENGTH` en un POST, o `HTTP_COOKIE`, `HTTP_USER_AGENT`, `HTTP_ACCEPT`…); por eso se agregaba `fastcgi_param HTTP_COOKIE` en nginx | no se pierde nada | | D2 | `response/http_status` no tenía efecto: nginx e IIS respondían siempre 200 | **ahora sí tiene efecto**: se envía el estado (404, 201, 500…). Vea [Errores HTTP 500](/es/devkron/2.0/migracion/errores-http.md) | | D3 | un cierre abrupto de conexión, un cliente que se desconecta o datos inválidos tumbaban el proceso | se cierra solo esa conexión | | D4 | una conexión inactiva retenía su lugar para siempre (con 3 lugares sin licencia, el servidor dejaba de responder) | tiempos de espera reales: `connection_timeout` y `keepalive_timeout` | | D5 | el cuerpo completo iba a memoria, sin límite | se recibe por partes; arriba de 1 MB va a un temporal; límite opcional `max_body_size` (413) | | D6 | parámetros más grandes que `max_header_size`: se cerraba la conexión (nginx daba 502) | responde 431 | | D7 | los temporales de archivos subidos podían quedar huérfanos en `/tmp` | se borran siempre | | D8 | el parser multipart quitaba `EF BB BF` al inicio de **cada bloque de 4096 bytes** (un binario con esos bytes perdía 3) | solo al inicio del cuerpo | | D9 | hasta 3 copias en memoria de cada archivo subido | se escribe directo al temporal | | D10 | solo TCP IPv4 | también socket Unix e IPv6 | | D11 | multiplexado, rol desconocido o `GET_VALUES` cerraban la conexión | respuesta correcta del protocolo (nginx no los usa) | Se conservan a propósito: el entorno del proceso copiado a `request/headers`; los valores de cookies, query y `post` cortados en el segundo `=`; `Environment.NewLine` en los campos de texto multipart (`\n` en Linux, `\r\n` en Windows); los encabezados duplicados por diferencias de mayúsculas; un `output="binary"` con `binary=null` sigue sin enviar cuerpo (nginx da 502). ## Datos (`dbr`) | Antes (1.x) | Ahora (2.0) | |---|---| | `dbr.execute` con DDL en SQL Server devolvía -1, igual que un `SELECT` | devuelve 0, como en los demás motores. Si su código distinguía un `SELECT` de un DDL por el -1 en SQL Server, revíselo | | `dbr.login` comparaba distinto en cada motor; en SQL Server concatenaba usuario y hash en el SQL | unificado y parametrizado: hash ASCII contra `LOWER(pwd)` o `LOWER(pwdmd5)`; Unicode (`dbr.setHashUnicode(@true)`) contra `LOWER(pwd)` | | `dbr.lock` de una fila que la misma sesión ya tenía bloqueada fallaba; en MySQL `lock`, `chklock` y `unlock` fallaban siempre | reentrante para la misma sesión (devuelve el mismo id) y funcional en los cuatro motores; un solo `dbr.unlock` libera | | `dbr.is_open` seguía en 1 después de `dbr.close`; un segundo `close` fallaba | 0; un segundo `close` no hace nada | | `dbr.getg` buscaba por `sys_pk` en lugar de `sys_guid` | busca por `sys_guid` | | `dbr.save` con un campo `byte[]` fallaba | se guarda como binario | | `dbr.save` de un cambio devolvía `sys_recver=0` y `sys_guid` vacío | devuelve la fila guardada | | `dbr.update` con filtro `@null` | funciona | | tras un error al leer filas la conexión quedaba inutilizable | sigue usable | | `dbr.num` sobre texto no numérico: mensaje distinto en cada versión | `GetDecimal Error. El valor 'abc' no es numérico` | | números y fechas hacia y desde el SQL con la cultura del servidor | siempre invariantes | | MySQL esperaba ~111 s ante un error permanente | responde de inmediato; los errores transitorios conservan los reintentos | | en MySQL se perdían `` y `` si faltaba ``; en SQL Server `` nunca se leía | se leen siempre | | SQL Server: cadenas como `VarChar` (los caracteres fuera de la página de códigos llegaban como `?`); `Double` como `Real` | `NVarChar`; `Float` exacto | | PostgreSQL no funcionaba en la variante multiplataforma de 1.x | funciona igual que MySQL hacia DKL | Se conservan: `dbr.num` sobre NULL lanza error (sin filas da 0); en MySQL un parámetro que falta vale NULL sin error; las fechas cero de MySQL fallan salvo `ConvertZeroDateTime=true`; `@{param}` se sustituye en el SQL sin escapar (no lo use con datos del usuario). ## Sistema operativo - Devkron 2.0 usa **OpenSSL 3** del sistema y **ya no requiere OpenSSL 1.1** (`libssl1.1`), que Devkron 1.x sí necesitaba. Solo conserve 1.1 si en el mismo servidor sigue corriendo Devkron 1.x. - Escribir en volúmenes SMB o NFS montados funciona sin bibliotecas adicionales ([Escribir en volúmenes de red](/es/devkron/2.0/migracion/linuxfixes.md)). ## Licencia Las licencias de 1.x **no se aceptan** en 2.0 (otra clave de cifrado): el servidor queda en modo demo hasta instalar una licencia emitida para 2.0 ([Licencia](/es/devkron/2.0/instalacion/licencia.md)). ## Comportamientos de 1.x que se conservan - `list.add(l, x)` con un número entero inserta **el objeto** con ese índice, no el valor; use `list.addnum`. Hasta 2.0.3 pasaba también con una cadena numérica o un número con decimales; desde 2.0.4 esos se agregan como valor. - Una expresión que devuelve un objeto (`f(x)` en `@"k": f(x)`, en `list.of` o en un bloque `$$` sin `&`) entrega su **índice** numérico. - Las funciones anidadas (declaradas dentro de otra función) de un `runscript`/`runcode` se registran en el programa que los llama; las de nivel superior, no ([Aislamiento](/es/devkron/2.0/migracion/aislamiento.md)). - `webcl` sigue sobre `HttpWebRequest`/`WebClient` (mismas cabeceras y redirecciones que 1.x); `ssl3` sigue dando error. - `>>` con una variable inexistente o una expresión a la izquierda, y `w >> r.sub`, se comportan como en 1.x. - Las peculiaridades de `@http_context` listadas arriba. ## Limitaciones de lo nuevo - Los bloques `$$` no son expresiones (no se puede escribir `x = $$ … $$`). - `a -> b` (de identificador a identificador) siempre anexa; para sacar un elemento use `a <- l`. - La cultura de presentación es por proceso (o por petición, al configurarla); no hay sentencia para cambiarla desde un programa. - No hay servicio de Windows propio todavía ([Servicio en Windows](/es/devkron/2.0/instalacion/servicio-windows.md)). - Programas que usan sintaxis o funciones nuevas no corren en 1.x.