QNativeIpcKey Class

Descripción detallada

Las clases QSharedMemory y QSystemSemaphore identifican su recurso utilizando un identificador de todo el sistema conocido como "clave". El valor de clave de bajo nivel, así como el tipo de clave, se encapsulan en Qt mediante la clase QNativeIpcKey.

Estas dos clases también proporcionan los medios para crear claves nativas a partir de un identificador multiplataforma, usando QSharedMemory::platformSafeKey() y QSystemSemaphore::platformSafeKey(). Las aplicaciones nunca deben compartir la entrada a esas funciones, ya que diferentes versiones de Qt pueden realizar diferentes transformaciones, resultando en diferentes claves nativas. En su lugar, la aplicación que creó el objeto IPC debería comunicar la clave nativa resultante utilizando los métodos descritos a continuación.

Para más detalles sobre los tipos de claves, limitaciones específicas de la plataforma e interoperabilidad con aplicaciones antiguas o no Qt, consulte la documentación Claves IPC nativas. Esto incluye información importante para aplicaciones en sandbox en plataformas Apple, incluyendo todas las aplicaciones obtenidas a través de la App Store de Apple.

Comunicación de claves a otros procesos

Comunicación de claves a otros procesos Qt

Si el otro proceso soporta QNativeIpcKey, la mejor manera de comunicarse es a través de la representación de cadena obtenida de toString() y analizándola usando fromString(). Esta representación puede ser almacenada en un archivo cuyo nombre es bien conocido o pasada en la línea de comandos a un proceso hijo usando QProcess::setArguments().

Si el otro proceso no soporta QNativeIpcKey, entonces los dos procesos pueden intercambiar el nativeKey() pero es probable que el código anterior no pueda ajustar su tipo de clave. La función legacyDefaultTypeForOs() devuelve el tipo que utilizaba el código antiguo, que puede no coincidir con la constante DefaultTypeForOs. Esto sigue siendo cierto incluso si la aplicación antigua no está utilizando la misma compilación que la nueva (por ejemplo, es una aplicación Qt 5), siempre que las opciones pasadas al script Qt configure sean las mismas.

Comunicación de claves a procesos que no son Qt

Cuando se comunica con procesos que no son Qt, la aplicación debe arreglárselas para obtener el tipo de clave que el otro proceso está utilizando. Esto es importante particularmente en sistemas Unix, donde tanto PosixRealtime como SystemV son comunes.

Representación en cadena de las claves nativas

El formato de la cadena de representación de una QNativeIpcKey pretende ser estable y por tanto compatible hacia atrás y hacia adelante, siempre que el tipo de clave esté soportado por la versión de Qt en cuestión. Es decir, un Qt antiguo fallará al analizar la representación en cadena de un tipo de clave introducido después de su lanzamiento. Sin embargo, analizar con éxito una representación de cadena no implica que las clases Qt puedan crear con éxito un objeto de ese tipo; las aplicaciones deberían verificar el soporte usando QSharedMemory::isKeyTypeSupported() y QSystemSemaphore::isKeyTypeSupported().

El formato de la representación de cadena está formado por dos componentes, separados por dos puntos (':'). El primer componente es el tipo de clave, descrito en la tabla siguiente. El segundo componente es una carga útil específica del tipo, utilizando percent-encoding. Para todos los tipos de clave admitidos actualmente, la forma descodificada es idéntica al contenido del campo nativeKey().

Este formato se asemeja a una URI y permite su análisis mediante funciones de análisis de URI/URL, como QUrl. Al ser analizado por dicha API, el tipo de clave aparecerá como scheme, y la carga útil será path. El uso de query o fragments está reservado.