ballerina 主要是分為兩大類

• 基於ballerina 語言開發的,一般是客戶端的connector
• 使用java語言開發的（類似的基於jvm的都可以），一般是註解以及進行構件生成

ballerina 語言開發說明

• 是一個ballerian 的包
• 建立一個物件包含了init 、getCallerActions 函式
• 實現init 函式，次函式是在使用者例項化一個endpoint的時候
• 實現getCallerActions 函式，次函式是在connect 必須別返回的時候進行呼叫
• 構建模組併發布

一個twilio connector 使用說明

官方提供了單檔案以及多檔案的程式碼組織方式，各有優缺點，結合實際使用

• 使用demo(注意官方文件的版本有問題，最好參考github 學習)

import ballerina/config;
import ballerina/io;
import wso2/twilio;

public function main(string... args) {
   endpoint twilio:Client twilioClient {
         accountSId:config:getAsString("ACCOUNT_SID"),
         authToken:config:getAsString("AUTH_TOKEN"),
         xAuthyKey:config:getAsString("AUTHY_API_KEY")
    };

    var details = twilioClient->getAccountDetails();
    match details {
        twilio:Account account => io:println(account);
        twilio:TwilioError twilioError => io:println(twilioError);
    }
}
 

twilio connector 開發細節說明

按照流程開發即可

• 是一個模組

我們可以使用ballerina init 建立

• 一個物件包含了init 、getCallerActions 函式

  因為其他地方需要呼叫，我們的可見性，使用public 修飾

endpoint： 
public type TwilioClient object {
   // 配置引數
    public TwilioConfiguration twilioConfig;
    public TwilioConnector twilioConnector = new;
    // init  函式
    public function init(TwilioConfiguration config);
    documentation { Initialize Twilio endpoint
        R{{}} The Twilio connector object
    }
   // getCallerActions 函式
    public function getCallerActions() returns TwilioConnector;
};
配置說明：
public type TwilioConfiguration record {
    http:ClientEndpointConfig clientConfig;
};
 

• connector 物件，實際上就是具體幹活的物件

public type TwilioConnector object {
    public string accountSId;
    public http:Client client;
    public function getAccountDetails() returns Account|error;
};

• 常量以及record 定義

public type Account record {
    string sid;
    string name;
    string status;
    string ^"type";
    string createdDate;
    string updatedDate;
};

// Constants
@final string BASE_URL = "https://api.twilio.com/2010-04-01";
@final string ACCOUNTS_API = "/Accounts/";
@final string RESPONSE_TYPE_JSON = ".json";
@final string EMPTY_STRING = "";

• 實現endpoint 的init 、getCallerActions 函式

function TwilioClient::getCallerActions() returns TwilioConnector {
    return self.twilioConnector;
}
function TwilioClient::init(TwilioConfiguration config) {
    config.clientConfig.url = BASE_URL;
    string username;
    string password;
    var usernameOrEmpty = config.clientConfig.auth.username;
    match usernameOrEmpty {
        string usernameString => username = usernameString;
        () => {
            error err = { message: "Username cannot be empty" };
            throw err;
        }
    }
    var passwordOrEmpty = config.clientConfig.auth.password;
    match passwordOrEmpty {
        string passwordString => password = passwordString;
        () => {
            error err = { message: "Password cannot be empty" };
            throw err;
        }
    }
    self.twilioConnector.accountSId = username;
    self.twilioConnector.client.init(config.clientConfig);
}

• 實現connector 函式

function TwilioConnector::getAccountDetails() returns Account|error {
    endpoint http:Client httpClient = self.client;
    string requestPath = ACCOUNTS_API + self.accountSId + RESPONSE_TYPE_JSON;
    var response = httpClient->get(requestPath);
    json jsonResponse = check parseResponseToJson(response);
    return mapJsonToAccount(jsonResponse);
}

參考資料