La clase ControllerHelper
es una parte fundamental de RESTFox y proporciona diversas funcionalidades para asistir en el desarrollo de APIs RESTful en Visual FoxPro. En este manual, exploraremos los métodos disponibles en esta clase y proporcionaremos ejemplos de cómo utilizarlos.
El método SetConnectionString
se utiliza para establecer la cadena de conexión a la base de datos que se utilizará para las operaciones de base de datos en el controlador.
Ejemplo:
oHelper.SetConnectionString("DRIVER={MariaDB ODBC 3.1 Driver};SERVER=localhost;USER=root;PASSWORD=1234;PORT=3309;DATABASE=mi_basededatos")
El método OpenConnection
se utiliza para abrir una conexión a la base de datos utilizando la cadena de conexión previamente establecida.
Ejemplo:
IF oHelper.OpenConnection()
&& "Conexión abierta exitosamente"
ELSE
&& "Error al abrir la conexión"
ENDIF
El método CloseConnection
se utiliza para cerrar la conexión a la base de datos.
Ejemplo:
oHelper.CloseConnection()
&& "Conexión cerrada"
El método QueryToJSON se utiliza para ejecutar una consulta SQL y devolver el resultado en formato JSON.
Ejemplo:
oHelper.cQuery = "SELECT * FROM productos"
cJsonResult = oHelper.QueryToJSON()
El método ExecuteQuery se utiliza después de una consulta de inserción, actualización o eliminación para ejecutarla en la base de datos.
Ejemplo:
oHelper.cQuery = "INSERT INTO productos (nombre, precio) VALUES ('Producto1', 10.99)"
IF oHelper.ExecuteQuery()
&& "Registro insertado exitosamente"
ELSE
&& "Error al insertar el registro"
ENDIF
El método GetLastID se utiliza después de una inserción para obtener el último ID insertado en la tabla.
Ejemplo:
IF oHelper.ExecuteQuery()
nLastID = oHelper.GetLastID()
&& "Último ID insertado: " + TRANSFORM(nLastID)
ELSE
&& "Error al insertar el registro"
ENDIF
El método GetExceptionMessage se utiliza para obtener el mensaje de excepción generado por una operación.
Ejemplo:
TRY
// Operación que genera una excepción
CATCH TO loEx
cErrorMessage = oHelper.GetExceptionMessage(loEx)
&& "Error: " + cErrorMessage
ENDTRY
Estos son algunos de los métodos más comunes disponibles en la clase ControllerHelper. Puedes utilizarlos para gestionar las operaciones de base de datos y controlar las excepciones en tus controladores.