OSGi服務

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
適用性表單

建立對象：

初學者
開發人員

OSGi服務是Java類別或服務介面，以及許多作為名稱/值配對的服務屬性。服務屬性會區分使用相同服務介面提供服務的不同服務提供者。

OSGi服務由其服務介面語義定義，並實作為服務物件。服務的功能由其實作的介面定義。因此，不同的應用程式可以實作相同的服務。服務介面允許套件組合透過繫結介面進行互動，而不是實作。指定的服務介面應儘可能包含較少的實作詳細資料。

定義介面

一個簡單介面，具有一個與XDP範本合併資料的方法。

package com.mysite.samples;

import com.adobe.aemfd.docmanager.Document;

public interface MyfirstInterface
{
    public Document mergeDataWithXDPTemplate(Document xdpTemplate, Document xmlDocument);
}

實作介面

建立名為com.mysite.samples.impl的新封裝以儲存介面的實作。

package com.mysite.samples.impl;
import org.osgi.service.component.annotations.Component;
import org.osgi.service.component.annotations.Reference;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.adobe.aemfd.docmanager.Document;
import com.adobe.fd.output.api.OutputService;
import com.adobe.fd.output.api.OutputServiceException;
import com.mysite.samples.MyfirstInterface;
@Component(service = MyfirstInterface.class)
public class MyfirstInterfaceImpl implements MyfirstInterface {
  @Reference
  OutputService outputService;

  private static final Logger log = LoggerFactory.getLogger(MyfirstInterfaceImpl.class);

  @Override
  public Document mergeDataWithXDPTemplate(Document xdpTemplate, Document xmlDocument) {
    com.adobe.fd.output.api.PDFOutputOptions pdfOptions = new com.adobe.fd.output.api.PDFOutputOptions();
    pdfOptions.setAcrobatVersion(com.adobe.fd.output.api.AcrobatVersion.Acrobat_11);
    try {
      return outputService.generatePDFOutput(xdpTemplate, xmlDocument, pdfOptions);

    } catch (OutputServiceException e) {

      log.error("Failed to merge data with XDP Template", e);

    }

    return null;
  }

}

第10行的註解@Component(...)會將此Java類別標籤為OSGi元件，並將其註冊為OSGi服務。

@Reference註解是OSGi宣告式服務的一部分，用來將Outputservice的參照插入變數outputService。

建置和部署套件組合

開啟 命令提示字元視窗
瀏覽至c:\aemformsbundles\mysite\core
執行命令mvn clean install -PautoInstallBundle
上述命令會自動建置套件，並將其部署至localhost：4502上執行的AEM執行個體

此組合也可在下列位置C:\AEMFormsBundles\mysite\core\target使用。也可以使用Felix Web主控台將套件組合部署到AEM。

使用服務

您現在可以在JSP頁面中使用服務。下列程式碼片段說明如何存取服務並使用服務實作的方法

MyFirstAEMFormsService myFirstAEMFormsService = sling.getService(com.mysite.samples.MyFirstAEMFormsService.class);
com.adobe.aemfd.docmanager.Document generatedDocument = myFirstAEMFormsService.mergeDataWithXDPTemplate(xdp_or_pdf_template,xmlDocument);

包含JSP頁面的範例套件可從這裡下載

完整的套裝軟體可供下載

測試封裝

使用封裝管理員將封裝匯入並安裝到AEM中

使用Postman進行POST呼叫並提供輸入引數，如下方熒幕擷取畫面所示
郵遞員

後續步驟

建立Sling Servlet

recommendation-more-help

8de24117-1378-413c-a581-01e660b7163e