選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。

messaging.md 2.3 KiB

1234567891011121314151617181920212223242526272829303132333435363738394041
  1. # Message
  2. The data sent by using the `ICapPublisher` interface is called `Message`.
  3. ## Scheduling
  4. After the CAP receives the message, it sends the message to Transport, which is transported by transport.
  5. When you send using the `ICapPublisher` interface, the CAP will dispatch the message to the corresponding Transport. Currently, bulk messaging is not supported.
  6. For more information on transports, see the [Transports](../transports/general.md) section.
  7. ## Persistent
  8. The CAP will storage after receiving the message. For more information on storage, see the [Persistent](../persistent/general.md) section.
  9. ## Retry
  10. Retrying plays an important role in the overall CAP architecture design, and CAPs retry for messages that fail to send or fail to execute. There are several retry strategies used throughout the CAP design process.
  11. ### Send retry
  12. During the message sending process, when the broker crashes or the connection fails or an abnormality occurs, the CAP will retry the sending. Retry 3 times for the first time, retry every minute after 4 minutes, and +1 retries. When the total number of times reaches 50, the CAP will stop retrying.
  13. You can adjust the total number of default retries by setting `FailedRetryCount` in CapOptions.
  14. It will stop when the maximum number of times is reached. You can see the reason for the failure in Dashboard and choose whether to manually retry.
  15. ### Consumption retry
  16. The consumer method is executed when the Consumer receives the message and will retry when an exception occurs. This retry strategy is the same as the send retry.
  17. ## Data Cleanup
  18. There is an `ExpiresAt` field in the database message table indicating the expiration time of the message. When the message is sent successfully, the status will be changed to `Successed`, and `ExpiresAt` will be set to **1 hour** later.
  19. Consuming failure will change the message status to `Failed` and `ExpiresAt` will be set to **15 days** later.
  20. By default, the data of the message table is deleted **every hour** to avoid performance degradation caused by too much data. The cleanup strategy is `ExpiresAt` is not empty and is less than the current time.
  21. That is to say, the message with the status Failed (normally they have been retried 50 times), if you do not have manual intervention for 15 days, it will **also be** cleaned up.