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

引言

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

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

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

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

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

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

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

2.1 场景分析

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

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

多Sheet页面

2.2 技术实现

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

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

Java 复制代码

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

// 示例代码：使用EasyExcel填充Excel模版中表格部分
try {
    try (ExcelWriter writer = EasyExcel.write(outputTempFile).withTemplate(templateTempFile).build()) {
        Logger.info(&#34;Starting Excel export...&#34;);
        
        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(&#34;填充Excel数据时发生错误: &#34; + e.getMessage());
    throw new IOException(&#34;填充Excel数据失败&#34;, e);
}

2.Excel转PDF功能

Java 复制代码

// 示例代码：使用Aspose.Cells实现Excel转PDF
public static File convertExcelToPdf(String excelFilePath, String pdfOutputPath) throws Exception {
    Logger.info(&#34;Starting Excel to PDF conversion: &#34; + excelFilePath + &#34; -> &#34; + 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, &#34;&\&#34;宋体,常规\&#34;&9注：本表为西安葡萄城软件有限责任公司专有，未经本公司许可，不得复制，不得将本表或其中内容以任何形式提供给第三方，也不得以任何形式，全部或部分用于其他目的。&#34;);
            }
            
            // ...
        }
        workbook.save(pdfOutputPath, pdfSaveOptions);
        Logger.info(&#34;Excel to PDF conversion completed: &#34; + pdfOutputPath);
        return new File(pdfOutputPath);
    } catch (Exception e) {
        Logger.error(&#34;Error converting Excel to PDF: &#34; + e.getMessage());
        throw e;
    } finally {
        // 确保资源正确关闭
        if (workbook != null) {
            try {
                workbook.dispose();
            } catch (Exception ignored) {}
        }
    }
}

2.3 方案优势

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

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

3.1 对接第三方系统API

C# 复制代码

// 示例：获取钉钉access_token
protected string GetAccessToken()
{
    if (config.token != &#34;&#34; && 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(&#34;https://oapi.dingtalk.com/gettoken?appkey=&#34; + config.appkey + &#34;&appsecret=&#34; + config.appsecret)) as JObject;
        string accessToken = jd[&#34;access_token&#34;].ToString();
        updateTokenDueTime(accessToken, 7200);
        return accessToken;
    }
}

3.2 对接Web Service协议

C# 复制代码

// 示例：调用Web Service
string soapRequest = $@&#34;
    
    
        
            
                
                    xxx
                    ......
                
            
        
    
&#34;;

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

3.3 文件哈希值计算

Java 复制代码

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

四. 调试与优化技巧

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

Java 复制代码

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

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

Java 复制代码

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

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

Java 复制代码

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

结论

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

扩展链接

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