Skip to content

Commit eea4702

Browse files
chore: [common-protos,common-protos] set packed = false on field_behavior extension (#2436)
- [ ] Regenerate this pull request now. PiperOrigin-RevId: 604675854 Source-Link: googleapis/googleapis@42c04fe Source-Link: https://github.com/googleapis/googleapis-gen/commit/a1ed8a97a00d02fe456f6ebd4160c5b2b000ad75 Copy-Tag: eyJwIjoiamF2YS1jb21tb24tcHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiJhMWVkOGE5N2EwMGQwMmZlNDU2ZjZlYmQ0MTYwYzViMmIwMDBhZDc1In0= chore: set packed = false on field_behavior extension PiperOrigin-RevId: 604675854 Source-Link: googleapis/googleapis@42c04fe Source-Link: https://github.com/googleapis/googleapis-gen/commit/a1ed8a97a00d02fe456f6ebd4160c5b2b000ad75 Copy-Tag: eyJwIjoiamF2YS1jb21tb24tcHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiJhMWVkOGE5N2EwMGQwMmZlNDU2ZjZlYmQ0MTYwYzViMmIwMDBhZDc1In0= build: Update protobuf to 25.2 in WORKSPACE build: Update grpc to 1.60.0 in WORKSPACE build: Remove pin for boringssl in WORKSPACE build: Update bazel to 6.3.0 in .bazeliskrc PiperOrigin-RevId: 603226138 Source-Link: googleapis/googleapis@2aec9e1 Source-Link: https://github.com/googleapis/googleapis-gen/commit/e9a5c2ef37b4d69c93e39141d87aae0b193c00b1 Copy-Tag: eyJwIjoiamF2YS1jb21tb24tcHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiJlOWE1YzJlZjM3YjRkNjljOTNlMzkxNDFkODdhYWUwYjE5M2MwMGIxIn0= build: Update protobuf to 25.2 in WORKSPACE build: Update grpc to 1.60.0 in WORKSPACE build: Remove pin for boringssl in WORKSPACE build: Update bazel to 6.3.0 in .bazeliskrc PiperOrigin-RevId: 603226138 Source-Link: googleapis/googleapis@2aec9e1 Source-Link: https://github.com/googleapis/googleapis-gen/commit/e9a5c2ef37b4d69c93e39141d87aae0b193c00b1 Copy-Tag: eyJwIjoiamF2YS1jb21tb24tcHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiJlOWE1YzJlZjM3YjRkNjljOTNlMzkxNDFkODdhYWUwYjE5M2MwMGIxIn0= --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent 9ec575b commit eea4702

File tree

308 files changed

+1991
-635
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

308 files changed

+1991
-635
lines changed

java-common-protos/README.md

+157-27
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,138 @@
1-
# Google Common Protos
1+
# Google Common Protos Client for Java
22

3-
Java protobuf classes for Google's common protos.
3+
Java idiomatic client for [Common Protos][product-docs].
44

55
[![Maven][maven-version-image]][maven-version-link]
66
![Stability][stability-image]
77

8+
- [Product Documentation][product-docs]
89
- [Client Library Documentation][javadocs]
910

10-
## Java Versions
1111

12-
Java 7 or above is required for using this client.
12+
## Quickstart
13+
14+
15+
If you are using Maven, add this to your pom.xml file:
16+
17+
18+
```xml
19+
<dependency>
20+
<groupId>com.google.api.grpc</groupId>
21+
<artifactId>proto-google-common-protos</artifactId>
22+
<version>2.33.0</version>
23+
</dependency>
24+
```
25+
26+
If you are using Gradle without BOM, add this to your dependencies:
27+
28+
```Groovy
29+
implementation 'com.google.api.grpc:proto-google-common-protos:2.33.0'
30+
```
31+
32+
If you are using SBT, add this to your dependencies:
33+
34+
```Scala
35+
libraryDependencies += "com.google.api.grpc" % "proto-google-common-protos" % "2.33.0"
36+
```
37+
38+
## Authentication
39+
40+
See the [Authentication][authentication] section in the base directory's README.
41+
42+
## Authorization
43+
44+
The client application making API calls must be granted [authorization scopes][auth-scopes] required for the desired Common Protos APIs, and the authenticated principal must have the [IAM role(s)][predefined-iam-roles] required to access GCP resources using the Common Protos API calls.
45+
46+
## Getting Started
47+
48+
### Prerequisites
49+
50+
You will need a [Google Cloud Platform Console][developer-console] project with the Common Protos [API enabled][enable-api].
51+
You will need to [enable billing][enable-billing] to use Google Common Protos.
52+
[Follow these instructions][create-project] to get your project set up. You will also need to set up the local development environment by
53+
[installing the Google Cloud SDK][cloud-sdk] and running the following commands in command line:
54+
`gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.
55+
56+
### Installation and setup
57+
58+
You'll need to obtain the `proto-google-common-protos` library. See the [Quickstart](#quickstart) section
59+
to add `proto-google-common-protos` as a dependency in your code.
60+
61+
## About Common Protos
62+
63+
64+
[Common Protos][product-docs] Protobuf classes for Google's common protos.
65+
66+
See the [Common Protos client library docs][javadocs] to learn how to
67+
use this Common Protos Client Library.
68+
69+
70+
71+
72+
73+
74+
## Troubleshooting
75+
76+
To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].
77+
78+
## Transport
79+
80+
Common Protos uses gRPC for the transport layer.
81+
82+
## Supported Java Versions
83+
84+
Java 8 or above is required for using this client.
85+
86+
Google's Java client libraries,
87+
[Google Cloud Client Libraries][cloudlibs]
88+
and
89+
[Google Cloud API Libraries][apilibs],
90+
follow the
91+
[Oracle Java SE support roadmap][oracle]
92+
(see the Oracle Java SE Product Releases section).
93+
94+
### For new development
95+
96+
In general, new feature development occurs with support for the lowest Java
97+
LTS version covered by Oracle's Premier Support (which typically lasts 5 years
98+
from initial General Availability). If the minimum required JVM for a given
99+
library is changed, it is accompanied by a [semver][semver] major release.
100+
101+
Java 11 and (in September 2021) Java 17 are the best choices for new
102+
development.
103+
104+
### Keeping production systems current
105+
106+
Google tests its client libraries with all current LTS versions covered by
107+
Oracle's Extended Support (which typically lasts 8 years from initial
108+
General Availability).
109+
110+
#### Legacy support
111+
112+
Google's client libraries support legacy versions of Java runtimes with long
113+
term stable libraries that don't receive feature updates on a best efforts basis
114+
as it may not be possible to backport all patches.
115+
116+
Google provides updates on a best efforts basis to apps that continue to use
117+
Java 7, though apps might need to upgrade to current versions of the library
118+
that supports their JVM.
119+
120+
#### Where to find specific information
121+
122+
The latest versions and the supported Java versions are identified on
123+
the individual GitHub repository `github.com/GoogleAPIs/java-SERVICENAME`
124+
and on [google-cloud-java][g-c-j].
13125

14126
## Versioning
15127

128+
16129
This library follows [Semantic Versioning](http://semver.org/).
17130

131+
132+
18133
## Contributing
19134

135+
20136
Contributions to this library are always welcome and highly encouraged.
21137

22138
See [CONTRIBUTING][contributing] for more information how to get started.
@@ -25,41 +141,55 @@ Please note that this project is released with a Contributor Code of Conduct. By
25141
this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more
26142
information.
27143

144+
28145
## License
29146

30147
Apache 2.0 - See [LICENSE][license] for more information.
31148

32149
## CI Status
33150

34-
| Java Version | Status |
35-
| -------------- | --------------------------------------------------------- |
36-
| Java 7 | [![Kokoro CI][kokoro-badge-image-1]][kokoro-badge-link-1] |
37-
| Java 8 | [![Kokoro CI][kokoro-badge-image-2]][kokoro-badge-link-2] |
38-
| Java 8 OSX | [![Kokoro CI][kokoro-badge-image-3]][kokoro-badge-link-3] |
39-
| Java 8 Windows | [![Kokoro CI][kokoro-badge-image-4]][kokoro-badge-link-4] |
40-
| Java 11 | [![Kokoro CI][kokoro-badge-image-5]][kokoro-badge-link-5] |
41-
42-
[javadocs]: https://cloud.google.com/java/docs/reference/proto-google-common-protos/latest/overview
43-
[kokoro-badge-image-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-common-protos/java7.svg
44-
[kokoro-badge-link-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-common-protos/java7.html
45-
[kokoro-badge-image-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-common-protos/java8.svg
46-
[kokoro-badge-link-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-common-protos/java8.html
47-
[kokoro-badge-image-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-common-protos/java8-osx.svg
48-
[kokoro-badge-link-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-common-protos/java8-osx.html
49-
[kokoro-badge-image-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-common-protos/java8-win.svg
50-
[kokoro-badge-link-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-common-protos/java8-win.html
51-
[kokoro-badge-image-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-common-protos/java11.svg
52-
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-common-protos/java11.html
53-
[stability-image]: https://img.shields.io/badge/stability-ga-green
151+
Java Version | Status
152+
------------ | ------
153+
Java 8 | [![Kokoro CI][kokoro-badge-image-2]][kokoro-badge-link-2]
154+
Java 8 OSX | [![Kokoro CI][kokoro-badge-image-3]][kokoro-badge-link-3]
155+
Java 8 Windows | [![Kokoro CI][kokoro-badge-image-4]][kokoro-badge-link-4]
156+
Java 11 | [![Kokoro CI][kokoro-badge-image-5]][kokoro-badge-link-5]
157+
158+
Java is a registered trademark of Oracle and/or its affiliates.
159+
160+
[product-docs]: https://github.com/googleapis/api-common-protos
161+
[javadocs]: https://cloud.google.com/java/docs/reference/proto-google-common-protos/latest/history
162+
[kokoro-badge-image-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/sdk-platform-java/java7.svg
163+
[kokoro-badge-link-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/sdk-platform-java/java7.html
164+
[kokoro-badge-image-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/sdk-platform-java/java8.svg
165+
[kokoro-badge-link-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/sdk-platform-java/java8.html
166+
[kokoro-badge-image-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/sdk-platform-java/java8-osx.svg
167+
[kokoro-badge-link-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/sdk-platform-java/java8-osx.html
168+
[kokoro-badge-image-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/sdk-platform-java/java8-win.svg
169+
[kokoro-badge-link-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/sdk-platform-java/java8-win.html
170+
[kokoro-badge-image-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/sdk-platform-java/java11.svg
171+
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/sdk-platform-java/java11.html
172+
[stability-image]: https://img.shields.io/badge/stability-stable-green
54173
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.api.grpc/proto-google-common-protos.svg
55174
[maven-version-link]: https://search.maven.org/search?q=g:com.google.api.grpc%20AND%20a:proto-google-common-protos&core=gav
56175
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
176+
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
177+
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles
178+
[iam-policy]: https://cloud.google.com/iam/docs/overview#cloud-iam-policy
57179
[developer-console]: https://console.developers.google.com/
58180
[create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
59181
[cloud-sdk]: https://cloud.google.com/sdk/
60182
[troubleshooting]: https://github.com/googleapis/google-cloud-common/blob/main/troubleshooting/readme.md#troubleshooting
61-
[contributing]: https://github.com/googleapis/java-common-protos/blob/main/CONTRIBUTING.md
62-
[code-of-conduct]: https://github.com/googleapis/java-common-protos/blob/main/CODE_OF_CONDUCT.md#contributor-code-of-conduct
63-
[license]: https://github.com/googleapis/java-common-protos/blob/main/LICENSE
183+
[contributing]: https://github.com/googleapis/sdk-platform-java/blob/main/CONTRIBUTING.md
184+
[code-of-conduct]: https://github.com/googleapis/sdk-platform-java/blob/main/CODE_OF_CONDUCT.md#contributor-code-of-conduct
185+
[license]: https://github.com/googleapis/sdk-platform-java/blob/main/LICENSE
64186
[enable-billing]: https://cloud.google.com/apis/docs/getting-started#enabling_billing
187+
65188
[libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
189+
[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
190+
191+
[semver]: https://semver.org/
192+
[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained
193+
[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
194+
[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html
195+
[g-c-j]: http://github.com/googleapis/google-cloud-java

java-common-protos/proto-google-common-protos/src/main/java/com/google/api/Advice.java

+1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
// Generated by the protocol buffer compiler. DO NOT EDIT!
1717
// source: google/api/config_change.proto
1818

19+
// Protobuf Java Version: 3.25.2
1920
package com.google.api;
2021

2122
/**

java-common-protos/proto-google-common-protos/src/main/java/com/google/api/AdviceOrBuilder.java

+1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
// Generated by the protocol buffer compiler. DO NOT EDIT!
1717
// source: google/api/config_change.proto
1818

19+
// Protobuf Java Version: 3.25.2
1920
package com.google.api;
2021

2122
public interface AdviceOrBuilder

java-common-protos/proto-google-common-protos/src/main/java/com/google/api/AnnotationsProto.java

+1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
// Generated by the protocol buffer compiler. DO NOT EDIT!
1717
// source: google/api/annotations.proto
1818

19+
// Protobuf Java Version: 3.25.2
1920
package com.google.api;
2021

2122
public final class AnnotationsProto {

java-common-protos/proto-google-common-protos/src/main/java/com/google/api/AuthProto.java

+1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
// Generated by the protocol buffer compiler. DO NOT EDIT!
1717
// source: google/api/auth.proto
1818

19+
// Protobuf Java Version: 3.25.2
1920
package com.google.api;
2021

2122
public final class AuthProto {

java-common-protos/proto-google-common-protos/src/main/java/com/google/api/AuthProvider.java

+1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
// Generated by the protocol buffer compiler. DO NOT EDIT!
1717
// source: google/api/auth.proto
1818

19+
// Protobuf Java Version: 3.25.2
1920
package com.google.api;
2021

2122
/**

java-common-protos/proto-google-common-protos/src/main/java/com/google/api/AuthProviderOrBuilder.java

+1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
// Generated by the protocol buffer compiler. DO NOT EDIT!
1717
// source: google/api/auth.proto
1818

19+
// Protobuf Java Version: 3.25.2
1920
package com.google.api;
2021

2122
public interface AuthProviderOrBuilder

java-common-protos/proto-google-common-protos/src/main/java/com/google/api/AuthRequirement.java

+1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
// Generated by the protocol buffer compiler. DO NOT EDIT!
1717
// source: google/api/auth.proto
1818

19+
// Protobuf Java Version: 3.25.2
1920
package com.google.api;
2021

2122
/**

java-common-protos/proto-google-common-protos/src/main/java/com/google/api/AuthRequirementOrBuilder.java

+1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
// Generated by the protocol buffer compiler. DO NOT EDIT!
1717
// source: google/api/auth.proto
1818

19+
// Protobuf Java Version: 3.25.2
1920
package com.google.api;
2021

2122
public interface AuthRequirementOrBuilder

java-common-protos/proto-google-common-protos/src/main/java/com/google/api/Authentication.java

+1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
// Generated by the protocol buffer compiler. DO NOT EDIT!
1717
// source: google/api/auth.proto
1818

19+
// Protobuf Java Version: 3.25.2
1920
package com.google.api;
2021

2122
/**

java-common-protos/proto-google-common-protos/src/main/java/com/google/api/AuthenticationOrBuilder.java

+1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
// Generated by the protocol buffer compiler. DO NOT EDIT!
1717
// source: google/api/auth.proto
1818

19+
// Protobuf Java Version: 3.25.2
1920
package com.google.api;
2021

2122
public interface AuthenticationOrBuilder

java-common-protos/proto-google-common-protos/src/main/java/com/google/api/AuthenticationRule.java

+23-6
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
// Generated by the protocol buffer compiler. DO NOT EDIT!
1717
// source: google/api/auth.proto
1818

19+
// Protobuf Java Version: 3.25.2
1920
package com.google.api;
2021

2122
/**
@@ -69,6 +70,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
6970
com.google.api.AuthenticationRule.Builder.class);
7071
}
7172

73+
private int bitField0_;
7274
public static final int SELECTOR_FIELD_NUMBER = 1;
7375

7476
@SuppressWarnings("serial")
@@ -141,7 +143,7 @@ public com.google.protobuf.ByteString getSelectorBytes() {
141143
*/
142144
@java.lang.Override
143145
public boolean hasOauth() {
144-
return oauth_ != null;
146+
return ((bitField0_ & 0x00000001) != 0);
145147
}
146148
/**
147149
*
@@ -279,7 +281,7 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
279281
if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(selector_)) {
280282
com.google.protobuf.GeneratedMessageV3.writeString(output, 1, selector_);
281283
}
282-
if (oauth_ != null) {
284+
if (((bitField0_ & 0x00000001) != 0)) {
283285
output.writeMessage(2, getOauth());
284286
}
285287
if (allowWithoutCredential_ != false) {
@@ -300,7 +302,7 @@ public int getSerializedSize() {
300302
if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(selector_)) {
301303
size += com.google.protobuf.GeneratedMessageV3.computeStringSize(1, selector_);
302304
}
303-
if (oauth_ != null) {
305+
if (((bitField0_ & 0x00000001) != 0)) {
304306
size += com.google.protobuf.CodedOutputStream.computeMessageSize(2, getOauth());
305307
}
306308
if (allowWithoutCredential_ != false) {
@@ -489,10 +491,20 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
489491
}
490492

491493
// Construct using com.google.api.AuthenticationRule.newBuilder()
492-
private Builder() {}
494+
private Builder() {
495+
maybeForceBuilderInitialization();
496+
}
493497

494498
private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
495499
super(parent);
500+
maybeForceBuilderInitialization();
501+
}
502+
503+
private void maybeForceBuilderInitialization() {
504+
if (com.google.protobuf.GeneratedMessageV3.alwaysUseFieldBuilders) {
505+
getOauthFieldBuilder();
506+
getRequirementsFieldBuilder();
507+
}
496508
}
497509

498510
@java.lang.Override
@@ -563,12 +575,15 @@ private void buildPartial0(com.google.api.AuthenticationRule result) {
563575
if (((from_bitField0_ & 0x00000001) != 0)) {
564576
result.selector_ = selector_;
565577
}
578+
int to_bitField0_ = 0;
566579
if (((from_bitField0_ & 0x00000002) != 0)) {
567580
result.oauth_ = oauthBuilder_ == null ? oauth_ : oauthBuilder_.build();
581+
to_bitField0_ |= 0x00000001;
568582
}
569583
if (((from_bitField0_ & 0x00000004) != 0)) {
570584
result.allowWithoutCredential_ = allowWithoutCredential_;
571585
}
586+
result.bitField0_ |= to_bitField0_;
572587
}
573588

574589
@java.lang.Override
@@ -950,8 +965,10 @@ public Builder mergeOauth(com.google.api.OAuthRequirements value) {
950965
} else {
951966
oauthBuilder_.mergeFrom(value);
952967
}
953-
bitField0_ |= 0x00000002;
954-
onChanged();
968+
if (oauth_ != null) {
969+
bitField0_ |= 0x00000002;
970+
onChanged();
971+
}
955972
return this;
956973
}
957974
/**

0 commit comments

Comments
 (0)