From b9c35f4a412b60f187a8cd45ad6e77c731100b54 Mon Sep 17 00:00:00 2001
From: paula-cano <paula.14canob@gmail.com>
Date: Sat, 13 Sep 2025 22:05:26 -0500
Subject: [PATCH] creacion de comentarios a los metodos de la clase UpgradeUtil
 y al metodo de la clase HttpClient

---
 .../java/org/openmrs/util/HttpClient.java     |  6 ++++
 .../java/org/openmrs/util/UpgradeUtil.java    | 36 +++++++++++++++++++
 2 files changed, 42 insertions(+)

diff --git a/api/src/main/java/org/openmrs/util/HttpClient.java b/api/src/main/java/org/openmrs/util/HttpClient.java
index 51decec1f776..2a5e83363d62 100644
--- a/api/src/main/java/org/openmrs/util/HttpClient.java
+++ b/api/src/main/java/org/openmrs/util/HttpClient.java
@@ -41,6 +41,12 @@ public HttpClient(HttpUrl url) {
 		this.url = url;
 	}
 	
+	/**
+	 * Realiza una consulta http post a la url que ingresa al constructor y devuelve la respuesta del servidor
+	 * 
+	 * @param parameters parametro de ingreso al constructor
+	 * @return respuesta del servidos
+	 */
 	public String post(Map<String, String> parameters) {
 		OutputStreamWriter wr = null;
 		BufferedReader rd = null;
diff --git a/api/src/main/java/org/openmrs/util/UpgradeUtil.java b/api/src/main/java/org/openmrs/util/UpgradeUtil.java
index 3a706e05b5c4..37ddf4728d0f 100644
--- a/api/src/main/java/org/openmrs/util/UpgradeUtil.java
+++ b/api/src/main/java/org/openmrs/util/UpgradeUtil.java
@@ -74,6 +74,15 @@ public static Integer getConceptIdForUnits(String units) {
 		        + ". Please refer to upgrade instructions for more details. https://wiki.openmrs.org/x/OALpAw");
 	}
 	
+	/**
+	 * 
+	 * Busca en la base de datos el uuid del concepto cuyo concept_id es igual al que se pasa como parametro
+	 * 
+	 * @param connection
+	 * @param conceptId
+	 * @return
+	 * @throws SQLException
+	**/
 	public static String getConceptUuid(Connection connection, int conceptId) throws SQLException {
 
 		try (PreparedStatement select = connection.prepareStatement("select uuid from concept where concept_id = ?")) {
@@ -88,6 +97,15 @@ public static String getConceptUuid(Connection connection, int conceptId) throws
 		}
 	}
 	
+	/**
+	 * 
+	 * El parametro gp que se ingresa es buscado en la base para saber si existe y si es asi devuelve su valor
+	 * 
+	 * @param connection
+	 * @param gp
+	 * @return
+	 * @throws SQLException
+	**/
 	public static String getGlobalProperty(Connection connection, String gp) throws SQLException {
 
 		try (PreparedStatement select = connection
@@ -103,6 +121,15 @@ public static String getGlobalProperty(Connection connection, String gp) throws
 		}
 	}
 	
+	/**
+	 * 
+	 * al ingresar el identificador lo busca en la base de datos y devuelve una lista con los conceptos que pertenecen a ese grupo
+	 * 
+	 * @param connection
+	 * @param conceptUuid
+	 * @return lista de los conceptos que pertenecen al grupo
+	 * @throws SQLException
+	**/
 	public static List<Integer> getMemberSetIds(Connection connection, String conceptUuid) throws SQLException {
 		Integer conceptSetId;
 
@@ -132,6 +159,15 @@ public static List<Integer> getMemberSetIds(Connection connection, String concep
 		return conceptIds;
 	}
 	
+	/**
+	 * 
+	 * al ingresar el concepto se busca en la base de datos si existe ese valor, si es asi devuelve su identificador
+	 * 
+	 * @param connection
+	 * @param conceptIdForFrequency
+	 * @return identificador del concepto
+	 * @throws SQLException
+	**/
 	public static Integer getOrderFrequencyIdForConceptId(Connection connection, Integer conceptIdForFrequency)
 	        throws SQLException {
 		PreparedStatement orderFrequencyIdQuery = connection