source: extensions/PiwigoLib/PiwigoLib/Service/PwgTagsService.cs @ 3834

using System;
using System.Collections.Generic;
using System.Text;

using Com.Piwigo.Lib.DTO;
using Com.Piwigo.Lib.Proxy;
using Com.Piwigo.Lib.Proxy.Response;
using Com.Piwigo.Lib.DTO.Helper;

namespace Com.Piwigo.Lib.Service
{

    static public class PwgTagsService
    {
        /// <summary>
        /// Get the list of tags the user is connected can access
        /// </summary>
        /// <param name="sortedByCounter"></param>
        /// <returns></returns>
        static public List<PwgTag> GetListOfTag(Boolean? sortedByCounter)
        {
            List<PwgTag> returnValue = new List<PwgTag>();

            try
            {
                PwgTagsProxyResponse response = PwgTagsProxy.pwg_tags_getList(sortedByCounter);

                if (response.Retour != PwgBaseProxyReponseRetourEnum.Ok)
                {
                    if (response.Erreur != null)
                    {
                        throw new PwgServiceException("GetListOfPwgTag, the server has return the error.",
                            response.Erreur.Code,
                            response.Erreur.Message);
                    }
                    else
                    {
                        throw new PwgServiceException("GetListOfPwgTag : a error occurs during server process.");
                    }
                }
                else
                {
                    returnValue = ConvertProxyResponseToDTO(response);
                }
            }
            catch (PwgProxyException ex)
            {
                throw new PwgServiceException("GetListOfPwgTag : a error is raised by proxy.", ex);
            }
            return returnValue;
        }

        /// <summary>
        /// Get the list of all atgs in piwigo, you must be connected with a high level user
        /// </summary>
        /// <param name="sortedByCounter"></param>
        /// <returns></returns>
        static public List<PwgTag> GetAdminListOfTag()
        {
            List<PwgTag> returnValue = new List<PwgTag>();

            try
            {
                PwgTagsProxyResponse response = PwgTagsProxy.pwg_tags_getAdminList();

                if (response.Retour != PwgBaseProxyReponseRetourEnum.Ok)
                {
                    if (response.Erreur != null)
                    {
                        throw new PwgServiceException("GetAdminListOfTag, the server has return the error.",
                            response.Erreur.Code,
                            response.Erreur.Message);
                    }
                    else
                    {
                        throw new PwgServiceException("GetAdminListOfTag : a error occurs during server process.");
                    }
                }
                else
                {
                    returnValue = ConvertProxyResponseToDTO(response);
                }
            }
            catch (PwgProxyException ex)
            {
                throw new PwgServiceException("GetAdminListOfTag : a error is raised by proxy.", ex);
            }
            return returnValue;
        }

        /// <summary>
        /// Add a Tag
        /// </summary>
        /// <param name="tagName"></param>
        /// <returns></returns>
        static public Boolean AddTag(String tagName, ref Int32 newId, ref String messageInfo)
        {
            Boolean returnValue = false;

            try
            {
                PwgAddRequestProxyResponse response = PwgTagsProxy.pwg_tag_add(tagName);

                if (response.Retour != PwgBaseProxyReponseRetourEnum.Ok)
                {
                    if (response.Erreur != null)
                    {
                        throw new PwgServiceException("AddTag, the server has return the error.",
                            response.Erreur.Code,
                            response.Erreur.Message);
                    }
                    else
                    {
                        throw new PwgServiceException("AddTag : a error occurs during server process.");
                    }
                }
                else
                {
                    returnValue = true;
                    newId = response.NewId;
                    messageInfo = response.Message;
                }
            }
            catch (PwgProxyException ex)
            {
                throw new PwgServiceException("AddTag : a error is raised by proxy.", ex);
            }
            return returnValue;
        }

        /// <summary>
        /// Return the list of image form a list of tag
        /// </summary>
        /// <param name="tagsId"></param>
        /// <param name="tagsUrlName"></param>
        /// <param name="tagsName"></param>
        /// <param name="tagModeAnd"></param>
        /// <param name="perPage"></param>
        /// <param name="Page"></param>
        /// <param name="Order"></param>
        /// <param name="minRate"></param>
        /// <param name="maxRate"></param>
        /// <param name="minHit"></param>
        /// <param name="maxHit"></param>
        /// <param name="minDateAvailable"></param>
        /// <param name="maxDateAvailable"></param>
        /// <param name="minDateCreated"></param>
        /// <param name="maxDateCreated"></param>
        /// <param name="minRatio"></param>
        /// <param name="maxRatio"></param>
        /// <param name="withThumbnail"></param>
        /// <param name="PageReturned"></param>
        /// <param name="PerPageeReturned"></param>
        /// <param name="CountReturned"></param>
        /// <returns></returns>
        static public List<PwgImage> GetListOfImagesFormTags(List<Int32> tagsId,
                                                            List<String> tagsUrlName,
                                                            List<String> tagsName,
                                                            Boolean? tagModeAnd,
                                                            Int32? perPage,
                                                            Int32? Page,
                                                            Int32? Order,
                                                            Int32? minRate,
                                                            Int32? maxRate,
                                                            Int32? minHit,
                                                            Int32? maxHit,
                                                            DateTime? minDateAvailable,
                                                            DateTime? maxDateAvailable,
                                                            DateTime? minDateCreated,
                                                            DateTime? maxDateCreated,
                                                            Int32? minRatio,
                                                            Int32? maxRatio,
                                                            Boolean? withThumbnail,
                                                            ref Int32 PageReturned,
                                                            ref Int32 PerPageeReturned,
                                                            ref Int32 CountReturned)
        {
            List<PwgImage> returnValue = new List<PwgImage>();

            try
            {
                PwgImagesProxyResponse response = PwgTagsProxy.pwg_tags_getImages(tagsId,
                                                            tagsUrlName,
                                                            tagsName,
                                                            tagModeAnd,
                                                            perPage,
                                                            Page,
                                                            Order,
                                                            minRate,
                                                            maxRate,
                                                            minHit,
                                                            maxHit,
                                                            minDateAvailable,
                                                            maxDateAvailable,
                                                            minDateCreated,
                                                            maxDateCreated,
                                                            minRatio,
                                                            maxRatio,
                                                            withThumbnail);

                if (response.Retour != PwgBaseProxyReponseRetourEnum.Ok)
                {
                    if (response.Erreur != null)
                    {
                        throw new PwgServiceException("GetListOfImagesFormTags, the server has return the error.",
                            response.Erreur.Code,
                            response.Erreur.Message);
                    }
                    else
                    {
                        throw new PwgServiceException("GetListOfImagesFormTags : a error occurs during server process.");
                    }
                }
                else
                {
                    PwgImagesService.ConvertProxyResponseToDTO(response, returnValue,
                                                            ref PageReturned,
                                                            ref PerPageeReturned,
                                                            ref CountReturned);
                }
            }
            catch (PwgProxyException ex)
            {
                throw new PwgServiceException("GetListOfImagesFormTags : a error is raised by proxy.", ex);
            }
            return returnValue;
        }


        /// <summary>
        /// private: convert response to dto object
        /// </summary>
        /// <param name="response"></param>
        /// <param name="session"></param>
        static public List<PwgTag> ConvertProxyResponseToDTO(PwgTagsProxyResponse response)
        {
            List<PwgTag> returnValue = new List<PwgTag>();

            foreach (PwgTagProxyResponse respTag in response.Tags)
            {
                returnValue.Add(ConvertProxyResponseToDTO(respTag));
            }

            return returnValue;
        }


        /// <summary>
        /// private: convert response to dto object
        /// </summary>
        /// <param name="response"></param>
        /// <param name="session"></param>
        static public PwgTag ConvertProxyResponseToDTO(PwgTagProxyResponse response)
        {
            PwgTag returnValue = new PwgTag();

            try
            {
                returnValue.Counter = response.Counter;
                returnValue.Id = response.Id;
                returnValue.Name = response.Name;
                returnValue.UrlName = response.UrlName;

                if (String.IsNullOrEmpty(response.UrlTag))
                {
                    returnValue.UrlTag = null;
                }
                else
                {
                    returnValue.UrlTag = (new UriBuilder(response.UrlTag)).Uri;
                }
            }
            catch (Exception ex)
            {
                throw new PwgServiceException("ConvertProxyResponseToDTO : a error is raised when converting PwgTagProxyResponse.", ex);
            }

            return returnValue;
        }
    }
}