Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

fix(deps): Update the Java code generator (gapic-generator-java) to 2.31.0 #1855

Merged
merged 6 commits into from Jan 13, 2024
Merged

fix(deps): Update the Java code generator (gapic-generator-java) to 2.31.0 #1855

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
7d64f5a
fix(deps): Update the Java code generator (gapic-generator-java) to 2…
gcf-owl-bot[bot] Jan 8, 2024
e641dea
🦉 Updates from OwlBot post-processor
gcf-owl-bot[bot] Jan 8, 2024
c45b7f4
fix javadoc html manually
alicejli Jan 10, 2024
25c2360
deps: shared deps 3.21.0
suztomo Jan 11, 2024
3ab91cf
fix javadoc tags
alicejli Jan 12, 2024
c99945d
Merge remote-tracking branch 'origin/main' into owl-bot-copy
suztomo Jan 12, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
252 changes: 239 additions & 13 deletions google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SchemaServiceClient.java
View file
Open in desktop
Expand Up @@ -79,19 +79,245 @@
* <p>Note: close() needs to be called on the SchemaServiceClient object to clean up resources such
* as threads. In the example above, try-with-resources is used, which automatically calls close().
*
* <p>The surface of this class includes several types of Java methods for each of the API's
* methods:
*
* <ol>
* <li>A "flattened" method. With this type of method, the fields of the request type have been
* converted into function parameters. It may be the case that not all fields are available as
* parameters, and not every API method will have a flattened method entry point.
* <li>A "request object" method. This type of method only takes one parameter, a request object,
* which must be constructed before the call. Not every API method will have a request object
* method.
* <li>A "callable" method. This type of method takes no parameters and returns an immutable API
* callable object, which can be used to initiate calls to the service.
* </ol>
* <table>
* <caption>Methods</caption>
* <tr>
* <th>Method</th>
* <th>Description</th>
* <th>Method Variants</th>
* </tr>
* <tr>
* <td>CreateSchema</td>
* <td><p> Creates a schema.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>createSchema(CreateSchemaRequest request)
* </ul>
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
* <ul>
* <li>createSchema(ProjectName parent, Schema schema, String schemaId)
* <li>createSchema(String parent, Schema schema, String schemaId)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>createSchemaCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>GetSchema</td>
* <td><p> Gets a schema.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>getSchema(GetSchemaRequest request)
* </ul>
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
* <ul>
* <li>getSchema(SchemaName name)
* <li>getSchema(String name)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>getSchemaCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>ListSchemas</td>
* <td><p> Lists schemas in a project.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>listSchemas(ListSchemasRequest request)
* </ul>
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
* <ul>
* <li>listSchemas(ProjectName parent)
* <li>listSchemas(String parent)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>listSchemasPagedCallable()
* <li>listSchemasCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>ListSchemaRevisions</td>
* <td><p> Lists all schema revisions for the named schema.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>listSchemaRevisions(ListSchemaRevisionsRequest request)
* </ul>
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
* <ul>
* <li>listSchemaRevisions(SchemaName name)
* <li>listSchemaRevisions(String name)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>listSchemaRevisionsPagedCallable()
* <li>listSchemaRevisionsCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>CommitSchema</td>
* <td><p> Commits a new schema revision to an existing schema.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>commitSchema(CommitSchemaRequest request)
* </ul>
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
* <ul>
* <li>commitSchema(SchemaName name, Schema schema)
* <li>commitSchema(String name, Schema schema)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>commitSchemaCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>RollbackSchema</td>
* <td><p> Creates a new schema revision that is a copy of the provided revision_id.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>rollbackSchema(RollbackSchemaRequest request)
* </ul>
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
* <ul>
* <li>rollbackSchema(SchemaName name, String revisionId)
* <li>rollbackSchema(String name, String revisionId)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>rollbackSchemaCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>DeleteSchemaRevision</td>
* <td><p> Deletes a specific schema revision.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>deleteSchemaRevision(DeleteSchemaRevisionRequest request)
* </ul>
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
* <ul>
* <li>deleteSchemaRevision(SchemaName name, String revisionId)
* <li>deleteSchemaRevision(String name, String revisionId)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>deleteSchemaRevisionCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>DeleteSchema</td>
* <td><p> Deletes a schema.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>deleteSchema(DeleteSchemaRequest request)
* </ul>
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
* <ul>
* <li>deleteSchema(SchemaName name)
* <li>deleteSchema(String name)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>deleteSchemaCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>ValidateSchema</td>
* <td><p> Validates a schema.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>validateSchema(ValidateSchemaRequest request)
* </ul>
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
* <ul>
* <li>validateSchema(ProjectName parent, Schema schema)
* <li>validateSchema(String parent, Schema schema)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>validateSchemaCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>ValidateMessage</td>
* <td><p> Validates a message against a schema.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>validateMessage(ValidateMessageRequest request)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>validateMessageCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>SetIamPolicy</td>
* <td><p> Sets the access control policy on the specified resource. Replacesany existing policy.
* <p> Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>setIamPolicy(SetIamPolicyRequest request)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>setIamPolicyCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>GetIamPolicy</td>
* <td><p> Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>getIamPolicy(GetIamPolicyRequest request)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>getIamPolicyCallable()
* </ul>
* </td>
* </tr>
* <tr>
* <td>TestIamPermissions</td>
* <td><p> Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error.
* <p> Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.</td>
* <td>
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
* <ul>
* <li>testIamPermissions(TestIamPermissionsRequest request)
* </ul>
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
* <ul>
* <li>testIamPermissionsCallable()
* </ul>
* </td>
* </tr>
* </table>
*
* <p>See the individual methods for example code.
*
Expand Down