Tencent Connecter

Content Type: Module
Categories: Utility

Overview

The Tencent COS Connector for Mendix provides an easy and secure way to integrate Mendix applications with Tencent Cloud Object Storage (COS). It enables developers to manage file uploads, downloads, and listings directly from Mendix using Tencent’s official COS Java SDK (v5).

This connector is designed with a stateless architecture, ensuring reliability and simplicity — each operation creates and closes its own COS client without session dependency. It includes full Mendix logging support for better visibility and error handling.

Key Features:

  • Upload FileDocuments directly to COS buckets or subfolders.
  • Download Files from COS as Mendix FileDocuments for viewing or download in the app.
  • List Files and Folders with prefix and delimiter support for folder-like browsing.
  • Test Connection to quickly validate COS credentials and bucket access.
  • Delete Files directly from COS buckets.
  • Integrated Logging through Mendix LogNode for easy debugging and monitoring.

Use Cases:

  • Enterprise file repositories
  • Media content storage
  • Document management systems
  • Integration with Tencent Cloud-based architectures

Technical Highlights:

  • Built on the official Tencent COS Java SDK (v5)
  • Compatible with Mendix 9+ and 10+
  • Supports standard CRUD file operations over COS
  • Fully stateless and thread-safe implementation

This release delivers a production-ready, easy-to-use solution for Mendix developers who need secure, high-performance integration with Tencent Cloud Object Storage.

Documentation

Typical Usage Scenario

The Tencent COS Connector allows Mendix developers to seamlessly integrate Tencent Cloud Object Storage (COS) into their applications. It is ideal for use cases such as document repositories, image or media management systems, and any Mendix app that requires secure cloud-based file storage. The connector simplifies interaction with COS by providing Java Actions to upload, download, list, and delete files directly from Mendix without leaving the app environment.

Features and Limitations

Features:

  • Upload Mendix FileDocuments directly to Tencent COS.
  • Download COS files for in-app viewing or export.
  • List and browse files and folders using prefixes and delimiters.
  • Validate connection credentials via TestConnection action.
  • Integrated Mendix logging for activity tracking.
  • Stateless design—each operation creates and closes its own client.

Limitations:

  • No built-in synchronization or background scheduling.
  • Folder browsing depends on COS prefixes (virtual folder structure).
  • Only supports access via Tencent COS credentials (no OAuth or STS).

Dependencies

  • Tencent Cloud COS Java SDK (v5.x).
  • Apache HTTPClient, Jackson, and SLF4J (bundled with SDK).
  • Mendix Runtime 9.0.5 or newer.

Installation

  1. Import this module into your Mendix project.
  2. Add COS SDK and its dependencies to the /userlib directory.
  3. Sync and deploy your project.

Configuration

  1. Create a ConnectionMaster entity with secretId, secretKey, regionName, and bucketName.
  2. Use constants or microflows to manage credentials.
  3. Use Java Actions (TestConnection, ViewFileList, UploadFileToCOS, DownloadFileFromCOS) within your flows.

Known Bugs

None reported in version 1.0.0.

Frequently Asked Questions

Q: My uploaded file doesn’t appear in the list.

A: Ensure the cosKey prefix matches the one used in ViewFileList.

Q: Can I show folder-like navigation?

A: Yes, by setting delimiter="/" in the list action.

Q: Does it support Mendix 10?

A: Yes, it supports Mendix 9 and 10 fully.

Releases