-
Notifications
You must be signed in to change notification settings - Fork 40
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.
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
[RTL13] Fix existing impl. for server sent DETACH #1054
base: main
Are you sure you want to change the base?
Conversation
WalkthroughThe pull request modifies the Changes
Assessment against linked issues
Poem
Tip CodeRabbit's docstrings feature is now available as part of our Early Access Program! Simply use the command 📜 Recent review detailsConfiguration used: CodeRabbit UI 📒 Files selected for processing (2)
🔇 Additional comments (12)lib/src/main/java/io/ably/lib/realtime/ChannelBase.java (4)
The code properly checks if the connection state is
The code correctly throws an exception when the connection manager is not active during detachment, following specification RTL5g.
The code correctly calls the completion listener's error method when an exception occurs during detachment, in line with RTL5g.
The code correctly implements immediate reattachment upon receiving an unexpected lib/src/test/java/io/ably/lib/test/realtime/RealtimeChannelTest.java (8)
The import of
The comment appropriately references the specification RTL4g for the test method.
The JavaDoc comment specifies the relevant specification being tested.
The test method correctly references the corresponding specification.
The test method accurately verifies that detaching when the connection is in invalid states (
The comment correctly refers to the relevant specification for the test method. Line range hint The test method properly checks the channel's state transitions when a server-initiated
The test effectively verifies the channel's behavior upon receiving a Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media? 🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. CodeRabbit Commands (Invoked using PR comments)
Other keywords and placeholders
CodeRabbit Configuration File (
|
2479c47
to
e8cb69a
Compare
e8cb69a
to
9b46c4f
Compare
9b46c4f
to
9eb265b
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Actionable comments posted: 0
🧹 Nitpick comments (2)
lib/src/test/java/io/ably/lib/test/realtime/RealtimeChannelTest.java (2)
1739-1745
: Refactor state sequence assertions to improve test robustnessAsserting the exact size and order of
channelStates
can make the test brittle to future changes in state transitions. Consider verifying the sequence of key states without hardcoding their positions.Apply this diff to refactor the assertions:
- Assert.assertEquals(4, channelStates.size()); - Assert.assertEquals(ChannelState.attaching, channelStates.get(0)); - Assert.assertEquals(ChannelState.attached, channelStates.get(1)); - Assert.assertEquals(ChannelState.attaching, channelStates.get(2)); - Assert.assertEquals(ChannelState.attached, channelStates.get(3)); + List<ChannelState> expectedStates = Arrays.asList( + ChannelState.attaching, + ChannelState.attached, + ChannelState.attaching, + ChannelState.attached + ); + Assert.assertTrue(channelStates.containsAll(expectedStates));
1795-1802
: Refactor assertions to enhance test maintainabilityDirectly asserting the size and exact order of
channelStates
may lead to brittle tests. It's advisable to verify the presence and order of important states to make the test more resilient to future changes.Consider the following refactor:
- Assert.assertEquals(5, channelStates.size()); - Assert.assertEquals(ChannelState.attaching, channelStates.get(0)); - Assert.assertEquals(ChannelState.attached, channelStates.get(1)); - Assert.assertEquals(ChannelState.suspended, channelStates.get(2)); - Assert.assertEquals(ChannelState.attaching, channelStates.get(3)); - Assert.assertEquals(ChannelState.attached, channelStates.get(4)); + List<ChannelState> expectedStates = Arrays.asList( + ChannelState.attaching, + ChannelState.attached, + ChannelState.suspended, + ChannelState.attaching, + ChannelState.attached + ); + Assert.assertTrue(channelStates.containsAll(expectedStates));
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (2)
lib/src/main/java/io/ably/lib/realtime/ChannelBase.java
(2 hunks)lib/src/test/java/io/ably/lib/test/realtime/RealtimeChannelTest.java
(3 hunks)
🔇 Additional comments (5)
lib/src/main/java/io/ably/lib/realtime/ChannelBase.java (2)
247-248
: Appropriate handling of connection states during attach
The added check for ConnectionState.connecting
and ConnectionState.disconnected
ensures that the channel correctly handles attaching when the connection is in these states, enhancing robustness during state transitions.
1299-1304
: Correct reattach logic on unexpected DETACH in attached or suspended states
The implementation properly reattaches the channel when an unexpected DETACH is received while the channel is in the attached
or suspended
state, adhering to the specification RTL13a.
lib/src/test/java/io/ably/lib/test/realtime/RealtimeChannelTest.java (3)
29-29
: Added necessary import statements
The addition of org.junit.Assert
import statements supports the use of assertion methods in the test cases, ensuring code clarity and reducing the need for fully qualified class names.
Line range hint 1707-1751
: Comprehensive test for server-initiated DETACH in attached state
The new test server_initiated_detach_for_attached_channel
effectively verifies the channel state transitions when a server-initiated DETACH is received while the channel is attached, ensuring correct reattachment behavior as per RTL13a.
1753-1802
: Added test for server-initiated DETACH in suspended state
The new test server_initiated_detach_for_suspended_channel
correctly checks the channel's behavior upon receiving a server-initiated DETACH while in the suspended state, ensuring compliance with specification RTL13a.
1. Removed use of explicitly setting detached state 2. Fixed attachWithTimeout method call, set forcedAttach flag to true 3. Updated tests to track channel state changes on server sent DETACH
…RTL5g) 1. Added missing callCompletionListenerError when detachImpl throws exception on invalid connection state 2. Added separate test case for the spec RTL5g 3. Annotated channel detach tests with appropriate spec
9eb265b
to
a6bbcb2
Compare
DETACHED
event #1051Summary by CodeRabbit
New Features
Bug Fixes
Refactor