低代码平台的扩展能力：活字格服务端编程实战

引言

在当今数字化转型浪潮中，低代码平台因其快速开发和易用性而备受青睐。然而，企业级应用往往需要处理复杂的业务逻辑和特殊需求，这些需求可能超出标准低代码功能的范畴。活字格低代码平台通过其强大的服务端编程能力，完美解决了这一挑战。

本文将深入探讨如何利用活字格的扩展能力，通过Java和C#编程实现复杂业务需求，特别是Excel模板填充和格式转换等高级功能。

一. 低代码平台的扩展需求与挑战

低代码平台虽然能快速构建大多数业务应用，但在面对以下场景时可能会遇到限制：

1. 特殊格式文件处理：如复杂Excel模板填充、PDF转换等
2. 第三方系统对接：如钉钉/企微客户端JSAPI、Web Service协议等
3. 专业算法实现：如文件哈希值计算、加密解密等

活字格平台通过开放的服务端编程接口，允许开发者使用Java或C#扩展平台功能，在平台上通过发送HTTP请求的方式调用扩展的Web API接口，既保留了低代码的开发效率，又能满足企业级应用的复杂需求。

二. Excel模板填充与转换实战

2.1 场景分析

以化学化工行业客户的实际需求为例，需要处理包含以下内容的复杂Excel模板，且Sheet页面个数是动态的：

• 结构化数据（设备信息）
• 动态列表数据（维修记录）
• 图片
• 多Sheet页面

2.2 技术实现

通过Java Web API实现以下功能：

1.接收JSON数据并填充Excel模板

// 示例代码：使用Apache POI填充Excel模版中指定单元格（页码、图片、...）
private static int processPageNumber(XSSFWorkbook workbook) {
    // 处理页码
    int numberOfSheets = workbook.getNumberOfSheets();
    workbook.getSheetAt(0).getRow(37).getCell(45).setCellValue("第  1  页  共  " + numberOfSheets +"  页  SHEET  1 OF  " + numberOfSheets);
    for(int i = 1; i < numberOfSheets; i++){
        workbook.getSheetAt(i).getRow(6).getCell(33).setCellValue("第   "+ (i+1) +"   页     共   " + numberOfSheets + "   页");
    }
    return numberOfSheets;
}

// 示例代码：使用EasyExcel填充Excel模版中表格部分
try {
    try (ExcelWriter writer = EasyExcel.write(outputTempFile).withTemplate(templateTempFile).build()) {
        Logger.info("Starting Excel export...");
        
        for (int i = 0; i < numberOfSheets; i++) {
            WriteSheet writeSheet = EasyExcel.writerSheet(i).build();
            writer.fill(deviceInfoMap, writeSheet);
            
            if (!emlList.isEmpty()) {
                writer.fill(emlList, writeSheet);
            }
        }
    }
} catch (Exception e) {
    Logger.error("填充Excel数据时发生错误: " + e.getMessage());
    throw new IOException("填充Excel数据失败", e);
}

2.Excel转PDF功能

// 示例代码：使用Aspose.Cells实现Excel转PDF
public static File convertExcelToPdf(String excelFilePath, String pdfOutputPath) throws Exception {
    Logger.info("Starting Excel to PDF conversion: " + excelFilePath + " -> " + pdfOutputPath);

    Workbook workbook = null;
    try {
        workbook = new Workbook(excelFilePath);

        // 设置PDF保存选项
        PdfSaveOptions pdfSaveOptions = new PdfSaveOptions();
        pdfSaveOptions.setOnePagePerSheet(true);

        WorksheetCollection worksheets = workbook.getWorksheets();
        
        for (int i = 0; i < worksheets.getCount(); i++) {
            Worksheet sheet = worksheets.get(i);
            PageSetup pageSetup = getPageSetup(sheet);

            // 添加页脚
            if (i > 0) {
                pageSetup.setFooter(0, "&\"宋体,常规\"&9注：本表为西安葡萄城软件有限责任公司专有，未经本公司许可，不得复制，不得将本表或其中内容以任何形式提供给第三方，也不得以任何形式，全部或部分用于其他目的。");
            }
            
            // ...
        }
        workbook.save(pdfOutputPath, pdfSaveOptions);
        Logger.info("Excel to PDF conversion completed: " + pdfOutputPath);
        return new File(pdfOutputPath);
    } catch (Exception e) {
        Logger.error("Error converting Excel to PDF: " + e.getMessage());
        throw e;
    } finally {
        // 确保资源正确关闭
        if (workbook != null) {
            try {
                workbook.dispose();
            } catch (Exception ignored) {}
        }
    }
}

2.3 方案优势

1. 灵活性：可处理任意复杂的Excel模板结构，动态生成Sheet页数据并导出
2. 性能：服务端处理大数据量性能更优
3. 格式保真：专业库确保输出文件格式完美
4. 可扩展：可轻松添加水印、加密等附加功能

三. 其他典型服务端扩展场景与应用

3.1 对接第三方系统API

// 示例：获取钉钉access_token
protected string GetAccessToken()
{
    if (config.token != "" && DateTime.Compare(DateTime.Now, DateTime.FromOADate(double.Parse(config.token_due_time))) <= 0)
    {
        return config.token;
    }
    else
    {
        PostData postData = new PostData();
        var jd = JsonConvert.DeserializeObject(postData.GetPage("https://oapi.dingtalk.com/gettoken?appkey=" + config.appkey + "&appsecret=" + config.appsecret)) as JObject;
        string accessToken = jd["access_token"].ToString();
        updateTokenDueTime(accessToken, 7200);
        return accessToken;
    }
}

3.2 对接Web Service协议

// 示例：调用Web Service
string soapRequest = $@"<soap:envelope xmlns:soap="" http: schemas.xmlsoap.org soap envelope "" xmlns:urn="" urn:sap-com:document:sap:rfc:functions"">
    <soap:header />
    <soap:body>
        <urn:zpp_create_prodord>
            <it_data>
                <item>
                    <guid>xxx</guid>
                    ......
                </item>
            </it_data>
        </urn:zpp_create_prodord>
    </soap:body>
</soap:envelope>";

string url = "xxx";
using var httpClient = new HttpClient();
// 设置HTTP基本认证  
var byteArray = Encoding.ASCII.GetBytes($"{_sapUsername}:{_sapPassword}");
httpClient.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Basic", Convert.ToBase64String(byteArray));
// 构造请求内容  
var content = new StringContent(soapRequest, Encoding.UTF8, "text/xml");
// 发送POST请求并等待响应  
HttpResponseMessage response = await httpClient.PostAsync(url, content);

3.3 文件哈希值计算

// 示例：计算文件SHA256哈希值
public String calculateFileHash(String filePath) throws Exception {
    MessageDigest digest = MessageDigest.getInstance("SHA-256");
    byte[] fileBytes = Files.readAllBytes(Paths.get(filePath));
    byte[] hashBytes = digest.digest(fileBytes);
    return bytesToHex(hashBytes);
}

四. 调试与优化技巧

1. 日志记录：使用活字格提供的Logger类输出调试信息

     Logger.info("开始处理Excel导出请求，参数大小：" + jsonData.length());
   

2. 错误处理：完善的异常捕获和处理机制

     try {
         // 业务逻辑
     } catch (Exception e) {
         Logger.error("导出Excel失败：" + e.getMessage());
         throw new RuntimeException("导出失败，请检查数据格式");
     }
   

3. 性能监控：记录关键操作耗时

     long start = System.currentTimeMillis();
     // 执行操作
     long duration = System.currentTimeMillis() - start;
     Logger.info("Excel填充/转换耗时：" + duration + "ms");
   

结论

活字格低代码平台通过其强大的服务端编程能力，成功解决了标准低代码功能无法满足复杂业务需求的挑战。本文展示的Excel模板填充和转换方案，以及其他扩展场景的实现，充分证明了活字格在企业级应用开发中的灵活性和强大能力。

扩展链接

敏捷构建企业级应用及AI智能体