add file list to readme

Author: Hegedus

README.md

@@ -191,7 +191,16 @@ for (RepositorySummary repoSummary : artifactory.storage().getStorageInfo().getR
 ##### Getting Items
 ```
 ItemHandle fileItem = artifactory.repository("RepoName").file("path/to/file.txt");
-ItemHandle folderItem = artifactory.repository("RepoName").folder("path/to/folder");
+FolderHandle folderItem = artifactory.repository("RepoName").folder("path/to/folder");
+```
+
+##### Getting All Items Under A Folder
+```
+FolderHandle folder = artifactory.repository("RepoName").folder("path/to/folder");
+boolean deep = true;
+boolean listFolders = true;
+boolean timeStamps = true;
+FileList list = folder.list(deep, listFolders, timeStamps);
 ```
 
 ##### Copying Items

api/src/main/java/org/jfrog/artifactory/client/FolderHandle.java

@@ -0,0 +1,9 @@
+package org.jfrog.artifactory.client;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import org.jfrog.artifactory.client.model.FileList;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public interface FolderHandle extends ItemHandle {
+    FileList list(boolean deep, boolean listFolders, boolean timestamps);
+}

api/src/main/java/org/jfrog/artifactory/client/RepositoryHandle.java

@@ -16,7 +16,7 @@
 @JsonIgnoreProperties(ignoreUnknown = true)
 public interface RepositoryHandle {
 
-    ItemHandle folder(String folderName);
+    FolderHandle folder(String folderName);
 
     ItemHandle file(String filePath);
 

api/src/main/java/org/jfrog/artifactory/client/model/FileList.java

@@ -0,0 +1,9 @@
+package org.jfrog.artifactory.client.model;
+
+import java.util.List;
+
+public interface FileList {
+
+    int size();
+    List<ListItem> getFiles();
+}

api/src/main/java/org/jfrog/artifactory/client/model/ListItem.java

@@ -0,0 +1,11 @@
+package org.jfrog.artifactory.client.model;
+
+import java.util.Date;
+
+public interface ListItem {
+    String getUri();
+    Long getSize();
+    Date getLastModified();
+    Boolean isFolder();
+    String getSha1();
+}

services/src/main/groovy/org/jfrog/artifactory/client/impl/FolderHandleImpl.groovy

@@ -0,0 +1,35 @@
+package org.jfrog.artifactory.client.impl
+
+import org.jfrog.artifactory.client.FolderHandle
+import org.jfrog.artifactory.client.model.FileList
+import org.jfrog.artifactory.client.model.impl.FileListImpl
+
+class FolderHandleImpl extends ItemHandleImpl implements FolderHandle {
+
+    private String baseApiPath
+
+    private ArtifactoryImpl artifactory
+    private String repo
+    private String path
+
+    FolderHandleImpl(ArtifactoryImpl artifactory, String baseApiPath, String repo, String path, Class itemType) {
+        super(artifactory, baseApiPath, repo, path, itemType)
+        this.artifactory = artifactory
+        this.repo = repo
+        this.path = path
+        this.baseApiPath = baseApiPath
+    }
+
+    FileList list(boolean deep, boolean listFolders, boolean timestamps) {
+        String deepInt = toInt(deep)
+        String listFoldersInt = toInt(listFolders)
+        String timestampsInt = toInt(timestamps)
+        String url = baseApiPath + "/storage/$repo/$path?list&deep=$deepInt&listFolders=$listFoldersInt&mdTimestamps=$timestampsInt"
+        return artifactory.get(url, FileListImpl, FileList)
+    }
+
+    private static String toInt(boolean b) {
+        return b?"1":"0"
+    }
+
+}

services/src/main/groovy/org/jfrog/artifactory/client/impl/RepositoryHandleImpl.groovy

@@ -40,8 +40,8 @@ class RepositoryHandleImpl implements RepositoryHandle {
 
     //TODO: [by yl] Use a FileHandler and a FolderHandler instead or returning Items
     @Override
-    ItemHandle folder(String folderName) {
-        new ItemHandleImpl(artifactory, baseApiPath, repoKey, folderName, FolderImpl)
+    FolderHandle folder(String folderName) {
+        new FolderHandleImpl(artifactory, baseApiPath, repoKey, folderName, FolderImpl)
     }
 
     @Override

services/src/main/java/org/jfrog/artifactory/client/model/impl/FileListImpl.java

@@ -0,0 +1,34 @@
+package org.jfrog.artifactory.client.model.impl;
+
+import org.jfrog.artifactory.client.model.FileList;
+import org.jfrog.artifactory.client.model.ListItem;
+
+import java.util.Arrays;
+import java.util.Date;
+import java.util.List;
+
+public class FileListImpl implements FileList {
+
+    String uri;
+    Date created;
+    ListItemImpl[] files;
+
+    FileListImpl(String uri, Date created, ListItemImpl[] files) {
+        this.uri = uri;
+        this.created = created;
+        this.files = files;
+    }
+
+    public FileListImpl() {
+    }
+
+    @Override
+    public int size() {
+       return files.length;
+    }
+
+    @Override
+    public List<ListItem> getFiles() {
+        return Arrays.asList(files);
+    }
+}

services/src/main/java/org/jfrog/artifactory/client/model/impl/ListItemImpl.java

@@ -0,0 +1,48 @@
+package org.jfrog.artifactory.client.model.impl;
+
+import org.jfrog.artifactory.client.model.ListItem;
+
+import java.util.Date;
+
+public class ListItemImpl implements ListItem {
+    String uri;
+    Long size;
+    Date lastModified;
+    Boolean folder;
+    String sha1;
+
+    ListItemImpl(String uri, Long size, Date lastModified, Boolean folder) {
+        this.uri = uri;
+        this.size = size;
+        this.lastModified = lastModified;
+        this.folder = folder;
+    }
+
+    ListItemImpl() {
+    }
+
+    @Override
+    public String getUri() {
+        return uri;
+    }
+
+    @Override
+    public Long getSize() {
+        return size;
+    }
+
+    @Override
+    public Date getLastModified() {
+        return lastModified;
+    }
+
+    @Override
+    public Boolean isFolder() {
+        return folder;
+    }
+
+    @Override
+    public String getSha1() {
+        return sha1;
+    }
+}

services/src/main/resources/artifactory.client.release.properties

@@ -1 +1 @@
-version=2.9.1
+version=2.9.x-SNAPSHOT