Skip to content

Commit c375d21

Browse files
jmdobryjmdobry
authored
Add NL quickstart sample. Fix some other quickstarts. (GoogleCloudPlatform#438)
1 parent 63790ea commit c375d21

File tree

9 files changed

+194
-7
lines changed

9 files changed

+194
-7
lines changed

‎datastore/cloud-client/src/test/java/com/example/datastore/QuickstartSampleIT.java

-1
Original file line numberDiff line numberDiff line change
@@ -69,4 +69,3 @@ public void testQuickstart() throws Exception {
6969
assertThat(got).contains("Saved sampletask1: Buy milk");
7070
}
7171
}
72-
// [END datastore_quickstart]

‎language/cloud-client/README.md

+30
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# Getting Started with Google Cloud Natural Language API and the Google Cloud Client libraries
2+
3+
[Google Cloud Natural Language API][language] provides natural language
4+
understanding technologies to developers, including sentiment analysis, entity
5+
recognition, and syntax analysis. This API is part of the larger collection of
6+
Cloud Machine Learning APIs.
7+
8+
These sample Java applications demonstrate how to access the Cloud Natural
9+
Language API using the [Google Cloud Client Library for Java][google-cloud-java].
10+
11+
[language]: https://cloud.google.com/natural-language/docs/
12+
[google-cloud-java]: https://github.com/GoogleCloudPlatform/google-cloud-java
13+
14+
## Quickstart
15+
16+
Install [Maven](http://maven.apache.org/).
17+
18+
Build your project with:
19+
20+
mvn clean package -DskipTests
21+
22+
You can then run a given `ClassName` via:
23+
24+
mvn exec:java -Dexec.mainClass=com.example.language.ClassName \
25+
-DpropertyName=propertyValue \
26+
-Dexec.args="arg1 'arg 2' arg3"
27+
28+
### Analyze a string for sentiment (using the quickstart sample)
29+
30+
mvn exec:java -Dexec.mainClass=com.example.language.QuickstartSample

‎language/cloud-client/pom.xml

+57
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
<!--
2+
Copyright 2016 Google Inc. All Rights Reserved.
3+
4+
Licensed under the Apache License, Version 2.0 (the "License");
5+
you may not use this file except in compliance with the License.
6+
You may obtain a copy of the License at
7+
8+
http://www.apache.org/licenses/LICENSE-2.0
9+
10+
Unless required by applicable law or agreed to in writing, software
11+
distributed under the License is distributed on an "AS IS" BASIS,
12+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13+
See the License for the specific language governing permissions and
14+
limitations under the License.
15+
-->
16+
<project>
17+
<modelVersion>4.0.0</modelVersion>
18+
<groupId>com.example.language</groupId>
19+
<artifactId>language-google-cloud-samples</artifactId>
20+
<packaging>jar</packaging>
21+
22+
<!-- Parent defines config for testing & linting. -->
23+
<parent>
24+
<artifactId>doc-samples</artifactId>
25+
<groupId>com.google.cloud</groupId>
26+
<version>1.0.0</version>
27+
<relativePath>../..</relativePath>
28+
</parent>
29+
30+
<properties>
31+
<maven.compiler.target>1.8</maven.compiler.target>
32+
<maven.compiler.source>1.8</maven.compiler.source>
33+
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
34+
</properties>
35+
36+
<dependencies>
37+
<dependency>
38+
<groupId>com.google.cloud</groupId>
39+
<artifactId>google-cloud-language</artifactId>
40+
<version>0.7.0</version>
41+
</dependency>
42+
43+
<!-- Test dependencies -->
44+
<dependency>
45+
<groupId>junit</groupId>
46+
<artifactId>junit</artifactId>
47+
<version>4.12</version>
48+
<scope>test</scope>
49+
</dependency>
50+
<dependency>
51+
<groupId>com.google.truth</groupId>
52+
<artifactId>truth</artifactId>
53+
<version>0.30</version>
54+
<scope>test</scope>
55+
</dependency>
56+
</dependencies>
57+
</project>

‎language/cloud-client/src/main/java/com/example/language/QuickstartSample.java

+44
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
/*
2+
Copyright 2016, Google, Inc.
3+
4+
Licensed under the Apache License, Version 2.0 (the "License");
5+
you may not use this file except in compliance with the License.
6+
You may obtain a copy of the License at
7+
8+
http://www.apache.org/licenses/LICENSE-2.0
9+
10+
Unless required by applicable law or agreed to in writing, software
11+
distributed under the License is distributed on an "AS IS" BASIS,
12+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13+
See the License for the specific language governing permissions and
14+
limitations under the License.
15+
*/
16+
17+
package com.example.language;
18+
19+
// [START language_quickstart]
20+
// Imports the Google Cloud client library
21+
import com.google.cloud.language.spi.v1.LanguageServiceClient;
22+
23+
import com.google.cloud.language.v1.Document;
24+
import com.google.cloud.language.v1.Document.Type;
25+
import com.google.cloud.language.v1.Sentiment;
26+
27+
public class QuickstartSample {
28+
public static void main(String... args) throws Exception {
29+
// Instantiates a client
30+
LanguageServiceClient language = LanguageServiceClient.create();
31+
32+
// The text to analyze
33+
String text = "Hello, world!";
34+
Document doc = Document.newBuilder()
35+
.setContent(text).setType(Type.PLAIN_TEXT).build();
36+
37+
// Detects the sentiment of the text
38+
Sentiment sentiment = language.analyzeSentiment(doc).getDocumentSentiment();
39+
40+
System.out.printf("Text: %s%n", text);
41+
System.out.printf("Sentiment: %s, %s%n", sentiment.getScore(), sentiment.getMagnitude());
42+
}
43+
}
44+
// [END language_quickstart]

‎language/cloud-client/src/test/java/com/example/language/QuickstartSampleIT.java

+61
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
/*
2+
Copyright 2016, Google, Inc.
3+
4+
Licensed under the Apache License, Version 2.0 (the "License");
5+
you may not use this file except in compliance with the License.
6+
You may obtain a copy of the License at
7+
8+
http://www.apache.org/licenses/LICENSE-2.0
9+
10+
Unless required by applicable law or agreed to in writing, software
11+
distributed under the License is distributed on an "AS IS" BASIS,
12+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13+
See the License for the specific language governing permissions and
14+
limitations under the License.
15+
*/
16+
17+
package com.example.language;
18+
19+
import static com.google.common.truth.Truth.assertThat;
20+
21+
import org.junit.After;
22+
import org.junit.Before;
23+
import org.junit.Test;
24+
import org.junit.runner.RunWith;
25+
import org.junit.runners.JUnit4;
26+
27+
import java.io.ByteArrayOutputStream;
28+
import java.io.PrintStream;
29+
30+
/**
31+
* Tests for quickstart sample.
32+
*/
33+
@RunWith(JUnit4.class)
34+
@SuppressWarnings("checkstyle:abbreviationaswordinname")
35+
public class QuickstartSampleIT {
36+
private ByteArrayOutputStream bout;
37+
private PrintStream out;
38+
39+
@Before
40+
public void setUp() {
41+
bout = new ByteArrayOutputStream();
42+
out = new PrintStream(bout);
43+
System.setOut(out);
44+
}
45+
46+
@After
47+
public void tearDown() {
48+
System.setOut(null);
49+
}
50+
51+
@Test
52+
public void testQuickstart() throws Exception {
53+
// Act
54+
QuickstartSample.main();
55+
56+
// Assert
57+
String got = bout.toString();
58+
assertThat(got).contains("Text: Hello, world!");
59+
assertThat(got).contains("Sentiment: ");
60+
}
61+
}

‎pubsub/cloud-client/src/test/java/com/example/pubsub/QuickstartSampleIT.java

-1
Original file line numberDiff line numberDiff line change
@@ -66,4 +66,3 @@ public void testQuickstart() throws Exception {
6666
assertThat(got).contains("Topic my-new-topic created.");
6767
}
6868
}
69-
// [END datastore_quickstart]

‎storage/cloud-client/src/test/java/com/example/storage/QuickstartSampleIT.java

-1
Original file line numberDiff line numberDiff line change
@@ -67,4 +67,3 @@ public void testQuickstart() throws Exception {
6767
assertThat(got).contains(String.format("Bucket %s created.", bucketName));
6868
}
6969
}
70-
// [END datastore_quickstart]

‎translate/cloud-client/README.md

+2-3
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
[Google Translate API][translate] provides a simple programmatic interface for translating an
44
arbitrary string into any supported language.
5-
These sample Java applications demonstrate how to access the Cloud Storage API using
5+
These sample Java applications demonstrate how to access the Google Translate API using
66
the [Google Cloud Client Library for Java][google-cloud-java].
77

88
[translate]: https://cloud.google.com/translate/
@@ -24,5 +24,4 @@ You can then run a given `ClassName` via:
2424

2525
### Translate a string (using the quickstart sample)
2626

27-
mvn exec:java -Dexec.mainClass=com.example.translate.QuickstartSample \
28-
-Dexec.args="YOUR_API_KEY"
27+
mvn exec:java -Dexec.mainClass=com.example.translate.QuickstartSample

‎translate/cloud-client/src/test/java/com/example/translate/QuickstartSampleIT.java

-1
Original file line numberDiff line numberDiff line change
@@ -59,4 +59,3 @@ public void testQuickstart() throws Exception {
5959
assertThat(got).contains("Translation: ");
6060
}
6161
}
62-
// [END datastore_quickstart]

0 commit comments

Comments
 (0)