com.google.cloud.storage.package-info Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of gcloud-java-storage Show documentation

Java idiomatic client for Google Cloud Storage.

The newest version!

/*
 * Copyright 2015 Google Inc. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * A client to Google Cloud Storage.
 *
 * Here's a simple usage example for using gcloud-java from App/Compute Engine. This example
 * shows how to create a Storage blob. For the complete source code see
 * 
 * CreateBlob.java.
 * 
 {@code
 * Storage storage = StorageOptions.defaultInstance().service();
 * BlobId blobId = BlobId.of("bucket", "blob_name");
 * BlobInfo blobInfo = BlobInfo.builder(blobId).contentType("text/plain").build();
 * Blob blob = storage.create(blobInfo, "Hello, Cloud Storage!".getBytes(UTF_8));
 * }
 * 
 * This second example shows how to update the blob's content if the blob exists. For the complete
 * source code see
 * 
 * UpdateBlob.java.
 * 
 {@code
 * Storage storage = StorageOptions.defaultInstance().service();
 * BlobId blobId = BlobId.of("bucket", "blob_name");
 * Blob blob = storage.get(blobId);
 * if (blob != null) {
 *   byte[] prevContent = blob.content();
 *   System.out.println(new String(prevContent, UTF_8));
 *   WritableByteChannel channel = blob.writer();
 *   channel.write(ByteBuffer.wrap("Updated content".getBytes(UTF_8)));
 *   channel.close();
 * }}
 * When using gcloud-java from outside of App/Compute Engine, you have to specify a
 * project ID and
 * provide
 * credentials.
 * @see Google Cloud Storage
 */
package com.google.cloud.storage;