mirror of
https://gitlab.com/pulsechaincom/go-pulse.git
synced 2024-12-24 20:37:17 +00:00
c76ad94492
This commit adds a build step to travis to auto-delete unstable archives older than 14 days (our regular release schedule) from Azure via ci.go purge. The commit also pulls in the latest Azure storage code, also switching over from the old import path (github.com/Azure/azure-sdk-for-go) to the new split one (github.com/Azure/azure-storage-go).
218 lines
6.4 KiB
Go
218 lines
6.4 KiB
Go
package storage
|
|
|
|
import (
|
|
"encoding/xml"
|
|
"net/http"
|
|
"net/url"
|
|
)
|
|
|
|
// Directory represents a directory on a share.
|
|
type Directory struct {
|
|
fsc *FileServiceClient
|
|
Metadata map[string]string
|
|
Name string `xml:"Name"`
|
|
parent *Directory
|
|
Properties DirectoryProperties
|
|
share *Share
|
|
}
|
|
|
|
// DirectoryProperties contains various properties of a directory.
|
|
type DirectoryProperties struct {
|
|
LastModified string `xml:"Last-Modified"`
|
|
Etag string `xml:"Etag"`
|
|
}
|
|
|
|
// ListDirsAndFilesParameters defines the set of customizable parameters to
|
|
// make a List Files and Directories call.
|
|
//
|
|
// See https://msdn.microsoft.com/en-us/library/azure/dn166980.aspx
|
|
type ListDirsAndFilesParameters struct {
|
|
Marker string
|
|
MaxResults uint
|
|
Timeout uint
|
|
}
|
|
|
|
// DirsAndFilesListResponse contains the response fields from
|
|
// a List Files and Directories call.
|
|
//
|
|
// See https://msdn.microsoft.com/en-us/library/azure/dn166980.aspx
|
|
type DirsAndFilesListResponse struct {
|
|
XMLName xml.Name `xml:"EnumerationResults"`
|
|
Xmlns string `xml:"xmlns,attr"`
|
|
Marker string `xml:"Marker"`
|
|
MaxResults int64 `xml:"MaxResults"`
|
|
Directories []Directory `xml:"Entries>Directory"`
|
|
Files []File `xml:"Entries>File"`
|
|
NextMarker string `xml:"NextMarker"`
|
|
}
|
|
|
|
// builds the complete directory path for this directory object.
|
|
func (d *Directory) buildPath() string {
|
|
path := ""
|
|
current := d
|
|
for current.Name != "" {
|
|
path = "/" + current.Name + path
|
|
current = current.parent
|
|
}
|
|
return d.share.buildPath() + path
|
|
}
|
|
|
|
// Create this directory in the associated share.
|
|
// If a directory with the same name already exists, the operation fails.
|
|
//
|
|
// See https://msdn.microsoft.com/en-us/library/azure/dn166993.aspx
|
|
func (d *Directory) Create() error {
|
|
// if this is the root directory exit early
|
|
if d.parent == nil {
|
|
return nil
|
|
}
|
|
|
|
headers, err := d.fsc.createResource(d.buildPath(), resourceDirectory, nil, mergeMDIntoExtraHeaders(d.Metadata, nil), []int{http.StatusCreated})
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
d.updateEtagAndLastModified(headers)
|
|
return nil
|
|
}
|
|
|
|
// CreateIfNotExists creates this directory under the associated share if the
|
|
// directory does not exists. Returns true if the directory is newly created or
|
|
// false if the directory already exists.
|
|
//
|
|
// See https://msdn.microsoft.com/en-us/library/azure/dn166993.aspx
|
|
func (d *Directory) CreateIfNotExists() (bool, error) {
|
|
// if this is the root directory exit early
|
|
if d.parent == nil {
|
|
return false, nil
|
|
}
|
|
|
|
resp, err := d.fsc.createResourceNoClose(d.buildPath(), resourceDirectory, nil, nil)
|
|
if resp != nil {
|
|
defer readAndCloseBody(resp.body)
|
|
if resp.statusCode == http.StatusCreated || resp.statusCode == http.StatusConflict {
|
|
if resp.statusCode == http.StatusCreated {
|
|
d.updateEtagAndLastModified(resp.headers)
|
|
return true, nil
|
|
}
|
|
|
|
return false, d.FetchAttributes()
|
|
}
|
|
}
|
|
|
|
return false, err
|
|
}
|
|
|
|
// Delete removes this directory. It must be empty in order to be deleted.
|
|
// If the directory does not exist the operation fails.
|
|
//
|
|
// See https://msdn.microsoft.com/en-us/library/azure/dn166969.aspx
|
|
func (d *Directory) Delete() error {
|
|
return d.fsc.deleteResource(d.buildPath(), resourceDirectory)
|
|
}
|
|
|
|
// DeleteIfExists removes this directory if it exists.
|
|
//
|
|
// See https://msdn.microsoft.com/en-us/library/azure/dn166969.aspx
|
|
func (d *Directory) DeleteIfExists() (bool, error) {
|
|
resp, err := d.fsc.deleteResourceNoClose(d.buildPath(), resourceDirectory)
|
|
if resp != nil {
|
|
defer readAndCloseBody(resp.body)
|
|
if resp.statusCode == http.StatusAccepted || resp.statusCode == http.StatusNotFound {
|
|
return resp.statusCode == http.StatusAccepted, nil
|
|
}
|
|
}
|
|
return false, err
|
|
}
|
|
|
|
// Exists returns true if this directory exists.
|
|
func (d *Directory) Exists() (bool, error) {
|
|
exists, headers, err := d.fsc.resourceExists(d.buildPath(), resourceDirectory)
|
|
if exists {
|
|
d.updateEtagAndLastModified(headers)
|
|
}
|
|
return exists, err
|
|
}
|
|
|
|
// FetchAttributes retrieves metadata for this directory.
|
|
func (d *Directory) FetchAttributes() error {
|
|
headers, err := d.fsc.getResourceHeaders(d.buildPath(), compNone, resourceDirectory, http.MethodHead)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
d.updateEtagAndLastModified(headers)
|
|
d.Metadata = getMetadataFromHeaders(headers)
|
|
|
|
return nil
|
|
}
|
|
|
|
// GetDirectoryReference returns a child Directory object for this directory.
|
|
func (d *Directory) GetDirectoryReference(name string) *Directory {
|
|
return &Directory{
|
|
fsc: d.fsc,
|
|
Name: name,
|
|
parent: d,
|
|
share: d.share,
|
|
}
|
|
}
|
|
|
|
// GetFileReference returns a child File object for this directory.
|
|
func (d *Directory) GetFileReference(name string) *File {
|
|
return &File{
|
|
fsc: d.fsc,
|
|
Name: name,
|
|
parent: d,
|
|
share: d.share,
|
|
}
|
|
}
|
|
|
|
// ListDirsAndFiles returns a list of files and directories under this directory.
|
|
// It also contains a pagination token and other response details.
|
|
//
|
|
// See https://msdn.microsoft.com/en-us/library/azure/dn166980.aspx
|
|
func (d *Directory) ListDirsAndFiles(params ListDirsAndFilesParameters) (*DirsAndFilesListResponse, error) {
|
|
q := mergeParams(params.getParameters(), getURLInitValues(compList, resourceDirectory))
|
|
|
|
resp, err := d.fsc.listContent(d.buildPath(), q, nil)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
defer resp.body.Close()
|
|
var out DirsAndFilesListResponse
|
|
err = xmlUnmarshal(resp.body, &out)
|
|
return &out, err
|
|
}
|
|
|
|
// SetMetadata replaces the metadata for this directory.
|
|
//
|
|
// Some keys may be converted to Camel-Case before sending. All keys
|
|
// are returned in lower case by GetDirectoryMetadata. HTTP header names
|
|
// are case-insensitive so case munging should not matter to other
|
|
// applications either.
|
|
//
|
|
// See https://msdn.microsoft.com/en-us/library/azure/mt427370.aspx
|
|
func (d *Directory) SetMetadata() error {
|
|
headers, err := d.fsc.setResourceHeaders(d.buildPath(), compMetadata, resourceDirectory, mergeMDIntoExtraHeaders(d.Metadata, nil))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
d.updateEtagAndLastModified(headers)
|
|
return nil
|
|
}
|
|
|
|
// updates Etag and last modified date
|
|
func (d *Directory) updateEtagAndLastModified(headers http.Header) {
|
|
d.Properties.Etag = headers.Get("Etag")
|
|
d.Properties.LastModified = headers.Get("Last-Modified")
|
|
}
|
|
|
|
// URL gets the canonical URL to this directory.
|
|
// This method does not create a publicly accessible URL if the directory
|
|
// is private and this method does not check if the directory exists.
|
|
func (d *Directory) URL() string {
|
|
return d.fsc.client.getEndpoint(fileServiceName, d.buildPath(), url.Values{})
|
|
}
|