Skip to content

Commit

Permalink
fix(deps): Update the Java code generator (gapic-generator-java) to 2…
Browse files Browse the repository at this point in the history
….31.0 (#1855)
  • Loading branch information
gcf-owl-bot[bot] authored Jan 13, 2024
1 parent b36825b commit 7e733d2
Show file tree
Hide file tree
Showing 6 changed files with 828 additions and 39 deletions.
Original file line number Diff line number Diff line change
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
Loading

0 comments on commit 7e733d2

Please sign in to comment.