SDK HTTP de ApsaraMQ for RocketMQ (se recomiendan varios lenguajes) - ApsaraMQ for RocketMQ

ApsaraMQ for RocketMQ proporciona SDK HTTP para varios lenguajes de programación con acceso a Internet público.

Compatibilidad con varios lenguajes de programación

ApsaraMQ for RocketMQ es compatible con protocolos HTTP RESTful y ofrece SDK para siete lenguajes de programación. Las funciones del SDK HTTP se desarrollan de forma continua para alinearse con las del SDK TCP. Para conocer más detalles sobre las diferencias, consulte los temas a continuación:

Notas de uso

Los consumidores HTTP pueden usar sondeo largo o sondeo corto para consumir mensajes de los brokers de ApsaraMQ for RocketMQ.
- Sondeo largo: el consumidor envía una solicitud al broker para obtener mensajes de un tema específico. Si no hay mensajes, el broker retiene la solicitud hasta que se produce uno o transcurre el periodo de sondeo largo.
- Sondeo corto: si no hay mensajes, el broker devuelve una respuesta de inmediato. Después, el cliente envía nuevas solicitudes de suscripción de forma repetida.
Configure el modo de sondeo de la siguiente manera:
- Sondeo largo: establezca el parámetro waitSeconds en un valor mayor que 0 en la solicitud de suscripción. El valor máximo es de 30 segundos.
- Sondeo corto: establezca el parámetro waitSeconds en 0 u omítalo en la solicitud de suscripción.
Para obtener más información, consulte Consume messages.

El sondeo corto genera una gran cantidad de solicitudes no válidas cuando el tema no tiene mensajes, lo cual implica cargos por llamadas a la API. Para reducir estas solicitudes y ahorrar costos, utilice el sondeo largo y aumente el tiempo de espera. Para conocer cómo se calculan los cargos por llamadas a la API, consulte API call fees.

Importante
Si más de 100 consumidores se conectan a una instancia de ApsaraMQ for RocketMQ mediante HTTP, el sistema cambia automáticamente del sondeo largo al sondeo corto para garantizar la estabilidad del servicio y la puntualidad del consumo. Para evitar que aumenten los costos por solicitudes no válidas después de este cambio, limite la cantidad de conexiones de consumidores.
El acceso mediante el SDK HTTP es una función mejorada de ApsaraMQ for RocketMQ. Los clústeres de Apache RocketMQ autogestionados no admiten esta función.
Asegúrese de que los recursos a los que desea acceder estén en la misma región que el endpoint HTTP que utiliza.

Por ejemplo, si su instancia de ApsaraMQ for RocketMQ está en la región China (Hangzhou), debe usar el endpoint de China (Hangzhou). Tenga en cuenta lo siguiente:
- Si su cliente está en la región China (Hangzhou), use el endpoint interno HTTP para obtener un rendimiento óptimo.
- Si su cliente está fuera de la región China (Hangzhou), asegúrese de tener conectividad a Internet y use el endpoint público HTTP.
Los mensajes se pueden transmitir entre clientes TCP y HTTP. Dado que HTTP usa serialización XML, los atributos, cuerpos, etiquetas y claves de los mensajes deben cumplir con las reglas de XML.

Nota
Para obtener más información sobre las reglas de XML, consulte Sintaxis de XML. También puede usar la herramienta XML Validator para comprobar el cumplimiento.

Los caracteres que infringen las reglas de XML provocan los siguientes problemas:
- Los mensajes enviados por HTTP no se entregan.
- Los mensajes enviados por TCP y consumidos por HTTP no se procesan.
Para manejar mensajes que contienen caracteres no compatibles, use la codificación y decodificación Base64.