<?php

/**
 * <--- Copyright 2005-2011 de Solis - Cooperativa de Soluções Livres Ltda. e
 * Univates - Centro Universitário.
 * 
 * Este arquivo é parte do programa Gnuteca.
 * 
 * O Gnuteca é um software livre; você pode redistribuí-lo e/ou modificá-lo
 * dentro dos termos da Licença Pública Geral GNU como publicada pela Fundação
 * do Software Livre (FSF); na versão 2 da Licença.
 * 
 * Este programa é distribuído na esperança que possa ser útil, mas SEM
 * NENHUMA GARANTIA; sem uma garantia implícita de ADEQUAÇÃO a qualquer MERCADO
 * ou APLICAÇÃO EM PARTICULAR. Veja a Licença Pública Geral GNU/GPL em
 * português para maiores detalhes.
 * 
 * Você deve ter recebido uma cópia da Licença Pública Geral GNU, sob o título
 * "LICENCA.txt", junto com este programa, se não, acesse o Portal do Software
 * Público Brasileiro no endereço www.softwarepublico.gov.br ou escreva para a
 * Fundação do Software Livre (FSF) Inc., 51 Franklin St, Fifth Floor, Boston,
 * MA 02110-1301, USA --->
 * 
 * Class
 *
 * @author Jader Osvino Fiegenbaum [jader@solis.com.br]
 *
 * @version $Id$
 *
 * \b Maintainers: \n
 * Jader Osvino Fiegenbaum [jader@solis.com.br]
 *
 * @since
 * Class created on 11/01/2017
 *
 **/

class DecsParse
{
    // Conteúdo XML string original.
    public $xmlString;
    
    // Conteúdo XML convertido em array.
    public $decsResponse;

    /**
     * Método construtor.
     *
     * @param text $xmlString Conteúdo String xml.
     * @param boolean $onlyTerm Quando true obtém somente o termo principal.
     */
    public function __construct($xmlString, $onlyTerm=false, $language='pt')
    {
        $this->xmlString = $xmlString;
        
        $xmlArray = xmlstr_to_array($xmlString);
        
        if ( isset($xmlArray['decsws_response']) )
        {
            // Faz o parse de uma ou mais respostas da pesquisa.
            if ( current(array_keys($xmlArray['decsws_response'])) === 'tree' )
            {
                $this->decsResponse[] = new DecsResponse($xmlArray['decsws_response'], $onlyTerm, $language);
            }
            else
            {
                foreach ( $xmlArray['decsws_response'] as $response )
                {
                    $this->decsResponse[] = new DecsResponse($response, $onlyTerm, $language);
                }
            }
        }
    }
    
    /**
     * Obtém a descrição do qualificador encontrado entre as respostas.
     *
     * @return stdClass Dados do qualificador.
     */
    public function getQualifier()
    {
        foreach ( $this->decsResponse as $response )
        {
            if ( $response->isQualifier )
            {
                $data = new stdClass();
                $data->label = $response->term;
                $data->abbreviated = $response->mfn .'|'.$response->category;
                
                return $data;
            }
        }
        
        return '';
    }
}