Buscar | InterSystems Developer Community

Artículo

Ricardo Paiva · 15 mar, 2023

Cómo llamar métodos de clase con la API nativa para Python

El [SDK nativo para Python](https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=BPYNAT_about) de InterSystems es una interfaz ligera para las APIs de InterSystems IRIS, que anteriormente solo estaba disponible mediante ObjectScript. Estoy especialmente interesado en la capacidad de llamar a los métodos de ObjectScript, a los métodos de clase, para ser más preciso. Esto funciona, y funciona muy bien, pero de manera predeterminada, las llamadas únicamente admiten argumentos escalares: strings, booleanos, enteros y flotantes. Pero si lo que quieres es: - Pasar o devolver estructuras, como diccionarios (dicts) o listas - Pasar o devolver *streams* Necesitarás escribir algún código adhesivo (*glue code*) o aprovechar este [proyecto](https://github.com/eduard93/edpy) (se instala mediante `pip install edpy`). El paquete `edpy` te da una estructura sencilla: ```python call(iris, class_name, method_name, args) ``` que te permite llamar a cualquier método de ObjectScript y obtener los resultados. Se importa así: ```python from edpy import iris ``` `call` acepta 4 argumentos necesarios: - `iris` - hace referencia a un [objeto de IRIS](https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=BPYNAT_refapi#BPYNAT_refapi_class-iris) establecido - `class_name` - la clase de IRIS que debe llamarse - `method_name` - el método de IRIS que debe llamarse - `args` - lista con 0 o más argumentos ## Argumentos Cada argumento puede ser alguno de los siguientes: - *string* (de cualquier longitud, si es mayor que `$$$MaxStringLength` o 3641144 símbolos, se convertirá automáticamente en un *stream*) - booleano - entero - flotante - dict (se convierte en un objeto dinámico) - lista o tupla (se convierte en una matriz dinámica) Los argumentos de dict, lista y tupla pueden contener otros dicts, listas y tuplas de forma recurrente (mientras dure la memoria). ## Valor devuelto A cambio, esperamos o un objeto/matriz dinámico o una string/stream JSON. En ese caso, edpy primero lo convertiría en un string Python y, si fuera posible, lo interpretaría como un dict o lista Python. De lo contrario, el resultado sería devuelto tal cual. Eso es todo lo que debemos saber por el momento, pero permíteme dar algunos ejemplos de métodos ObjectScript y cómo llamarlos usando esta función de Python. ## Ejemplo 1: Pong ```objectscript ClassMethod Test(arg1, arg2, arg3) As %DynamicArray { return [(arg1), (arg2), (arg3)] } ``` Se llama con: ``` >>> iris.call(iris_native, "User.Py", "Test", [1, 1.2, "ABC"]) [1, 1.2, 'ABC'] ``` El resultado no es ninguna sorpresa. Los argumentos se vuelven a empaquetar en una matriz y se devuelven. ## Ejemplo 2: Propiedades ```objectscript ClassMethod Test2(arg As %DynamicObject) As %String { return arg.Prop } ``` Se llama así: ``` >>> iris.call(iris_native, "User.Py", "Test2", [{"Prop":123}]) 123 ``` Para una invocación más embebida: ``` >>> iris.call(iris_native, "User.Py", "Test2", [{"Prop":{"Prop2":123}}]) {'Prop2': 123} ``` No hay ningún problema si una propiedad es demasiado larga: se utilizarán *streams* para enviarla y/o devolverla a IRIS: ``` ret = iris.call(iris_native, "User.Py", "Test2", [{"Prop":"A" * 10000000}]) >>> len(ret) 10000000 ``` Si necesitas streams garantizados en el lado de InterSystems IRIS, puedes usar [%Get](https://docs.intersystems.com/irislatest/csp/documatic/%25CSP.Documatic.cls?&LIBRARY=%25SYS&CLASSNAME=%25Library.DynamicObject#%25Get): ```objectscript set stream = arg.%Get("Prop",,"stream") ``` Si el stream está codificado en base64, puedes descodificarlo automáticamente mediante: ```objectscript set stream = arg.%Get("Prop",,"stream

primero
anterior
…
52
53
54
55
56
…
siguiente
último