文档首页/ 函数工作流 FunctionGraph/ 开发指南/ Java/ 开发Java事件函数/ Java函数开发指南（使用IDEA工具创建Java工程）
更新时间：2025-08-05 GMT+08:00
查看PDF
分享

Java函数开发指南（使用IDEA工具创建Java工程）

本章节介绍使用IDEA工具开发Java函数。关于Java函数接口定义、Initializer入口介绍以及SDK接口说明请参考Java函数开发概述。

操作流程

您可以跟随本文以下步骤从头开始创建Java工程和Java函数，也可以直接下载Java的函数样例工程包并从步骤三：创建Java函数并测试开始操作。

步骤一：使用IDEA创建Java工程

  1. 配置IDEA
    如图创建工程所示，创建java工程。
    图1 创建工程
  2. 添加工程依赖

    根据Java SDK下载提供的SDK地址，下载JavaRuntime SDK到本地开发环境解压，如图2所示。

    图2 下载SDK解压
  3. 配置依赖

    在工程目录下创建lib目录，将zip中的Runtime2.0.5.jar和代码所需要的三方依赖包拷贝到该目录，并把该jar添加为工程依赖，如图3所示。

    图3 配置依赖
  4. 配置函数资源

    创建包com.huawei.demo，并在包下创建TriggerTests类，如图4所示。

    图4 创建TriggerTests类
  5. 配置函数代码
    如图5所示，在TriggerTests.java中定义函数运行入口，示例代码如下。（普通java项目需要通过Artifacts来进行编译，因此需要定义一个main函数。） 
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
    		 
    package com.huawei.demo;

import java.io.UnsupportedEncodingException;
import java.util.HashMap;
import java.util.Map;

import com.huawei.services.runtime.Context;
import com.huawei.services.runtime.entity.apig.APIGTriggerEvent;
import com.huawei.services.runtime.entity.apig.APIGTriggerResponse;
import com.huawei.services.runtime.entity.dis.DISTriggerEvent;
import com.huawei.services.runtime.entity.dms.DMSTriggerEvent;
import com.huawei.services.runtime.entity.lts.LTSTriggerEvent;
import com.huawei.services.runtime.entity.smn.SMNTriggerEvent;
import com.huawei.services.runtime.entity.timer.TimerTriggerEvent;
import com.huawei.services.runtime.entity.eventgrid.EventGridTriggerEvent;

public class TriggerTests {
    public static void main(String args[]) {}
    public APIGTriggerResponse apigTest(APIGTriggerEvent event, Context context){
        System.out.println(event);
        Map<String, String> headers = new HashMap<String, String>();
        headers.put("Content-Type", "application/json");
        return new APIGTriggerResponse(200, headers, event.toString());
    }

    public String smnTest(SMNTriggerEvent event, Context context){
        System.out.println(event);
        return "ok";
    }

    public String dmsTest(DMSTriggerEvent event, Context context){
        System.out.println(event);
        return "ok";
    }

    public String timerTest(TimerTriggerEvent event, Context context){
        System.out.println(event);
        return "ok";
    }

    public String disTest(DISTriggerEvent event, Context context) throws UnsupportedEncodingException{
        System.out.println(event);
        System.out.println(event.getMessage().getRecords()[0].getRawData());
        return "ok";
    }

    public String ltsTest(LTSTriggerEvent event, Context context) throws UnsupportedEncodingException {
        System.out.println(event);
        event.getLts().getData();
        System.out.println("raw data: " + event.getLts().getRawData());
        return "ok";
    }

    public String eventgridTest(EventGridTriggerEvent event, Context context){
        System.out.println(event);return "ok";
    }
}
    图5 定义函数运行入口

    示例代码中添加了多个入口函数，分别使用了不同的触发器事件类型，可通过FunctionGraph控制台修改函数执行入口测试不同的入口函数。当函数的事件源是APIG时，相关约束条件请参考Base64解码和返回结构体的说明。

    修改函数执行入口：

    在FunctionGraph控制台左侧导航栏选择“函数 > 函数列表”，单击需要设置的“函数名称”进入函数详情页，选择“设置 > 常规设置”，配置“函数执行入口”参数，如图6所示。
    图6 函数执行入口

步骤二：打包Java工程

  1. 单击“File > Project Structure”打开Project Structure窗口，如图7所示。
    图7 Project Structure
  2. 选择上图中的“Artifacts”，单击“+”，进入添加“Artifacts”窗口，如图8所示。
    图8 添加Artifacts
  3. 添加“Main Class”，如图9所示。
    图9 添加Main Class
  4. 单击“Build > Build Artifacts”来编译JAR包，如图10所示。
    图10 Build Artifacts

步骤三：创建Java函数并测试

  1. 登录函数工作流控制台，左侧导航栏选择“函数 > 函数列表”，单击右上角“创建函数”进入创建函数页面，选择“创建空白函数”。
  2. 如图11所示，配置函数基本信息，“运行时”选择“Java 17”，配置完成后单击右下角“创建函数”完成创建。
    图11 创建Java函数

  3. 进入函数详情页，在“代码”页签下，单击右侧“上传代码 > JAR文件 ”，如图12所示，添加步骤二：打包Java工程的JAR文件上传。
    图12 上传JAR文件
  4. 上传成功后，选择“设置 > 常规设置”，修改需要测试的函数执行入口参数，单击“保存”。
  5. 回到“代码”页签，单击代码编辑区的“测试”，选择“创建新的测试事件”，在云事件模板列表中选择需要测试的事件模板，单击“创建”。
  6. 单击“测试”，查看函数执行结果。

    函数执行结果分为三部分，分别为函数返回（由callback返回）、执行摘要、日志输出（由console.log或getLogger()方法获取的日志方法输出），参考表1查看结果说明。

    表1 执行结果说明

    参数项

    执行成功

    执行失败

    函数返回

    返回函数中定义的返回信息。

    返回包含错误信息和堆栈异常报错信息的JSON文件。格式如下：

    {
  "errorMessage": "",
  "stackTrace": []
}

    errorMessage：Runtime返回的错误信息

    stackTrace：Runtime返回的堆栈异常报错信息

    执行摘要

    显示请求ID、配置内存、执行时长、实际使用内存和收费时长。

    显示请求ID、配置内存、执行时长、实际使用内存和收费时长。

    日志

    打印函数日志，最多显示4KB的日志。

    打印报错信息，最多显示4KB的日志。

    如需测试示例代码中的其他事件源触发器，例如SMN事件源，可在函数的常规设置中，将函数执行入口修改为com.huawei.demo.TriggerTests.smnTest，并参考以上步骤，创建新的消息通知服务SMN测试事件进行函数测试。

父主题： 开发Java事件函数

相关文档