Google Cloud Java Contributions

Packages that provide higher-level abstraction/functionality for common gcloud-java use cases.

[//]: # (commented out because there isn't any code yet, so this won't work)

[//]: #

[//]: # (Quickstart)

[//]: # (----------)

[//]: # (If you are using Maven, add this to your pom.xml file)

[//]: # (```xml)

[//]: # (<dependency>)

[//]: # ( <groupId>com.google.gcloud</groupId>)

[//]: # ( <artifactId>gcloud-java-contrib</artifactId>)

[//]: # ( <version>0.1.2</version>)

[//]: # (</dependency>)

[//]: # (```)

[//]: # (If you are using Gradle, add this to your dependencies)

[//]: # (```Groovy)

[//]: # (compile 'com.google.gcloud:gcloud-java-contrib:0.1.2')

[//]: # (```)

[//]: # (If you are using SBT, add this to your dependencies)

[//]: # (```Scala)

[//]: # (libraryDependencies += "com.google.gcloud" % "gcloud-java-contrib" % "0.1.2")

[//]: # (```)

Java Versions

Java 7 or above is required for using this client.

Versioning

This library follows [Semantic Versioning] (http://semver.org/).

It is currently in major version zero (``0.y.z``), which means that anything

may change at any time and the public API should not be considered

stable.

Contributing

Contributions to this library are always welcome and highly encouraged.

See `gcloud-java`'s [CONTRIBUTING] documentation and the `gcloud-*` [shared documentation](https://github.com/GoogleCloudPlatform/gcloud-common/blob/master/contributing/readme.md#how-to-contribute-to-gcloud) for more information on how to get started.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more information.

License

Apache 2.0 - See [LICENSE] for more information.

[CONTRIBUTING]:https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/CONTRIBUTING.md

[code-of-conduct]:https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct

[LICENSE]: https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/LICENSE

[cloud-platform]: https://cloud.google.com/

[developers-console]:https://console.developers.google.com/

<?xml version="1.0"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

<modelVersion>4.0.0</modelVersion>

<groupId>com.google.gcloud</groupId>

<artifactId>gcloud-java-contrib</artifactId>

<packaging>jar</packaging>

<name>GCloud Java contributions</name>

<description>

Contains packages that provide higher-level abstraction/functionality for common gcloud-java use cases.

</description>

<parent>

<groupId>com.google.gcloud</groupId>

<artifactId>gcloud-java-pom</artifactId>

<version>0.1.3-SNAPSHOT</version>

</parent>

<properties>

<site.installationModule>gcloud-java-contrib</site.installationModule>

</properties>

<dependencies>

<dependency>

<groupId>${project.groupId}</groupId>

<artifactId>gcloud-java</artifactId>

<version>${project.version}</version>

</dependency>

</dependencies>

<build>

<plugins>

<plugin>

<groupId>org.codehaus.mojo</groupId>

<artifactId>exec-maven-plugin</artifactId>

<configuration>

<skip>false</skip>

</configuration>

</plugin>

</plugins>

</build>

</project>

Here's an example run of `BigQueryExample`.

Before running the example, go to the [Google Developers Console][developers-console] to ensure

that BigQuery API is enabled. You can upload a CSV file `my_csv_file` to the `my_bucket` bucket

(replace `my_csv_file` and `my_bucket` with actual file and bucket names) using the GCS

[web browser](https://console.developers.google.com/storage/browser). The CSV file will be used to

load data into a BigQuery table and should look something like:

```csv

```

Then you are ready to run the following example:

```

```

Here's an example run of `DatastoreExample`.

Note that you have to enable the Google Cloud Datastore API on the [Google Developers Console][developers-console] before running the following commands.

```

```

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.

```

```

Here's an example run of `StorageExample`.

Before running the example, go to the [Google Developers Console][developers-console] to ensure that Google Cloud Storage API is enabled and that you have a bucket. Also ensure that you have a test file (`test.txt` is chosen here) to upload to Cloud Storage stored locally on your machine.

```

```

import com.google.gcloud.datastore.Query.ResultType;

// ORDER BY timestamp";

String gql = "SELECT * FROM " + COMMENT_KIND + " WHERE __key__ HAS ANCESTOR @1";

Query<Entity> query = Query.gqlQueryBuilder(ResultType.ENTITY, gql)

.namespace(NAMESPACE)

.addBinding(userKey)

.build();

QueryResults<Entity> results = tx.run(query);

// We could have added "ORDER BY timestamp" to the query to avoid the sorting bellow

// but that would require adding an ancestor index for timestamp

// see: https://cloud.google.com/datastore/docs/tools/indexconfig

while (results.hasNext()) {

Entity result = results.next();

sortedComments.put(result.getDateTime("timestamp"), result.getString("content"));

<module>gcloud-java-contrib</module>