source: extensions/jiwigo-ws-api/src/main/java/fr/mael/jiwigo/service/TagService.java @ 9879

package fr.mael.jiwigo.service;

import java.io.IOException;
import java.util.List;

import fr.mael.jiwigo.dao.TagDao;
import fr.mael.jiwigo.om.Image;
import fr.mael.jiwigo.om.Tag;
import fr.mael.jiwigo.transverse.exception.ProxyAuthenticationException;
import fr.mael.jiwigo.transverse.session.SessionManager;

/*
 *  jiwigo-ws-api Piwigo webservice access Api
 *  Copyright (c) 2010-2011 Mael mael@le-guevel.com
 *                All Rights Reserved
 *
 *  This library is free software. It comes without any warranty, to
 *  the extent permitted by applicable law. You can redistribute it
 *  and/or modify it under the terms of the Do What The Fuck You Want
 *  To Public License, Version 2, as published by Sam Hocevar. See
 *  http://sam.zoy.org/wtfpl/COPYING for more details.
 */
/**
 *

 * @author mael
 *
 */
public class TagService {
    /**
     * Logger
     */
    public static final org.apache.commons.logging.Log LOG = org.apache.commons.logging.LogFactory
            .getLog(TagService.class);

    /**
     * The instance, to use a singleton
     */
    private static TagService instance;

    private SessionManager sessionManager;

    /**
     * @return the singleton
     */
    public static TagService getInstance(SessionManager sessionManager) {
        if (instance == null) {
            instance = new TagService(sessionManager);
        }
        return instance;
    }

    /**
     * private constructor
     */
    private TagService(SessionManager sessionManager) {
        this.sessionManager = sessionManager;
    }

    /**
     * Lists all tags
     * @return le list of tags
     * @throws IOException
     * @throws ProxyAuthenticationException
     */
    public List<Tag> list() throws IOException, ProxyAuthenticationException {
        return TagDao.getInstance(sessionManager).list();
    }

    /**
     * Creates a tag
     * @param nom name of the tag
     * @return true if the tag is created
     * @throws IOException
     * @throws ProxyAuthenticationException
     */
    public boolean create(String nom) throws IOException, ProxyAuthenticationException {
        Tag tag = new Tag();
        tag.setName(nom);
        return TagDao.getInstance(sessionManager).create(tag);
    }

    /**
     * Returns all the tag for an image
     * @param image the image to check
     * @return the list of tags
     * @throws IOException
     * @throws ProxyAuthenticationException
     */
    public List<Tag> tagsForImage(Image image) throws IOException, ProxyAuthenticationException {
        return TagDao.getInstance(sessionManager).tagsForImage(image);
    }

}