#1381: PhoneNumberUtils.kt
projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt Clase Kotlin, projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt 289 líneas · 165 código · 84 comentarios · 40 en blanco
Propósito: Archivo fuente: projectforge/framework/utils/PhoneNumberUtils.kt. PhoneNumberUtils.kt es parte de la aplicación de gestión de proyectos de código abierto ProjectForge.
Fuente (primeras 100 líneas)
/////////////////////////////////////////////////////////////////////////////
//
// Proyecto ProjectForge Community Edition
// www.projectforge.org
//
// Copyright (C) 2001-2026 Micromata GmbH, Alemania (www.micromata.com)
//
// ProjectForge tiene doble licencia.
//
// Esta edición comunitaria es software libre; puedes redistribuirla y/o
// modificarla bajo los términos de la Licencia Pública General GNU publicada
// por la Free Software Foundation; versión 3 de la Licencia.
//
// Esta edición comunitaria se distribuye con la esperanza de que sea útil,
// pero SIN NINGUNA GARANTÍA; sin siquiera la garantía implícita de
// COMERCIABILIDAD o IDONEIDAD PARA UN PROPÓSITO PARTICULAR. Consulte la Licencia
// General Pública de GNU para más detalles.
//
// Deberías haber recibido una copia de la Licencia Pública General GNU junto
// con este programa; si no, visita http://www.gnu.org/licenses/.
//
/////////////////////////////////////////////////////////////////////////////
package org.projectforge.framework.utils
import org.projectforge.framework.configuration.Configuration
import org.projectforge.framework.configuration.ConfigurationParam
/**
* Funciones de utilidad para normalización y formateo de números de teléfono.
*
* @author Kai Reinhard (k.reinhard@micromata.de)
*/
object PhoneNumberUtils {
// Códigos de país comunes (1-3 dígitos)
private val KNOWN_COUNTRY_CODES = setOf(
"1", // EE. UU., Canadá
"7", // Rusia, Kazajistán
"20", "27", // Egipto, Sudáfrica
"30", "31", "32", "33", "34", "36", "39", "40", "41", "43", "44", "45", "46", "47", "48", "49", // Europa
"51", "52", "53", "54", "55", "56", "57", "58", // Sudamérica
"60", "61", "62", "63", "64", "65", "66", // Asia/Oceanía
"81", "82", "84", "86", "90", "91", "92", "93", "94", "95", "98", // Asia
"212", "213", "216", "218", "220", "221", "222", "223", "224", "225", "226", "227", "228", "229", // África
"230", "231", "232", "233", "234", "235", "236", "237", "238", "239", "240", "241", "242", "243", "244", "245", "246", "247", "248", "249", // África
"250", "251", "252", "253", "254", "255", "256", "257", "258", "260", "261", "262", "263", "264", "265", "266", "267", "268", "269", // África
"290", "291", "297", "298", "299", // Atlántico
"350", "351", "352", "353", "354", "355", "356", "357", "358", "359", // Europa
"370", "371", "372", "373", "374", "375", "376", "377", "378", "380", "381", "382", "383", "385", "386", "387", "389", // Europa
"420", "421", "423", // Europa
"500", "501", "502", "503", "504", "505", "506", "507", "508", "509", "590", "591", "592", "593", "594", "595", "596", "597", "598", "599", // Américas
"670", "671", "672", "673", "674", "675", "676", "677", "678", "679", "680", "681", "682", "683", "684", "685", "686", "687", "688", "689", "690", "691", "692", // Pacífico
"850", "852", "853", "855", "856", "880", "886", // Asia
"960", "961", "962", "963", "964", "965", "966", "967", "968", "970", "971", "972", "973", "974", "975", "976", "977", "992", "993", "994", "995", "996", "998" // Asia/Oriente Medio
)
/**
* Normaliza un número de teléfono a un formato estandarizado y legible.
*
* Formato: +[País] [Área] [Número][-Extensión]
*
* Ejemplos:
* - "0561 316793-0" → "+49 561 316793-0"
* - "+49 (0) 561 / 316793-0" → "+49 561 316793-0"
* - "0170 1234567" → "+49 170 1234567"
* - "+1 415 555-1234" → "+1 415 5551234"
*
* @param phoneNumber El número de teléfono a normalizar (puede contener espacios, barras, paréntesis, etc.)
* @param defaultCountryPrefix El prefijo de país predeterminado a usar si no hay ninguno presente (por defecto: desde configuración o "+49")
* @return Número de teléfono normalizado en formato "+CC AAA NNNNNNN[-EXT]" o null si la entrada es nula/vacía
*/
fun normalizePhoneNumber(
phoneNumber: String?,
defaultCountryPrefix: String = getDefaultCountryPrefix()
): String? {
if (phoneNumber.isNullOrBlank()) {
return null
}
var cleaned = phoneNumber.trim()
// Eliminar prefijos como "Tel:", "Phone:", "Fax:", etc.
cleaned = cleaned.replace(Regex("^(?:Tel\\.?:|Telefon:|Phone:|Mobil:|Mobile:|Fax:)\\s*", RegexOption.IGNORE_CASE), "")
// Eliminar caracteres de control UTF
cleaned = cleaned.replace("\\p{C}".toRegex(), "")
// Eliminar (0) en +49 (0) 123456789
cleaned = cleaned.replace(Regex("\\(0\\)"), "")
// Eliminar paréntesis y barras al inicio para la detección del código de país
cleaned = cleaned.replace(Regex("[/()]"), "")
if (cleaned.isEmpty()) {
return null
}
// Devolver números muy cortos (3 dígitos o menos) sin cambios: números de emergencia, códigos cortos, etc.
// Ejemplos: 0, 00, 110, 112
Historial Git
868d6abb7 2025 -> 2026
2b9888261 Refactorizado el formateo de números en Sipgate y manejo de vcard.
a2608ee2e PhoneNumberUtils...
c624d79b8 PhoneNumberUtils.formatPhoneNumber y AddressTextParser
868d6abb7
2025 -> 2026868d6abb75cd191a892911ac8e45058932cf9074
diff --git a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
index 320fb1c99..37ee6ed30 100644
--- a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
+++ b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
@@ -3,7 +3,7 @@
// Project ProjectForge Community Edition
// www.projectforge.org
//
-// Copyright (C) 2001-2025 Micromata GmbH, Germany (www.micromata.com)
+// Copyright (C) 2001-2026 Micromata GmbH, Germany (www.micromata.com)
//
// ProjectForge is dual-licensed.
//
2b9888261
Refactorizado el formateo de números en Sipgate y manejo de vcard.2b9888261f5880a0d9bda8d7343c4367bd32d7c9
diff --git a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
index 506ea65ab..320fb1c99 100644
--- a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
+++ b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
@@ -89,21 +89,50 @@ object PhoneNumberUtils {
// Eliminar (0) en +49 (0) 123456789
cleaned = cleaned.replace(Regex("\\(0\\)"), "")
+ // Eliminar paréntesis y barras al inicio para la detección del código de país
+ cleaned = cleaned.replace(Regex("[/()]"), "")
+
if (cleaned.isEmpty()) {
return null
}
+ // Devolver números muy cortos (3 dígitos o menos) sin cambios: números de emergencia, códigos cortos, etc.
+ // Ejemplos: 0, 00, 110, 112
+ // Pero NO si comienzan con 00X (prefijo internacional) o +X
+ val digitCount = cleaned.count { it.isDigit() }
+ if (digitCount in 1..3) {
+ // Permitir "0", "00", "110", "112" etc. pasar sin cambios
+ // Pero bloquear "001", "0049" etc. (formato internacional) - necesitan procesamiento
+ if (cleaned == "0" || cleaned == "00" || !cleaned.startsWith("00") && !cleaned.startsWith("+")) {
+ return cleaned
+ }
+ }
+
// Extraer código de país
- val (countryCode, remainingPart) = extractCountryCode(cleaned, defaultCountryPrefix)
+ val (countryCode, remainingPart, hasPrefix) = extractCountryCode(cleaned, defaultCountryPrefix)
+
+ // Si no se detectó prefijo (sin +, sin 00, sin 0 inicial), devolver el número limpio sin cambios
+ if (!hasPrefix) {
+ // Solo limpiar caracteres especiales y normalizar espacios
+ val result = cleaned
+ .replace(".", " ")
+ .replace(Regex("\\s+"), " ")
+ .trim()
+ // Pero validar que contenga al menos algunos dígitos
+ if (!result.contains(Regex("\\d"))) {
+ return null
+ }
+ return result
+ }
if (remainingPart.isBlank()) {
- return null
+ // Si solo existe el código de país (ej., "001" -> "+1"), devolver solo el código de país
+ return countryCode
}
- // Limpiar parte restante: reemplazar puntos con espacios (separador), eliminar barras/paréntesis, luego normalizar espacios
+ // Limpiar parte restante: reemplazar puntos con espacios (separador), luego normalizar espacios
var remaining = remainingPart.trim()
.replace(".", " ") // El punto es un separador entre bloques de números
- .replace(Regex("[/()]"), "") // Eliminar barras, paréntesis
.replace(Regex("\\s+"), " ") // Normalizar múltiples espacios a un solo espacio
.trim()
a2608ee2e
PhoneNumberUtils...a2608ee2e9bf20343a26a5543fc0f06176735862
diff --git a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
index 41a89f714..506ea65ab 100644
--- a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
+++ b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
@@ -100,9 +100,10 @@ object PhoneNumberUtils {
return null
}
- // Limpiar parte restante: eliminar barras, puntos, paréntesis primero, luego normalizar espacios
+ // Limpiar parte restante: reemplazar puntos con espacios (separador), eliminar barras/paréntesis, luego normalizar espacios
var remaining = remainingPart.trim()
- .replace(Regex("[/().]"), "") // Eliminar barras, paréntesis, puntos
+ .replace(".", " ") // El punto es un separador entre bloques de números
+ .replace(Regex("[/()]"), "") // Eliminar barras, paréntesis
.replace(Regex("\\s+"), " ") // Normalizar múltiples espacios a un solo espacio
.trim()
c624d79b8
PhoneNumberUtils.formatPhoneNumber y AddressTextParserc624d79b8c005f4f746148f647e9eb1dbff3226f
diff --git a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
new file mode 100644
index 000000000..41a89f714
--- /dev/null
+++ b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
@@ -0,0 +1,256 @@
+/////////////////////////////////////////////////////////////////////////////
+//
+// Proyecto ProjectForge Community Edition
+// www.projectforge.org
+//
+// Copyright (C) 2001-2025 Micromata GmbH, Alemania (www.micromata.com)
+//
+// ProjectForge tiene doble licencia.
+//
+// Esta edición comunitaria es software libre; puedes redistribuirla y/o
+// modificarla bajo los términos de la Licencia Pública General GNU publicada
+// por la Free Software Foundation; versión 3 de la Licencia.
+//
+// Esta edición comunitaria se distribuye con la esperanza de que sea útil,
+// pero SIN NINGUNA GARANTÍA; sin siquiera la garantía implícita de
+// COMERCIABILIDAD o IDONEIDAD PARA UN PROPÓSITO PARTICULAR. Consulte la
+// Licencia General Pública de GNU para más detalles.
+//
+// Deberías haber recibido una copia de la Licencia Pública General GNU junto
+// con este programa; si no, visita http://www.gnu.org/licenses/.
+//
+/////////////////////////////////////////////////////////////////////////////
+
+package org.projectforge.framework.utils
+
+import org.projectforge.framework.configuration.Configuration
+import org.projectforge.framework.configuration.ConfigurationParam
+
+/**
+ * Funciones de utilidad para normalización y formateo de números de teléfono.
+ *
+ * @author Kai Reinhard (k.reinhard@micromata.de)
+ */
+object PhoneNumberUtils {
+
+ // Códigos de país comunes (1-3 dígitos)
+ private val KNOWN_COUNTRY_CODES = setOf(
+ "1", // EE. UU., Canadá
+ "7", // Rusia, Kazajistán
+ "20", "27", // Egipto, Sudáfrica
+ "30", "31", "32", "33", "34", "36", "39", "40", "41", "43", "44", "45", "46", "47", "48", "49", // Europa
+ "51", "52", "53", "54", "55", "56", "57", "58", // Sudamérica
+ "60", "61", "62", "63", "64", "65", "66", // Asia/Oceanía
+ "81", "82", "84", "86", "90", "91", "92", "93", "94", "95", "98", // Asia
+ "212", "213", "216", "218", "220", "221", "222", "223", "224", "225", "226", "227", "228", "229", // África
+ "230", "231", "232", "233", "234", "235", "236", "237", "238", "239", "240", "241", "242", "243", "244", "245", "246", "247", "248", "249", // África
+ "250", "251", "252", "253", "254", "255", "256", "257", "258", "260", "261", "262", "263", "264", "265", "266", "267", "268", "269", // África
+ "290", "291", "297", "298", "299", // Atlántico
+ "350", "351", "352", "353", "354", "355", "356", "357", "358", "359", // Europa
+ "370", "371", "372", "373", "374", "375", "376", "377", "378", "380", "381", "382", "383", "385", "386", "387", "389", // Europa
+ "420", "421", "423", // Europa
+ "500", "501", "502", "503", "504", "505", "506", "507", "508", "509", "590", "591", "592", "593", "594", "595", "596", "597", "598", "599", // Américas
+ "670", "671", "672", "673", "674", "675", "676", "677", "678", "679", "680", "681", "682", "683", "684", "685", "686", "687", "688", "689", "690", "691", "692", // Pacífico