ballerina 学习 三十一 扩展开发（二）

上篇说了使用ballerina 语言开发扩展模块，对于注解类型的我们是需要使用java 语言进行
开发的

官方提供了一个hello 的demo可以参考 https://github.com/ballerinax/hello

注解扩展插件的使用

这个注解是调用方法之后，会生成一个文本文件

import ballerina/http;
import ballerinax/hello;

@hello:Greeting{
  salutation: "Guten Tag!"
}
service<http:Service> helloWorld bind {port:9091} {
   sayHello(endpoint outboundEP, http:Request request) {
       http:Response response = new;
       response.setTextPayload("Hello, World from service helloWorld ! \n");
       _ = outboundEP->respond(response);
   }
}

开发细节

开发需要的环境是jdk8 同时需要maven ，构建完成之后，用户需要安装扩展,为了测试我使用的是直接clone 代码

  • clone 代码
git clone https://github.com/ballerinax/hello.git
  • 导入项目
  • 构建&&测试
mvn clean package
  • 构建结果
    ballerina 学习 三十一 扩展开发（二）_ballerina
  • 说明
    hello-extension-0.980.0.jar 文件需要放ballerian 的 /bre/lib，同时repo 包需要解压，并放到
    ballerina 学习 三十一 扩展开发（二）_ballerina_02
  • 测试
import ballerina/http;
import ballerinax/hello;

@hello:Greeting{salutation : "Guten Tag!"}
@http:ServiceConfig {
    basePath:"/dalong"
}
service<http:Service> helloWorld bind {port:9091} {
    sayHello(endpoint outboundEP, http:Request request) {
        http:Response response;
        response.setJsonPayload("Hello, World from service helloWorld ! \n");
        // Send response to the client.
        _ = outboundEP->respond(response);
    }
}
  • 效果

    会生成一个hello_world.txt 文件

Guten Tag!

说明

以下为代码的结构
ballerina 学习 三十一 扩展开发（二）_ballerina_03

  • 因为开发会有依赖的打包，官方的方式是使用maven 的maven-shade-plugin ，好多mapreduce 以及开发打包也是类似的
    详细使用说明，可以参考https://ballerina.io/learn/how-to-extend-ballerina/
  • 主要的处理代码是实现 AbstractCompilerPlugin 其中包含了具体的代码处理，以及逻辑
实现 init process codeGenerated 方法，docker 扩展是一个比较有价值的参考项目

参考资料

https://github.com/ballerinax/docker
https://github.com/ballerinax/hello
https://ballerina.io/learn/how-to-extend-ballerina/