TracciaBuilder.java

/*
 * GovWay - A customizable API Gateway 
 * https://govway.org
 * 
 * Copyright (c) 2005-2025 Link.it srl (https://link.it). 
 * 
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 3, as published by
 * the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 */



package org.openspcoop2.protocol.engine.builder;

import org.openspcoop2.protocol.engine.Configurazione;
import org.openspcoop2.protocol.sdk.IProtocolFactory;
import org.openspcoop2.protocol.sdk.ProtocolException;
import org.openspcoop2.protocol.sdk.constants.TipoSerializzazione;
import org.openspcoop2.protocol.sdk.tracciamento.ITracciaSerializer;
import org.openspcoop2.protocol.sdk.tracciamento.Traccia;
import org.openspcoop2.utils.LoggerWrapperFactory;
import org.slf4j.Logger;
import org.w3c.dom.Element;

/**
 * Classe per la costruzione delle traccie
 *
 * @author Poli Andrea (apoli@link.it)
 * @author $Author$
 * @version $Rev$, $Date$
 */

public class TracciaBuilder  {


    /** Logger utilizzato per debug. */
    protected Logger log = null;

    private IProtocolFactory<?> protocolFactory;
    private ITracciaSerializer tracciaProtocolBuilder;
    
    public TracciaBuilder(IProtocolFactory<?> protocolFactory) {
        this(Configurazione.getLibraryLog(), protocolFactory);
    }
    public TracciaBuilder(Logger aLog, IProtocolFactory<?> protocolFactory) {
        if(aLog!=null)
            this.log = aLog;
        else
            this.log = LoggerWrapperFactory.getLogger(TracciaBuilder.class);
        this.protocolFactory = protocolFactory;
        try{
            this.tracciaProtocolBuilder = this.protocolFactory.createTracciaSerializer();
        }catch(Exception e){
            this.log.error("Errore durante la creazione dell'XMLTracciaBuilder: "+e.getMessage(),e);
        }
    }

    public IProtocolFactory<?> getProtocolFactory(){
        return this.protocolFactory;
    }

    /* --------------------- TRACCIAMENTO BUSTE -----------------------*/

    /**
     * Costruisce un SOAPElement contenente un Tracciamento come definito da specifica del protocollo 
     *
     * @param traccia conterra' i valori della traccia
     * @return SOAPElement contenente il  tracciamento in caso di successo, null altrimenti. 
     * 
     */
    public Element toElement(Traccia traccia)throws ProtocolException{
        return this.tracciaProtocolBuilder.toElement(traccia);
    }
    
    /**
     * Costruisce un array di byte contenenti un Tracciamento (formato XML) come definito da specifica del protocollo 
     *
     * @param traccia conterra' i valori della traccia
     * @return array di byte contenente il codice XML del tracciamento in caso di successo, null altrimenti. 
     * 
     */
    public byte[] toByteArray(Traccia traccia, TipoSerializzazione tipoSerializzazione)throws ProtocolException{
        return this.tracciaProtocolBuilder.toByteArray(traccia, tipoSerializzazione);
    }

    /**
     * Costruisce un pezzo di codice XML contenente un Tracciamento come definito da specifica del protocollo 
     *
     * @param traccia conterra' i valori della traccia
     * @return String contenente il codice XML del tracciamento in caso di successo, null altrimenti. 
     * 
     */
    public String toString(Traccia traccia, TipoSerializzazione tipoSerializzazione) throws ProtocolException{
        return this.tracciaProtocolBuilder.toString(traccia, tipoSerializzazione);
    }

}