CloudRail là một giải pháp tích hợp API giúp tăng tốc quá trình tích hợp các API của bên thứ ba vào một ứng dụng và duy trì chúng. Nó làm như vậy bằng cách cung cấp các thư viện cho nhiều nền tảng có các lớp trừu tượng kết hợp các dịch vụ tương tự đằng sau một giao diện chung.

Hướng dẫn này nhắm mục tiêu đến các nhà phát triển phần mềm muốn tìm hiểu cách mất ít thời gian hơn trong việc tích hợp API.

CloudRail cung cấp các thư viện cho Android, Java, Node.js và iOS (Objective-C và Swift). Cần có kiến thức cơ bản về nền tảng tương ứng để sử dụng thư viện tương ứng. Bạn có thể nhanh chóng đăng ký một tài khoản miễn phí tại https://developers.cloudrail.com và nhận khóa cấp phép mà bạn sẽ cần để sử dụng thư viện

Cloudrail – Tổng quan

CloudRail – Tính năng

Dưới đây là danh sách một số tính năng nổi bật nhất của CloudRail –

API hợp nhất – CloudRail gói nhiều API web thành một API hợp nhất duy nhất. Ví dụ: hàm upload () hoạt động giống hệt với Dropbox cũng như đối với Google Drive. Bạn có thể dễ dàng tích hợp toàn bộ danh mục nhà cung cấp, ví dụ Đăng nhập xã hội hoặc thay đổi nhà cung cấp bằng một dòng mã.
Quản lý thay đổi API – API thay đổi liên tục, dẫn đến tích hợp bị hỏng, khách hàng không hài lòng và thậm chí lãng phí thời gian phát triển hơn. CloudRail giám sát tất cả các API và duy trì các tích hợp. Bạn nhận được thông báo ngay lập tức về các thay đổi và tất cả những gì bạn cần làm là cập nhật thư viện CloudRail lên phiên bản mới nhất – không cần thay đổi mã.
Thống kê API – Hiểu các API và chức năng nào đang được khách hàng của bạn sử dụng nhiều nhất. Nhận thông tin chi tiết cần thiết bạn cần để xác định các tính năng mới hoặc cải thiện các chiến dịch tiếp thị.
Dữ liệu trực tiếp – Không có dữ liệu nào của bạn sẽ vượt qua máy chủ CloudRail. Hệ thống không sử dụng phần mềm trung gian được lưu trữ. Tất cả chuyển đổi dữ liệu diễn ra trong thư viện CloudRail được tích hợp trong Ứng dụng của bạn. Điều này có nghĩa là không có lo ngại về quyền riêng tư dữ liệu, không có thời gian ngừng hoạt động và không có SPOF bổ sung.
OAuth Made Simple – Thực hiện xác thực OAuth là một công việc khó khăn. CloudRail làm cho việc ủy quyền đơn giản như việc thêm một dòng mã.

Phiên bản miễn phí của CloudRail chỉ có thể được sử dụng cho mục đích phi thương mại hoặc thử nghiệm. Người dùng thương mại phải mua giấy phép

Cloudrail – Android

Phần này giới thiệu về cách sử dụng SDK Android của CloudRail.

Thiết lập

Cách dễ nhất để cài đặt là thông qua Maven. Nếu bạn đang sử dụng Android Studio với Gradle, chỉ cần thêm phần sau vào tệp build.gradle của bạn

dependencies {
   compile 'com.cloudrail:cloudrail-si-android:2.8.1
}

Sử dụng

Ví dụ sau đây cho thấy cách tạo thư mục mới và tải tệp từ nội dung của ứng dụng Android lên thư mục mới được tạo trên bất kỳ nhà cung cấp dịch vụ lưu trữ đám mây nào.

java
CloudRail.setAppKey("[CloudRail License Key]");

// CloudStorage cs = new Box(context, "[clientIdentifier]", "[clientSecret]");
// CloudStorage cs = new OneDrive(context, "[clientIdentifier]", "[clientSecret]");
// CloudStorage cs = new GoogleDrive(context, "[clientIdentifier]", "[clientSecret]");
CloudStorage cs = new Dropbox(context, "[clientIdentifier]", "[clientSecret]");

new Thread() {
   @Override
   public void run() {
      cs.createFolder("/TestFolder"); // <---
      InputStream stream = null;
      
      try {
         AssetManager assetManager = getAssets();
         stream = assetManager.open("UserData.csv");
         long size = assetManager.openFd("UserData.csv").getLength();
         cs.upload("/TestFolder/Data.csv", stream, size, false); // <---
      } catch (Exception e) {
         // TODO: handle error
      } finally {
         // TODO: close stream
      }
   }
}.start();

Cloudrail – Java

Phần này giới thiệu về cách sử dụng Java SDK của CloudRail.

Thiết lập

Cách dễ nhất để cài đặt là thông qua Maven. Chỉ cần thêm phần sau vào tệp pom.xml của bạn là đủ

<dependencies>
   <dependency>
      <groupId>com.cloudrail</groupId>
      <artifactId>cloudrail-si-java</artifactId>
      <version>2.8.0</version>
   </dependency>
</dependencies>

Sử dụng

Ví dụ sau đây cho thấy cách tạo thư mục mới và tải tệp từ máy cục bộ lên thư mục mới tạo trên bất kỳ nhà cung cấp dịch vụ lưu trữ đám mây nào.

java
CloudRail.setAppKey("[CloudRail License Key]");

// CloudStorage cs = new Box(redirectReceiver, "[clientIdentifier]", "[clientSecret]", "[redirectUri]", "[state]");
// CloudStorage cs = new OneDrive(redirectReceiver, "[clientIdentifier]", "[clientSecret]", "[redirectUri]", "[state]");
// CloudStorage cs = new GoogleDrive(redirectReceiver, "[clientIdentifier]", "[clientSecret]", "[redirectUri]", "[state]");
CloudStorage cs = new Dropbox(redirectReceiver, "[clientIdentifier]", "[clientSecret]", "[redirectUri]", "[state]");
new Thread() {
   @Override
   public void run() {
      cs.createFolder("/TestFolder");
      InputStream stream = null;
      
      try {
         stream = getClass().getResourceAsStream("Data.csv");
         long size = new File(getClass().getResource("Data.csv").toURI()).length();
         cs.upload("/TestFolder/Data.csv", stream, size, false);
      } catch (Exception e) {
         // TODO: handle error
      } finally {
         // TODO: close stream
      }
   }
}.start();

Cloudrail – Node.js

Phần này giới thiệu về cách sử dụng SDK Node.js của CloudRail.

Thiết lập

Cách dễ nhất để cài đặt là thông qua NPM . Chỉ cần sử dụng lệnh sau:

npm install cloudrail-si

Sử dụng

Ví dụ sau đây cho thấy cách tạo thư mục mới và tải tệp từ máy cục bộ lên thư mục mới tạo trên bất kỳ nhà cung cấp dịch vụ lưu trữ đám mây nào.

javascript
const cloudrail = require("cloudrail-si");
cloudrail.Settings.setKey("[CloudRail License Key]");

// let cs = new cloudrail.services.Box(redirectReceiver, "[clientIdentifier]", "[clientSecret]", "[redirectUri]", "[state]");
// let cs = new cloudrail.services.OneDrive(redirectReceiver, "[clientIdentifier]", "[clientSecret]", "[redirectUri]", "[state]");
// let cs = new cloudrail.services.GoogleDrive(redirectReceiver, "[clientIdentifier]", "[clientSecret]", "[redirectUri]", "[state]");
let cs = new cloudrail.services.Dropbox(redirectReceiver, "[clientIdentifier]", "[clientSecret]", "[redirectUri]", "[state]");

cs.createFolder("/TestFolder", (err) => { // <---
   if (err) throw err;
   let fileStream = fs.createReadStream("UserData.csv");
   let size = fs.statSync("UserData.csv").size;
   
   cs.upload("/TestFolder/Data.csv", fileStream, size, false, (err) => { // <---
      if (err) throw err;
      console.log("Upload successfully finished");
   });
});

Thiết lập

Cách dễ nhất để cài đặt là thông qua CocoaPods . Chỉ cần thêm phần sau vào podfile của bạn –

pod "cloudrail-si-ios-sdk"

Đảm bảo rằng “use_frameworks!” cờ được đặt và chạy

Pod install

Sử dụng

Các ví dụ sau đây cho thấy cách tải xuống tệp từ bất kỳ nhà cung cấp dịch vụ lưu trữ đám mây nào trong Objective-C và Swift.

objective-c
// self.service = [[CROneDrive alloc] initWithClientId:@"clientIdentifier" clientSecret:@"clientSecret" redirectUri:@"REDIRURL" state:@"CRSTATE"];
// self.service = [[CRGoogleDrive alloc] initWithClientId:@"clientIdentifier" clientSecret:@"clientSecret" redirectUri:@"REDIRURL" state:@"CRSTATE"];
// self.service = [[CRBox alloc] initWithClientId:@"clientIdentifier" clientSecret:@"clientSecret" redirectUri:@"REDIRURL" state:@"CRSTATE"];

[CRCloudRail setAppKey:@"CLOUDRAIL_API_KEY"];
self.service = [[CRDropbox alloc] initWithClientId:@"clientIdentifier" 
   clientSecret:@"clientSecret" redirectUri:@"REDIRURL" state:@"CRSTATE"];

NSInputStream * object = [self.service downloadFileWithPath:@"/mudkip.jpg"];
//READ FROM STREAM

swift
//let cloudStorage : CloudStorageProtocol = Box.init(clientId: "ClientID", clientSecret: "ClientSecret")
//let cloudStorage : CloudStorageProtocol = GoogleDrive.init(clientId: "ClientID", clientSecret: "ClientSecret")
//let cloudStorage : CloudStorageProtocol = OneDrive.init(clientId: "ClientID", clientSecret: "ClientSecret")

CRCloudRail.setAppKey("CLOUDRAIL_API_KEY")
let cloudStorage : CloudStorageProtocol = Dropbox.init(
   clientId: "ClientID", clientSecret: "ClientSecret")
do {
   let inputStream = try cloudStorage.downloadFileWithPath("/TestFolder/Data.csv")
} catch let error{
   print("An error: \(error)")
}
//READ FROM STREAM

Cloudrail – Social Login Đăng nhập mạng xã hội xem thêm