br.com.anteros.nextcloud.api.webdav.Folders Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of Anteros-NextCloud Show documentation
Anteros NextCloud for Java.
There is a newer version: 1.0.16
/*
 * Copyright (C) 2017 a.schild
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * 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 .
 */
package br.com.anteros.nextcloud.api.webdav;

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

import com.github.sardine.DavResource;
import com.github.sardine.Sardine;

import br.com.anteros.nextcloud.api.ServerConfig;
import br.com.anteros.nextcloud.api.exception.NextCloudApiException;
import br.com.anteros.nextcloud.api.utils.AnterosSardineFactory;

/**
 *
 * @author a.schild
 */
public class Folders {

    private final String WEB_DAV_BASE_PATH= "remote.php/webdav/";

    private final ServerConfig  _serverConfig;

    public Folders(ServerConfig _serverConfig) {
        this._serverConfig = _serverConfig;
    }

    /**
     * Get all subfolders of the specified path
     *
     * @param rootPath path of the folder
     * @return found subfolders
     *
     * @deprecated The methods naming is somehow misleading, as it lists all resources (subfolders and files) within the given {@code rootPath}. Please use {@link #listFolderContent(String)} instead.
     */
    @Deprecated
    public List getFolders(String rootPath)
    {
        return listFolderContent(rootPath);
    }

    /**
     * List all file names and subfolders of the specified path
     *
     * @param path path of the folder
     * @return found file names and subfolders
     */
    public List listFolderContent(String path)
    {
        return listFolderContent(path, 1);
    }

    /**
     * List all file names and subfolders of the specified path traversing into subfolders to the given depth.
     *
     * @param path path of the folder
     * @param depth depth of recursion while listing folder contents
     * @return found file names and subfolders
     */
    public List listFolderContent(String path, int depth)
    {
        String url = (_serverConfig.isUseHTTPS() ? "https" : "http") +"://"+_serverConfig.getServerName()+"/"+WEB_DAV_BASE_PATH+path ;

        List retVal= new LinkedList<>();
        Sardine sardine = AnterosSardineFactory.begin();
        sardine.setCredentials(_serverConfig.getUserName(), _serverConfig.getPassword());
        List resources;
        try {
            resources = sardine.list(url, depth);
        } catch (IOException e) {
            throw new NextCloudApiException(e);
        }
        for (DavResource res : resources)
        {
            retVal.add(res.getName());
        }
        return retVal;
    }

    /**
     * Checks if the folder at the specified path exists
     *
     * @param rootPath path of the folder
     * @return true if the folder exists
     */
    public boolean exists(String rootPath)
    {
        String path=  (_serverConfig.isUseHTTPS() ? "https" : "http") +"://"+_serverConfig.getServerName()+"/"+WEB_DAV_BASE_PATH+rootPath ;

        Sardine sardine = AnterosSardineFactory.begin();
        sardine.setCredentials(_serverConfig.getUserName(), _serverConfig.getPassword());
        try {
            return sardine.exists(path);
        } catch (IOException e) {
            throw new NextCloudApiException(e);
        }
    }

    /**
     * Creates a folder at the specified path
     *
     * @param rootPath path of the folder
     */
    public void createFolder(String rootPath)
    {
        String path=  (_serverConfig.isUseHTTPS() ? "https" : "http") +"://"+_serverConfig.getServerName()+"/"+WEB_DAV_BASE_PATH+rootPath ;

        Sardine sardine = AnterosSardineFactory.begin();
        sardine.setCredentials(_serverConfig.getUserName(), _serverConfig.getPassword());
        try {
            sardine.createDirectory(path);
        } catch (IOException e) {
            throw new NextCloudApiException(e);
        }
    }

    /**
     * Deletes the folder at the specified path
     *
     * @param rootPath path of the folder
     */
    public void deleteFolder(String rootPath)
    {
        String path=  (_serverConfig.isUseHTTPS() ? "https" : "http") +"://"+_serverConfig.getServerName()+"/"+WEB_DAV_BASE_PATH+rootPath ;

        Sardine sardine = AnterosSardineFactory.begin();
        sardine.setCredentials(_serverConfig.getUserName(), _serverConfig.getPassword());
        try {
            sardine.delete(path);
        } catch (IOException e) {
            throw new NextCloudApiException(e);
        }
    }
}