├── .gitignore
├── .playground
├── .travis.yml
├── LICENSE
├── build.xml
├── java-repo-tools
├── .gitignore
├── .travis.yml
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── codecov.yml
├── google-checks.xml
├── pom.xml
├── scripts
│ └── test-localhost.sh
├── suppressions.xml
└── test
│ ├── README.md
│ ├── pom.xml
│ └── src
│ ├── main
│ └── java
│ │ └── com
│ │ └── google
│ │ └── cloud
│ │ └── samples
│ │ └── test
│ │ └── App.java
│ └── test
│ └── java
│ └── com
│ └── google
│ └── cloud
│ └── samples
│ └── test
│ └── AppTest.java
├── pom.xml
└── src
└── main
├── java
└── myapp
│ └── DemoServlet.java
└── webapp
├── WEB-INF
├── appengine-web.xml
├── logging.properties
└── web.xml
└── index.html
/.gitignore:
--------------------------------------------------------------------------------
1 | ## https://github.com/github/gitignore/blob/master/Java.gitignore
2 | *.class
3 |
4 | # Mobile Tools for Java (J2ME)
5 | .mtj.tmp/
6 |
7 | # Package Files #
8 | *.jar
9 | *.war
10 | *.ear
11 |
12 | # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
13 | hs_err_pid*
14 |
15 | ## https://github.com/github/gitignore/blob/master/Maven.gitignore
16 | target/
17 | pom.xml.tag
18 | pom.xml.releaseBackup
19 | pom.xml.versionsBackup
20 | pom.xml.next
21 | release.properties
22 | dependency-reduced-pom.xml
23 | buildNumber.properties
24 | .mvn/timing.properties
25 |
--------------------------------------------------------------------------------
/.playground:
--------------------------------------------------------------------------------
1 | {
2 | "project_name": "Hello World - Java",
3 | "project_description": "Starter code for a Google App Engine app in Java.",
4 | "show_files": [
5 | "src/main/java/myapp/DemoServlet.java",
6 | "build.xml",
7 | "pom.xml",
8 | "src/main/webapp/index.html",
9 | "src/main/webapp/WEB-INF/appengine-web.xml",
10 | "src/main/webapp/WEB-INF/logging.properties",
11 | "src/main/webapp/WEB-INF/web.xml"
12 | ],
13 | "read_only_demo_url": "https://try-java-demo-dot-cloud-playground.appspot.com/",
14 | "download_filename": "appengine-try-java.zip"
15 | }
16 |
--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
1 | # Copyright 2016 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 |
15 | language: java
16 | jdk:
17 | - oraclejdk8
18 | script: mvn --batch-mode clean verify | egrep -v "(^\[INFO\] Download|^\[INFO\].*skipping)"
19 | after_success:
20 | - mvn clean cobertura:cobertura coveralls:report
21 | branches:
22 | only:
23 | - master
24 | - gcloud
25 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 |
2 | Apache License
3 | Version 2.0, January 2004
4 | http://www.apache.org/licenses/
5 |
6 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
7 |
8 | 1. Definitions.
9 |
10 | "License" shall mean the terms and conditions for use, reproduction,
11 | and distribution as defined by Sections 1 through 9 of this document.
12 |
13 | "Licensor" shall mean the copyright owner or entity authorized by
14 | the copyright owner that is granting the License.
15 |
16 | "Legal Entity" shall mean the union of the acting entity and all
17 | other entities that control, are controlled by, or are under common
18 | control with that entity. For the purposes of this definition,
19 | "control" means (i) the power, direct or indirect, to cause the
20 | direction or management of such entity, whether by contract or
21 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
22 | outstanding shares, or (iii) beneficial ownership of such entity.
23 |
24 | "You" (or "Your") shall mean an individual or Legal Entity
25 | exercising permissions granted by this License.
26 |
27 | "Source" form shall mean the preferred form for making modifications,
28 | including but not limited to software source code, documentation
29 | source, and configuration files.
30 |
31 | "Object" form shall mean any form resulting from mechanical
32 | transformation or translation of a Source form, including but
33 | not limited to compiled object code, generated documentation,
34 | and conversions to other media types.
35 |
36 | "Work" shall mean the work of authorship, whether in Source or
37 | Object form, made available under the License, as indicated by a
38 | copyright notice that is included in or attached to the work
39 | (an example is provided in the Appendix below).
40 |
41 | "Derivative Works" shall mean any work, whether in Source or Object
42 | form, that is based on (or derived from) the Work and for which the
43 | editorial revisions, annotations, elaborations, or other modifications
44 | represent, as a whole, an original work of authorship. For the purposes
45 | of this License, Derivative Works shall not include works that remain
46 | separable from, or merely link (or bind by name) to the interfaces of,
47 | the Work and Derivative Works thereof.
48 |
49 | "Contribution" shall mean any work of authorship, including
50 | the original version of the Work and any modifications or additions
51 | to that Work or Derivative Works thereof, that is intentionally
52 | submitted to Licensor for inclusion in the Work by the copyright owner
53 | or by an individual or Legal Entity authorized to submit on behalf of
54 | the copyright owner. For the purposes of this definition, "submitted"
55 | means any form of electronic, verbal, or written communication sent
56 | to the Licensor or its representatives, including but not limited to
57 | communication on electronic mailing lists, source code control systems,
58 | and issue tracking systems that are managed by, or on behalf of, the
59 | Licensor for the purpose of discussing and improving the Work, but
60 | excluding communication that is conspicuously marked or otherwise
61 | designated in writing by the copyright owner as "Not a Contribution."
62 |
63 | "Contributor" shall mean Licensor and any individual or Legal Entity
64 | on behalf of whom a Contribution has been received by Licensor and
65 | subsequently incorporated within the Work.
66 |
67 | 2. Grant of Copyright License. Subject to the terms and conditions of
68 | this License, each Contributor hereby grants to You a perpetual,
69 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
70 | copyright license to reproduce, prepare Derivative Works of,
71 | publicly display, publicly perform, sublicense, and distribute the
72 | Work and such Derivative Works in Source or Object form.
73 |
74 | 3. Grant of Patent License. Subject to the terms and conditions of
75 | this License, each Contributor hereby grants to You a perpetual,
76 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
77 | (except as stated in this section) patent license to make, have made,
78 | use, offer to sell, sell, import, and otherwise transfer the Work,
79 | where such license applies only to those patent claims licensable
80 | by such Contributor that are necessarily infringed by their
81 | Contribution(s) alone or by combination of their Contribution(s)
82 | with the Work to which such Contribution(s) was submitted. If You
83 | institute patent litigation against any entity (including a
84 | cross-claim or counterclaim in a lawsuit) alleging that the Work
85 | or a Contribution incorporated within the Work constitutes direct
86 | or contributory patent infringement, then any patent licenses
87 | granted to You under this License for that Work shall terminate
88 | as of the date such litigation is filed.
89 |
90 | 4. Redistribution. You may reproduce and distribute copies of the
91 | Work or Derivative Works thereof in any medium, with or without
92 | modifications, and in Source or Object form, provided that You
93 | meet the following conditions:
94 |
95 | (a) You must give any other recipients of the Work or
96 | Derivative Works a copy of this License; and
97 |
98 | (b) You must cause any modified files to carry prominent notices
99 | stating that You changed the files; and
100 |
101 | (c) You must retain, in the Source form of any Derivative Works
102 | that You distribute, all copyright, patent, trademark, and
103 | attribution notices from the Source form of the Work,
104 | excluding those notices that do not pertain to any part of
105 | the Derivative Works; and
106 |
107 | (d) If the Work includes a "NOTICE" text file as part of its
108 | distribution, then any Derivative Works that You distribute must
109 | include a readable copy of the attribution notices contained
110 | within such NOTICE file, excluding those notices that do not
111 | pertain to any part of the Derivative Works, in at least one
112 | of the following places: within a NOTICE text file distributed
113 | as part of the Derivative Works; within the Source form or
114 | documentation, if provided along with the Derivative Works; or,
115 | within a display generated by the Derivative Works, if and
116 | wherever such third-party notices normally appear. The contents
117 | of the NOTICE file are for informational purposes only and
118 | do not modify the License. You may add Your own attribution
119 | notices within Derivative Works that You distribute, alongside
120 | or as an addendum to the NOTICE text from the Work, provided
121 | that such additional attribution notices cannot be construed
122 | as modifying the License.
123 |
124 | You may add Your own copyright statement to Your modifications and
125 | may provide additional or different license terms and conditions
126 | for use, reproduction, or distribution of Your modifications, or
127 | for any such Derivative Works as a whole, provided Your use,
128 | reproduction, and distribution of the Work otherwise complies with
129 | the conditions stated in this License.
130 |
131 | 5. Submission of Contributions. Unless You explicitly state otherwise,
132 | any Contribution intentionally submitted for inclusion in the Work
133 | by You to the Licensor shall be under the terms and conditions of
134 | this License, without any additional terms or conditions.
135 | Notwithstanding the above, nothing herein shall supersede or modify
136 | the terms of any separate license agreement you may have executed
137 | with Licensor regarding such Contributions.
138 |
139 | 6. Trademarks. This License does not grant permission to use the trade
140 | names, trademarks, service marks, or product names of the Licensor,
141 | except as required for reasonable and customary use in describing the
142 | origin of the Work and reproducing the content of the NOTICE file.
143 |
144 | 7. Disclaimer of Warranty. Unless required by applicable law or
145 | agreed to in writing, Licensor provides the Work (and each
146 | Contributor provides its Contributions) on an "AS IS" BASIS,
147 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
148 | implied, including, without limitation, any warranties or conditions
149 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
150 | PARTICULAR PURPOSE. You are solely responsible for determining the
151 | appropriateness of using or redistributing the Work and assume any
152 | risks associated with Your exercise of permissions under this License.
153 |
154 | 8. Limitation of Liability. In no event and under no legal theory,
155 | whether in tort (including negligence), contract, or otherwise,
156 | unless required by applicable law (such as deliberate and grossly
157 | negligent acts) or agreed to in writing, shall any Contributor be
158 | liable to You for damages, including any direct, indirect, special,
159 | incidental, or consequential damages of any character arising as a
160 | result of this License or out of the use or inability to use the
161 | Work (including but not limited to damages for loss of goodwill,
162 | work stoppage, computer failure or malfunction, or any and all
163 | other commercial damages or losses), even if such Contributor
164 | has been advised of the possibility of such damages.
165 |
166 | 9. Accepting Warranty or Additional Liability. While redistributing
167 | the Work or Derivative Works thereof, You may choose to offer,
168 | and charge a fee for, acceptance of support, warranty, indemnity,
169 | or other liability obligations and/or rights consistent with this
170 | License. However, in accepting such obligations, You may act only
171 | on Your own behalf and on Your sole responsibility, not on behalf
172 | of any other Contributor, and only if You agree to indemnify,
173 | defend, and hold each Contributor harmless for any liability
174 | incurred by, or claims asserted against, such Contributor by reason
175 | of your accepting any such warranty or additional liability.
176 |
177 | END OF TERMS AND CONDITIONS
178 |
179 | APPENDIX: How to apply the Apache License to your work.
180 |
181 | To apply the Apache License to your work, attach the following
182 | boilerplate notice, with the fields enclosed by brackets "[]"
183 | replaced with your own identifying information. (Don't include
184 | the brackets!) The text should be enclosed in the appropriate
185 | comment syntax for the file format. We also recommend that a
186 | file or class name and description of purpose be included on the
187 | same "printed page" as the copyright notice for easier
188 | identification within third-party archives.
189 |
190 | Copyright [yyyy] [name of copyright owner]
191 |
192 | Licensed under the Apache License, Version 2.0 (the "License");
193 | you may not use this file except in compliance with the License.
194 | You may obtain a copy of the License at
195 |
196 | http://www.apache.org/licenses/LICENSE-2.0
197 |
198 | Unless required by applicable law or agreed to in writing, software
199 | distributed under the License is distributed on an "AS IS" BASIS,
200 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
201 | See the License for the specific language governing permissions and
202 | limitations under the License.
203 |
--------------------------------------------------------------------------------
/build.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
19 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
41 |
42 |
43 |
45 |
46 |
47 |
48 |
50 |
51 |
52 |
53 |
55 |
56 |
57 |
58 |
60 |
61 |
62 |
63 |
65 |
66 |
67 |
68 |
69 |
70 |
71 |
72 |
73 |
74 |
75 |
76 |
--------------------------------------------------------------------------------
/java-repo-tools/.gitignore:
--------------------------------------------------------------------------------
1 | service-account.json
2 |
3 | ### Java ###
4 | *.class
5 |
6 | # Mobile Tools for Java (J2ME)
7 | .mtj.tmp/
8 |
9 | # Package Files #
10 | *.jar
11 | *.war
12 | *.ear
13 |
14 | # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
15 | hs_err_pid*
16 |
17 | # Maven
18 | target/
19 | pom.xml.tag
20 | pom.xml.releaseBackup
21 | pom.xml.versionsBackup
22 | pom.xml.next
23 | release.properties
24 | dependency-reduced-pom.xml
25 | buildNumber.properties
26 | .mvn/timing.properties
27 |
--------------------------------------------------------------------------------
/java-repo-tools/.travis.yml:
--------------------------------------------------------------------------------
1 | # Copyright 2016 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 | language: java
15 | jdk:
16 | - oraclejdk7
17 | - oraclejdk8
18 | script: mvn verify
19 | after_success:
20 | - bash <(curl -s https://codecov.io/bash)
21 | branches:
22 | only:
23 | - master
24 |
--------------------------------------------------------------------------------
/java-repo-tools/CONTRIBUTING.md:
--------------------------------------------------------------------------------
1 | # How to become a contributor and submit your own code
2 |
3 | ## Contributor License Agreements
4 |
5 | We'd love to accept your sample apps and patches! Before we can take them, we
6 | have to jump a couple of legal hurdles.
7 |
8 | Please fill out either the individual or corporate Contributor License Agreement
9 | (CLA).
10 |
11 | * If you are an individual writing original source code and you're sure you
12 | own the intellectual property, then you'll need to sign an [individual CLA]
13 | (https://developers.google.com/open-source/cla/individual).
14 | * If you work for a company that wants to allow you to contribute your work,
15 | then you'll need to sign a [corporate CLA]
16 | (https://developers.google.com/open-source/cla/corporate).
17 |
18 | Follow either of the two links above to access the appropriate CLA and
19 | instructions for how to sign and return it. Once we receive it, we'll be able to
20 | accept your pull requests.
21 |
22 | ## Contributing A Patch
23 |
24 | 1. Submit an issue describing your proposed change to the repo in question.
25 | 1. The repo owner will respond to your issue promptly.
26 | 1. If your proposed change is accepted, and you haven't already done so, sign a
27 | Contributor License Agreement (see details above).
28 | 1. Fork the desired repo, develop and test your code changes.
29 | 1. Ensure that your code adheres to the existing style in the sample to which
30 | you are contributing. Refer to the
31 | [Google Cloud Platform Samples Style Guide]
32 | (https://github.com/GoogleCloudPlatform/Template/wiki/style.html) for the
33 | recommended coding standards for this organization.
34 | 1. Ensure that your code has an appropriate set of unit tests which all pass.
35 | 1. Submit a pull request.
36 |
--------------------------------------------------------------------------------
/java-repo-tools/LICENSE:
--------------------------------------------------------------------------------
1 | Apache License
2 | Version 2.0, January 2004
3 | http://www.apache.org/licenses/
4 |
5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6 |
7 | 1. Definitions.
8 |
9 | "License" shall mean the terms and conditions for use, reproduction,
10 | and distribution as defined by Sections 1 through 9 of this document.
11 |
12 | "Licensor" shall mean the copyright owner or entity authorized by
13 | the copyright owner that is granting the License.
14 |
15 | "Legal Entity" shall mean the union of the acting entity and all
16 | other entities that control, are controlled by, or are under common
17 | control with that entity. For the purposes of this definition,
18 | "control" means (i) the power, direct or indirect, to cause the
19 | direction or management of such entity, whether by contract or
20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
21 | outstanding shares, or (iii) beneficial ownership of such entity.
22 |
23 | "You" (or "Your") shall mean an individual or Legal Entity
24 | exercising permissions granted by this License.
25 |
26 | "Source" form shall mean the preferred form for making modifications,
27 | including but not limited to software source code, documentation
28 | source, and configuration files.
29 |
30 | "Object" form shall mean any form resulting from mechanical
31 | transformation or translation of a Source form, including but
32 | not limited to compiled object code, generated documentation,
33 | and conversions to other media types.
34 |
35 | "Work" shall mean the work of authorship, whether in Source or
36 | Object form, made available under the License, as indicated by a
37 | copyright notice that is included in or attached to the work
38 | (an example is provided in the Appendix below).
39 |
40 | "Derivative Works" shall mean any work, whether in Source or Object
41 | form, that is based on (or derived from) the Work and for which the
42 | editorial revisions, annotations, elaborations, or other modifications
43 | represent, as a whole, an original work of authorship. For the purposes
44 | of this License, Derivative Works shall not include works that remain
45 | separable from, or merely link (or bind by name) to the interfaces of,
46 | the Work and Derivative Works thereof.
47 |
48 | "Contribution" shall mean any work of authorship, including
49 | the original version of the Work and any modifications or additions
50 | to that Work or Derivative Works thereof, that is intentionally
51 | submitted to Licensor for inclusion in the Work by the copyright owner
52 | or by an individual or Legal Entity authorized to submit on behalf of
53 | the copyright owner. For the purposes of this definition, "submitted"
54 | means any form of electronic, verbal, or written communication sent
55 | to the Licensor or its representatives, including but not limited to
56 | communication on electronic mailing lists, source code control systems,
57 | and issue tracking systems that are managed by, or on behalf of, the
58 | Licensor for the purpose of discussing and improving the Work, but
59 | excluding communication that is conspicuously marked or otherwise
60 | designated in writing by the copyright owner as "Not a Contribution."
61 |
62 | "Contributor" shall mean Licensor and any individual or Legal Entity
63 | on behalf of whom a Contribution has been received by Licensor and
64 | subsequently incorporated within the Work.
65 |
66 | 2. Grant of Copyright License. Subject to the terms and conditions of
67 | this License, each Contributor hereby grants to You a perpetual,
68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69 | copyright license to reproduce, prepare Derivative Works of,
70 | publicly display, publicly perform, sublicense, and distribute the
71 | Work and such Derivative Works in Source or Object form.
72 |
73 | 3. Grant of Patent License. Subject to the terms and conditions of
74 | this License, each Contributor hereby grants to You a perpetual,
75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76 | (except as stated in this section) patent license to make, have made,
77 | use, offer to sell, sell, import, and otherwise transfer the Work,
78 | where such license applies only to those patent claims licensable
79 | by such Contributor that are necessarily infringed by their
80 | Contribution(s) alone or by combination of their Contribution(s)
81 | with the Work to which such Contribution(s) was submitted. If You
82 | institute patent litigation against any entity (including a
83 | cross-claim or counterclaim in a lawsuit) alleging that the Work
84 | or a Contribution incorporated within the Work constitutes direct
85 | or contributory patent infringement, then any patent licenses
86 | granted to You under this License for that Work shall terminate
87 | as of the date such litigation is filed.
88 |
89 | 4. Redistribution. You may reproduce and distribute copies of the
90 | Work or Derivative Works thereof in any medium, with or without
91 | modifications, and in Source or Object form, provided that You
92 | meet the following conditions:
93 |
94 | (a) You must give any other recipients of the Work or
95 | Derivative Works a copy of this License; and
96 |
97 | (b) You must cause any modified files to carry prominent notices
98 | stating that You changed the files; and
99 |
100 | (c) You must retain, in the Source form of any Derivative Works
101 | that You distribute, all copyright, patent, trademark, and
102 | attribution notices from the Source form of the Work,
103 | excluding those notices that do not pertain to any part of
104 | the Derivative Works; and
105 |
106 | (d) If the Work includes a "NOTICE" text file as part of its
107 | distribution, then any Derivative Works that You distribute must
108 | include a readable copy of the attribution notices contained
109 | within such NOTICE file, excluding those notices that do not
110 | pertain to any part of the Derivative Works, in at least one
111 | of the following places: within a NOTICE text file distributed
112 | as part of the Derivative Works; within the Source form or
113 | documentation, if provided along with the Derivative Works; or,
114 | within a display generated by the Derivative Works, if and
115 | wherever such third-party notices normally appear. The contents
116 | of the NOTICE file are for informational purposes only and
117 | do not modify the License. You may add Your own attribution
118 | notices within Derivative Works that You distribute, alongside
119 | or as an addendum to the NOTICE text from the Work, provided
120 | that such additional attribution notices cannot be construed
121 | as modifying the License.
122 |
123 | You may add Your own copyright statement to Your modifications and
124 | may provide additional or different license terms and conditions
125 | for use, reproduction, or distribution of Your modifications, or
126 | for any such Derivative Works as a whole, provided Your use,
127 | reproduction, and distribution of the Work otherwise complies with
128 | the conditions stated in this License.
129 |
130 | 5. Submission of Contributions. Unless You explicitly state otherwise,
131 | any Contribution intentionally submitted for inclusion in the Work
132 | by You to the Licensor shall be under the terms and conditions of
133 | this License, without any additional terms or conditions.
134 | Notwithstanding the above, nothing herein shall supersede or modify
135 | the terms of any separate license agreement you may have executed
136 | with Licensor regarding such Contributions.
137 |
138 | 6. Trademarks. This License does not grant permission to use the trade
139 | names, trademarks, service marks, or product names of the Licensor,
140 | except as required for reasonable and customary use in describing the
141 | origin of the Work and reproducing the content of the NOTICE file.
142 |
143 | 7. Disclaimer of Warranty. Unless required by applicable law or
144 | agreed to in writing, Licensor provides the Work (and each
145 | Contributor provides its Contributions) on an "AS IS" BASIS,
146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 | implied, including, without limitation, any warranties or conditions
148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 | PARTICULAR PURPOSE. You are solely responsible for determining the
150 | appropriateness of using or redistributing the Work and assume any
151 | risks associated with Your exercise of permissions under this License.
152 |
153 | 8. Limitation of Liability. In no event and under no legal theory,
154 | whether in tort (including negligence), contract, or otherwise,
155 | unless required by applicable law (such as deliberate and grossly
156 | negligent acts) or agreed to in writing, shall any Contributor be
157 | liable to You for damages, including any direct, indirect, special,
158 | incidental, or consequential damages of any character arising as a
159 | result of this License or out of the use or inability to use the
160 | Work (including but not limited to damages for loss of goodwill,
161 | work stoppage, computer failure or malfunction, or any and all
162 | other commercial damages or losses), even if such Contributor
163 | has been advised of the possibility of such damages.
164 |
165 | 9. Accepting Warranty or Additional Liability. While redistributing
166 | the Work or Derivative Works thereof, You may choose to offer,
167 | and charge a fee for, acceptance of support, warranty, indemnity,
168 | or other liability obligations and/or rights consistent with this
169 | License. However, in accepting such obligations, You may act only
170 | on Your own behalf and on Your sole responsibility, not on behalf
171 | of any other Contributor, and only if You agree to indemnify,
172 | defend, and hold each Contributor harmless for any liability
173 | incurred by, or claims asserted against, such Contributor by reason
174 | of your accepting any such warranty or additional liability.
175 |
176 | END OF TERMS AND CONDITIONS
177 |
178 | APPENDIX: How to apply the Apache License to your work.
179 |
180 | To apply the Apache License to your work, attach the following
181 | boilerplate notice, with the fields enclosed by brackets "[]"
182 | replaced with your own identifying information. (Don't include
183 | the brackets!) The text should be enclosed in the appropriate
184 | comment syntax for the file format. We also recommend that a
185 | file or class name and description of purpose be included on the
186 | same "printed page" as the copyright notice for easier
187 | identification within third-party archives.
188 |
189 | Copyright [yyyy] [name of copyright owner]
190 |
191 | Licensed under the Apache License, Version 2.0 (the "License");
192 | you may not use this file except in compliance with the License.
193 | You may obtain a copy of the License at
194 |
195 | http://www.apache.org/licenses/LICENSE-2.0
196 |
197 | Unless required by applicable law or agreed to in writing, software
198 | distributed under the License is distributed on an "AS IS" BASIS,
199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 | See the License for the specific language governing permissions and
201 | limitations under the License.
202 |
--------------------------------------------------------------------------------
/java-repo-tools/README.md:
--------------------------------------------------------------------------------
1 | # Cloud Platform Java Repository Tools
2 |
3 | [](https://travis-ci.org/GoogleCloudPlatform/java-repo-tools)
5 | [](https://codecov.io/gh/GoogleCloudPlatform/java-repo-tools)
7 |
8 | This is a collection of common tools used to maintain and test Java repositories
9 | in the [GoogleCloudPlaftorm](https://github.com/GoogleCloudPlatform)
10 | organization.
11 |
12 |
13 | ## Using this repository
14 |
15 | This repository is copied into a subtree of other Java repositories, such as
16 | [java-docs-samples](/GoogleCloudPlatform/java-docs-samples). Note, that a
17 | subtree is just the code copied into a directory, so a regular `git clone` will
18 | continue to work.
19 |
20 |
21 | ### Adding to a new repository
22 |
23 | To copy `java-repo-tools` into a subtree of a new repository `my-java-samples`,
24 | first add this repository as a remote. We then fetch all the changes from this
25 | `java-repo-tools`.
26 |
27 | ```
28 | git remote add java-repo-tools git@github.com:GoogleCloudPlatform/java-repo-tools.git
29 | git fetch java-repo-tools master
30 | ```
31 |
32 | We can then go back to the `my-java-samples` code and prepare a Pull Request to
33 | add the `java-repo-tools` code in a subtree. Making a new branch is optional, but
34 | recommended so that you can more easily send a pull request to start using
35 | `java-repo-tools`.
36 |
37 | ```
38 | git checkout -b use-java-repo-tools origin/master
39 | ```
40 |
41 | Finally, read the `java-repo-tools` into a subtree. So that you can pull future
42 | updates from the `java-repo-tools` repository, this command will merge histories.
43 | This way prevents unnecessary conflicts when pulling changes in.
44 |
45 | ```
46 | git subtree add --prefix=java-repo-tools java-repo-tools master
47 | ```
48 |
49 | Now all the content of `java-repo-tools` will be in the `java-repo-tools/`
50 | directory (which we specified in the `--prefix` command).
51 |
52 | #### Using the Maven configuration
53 |
54 | If all the projects within your `my-java-samples` share a common parent POM for
55 | plugin configuration (like checkstyle). We can then make the
56 | `java-repo-tools/pom.xml` parent of this.
57 |
58 | ```
59 |
60 |
61 | com.google.cloud
62 | shared-configuration
63 | 1.0.0
64 | java-repo-tools
65 |
66 | ```
67 |
68 | Once this is added to the common parent, all modules will have the same plugin
69 | configuration applied. If the children POMs provide the plugin information
70 | themselves, it will override this configuration, so you should delete any
71 | now-redundant plugin information.
72 |
73 |
74 | #### Examples
75 |
76 | - Adding to repository with an existing parent POM: Pull Request
77 | [java-docs-samples#125][java-docs-samples-125].
78 |
79 | [java-docs-samples-125]: https://github.com/GoogleCloudPlatform/java-docs-samples/pull/125
80 |
81 |
82 | ### Detecting if you need to synchronize a subtree
83 |
84 | If you haven't done this before, run
85 |
86 | ```
87 | git remote add java-repo-tools git@github.com:GoogleCloudPlatform/java-repo-tools.git
88 | ```
89 |
90 | To detect if you have changes in the directory, run
91 |
92 | ```
93 | git fetch java-repo-tools master
94 | git diff-tree -p HEAD:java-repo-tools/ java-repo-tools/master
95 | ```
96 |
97 | or to diff against your local `java-repo-tools` branch:
98 |
99 | ```
100 | git diff-tree -p HEAD:java-repo-tools/ java-repo-tools --
101 | ```
102 |
103 | (The trailing `--` is to say that we want to compare against the branch, not the
104 | directory.)
105 |
106 |
107 | ### Pulling changes from Java Repository Tools to a subtree
108 |
109 | To update the `java-repo-tools` directory, if you haven't done this before, run
110 |
111 | ```
112 | git remote add java-repo-tools git@github.com:GoogleCloudPlatform/java-repo-tools.git
113 | ```
114 |
115 | To pull the latest changes from this `java-repo-tools` repository, run:
116 |
117 | ```
118 | git checkout master
119 | # Making a new branch is optional, but recommended to send a pull request for
120 | # update.
121 | git checkout -b update-java-repo-tools
122 | git pull -s subtree java-repo-tools master
123 | ```
124 |
125 | Then you can make any needed changes to make the rest of the repository
126 | compatible with the updated `java-repo-tools` code, commit, push, and send a
127 | Pull Request as you would in the normal flow.
128 |
129 |
130 | ### Pushing changes from a subtree upstream to Java Repository Tools
131 |
132 | What if you make changes in your repository and now want to push them upstream?
133 |
134 | Assuming you just commited changes in the `java-repo-tools/` directory of your
135 | `my-main-branch`, to split the `java-repo-tools` changes into their own branch.
136 | The first time using the `subtree` command, we may need to use the `--rejoin`
137 | argument.
138 |
139 | ```
140 | git subtree split --prefix=java-repo-tools -b ${USER}-push-java-repo-tools
141 | git checkout ${USER}-push-java-repo-tools
142 | git push java-repo-tools ${USER}-push-java-repo-tools
143 | ```
144 |
145 | Then, you can send a pull request to the `java-repo-tools` repository.
146 |
147 |
148 | ## References
149 |
150 | - [GitHub's subtree merge reference](https://help.github.com/articles/about-git-subtree-merges/)
151 |
152 | ## Contributing changes
153 |
154 | - See [CONTRIBUTING.md](CONTRIBUTING.md)
155 |
156 |
157 | ## Licensing
158 |
159 | - Apache 2.0 - See [LICENSE](LICENSE)
160 |
161 |
--------------------------------------------------------------------------------
/java-repo-tools/codecov.yml:
--------------------------------------------------------------------------------
1 | # Copyright 2016 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 | codecov:
15 | branch: master
16 | comment:
17 | branches:
18 | - master
19 |
--------------------------------------------------------------------------------
/java-repo-tools/google-checks.xml:
--------------------------------------------------------------------------------
1 |
2 |
5 |
20 |
21 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 |
63 |
64 |
65 |
66 |
67 |
68 |
69 |
70 |
71 |
72 |
73 |
74 |
75 |
76 |
77 |
78 |
79 |
80 |
81 |
82 |
83 |
84 |
85 |
87 |
89 |
90 |
91 |
92 |
93 |
94 |
95 |
96 |
97 |
98 |
99 |
100 |
101 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
111 |
113 |
114 |
115 |
117 |
118 |
119 |
120 |
122 |
123 |
124 |
125 |
127 |
128 |
129 |
130 |
131 |
132 |
134 |
135 |
136 |
137 |
139 |
140 |
141 |
142 |
144 |
145 |
146 |
147 |
149 |
151 |
153 |
155 |
156 |
157 |
158 |
159 |
160 |
161 |
162 |
163 |
164 |
165 |
166 |
167 |
168 |
169 |
170 |
171 |
172 |
173 |
174 |
175 |
176 |
177 |
178 |
179 |
180 |
181 |
182 |
183 |
184 |
185 |
186 |
187 |
188 |
189 |
190 |
191 |
192 |
193 |
194 |
195 |
196 |
197 |
198 |
199 |
200 |
201 |
202 |
203 |
204 |
205 |
206 |
207 |
209 |
210 |
211 |
212 |
213 |
214 |
215 |
216 |
217 |
218 |
219 |
220 |
221 |
222 |
223 |
224 |
--------------------------------------------------------------------------------
/java-repo-tools/pom.xml:
--------------------------------------------------------------------------------
1 |
16 |
17 | 4.0.0
18 | 1.0.0
19 |
20 | com.google.cloud
21 | shared-configuration
22 | pom
23 |
24 |
25 | UTF-8
26 | UTF-8
27 |
28 |
29 |
30 | 3.1.0
31 |
32 |
33 |
34 | test
35 |
36 |
37 |
38 |
39 |
40 |
41 | org.apache.maven.plugins
42 | maven-surefire-plugin
43 | 2.19.1
44 |
45 | false
46 |
47 |
48 |
49 |
50 | org.apache.maven.plugins
51 | maven-failsafe-plugin
52 | 2.19.1
53 |
54 |
55 |
56 | integration-test
57 | verify
58 |
59 |
60 |
61 |
62 |
63 | org.apache.maven.plugins
64 | maven-checkstyle-plugin
65 | 2.17
66 |
67 | google-checks.xml
68 | true
69 | true
70 | true
71 | true
72 | suppressions.xml
73 |
74 |
75 | check
76 |
77 |
78 |
79 | org.codehaus.mojo
80 | versions-maven-plugin
81 | 2.2
82 |
83 |
84 | org.jacoco
85 | jacoco-maven-plugin
86 | 0.7.6.201602180812
87 |
88 |
89 |
90 | prepare-agent
91 |
92 |
93 |
94 | report
95 | test
96 |
97 | report
98 |
99 |
100 |
101 |
102 |
103 |
104 |
105 |
--------------------------------------------------------------------------------
/java-repo-tools/scripts/test-localhost.sh:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env bash
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 | # Usage:
17 | # test-localhost.sh deployment-type path/to/project -- [maven arguments]
18 | #
19 | # This script runs a localhost server Maven plugin and verifies that a request
20 | # to http://localhost:8080/ does not return an error code.
21 |
22 | print_usage () {
23 | echo "Usage:" >&2
24 | echo " $0 server-type path/to/project [-- maven arguments]" >&2
25 | echo >&2
26 | echo "server-type can be any of the following:" >&2
27 | echo " appengine" >&2
28 | echo " jetty" >&2
29 | echo " spring-boot" >&2
30 | }
31 |
32 | if [[ -z "$1" ]]; then
33 | echo "Missing server-type parameter." >&2
34 | print_usage
35 | exit 1
36 | fi
37 | case $1 in
38 | appengine)
39 | mvn_plugin="appengine:devserver"
40 | server_started_message="localhost:8080"
41 | ;;
42 | jetty)
43 | mvn_plugin="jetty:run-exploded"
44 | server_started_message="Started Jetty Server"
45 | ;;
46 | spring-boot)
47 | mvn_plugin="spring-boot:run"
48 | server_started_message="Tomcat started on port(s): 8080 (http)"
49 | ;;
50 | *)
51 | print_usage
52 | exit 1
53 | ;;
54 | esac
55 |
56 | if [[ -z "$2" ]]; then
57 | echo "Missing directory parameter." >&2
58 | print_usage
59 | exit 1
60 | fi
61 | code_path=$2
62 |
63 | mvn_command="mvn --batch-mode clean ${mvn_plugin} -DskipTests"
64 | if [[ "$3" == "--" ]]; then
65 | shift 3
66 | for mvn_arg in "${@}"; do
67 | mvn_command="${mvn_command} ${mvn_arg}"
68 | done
69 | elif [[ -n "$3" ]]; then
70 | echo "Got unexpected third argument" >&2
71 | print_usage
72 | exit 1
73 | fi
74 |
75 | set -e
76 | set -x
77 |
78 | (
79 | cd "$code_path"
80 | expect -c "
81 | spawn ${mvn_command}
82 | set timeout 600
83 | expect \"${server_started_message}\"
84 | "'sleep 10
85 | spawn curl --silent --output /dev/stderr --write-out "%{http_code}" http://localhost:8080/
86 | expect {
87 | "200" {
88 | exit
89 | }
90 | }
91 | exit 1
92 | '
93 | )
94 |
95 |
--------------------------------------------------------------------------------
/java-repo-tools/suppressions.xml:
--------------------------------------------------------------------------------
1 |
2 |
5 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
--------------------------------------------------------------------------------
/java-repo-tools/test/README.md:
--------------------------------------------------------------------------------
1 | # Cloud Platform Java Repository Tools Test
2 |
3 | This is a test application for checking that the root [`pom.xml`](../pom.xml)
4 | and [`google-checks.xml`](../google-checks.xml) are working as expected.
5 |
6 |
--------------------------------------------------------------------------------
/java-repo-tools/test/pom.xml:
--------------------------------------------------------------------------------
1 |
2 |
17 |
19 | 4.0.0
20 |
21 | com.google.cloud
22 | shared-configuration-test
23 | 1.0
24 | jar
25 |
26 |
27 | shared-configuration
28 | com.google.cloud
29 | 1.0.0
30 | ..
31 |
32 |
33 |
34 |
35 |
36 | junit
37 | junit
38 | 4.12
39 | test
40 |
41 |
42 | com.google.truth
43 | truth
44 | 0.28
45 | test
46 |
47 |
48 |
49 |
--------------------------------------------------------------------------------
/java-repo-tools/test/src/main/java/com/google/cloud/samples/test/App.java:
--------------------------------------------------------------------------------
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 |
17 | package com.google.cloud.samples.test;
18 |
19 | /**
20 | * A hello world app to test the parent pom.xml.
21 | */
22 | public class App {
23 | public String greeting() {
24 | return "Hello World!";
25 | }
26 |
27 | public static void main(String[] args) {
28 | App app = new App();
29 | System.out.println(app.greeting());
30 | }
31 | }
32 |
--------------------------------------------------------------------------------
/java-repo-tools/test/src/test/java/com/google/cloud/samples/test/AppTest.java:
--------------------------------------------------------------------------------
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 |
17 | package com.google.cloud.samples.test;
18 |
19 | import static com.google.common.truth.Truth.assertThat;
20 |
21 | import org.junit.Test;
22 | import org.junit.runner.RunWith;
23 | import org.junit.runners.JUnit4;
24 |
25 | import java.io.ByteArrayOutputStream;
26 | import java.io.PrintStream;
27 |
28 | /**
29 | * Unit tests for {@link App}.
30 | */
31 | @RunWith(JUnit4.class)
32 | public class AppTest {
33 | @Test public void main_printsHelloWorld() {
34 | ByteArrayOutputStream out = new ByteArrayOutputStream();
35 | System.setOut(new PrintStream(out));
36 |
37 | App.main(new String[0]);
38 |
39 | String greeting = out.toString();
40 | assertThat(greeting).named("greeting").contains("Hello World!");
41 | }
42 | }
43 |
--------------------------------------------------------------------------------
/pom.xml:
--------------------------------------------------------------------------------
1 |
16 |
17 | 4.0.0
18 | war
19 | 1.0
20 |
21 | com.google.appengine.demos
22 | appengine-try-java
23 |
24 |
25 |
26 | com.google.cloud
27 | shared-configuration
28 | 1.0.0
29 | java-repo-tools
30 |
31 |
32 |
33 | 1
34 | 1.9.38
35 | UTF-8
36 |
37 |
38 |
39 |
40 |
41 | com.google.appengine
42 | appengine-api-1.0-sdk
43 | ${appengine.target.version}
44 |
45 |
46 | javax.servlet
47 | servlet-api
48 | 2.5
49 | provided
50 |
51 |
52 | jstl
53 | jstl
54 | 1.2
55 |
56 |
57 |
58 |
59 | junit
60 | junit
61 | 4.10
62 | test
63 |
64 |
65 | org.mockito
66 | mockito-all
67 | 1.9.0
68 | test
69 |
70 |
71 | com.google.appengine
72 | appengine-testing
73 | ${appengine.target.version}
74 | test
75 |
76 |
77 | com.google.appengine
78 | appengine-api-stubs
79 | ${appengine.target.version}
80 | test
81 |
82 |
83 |
84 |
85 | target/${project.artifactId}/WEB-INF/classes
86 |
87 |
88 |
89 | org.apache.maven.plugins
90 | maven-war-plugin
91 | 2.3
92 |
93 | true
94 |
95 |
96 |
97 | ${basedir}/src/main/webapp/WEB-INF
98 | true
99 | WEB-INF
100 |
101 |
102 |
103 |
104 |
105 |
106 | com.google.appengine
107 | appengine-maven-plugin
108 | ${appengine.target.version}
109 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
--------------------------------------------------------------------------------
/src/main/java/myapp/DemoServlet.java:
--------------------------------------------------------------------------------
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 |
17 | package myapp;
18 |
19 | import java.io.IOException;
20 | import javax.servlet.http.HttpServlet;
21 | import javax.servlet.http.HttpServletRequest;
22 | import javax.servlet.http.HttpServletResponse;
23 |
24 | public class DemoServlet extends HttpServlet {
25 | @Override
26 | public void doGet(HttpServletRequest req, HttpServletResponse resp)
27 | throws IOException {
28 | resp.setContentType("text/plain");
29 | resp.getWriter().println("{ \"name\": \"World\" }");
30 | }
31 | }
32 |
--------------------------------------------------------------------------------
/src/main/webapp/WEB-INF/appengine-web.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | your-project-id-here
4 | 1
5 | true
6 |
7 |
--------------------------------------------------------------------------------
/src/main/webapp/WEB-INF/logging.properties:
--------------------------------------------------------------------------------
1 | # A default java.util.logging configuration.
2 | # (All App Engine logging is through java.util.logging by default).
3 | #
4 | # To use this configuration, copy it into your application's WEB-INF
5 | # folder and add the following to your appengine-web.xml:
6 | #
7 | #
8 | #
9 | #
10 | #
11 |
12 | # Set the default logging level for all loggers to WARNING
13 | .level = WARNING
14 |
--------------------------------------------------------------------------------
/src/main/webapp/WEB-INF/web.xml:
--------------------------------------------------------------------------------
1 |
2 |
5 |
6 |
7 |
8 | demo
9 | myapp.DemoServlet
10 |
11 |
12 | demo
13 | /demo
14 |
15 |
16 | index.html
17 |
18 |
19 |
--------------------------------------------------------------------------------
/src/main/webapp/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | App Engine Demo
5 |
6 |
7 |
8 | Loading...
9 |
10 |
17 |
18 |
19 |
--------------------------------------------------------------------------------