Un servizio OSGi è un'interfaccia di classe o servizio Java, insieme a una serie di proprietà del servizio come coppie nome/valore. Le proprietà del servizio differenziano tra i diversi provider di servizi che forniscono servizi con la stessa interfaccia di servizio.
Un servizio OSGi viene definito semanticamente dalla relativa interfaccia di servizio e implementato come oggetto di servizio. La funzionalità di un servizio è definita dalle interfacce che implementa. Pertanto, applicazioni diverse possono implementare lo stesso servizio. Le interfacce di servizio consentono ai bundle di interagire mediante interfacce di binding, non tramite implementazioni. Specificare un'interfaccia di servizio con il minor numero possibile di dettagli di implementazione.
Definire l’interfaccia
Interfaccia semplice con un metodo per unire i dati con il modello XDP.
package com.learningaemforms.adobe.core;
import com.adobe.aemfd.docmanager.Document;
public interface MyfirstInterface {
public Document mergeDataWithXDPTemplate(Document xdpTemplate, Document xmlDocument);
}
Implementare l’interfaccia
Crea un nuovo pacchetto denominato com.learningaemforms.adobe.core.impl per mantenere l’implementazione dell’interfaccia.
package com.learningaemforms.adobe.core.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.learningaemforms.adobe.core.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;
}
}
L’annotazione @Component(...) alla riga 10 indica questa classe Java come componente OSGi e la registra come servizio OSGi.
L'annotazione @Reference fa parte dei servizi dichiarativi OSGi e viene utilizzata per inserire un riferimento di Outputservice nella variabile outputService.
Creare e distribuire il bundle
Apri finestra del prompt dei comandi
Accedi a c:\aemformsbundles\learningaemforms\core
Esegui il comando mvn clean install -PautoInstallBundle
Il comando precedente genera e distribuisce automaticamente il bundle nella tua istanza AEM in esecuzione su localhost:4502
Il bundle sarà disponibile anche nel seguente percorso C:\AEMFormsBundles\learningaemforms\core\target. Il bundle può anche essere distribuito in AEM utilizzando la console web Felix.
Utilizzo del servizio
Ora puoi utilizzare il servizio nella pagina JSP. Il seguente frammento di codice mostra come accedere al servizio e utilizzare i metodi implementati dal servizio
