Skip to content

Commit

Permalink
Adding ResourceManagerExample, update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Ajay Kannan committed Dec 18, 2015
1 parent 2650901 commit 448f3b5
Show file tree
Hide file tree
Showing 4 changed files with 180 additions and 9 deletions.
13 changes: 11 additions & 2 deletions gcloud-java-examples/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ To run examples from your command line:

1. Login using gcloud SDK (`gcloud auth login` in command line)

2. Set your current project using `gcloud config set project PROJECT_ID`
2. If you are running an example other than `ResourceManagerExample`, set your current project using `gcloud config set project PROJECT_ID`. If you are running `ResourceManagerExample`, unset your project by using `gcloud config unset project`.

3. Compile using Maven (`mvn compile` in command line from your base project directory)

Expand All @@ -56,7 +56,16 @@ To run examples from your command line:
$mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.StorageExample" -Dexec.args="list <bucket_name>"
$mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.StorageExample" -Dexec.args="download <bucket_name> test.txt"
$mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.StorageExample" -Dexec.args="delete <bucket_name> test.txt"
```
```

Here's an example run of `ResourceManagerExample`.

Be sure to change the placeholder project ID "my-project-id" with your own globally unique project ID.
```
$mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.ResourceManagerExample" -Dexec.args="create my-project-id"
$mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.ResourceManagerExample" -Dexec.args="list"
$mvn exec:java -Dexec.mainClass="com.google.gcloud.examples.ResourceManagerExample" -Dexec.args="get my-project-id"
```

Troubleshooting
---------------
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,147 @@
/*
* 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.
*/

package com.google.gcloud.examples;

import com.google.gcloud.resourcemanager.ProjectInfo;
import com.google.gcloud.resourcemanager.ResourceManager;
import com.google.gcloud.resourcemanager.ResourceManagerOptions;

import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
* An example of using the Google Cloud Resource Manager.
* <p>
* This example creates, gets, and lists projects.
* <p>
* Steps needed for running the example:<ol>
* <li>login using gcloud SDK - {@code gcloud auth login}.</li>
* <li>compile using maven - {@code mvn compile}</li>
* <li>run using maven - {@code mvn exec:java
* -Dexec.mainClass="com.google.gcloud.examples.ResourceManagerExample"
* -Dexec.args="[create|get|list projectId]"}</li>
* </ol>
*/
public class ResourceManagerExample {

private static final String DEFAULT_ACTION = "list";
private static final Map<String, ResourceManagerAction> ACTIONS = new HashMap<>();

private interface ResourceManagerAction {
void run(ResourceManager resourceManager, String... args);
String getRequiredParams();
}

private static class CreateAction implements ResourceManagerAction {
@Override
public void run(ResourceManager resourceManager, String... args) {
if (args.length > 0) {
String projectId = args[0];
ProjectInfo project = resourceManager.create(ProjectInfo.builder(projectId).build());
System.out.printf(
"Successfully created project '%s': %s.%n", projectId, projectDetails(project));
} else {
System.out.println("Error: must supply a globally unique project ID for your new project.");
}
}

@Override
public String getRequiredParams() {
return "projectId";
}
}

private static class GetAction implements ResourceManagerAction {
@Override
public void run(ResourceManager resourceManager, String... args) {
if (args.length > 0) {
String projectId = args[0];
ProjectInfo project = resourceManager.get(projectId);
if (project != null) {
System.out.printf(
"Successfully got project '%s': %s.%n", projectId, projectDetails(project));
} else {
System.out.printf("Could not find project '%s'.%n", projectId);
}
} else {
System.out.println(
"Error: must supply a project ID corresponding to a project for which you have viewing"
+ " permissions. You can create a project and then call get using the same project ID"
+ " if you have no other projects to use in this test.");
}
}

@Override
public String getRequiredParams() {
return "projectId";
}
}

private static class ListAction implements ResourceManagerAction {
@Override
public void run(ResourceManager resourceManager, String... args) {
System.out.println("Projects you can view:");
for (ProjectInfo project : resourceManager.list().values()) {
System.out.println(projectDetails(project));
}
}

@Override
public String getRequiredParams() {
return "";
}
}

static {
ACTIONS.put("create", new CreateAction());
ACTIONS.put("get", new GetAction());
ACTIONS.put("list", new ListAction());
}

private static String projectDetails(ProjectInfo project) {
return "{projectId:" + project.projectId() + ", projectNumber:" + project.projectNumber()
+ ", createTimeMillis:" + project.createTimeMillis() + ", state:" + project.state() + "}";
}

public static void main(String... args) {
String actionName = args.length > 0 ? args[0].toLowerCase() : DEFAULT_ACTION;
ResourceManagerAction action = ACTIONS.get(actionName);
if (action == null) {
StringBuilder actionAndParams = new StringBuilder();
for (Map.Entry<String, ResourceManagerAction> entry : ACTIONS.entrySet()) {
actionAndParams.append(entry.getKey());
String param = entry.getValue().getRequiredParams();
if (param != null && !param.isEmpty()) {
actionAndParams.append(' ').append(param);
}
actionAndParams.append('|');
}
actionAndParams.setLength(actionAndParams.length() - 1);
System.out.printf(
"Usage: %s [%s]%n", ResourceManagerExample.class.getSimpleName(), actionAndParams);
return;
}

// If you want to access a local Resource Manager emulator (after creating and starting the
// LocalResourceManagerHelper), use the following code instead:
// ResourceManager resourceManager = LocalResourceManagerHelper.options().service();
ResourceManager resourceManager = ResourceManagerOptions.defaultInstance().service();
args = args.length > 1 ? Arrays.copyOfRange(args, 1, args.length) : new String[] {};
action.run(resourceManager, args);
}
}
10 changes: 4 additions & 6 deletions gcloud-java-resourcemanager/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,10 @@ Java idiomatic client for [Google Cloud Resource Manager] (https://cloud.google.

[![Build Status](https://travis-ci.org/GoogleCloudPlatform/gcloud-java.svg?branch=master)](https://travis-ci.org/GoogleCloudPlatform/gcloud-java)
[![Coverage Status](https://coveralls.io/repos/GoogleCloudPlatform/gcloud-java/badge.svg?branch=master)](https://coveralls.io/r/GoogleCloudPlatform/gcloud-java?branch=master)

<!-- TODO(ajaykannan): add in the maven shield once the artifact is pushed to maven -->
[![Maven](https://img.shields.io/maven-central/v/com.google.gcloud/gcloud-java-resourcemanager.svg)]( https://img.shields.io/maven-central/v/com.google.gcloud/gcloud-java-resourcemanager.svg)

- [Homepage] (https://googlecloudplatform.github.io/gcloud-java/)

<!-- TODO(ajaykannan): add in a link to javadocs once the site has been generated with resource manager docs included -->
- [API Documentation] (http://googlecloudplatform.github.io/gcloud-java/apidocs/index.html?com/google/gcloud/resourcemanager/package-summary.html)

> Note: This client is a work-in-progress, and may occasionally
> make backwards-incompatible changes.
Expand All @@ -34,9 +32,9 @@ If you are using SBT, add this to your dependencies
libraryDependencies += "com.google.gcloud" % "gcloud-java-resourcemanager" % "0.1.0"
```

<!-- TODO(ajaykannan): once the API becomes usable, make an example application
Example Application
-------------------- -->
--------------------
[`ResourceManagerExample`](https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/gcloud-java-examples/src/main/java/com/google/gcloud/examples/ResourceManagerExample.java) is a simple command line interface for the Cloud Resource Manager. Read more about using the application on the [`gcloud-java-examples` docs page](http://googlecloudplatform.github.io/gcloud-java/apidocs/?com/google/gcloud/examples/ResourceManagerExample.html).

Authentication
--------------
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,24 @@

/**
* A client to Google Cloud Resource Manager.
* //TODO(ajaykannan): add code example
*
* <p>Here's a simple usage example for using gcloud-java-resourcemanager:
* <pre>{@code
* ResourceManager resourceManager = ResourceManagerOptions.defaultInstance().service();
* String myProjectId = "my-globally-unique-project-id"; // Change to a unique project ID.
* ProjectInfo myProject = resourceManager.create(ProjectInfo.builder(myProjectId).build());
* ProjectInfo newProjectInfo = resourceManager.replace(myProject.toBuilder()
* .addLabel("launch-status", "in-development").build());
* Iterator<ProjectInfo> projectIterator = resourceManager.list().iterateAll();
* System.out.println("Projects I can view:");
* while (projectIterator.hasNext()) {
* System.out.println(projectIterator.next().projectId());
* }}</pre>
*
* Remember that you must authenticate using the Google Cloud SDK. See more about
* <a href="https://github.com/GoogleCloudPlatform/gcloud-java#specifying-a-project-id">providing
* credentials here</a>.
*
* @see <a href="https://cloud.google.com/resource-manager/">Google Cloud Resource Manager</a>
*/

Expand Down

0 comments on commit 448f3b5

Please sign in to comment.