Skip to content

Conversation

@danieljbruce
Copy link
Contributor

@danieljbruce danieljbruce commented Aug 12, 2024

Summary:

This PR replaces the long and complex readRowsImpl function with a group of classes containing smaller functions for handling a ReadRows request.

Background:

This is the final PR for making the ReadRows service more modular. So far three PRs have been written in order to make the ReadRows test service more modular:

  1. this PR eliminates duplicate code and adds interfaces to simplify data flows
  2. this PR eliminated the duplicate copy of the ReadRows service
  3. this PR gets rid of a complex block of if statements

Changes:

  • Create a ReadRowsImpl class for defining the Bigtable ReadRows service. Make the constructor of the class private to control the context in which the class is created and add a static createService method to the class which will use the constructor to create the service.
  • Replace all usages of the readRowsImpl function with a call to createService now that readRowsImpl has been deleted.
  • Two classes in total are introduced. One is ReadRowsRequestHandler and another is ReadRowsImpl. ReadRowsImpl will store data that changes between requests. In particular, errorAfterChunkNo is data that changes between requests. ReadRowsImpl uses a ReadRowsRequestHandler object when handling an incoming request.
  • The introduced ReadRowsRequestHandler will maintain information about whether the stream is waiting/cancelled and will have one function used for sending responses. This function sendResponse will do the same thing that the sendResponse function did before.
  • Code that used to define the ReadRows service will now live in ReadRowsImpl and be broken up into a handleRequest function which calls a sendAllChunks function.

Only ignore keyFrom and keyTo when they are undefined and not just when they are Falsy.
The old service has been generalized enough to mock correct server behaviour.
they are undefined anyway.
@product-auto-label product-auto-label bot added size: l Pull request size is large. api: bigtable Issues related to the googleapis/nodejs-bigtable API. labels Aug 12, 2024
@danieljbruce danieljbruce changed the base branch from 3527322442-to-main-2 to 3527322442-refactor-the-test-into-classes-3 August 12, 2024 16:02
@danieljbruce danieljbruce changed the title TODO test: Break the ReadRows service down into classes instead of a single long function Aug 12, 2024
@product-auto-label product-auto-label bot added size: m Pull request size is medium. and removed size: l Pull request size is large. labels Aug 12, 2024
@danieljbruce danieljbruce changed the base branch from 3527322442-refactor-the-test-into-classes-3 to 3527322442-to-main-2 August 12, 2024 18:05
…nodejs-bigtable into 3527322442-refactor-the-test-into-classes-4

# Conflicts:
#	test/readrows.ts
#	test/utils/readRowsImpl.ts
@danieljbruce danieljbruce marked this pull request as ready for review August 14, 2024 14:43
@danieljbruce danieljbruce requested review from a team as code owners August 14, 2024 14:43
@danieljbruce danieljbruce merged commit b2030b9 into 3527322442-to-main-2 Aug 19, 2024
@danieljbruce danieljbruce deleted the 3527322442-refactor-the-test-into-classes-4 branch August 19, 2024 14:40
danieljbruce added a commit that referenced this pull request Sep 23, 2024
* test: begin to refactor the mock service (#1447)

* Use prettyPrintRequest from readRowsImpl1

* Define interfaces for creating a Bigtable service

* Remove keyFrom and keyTo from each test

* Define the service inline for standard keys errors

* Add a comment about the refactor steps I am doing

* Add a header to the service parameters file

* Use the ChunkGeneratorParameters interface

* Simplify the diff by creating local variables

* Remove comment

* Eliminate chunks per response constant

* Change imports

* Replace with as ServerImplementationInterface

* Update test/readrows.ts

Co-authored-by: Leah E. Cole <[email protected]>

* Add a second test for an error at a random pos

* Add some comments for documentation

* Chunk generation - add the parameter

* Added comments to all the interfaces

* Fix a regression bug from the merge

---------

Co-authored-by: Leah E. Cole <[email protected]>

* test: Eliminate the second ReadRows Service and use a generalized version of the first ReadRows (#1457)

* Use prettyPrintRequest from readRowsImpl1

* Define interfaces for creating a Bigtable service

* Remove keyFrom and keyTo from each test

* Define the service inline for standard keys errors

* Add a comment about the refactor steps I am doing

* Add a header to the service parameters file

* Use the ChunkGeneratorParameters interface

* Simplify the diff by creating local variables

* Remove comment

* Eliminate chunks per response constant

* Change imports

* Set up the second ReadRows service to use params

* Remove duplicate copy of generate chunks from serv

* Remove second copy of isKeyInRowSet

* Eliminate duplicate copies of the debug log

* Fix a bug for the to and from service parameters

Only ignore keyFrom and keyTo when they are undefined and not just when they are Falsy.

* Add cancel back into the mock service for testing

* Add variables to match service 1

* Add one more check to match the other service

* Remove usages of ReadRows2Impl

* Remove the new service

The old service has been generalized enough to mock correct server behaviour.

* Moved the position of the comment for 150 rows

* Eliminate setting keyTo and keyFrom

they are undefined anyway.

* Add a second test for an error at a random pos

* Add some comments for documentation

* Chunk generation - add the parameter

* Added comments to all the interfaces

* Delete file

* Change splitted to split

* Remove export

* Don’t rename the interfaces

There is no point

* Increase Windows timeout

* Provide functions to eliminate if statements

* Eliminate the if statements

Make a direct call to generateChunksFromRequest

* Revert "Eliminate the if statements"

This reverts commit 0996e89.

* Revert "Provide functions to eliminate if statements"

This reverts commit 4a4761f.

* Change any’s to string | undefined

* Eliminate duplicate code for setting timeouts

* remove only

* Update test/readrows.ts

Co-authored-by: Leah E. Cole <[email protected]>

* Update test/readrows.ts

Co-authored-by: Leah E. Cole <[email protected]>

* Update test/readrows.ts

Co-authored-by: Leah E. Cole <[email protected]>

* Update test/readrows.ts

Co-authored-by: Leah E. Cole <[email protected]>

* Update test/readrows.ts

Co-authored-by: Leah E. Cole <[email protected]>

* Update test/readrows.ts

Co-authored-by: Leah E. Cole <[email protected]>

* Update test/readrows.ts

Co-authored-by: Leah E. Cole <[email protected]>

---------

Co-authored-by: Leah E. Cole <[email protected]>

* test: Eliminate repeated if statements in the ReadRows mock service reducing the size of it significantly (#1460)

* Use prettyPrintRequest from readRowsImpl1

* Define interfaces for creating a Bigtable service

* Remove keyFrom and keyTo from each test

* Define the service inline for standard keys errors

* Add a comment about the refactor steps I am doing

* Add a header to the service parameters file

* Use the ChunkGeneratorParameters interface

* Simplify the diff by creating local variables

* Remove comment

* Eliminate chunks per response constant

* Change imports

* Set up the second ReadRows service to use params

* Remove duplicate copy of generate chunks from serv

* Remove second copy of isKeyInRowSet

* Eliminate duplicate copies of the debug log

* Fix a bug for the to and from service parameters

Only ignore keyFrom and keyTo when they are undefined and not just when they are Falsy.

* Add cancel back into the mock service for testing

* Add variables to match service 1

* Add one more check to match the other service

* Remove usages of ReadRows2Impl

* Remove the new service

The old service has been generalized enough to mock correct server behaviour.

* Moved the position of the comment for 150 rows

* Eliminate setting keyTo and keyFrom

they are undefined anyway.

* Add a second test for an error at a random pos

* Add some comments for documentation

* Chunk generation - add the parameter

* Added comments to all the interfaces

* Group the property getter into a function

* Group key selection into functions

* Fix typo: default key

* Documentation for isInRowSet

* Eliminate variable - move function inline

* Omit optional selector on stream

* Create ReadRowsWritableStream interface

* Use new interface, remove ServerWritableStream

* Don’t pass the whole stream into helpers

* Add a function for generating the chunks

* The debug log should be a pass through parameter

* Solve compiler errors resulting immediately from

merge

* Add debugLog parameter to various functions

* Add return type

* Remove exports - functions are only used in this

module

* Revise merge correction

* Remove TODO for the stream type

* Update the getKeyValue function

* Eliminate place where debug log is needed

* Run linter

* test: Break the ReadRows service down into classes instead of a single long function (#1461)

* Use prettyPrintRequest from readRowsImpl1

* Define interfaces for creating a Bigtable service

* Remove keyFrom and keyTo from each test

* Define the service inline for standard keys errors

* Add a comment about the refactor steps I am doing

* Add a header to the service parameters file

* Use the ChunkGeneratorParameters interface

* Simplify the diff by creating local variables

* Remove comment

* Eliminate chunks per response constant

* Change imports

* Set up the second ReadRows service to use params

* Remove duplicate copy of generate chunks from serv

* Remove second copy of isKeyInRowSet

* Eliminate duplicate copies of the debug log

* Fix a bug for the to and from service parameters

Only ignore keyFrom and keyTo when they are undefined and not just when they are Falsy.

* Add cancel back into the mock service for testing

* Add variables to match service 1

* Add one more check to match the other service

* Remove usages of ReadRows2Impl

* Remove the new service

The old service has been generalized enough to mock correct server behaviour.

* Moved the position of the comment for 150 rows

* Eliminate setting keyTo and keyFrom

they are undefined anyway.

* Add a second test for an error at a random pos

* Add some comments for documentation

* Chunk generation - add the parameter

* Added comments to all the interfaces

* Group the property getter into a function

* Group key selection into functions

* Fix typo: default key

* Documentation for isInRowSet

* Eliminate variable - move function inline

* Omit optional selector on stream

* Create ReadRowsWritableStream interface

* Use new interface, remove ServerWritableStream

* Don’t pass the whole stream into helpers

* Add a function for generating the chunks

* The debug log should be a pass through parameter

* Add some TODOs about how to address this next

* Pull send response into a class

* Create a dedicated class for defining the service

* Change name to readRowsRequestHandler

* Pull the function that generates the chunks into

Separate module

* Generate documentation

* Add more documentation to the Service class

* Add debugLog as a method parameter

* Solve compiler errors resulting immediately from

merge

* Add debugLog parameter to various functions

* Add return type

* Remove exports - functions are only used in this

module

* Revise merge correction

* Remove TODO for the stream type

* Update the getKeyValue function

* Eliminate place where debug log is needed

* Run linter

* Eliminate the function that creates a service

Add a factory method instead

* Add documentation for the constructor

* Remove the TODO

* Set the timeout for the test

* Increase the timeout

* Eliminate ternary statement

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* Add a couple of comments

* re-write the ternary expression

---------

Co-authored-by: Leah E. Cole <[email protected]>
Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

api: bigtable Issues related to the googleapis/nodejs-bigtable API. size: m Pull request size is medium.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants