app.go 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398
  1. // Copyright 2014 Google Inc. All Rights Reserved.
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. // Package main is an example Mananged VM app using the Google Cloud Storage API.
  15. package main
  16. import (
  17. "bytes"
  18. "fmt"
  19. "io"
  20. "io/ioutil"
  21. "net/http"
  22. "strings"
  23. "golang.org/x/net/context"
  24. "google.golang.org/appengine"
  25. "google.golang.org/appengine/file"
  26. "google.golang.org/appengine/log"
  27. "google.golang.org/cloud/storage"
  28. )
  29. // bucket is a local cache of the app's default bucket name.
  30. var bucket string // or: var bucket = "<your-app-id>.appspot.com"
  31. func main() {
  32. http.HandleFunc("/", handler)
  33. appengine.Main()
  34. }
  35. // demo struct holds information needed to run the various demo functions.
  36. type demo struct {
  37. bucket *storage.BucketHandle
  38. client *storage.Client
  39. w http.ResponseWriter
  40. ctx context.Context
  41. // cleanUp is a list of filenames that need cleaning up at the end of the demo.
  42. cleanUp []string
  43. // failed indicates that one or more of the demo steps failed.
  44. failed bool
  45. }
  46. func (d *demo) errorf(format string, args ...interface{}) {
  47. d.failed = true
  48. log.Errorf(d.ctx, format, args...)
  49. }
  50. // handler is the main demo entry point that calls the GCS operations.
  51. func handler(w http.ResponseWriter, r *http.Request) {
  52. if r.URL.Path != "/" {
  53. http.NotFound(w, r)
  54. return
  55. }
  56. ctx := appengine.NewContext(r)
  57. if bucket == "" {
  58. var err error
  59. if bucket, err = file.DefaultBucketName(ctx); err != nil {
  60. log.Errorf(ctx, "failed to get default GCS bucket name: %v", err)
  61. return
  62. }
  63. }
  64. client, err := storage.NewClient(ctx)
  65. if err != nil {
  66. log.Errorf(ctx, "failed to get default GCS bucket name: %v", err)
  67. return
  68. }
  69. defer client.Close()
  70. w.Header().Set("Content-Type", "text/plain; charset=utf-8")
  71. fmt.Fprintf(w, "Demo GCS Application running from Version: %v\n", appengine.VersionID(ctx))
  72. fmt.Fprintf(w, "Using bucket name: %v\n\n", bucket)
  73. d := &demo{
  74. w: w,
  75. ctx: ctx,
  76. client: client,
  77. bucket: client.Bucket(bucket),
  78. }
  79. n := "demo-testfile-go"
  80. d.createFile(n)
  81. d.readFile(n)
  82. d.copyFile(n)
  83. d.statFile(n)
  84. d.createListFiles()
  85. d.listBucket()
  86. d.listBucketDirMode()
  87. d.defaultACL()
  88. d.putDefaultACLRule()
  89. d.deleteDefaultACLRule()
  90. d.bucketACL()
  91. d.putBucketACLRule()
  92. d.deleteBucketACLRule()
  93. d.acl(n)
  94. d.putACLRule(n)
  95. d.deleteACLRule(n)
  96. d.deleteFiles()
  97. if d.failed {
  98. io.WriteString(w, "\nDemo failed.\n")
  99. } else {
  100. io.WriteString(w, "\nDemo succeeded.\n")
  101. }
  102. }
  103. // createFile creates a file in Google Cloud Storage.
  104. func (d *demo) createFile(fileName string) {
  105. fmt.Fprintf(d.w, "Creating file /%v/%v\n", bucket, fileName)
  106. wc := d.bucket.Object(fileName).NewWriter(d.ctx)
  107. wc.ContentType = "text/plain"
  108. wc.Metadata = map[string]string{
  109. "x-goog-meta-foo": "foo",
  110. "x-goog-meta-bar": "bar",
  111. }
  112. d.cleanUp = append(d.cleanUp, fileName)
  113. if _, err := wc.Write([]byte("abcde\n")); err != nil {
  114. d.errorf("createFile: unable to write data to bucket %q, file %q: %v", bucket, fileName, err)
  115. return
  116. }
  117. if _, err := wc.Write([]byte(strings.Repeat("f", 1024*4) + "\n")); err != nil {
  118. d.errorf("createFile: unable to write data to bucket %q, file %q: %v", bucket, fileName, err)
  119. return
  120. }
  121. if err := wc.Close(); err != nil {
  122. d.errorf("createFile: unable to close bucket %q, file %q: %v", bucket, fileName, err)
  123. return
  124. }
  125. }
  126. // readFile reads the named file in Google Cloud Storage.
  127. func (d *demo) readFile(fileName string) {
  128. io.WriteString(d.w, "\nAbbreviated file content (first line and last 1K):\n")
  129. rc, err := d.bucket.Object(fileName).NewReader(d.ctx)
  130. if err != nil {
  131. d.errorf("readFile: unable to open file from bucket %q, file %q: %v", bucket, fileName, err)
  132. return
  133. }
  134. defer rc.Close()
  135. slurp, err := ioutil.ReadAll(rc)
  136. if err != nil {
  137. d.errorf("readFile: unable to read data from bucket %q, file %q: %v", bucket, fileName, err)
  138. return
  139. }
  140. fmt.Fprintf(d.w, "%s\n", bytes.SplitN(slurp, []byte("\n"), 2)[0])
  141. if len(slurp) > 1024 {
  142. fmt.Fprintf(d.w, "...%s\n", slurp[len(slurp)-1024:])
  143. } else {
  144. fmt.Fprintf(d.w, "%s\n", slurp)
  145. }
  146. }
  147. // copyFile copies a file in Google Cloud Storage.
  148. func (d *demo) copyFile(fileName string) {
  149. copyName := fileName + "-copy"
  150. fmt.Fprintf(d.w, "Copying file /%v/%v to /%v/%v:\n", bucket, fileName, bucket, copyName)
  151. obj, err := d.client.CopyObject(d.ctx, bucket, fileName, bucket, copyName, nil)
  152. if err != nil {
  153. d.errorf("copyFile: unable to copy /%v/%v to bucket %q, file %q: %v", bucket, fileName, bucket, copyName, err)
  154. return
  155. }
  156. d.cleanUp = append(d.cleanUp, copyName)
  157. d.dumpStats(obj)
  158. }
  159. func (d *demo) dumpStats(obj *storage.ObjectAttrs) {
  160. fmt.Fprintf(d.w, "(filename: /%v/%v, ", obj.Bucket, obj.Name)
  161. fmt.Fprintf(d.w, "ContentType: %q, ", obj.ContentType)
  162. fmt.Fprintf(d.w, "ACL: %#v, ", obj.ACL)
  163. fmt.Fprintf(d.w, "Owner: %v, ", obj.Owner)
  164. fmt.Fprintf(d.w, "ContentEncoding: %q, ", obj.ContentEncoding)
  165. fmt.Fprintf(d.w, "Size: %v, ", obj.Size)
  166. fmt.Fprintf(d.w, "MD5: %q, ", obj.MD5)
  167. fmt.Fprintf(d.w, "CRC32C: %q, ", obj.CRC32C)
  168. fmt.Fprintf(d.w, "Metadata: %#v, ", obj.Metadata)
  169. fmt.Fprintf(d.w, "MediaLink: %q, ", obj.MediaLink)
  170. fmt.Fprintf(d.w, "StorageClass: %q, ", obj.StorageClass)
  171. if !obj.Deleted.IsZero() {
  172. fmt.Fprintf(d.w, "Deleted: %v, ", obj.Deleted)
  173. }
  174. fmt.Fprintf(d.w, "Updated: %v)\n", obj.Updated)
  175. }
  176. // statFile reads the stats of the named file in Google Cloud Storage.
  177. func (d *demo) statFile(fileName string) {
  178. io.WriteString(d.w, "\nFile stat:\n")
  179. obj, err := d.bucket.Object(fileName).Attrs(d.ctx)
  180. if err != nil {
  181. d.errorf("statFile: unable to stat file from bucket %q, file %q: %v", bucket, fileName, err)
  182. return
  183. }
  184. d.dumpStats(obj)
  185. }
  186. // createListFiles creates files that will be used by listBucket.
  187. func (d *demo) createListFiles() {
  188. io.WriteString(d.w, "\nCreating more files for listbucket...\n")
  189. for _, n := range []string{"foo1", "foo2", "bar", "bar/1", "bar/2", "boo/"} {
  190. d.createFile(n)
  191. }
  192. }
  193. // listBucket lists the contents of a bucket in Google Cloud Storage.
  194. func (d *demo) listBucket() {
  195. io.WriteString(d.w, "\nListbucket result:\n")
  196. query := &storage.Query{Prefix: "foo"}
  197. for query != nil {
  198. objs, err := d.bucket.List(d.ctx, query)
  199. if err != nil {
  200. d.errorf("listBucket: unable to list bucket %q: %v", bucket, err)
  201. return
  202. }
  203. query = objs.Next
  204. for _, obj := range objs.Results {
  205. d.dumpStats(obj)
  206. }
  207. }
  208. }
  209. func (d *demo) listDir(name, indent string) {
  210. query := &storage.Query{Prefix: name, Delimiter: "/"}
  211. for query != nil {
  212. objs, err := d.bucket.List(d.ctx, query)
  213. if err != nil {
  214. d.errorf("listBucketDirMode: unable to list bucket %q: %v", bucket, err)
  215. return
  216. }
  217. query = objs.Next
  218. for _, obj := range objs.Results {
  219. fmt.Fprint(d.w, indent)
  220. d.dumpStats(obj)
  221. }
  222. for _, dir := range objs.Prefixes {
  223. fmt.Fprintf(d.w, "%v(directory: /%v/%v)\n", indent, bucket, dir)
  224. d.listDir(dir, indent+" ")
  225. }
  226. }
  227. }
  228. // listBucketDirMode lists the contents of a bucket in dir mode in Google Cloud Storage.
  229. func (d *demo) listBucketDirMode() {
  230. io.WriteString(d.w, "\nListbucket directory mode result:\n")
  231. d.listDir("b", "")
  232. }
  233. // dumpDefaultACL prints out the default object ACL for this bucket.
  234. func (d *demo) dumpDefaultACL() {
  235. acl, err := d.bucket.ACL().List(d.ctx)
  236. if err != nil {
  237. d.errorf("defaultACL: unable to list default object ACL for bucket %q: %v", bucket, err)
  238. return
  239. }
  240. for _, v := range acl {
  241. fmt.Fprintf(d.w, "Scope: %q, Permission: %q\n", v.Entity, v.Role)
  242. }
  243. }
  244. // defaultACL displays the default object ACL for this bucket.
  245. func (d *demo) defaultACL() {
  246. io.WriteString(d.w, "\nDefault object ACL:\n")
  247. d.dumpDefaultACL()
  248. }
  249. // putDefaultACLRule adds the "allUsers" default object ACL rule for this bucket.
  250. func (d *demo) putDefaultACLRule() {
  251. io.WriteString(d.w, "\nPut Default object ACL Rule:\n")
  252. err := d.bucket.DefaultObjectACL().Set(d.ctx, storage.AllUsers, storage.RoleReader)
  253. if err != nil {
  254. d.errorf("putDefaultACLRule: unable to save default object ACL rule for bucket %q: %v", bucket, err)
  255. return
  256. }
  257. d.dumpDefaultACL()
  258. }
  259. // deleteDefaultACLRule deleted the "allUsers" default object ACL rule for this bucket.
  260. func (d *demo) deleteDefaultACLRule() {
  261. io.WriteString(d.w, "\nDelete Default object ACL Rule:\n")
  262. err := d.bucket.DefaultObjectACL().Delete(d.ctx, storage.AllUsers)
  263. if err != nil {
  264. d.errorf("deleteDefaultACLRule: unable to delete default object ACL rule for bucket %q: %v", bucket, err)
  265. return
  266. }
  267. d.dumpDefaultACL()
  268. }
  269. // dumpBucketACL prints out the bucket ACL.
  270. func (d *demo) dumpBucketACL() {
  271. acl, err := d.bucket.ACL().List(d.ctx)
  272. if err != nil {
  273. d.errorf("dumpBucketACL: unable to list bucket ACL for bucket %q: %v", bucket, err)
  274. return
  275. }
  276. for _, v := range acl {
  277. fmt.Fprintf(d.w, "Scope: %q, Permission: %q\n", v.Entity, v.Role)
  278. }
  279. }
  280. // bucketACL displays the bucket ACL for this bucket.
  281. func (d *demo) bucketACL() {
  282. io.WriteString(d.w, "\nBucket ACL:\n")
  283. d.dumpBucketACL()
  284. }
  285. // putBucketACLRule adds the "allUsers" bucket ACL rule for this bucket.
  286. func (d *demo) putBucketACLRule() {
  287. io.WriteString(d.w, "\nPut Bucket ACL Rule:\n")
  288. err := d.bucket.ACL().Set(d.ctx, storage.AllUsers, storage.RoleReader)
  289. if err != nil {
  290. d.errorf("putBucketACLRule: unable to save bucket ACL rule for bucket %q: %v", bucket, err)
  291. return
  292. }
  293. d.dumpBucketACL()
  294. }
  295. // deleteBucketACLRule deleted the "allUsers" bucket ACL rule for this bucket.
  296. func (d *demo) deleteBucketACLRule() {
  297. io.WriteString(d.w, "\nDelete Bucket ACL Rule:\n")
  298. err := d.bucket.ACL().Delete(d.ctx, storage.AllUsers)
  299. if err != nil {
  300. d.errorf("deleteBucketACLRule: unable to delete bucket ACL rule for bucket %q: %v", bucket, err)
  301. return
  302. }
  303. d.dumpBucketACL()
  304. }
  305. // dumpACL prints out the ACL of the named file.
  306. func (d *demo) dumpACL(fileName string) {
  307. acl, err := d.bucket.Object(fileName).ACL().List(d.ctx)
  308. if err != nil {
  309. d.errorf("dumpACL: unable to list file ACL for bucket %q, file %q: %v", bucket, fileName, err)
  310. return
  311. }
  312. for _, v := range acl {
  313. fmt.Fprintf(d.w, "Scope: %q, Permission: %q\n", v.Entity, v.Role)
  314. }
  315. }
  316. // acl displays the ACL for the named file.
  317. func (d *demo) acl(fileName string) {
  318. fmt.Fprintf(d.w, "\nACL for file %v:\n", fileName)
  319. d.dumpACL(fileName)
  320. }
  321. // putACLRule adds the "allUsers" ACL rule for the named file.
  322. func (d *demo) putACLRule(fileName string) {
  323. fmt.Fprintf(d.w, "\nPut ACL rule for file %v:\n", fileName)
  324. err := d.bucket.Object(fileName).ACL().Set(d.ctx, storage.AllUsers, storage.RoleReader)
  325. if err != nil {
  326. d.errorf("putACLRule: unable to save ACL rule for bucket %q, file %q: %v", bucket, fileName, err)
  327. return
  328. }
  329. d.dumpACL(fileName)
  330. }
  331. // deleteACLRule deleted the "allUsers" ACL rule for the named file.
  332. func (d *demo) deleteACLRule(fileName string) {
  333. fmt.Fprintf(d.w, "\nDelete ACL rule for file %v:\n", fileName)
  334. err := d.bucket.Object(fileName).ACL().Delete(d.ctx, storage.AllUsers)
  335. if err != nil {
  336. d.errorf("deleteACLRule: unable to delete ACL rule for bucket %q, file %q: %v", bucket, fileName, err)
  337. return
  338. }
  339. d.dumpACL(fileName)
  340. }
  341. // deleteFiles deletes all the temporary files from a bucket created by this demo.
  342. func (d *demo) deleteFiles() {
  343. io.WriteString(d.w, "\nDeleting files...\n")
  344. for _, v := range d.cleanUp {
  345. fmt.Fprintf(d.w, "Deleting file %v\n", v)
  346. if err := d.bucket.Object(v).Delete(d.ctx); err != nil {
  347. d.errorf("deleteFiles: unable to delete bucket %q, file %q: %v", bucket, v, err)
  348. return
  349. }
  350. }
  351. }