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.

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

Clarification: can a service be registered/unregistered more than once? #264

Closed
angusholder opened this issue Nov 14, 2022 · 5 comments
Closed

Comments

@angusholder
Copy link

I'm trying to write something equivalent to val ViewModel.viewModelScope: CoroutineScope:

class FooViewModel : ScopedServices.Registered {
    private val serviceScope = CoroutineScope(SupervisorJob() + Dispatchers.Main.immediate)

    override fun onServiceRegistered() {
    }

    override fun onServiceUnregistered() {
        serviceScope.cancel()
    }
}

Am I correct in thinking that once unregistered, the service is destroyed and that instance won't ever be reused? So onServiceRegistered and onServiceUnregistered only ever get called once each?

Another question; with Jetpack ViewModel, I often have a loadInitialData() method that I call from Fragment.onViewCreated, because I'd rather not kick off database calls/network calls from the constructor, it feels hacky and is not nice for testing. onServiceRegistered looks ideal for kicking off initial data loading, would you recommend that?

@Zhuinden
Copy link
Owner

Zhuinden commented Nov 14, 2022

Am I correct in thinking that once unregistered, the service is destroyed and that instance won't ever be reused?

Back in Simple-Stack 1.x there was a "bug" (design oversight) caused by how re-registering the same instance would call onEnterScope() to run multiple times, 2,x exists specifically because this section was heavily reworked to ensure that 1 object is tracked only once per registration.

So even if the same instance is added in multiple scopes, it would only have onServiceRegistered called when 0 -> 1, and onServiceUnregistered() only called when 1 -> 0, but not later.

Therefore, unless you cache these poor objects in some singleton and "re-add the same instance" again, then these callbacks are ensured to be only called once. If the object is instantiated along with the scope as is done in the samples in bindServices(), then they are definitely only called once.

TL;DR:

Am I correct in thinking that once unregistered, the service is destroyed and that instance won't ever be reused? So onServiceRegistered and onServiceUnregistered only ever get called once each?

Yes

Another question; with Jetpack ViewModel, I often have a loadInitialData() method that I call from Fragment.onViewCreated, because I'd rather not kick off database calls/network calls from the constructor, it feels hacky and is not nice for testing. onServiceRegistered looks ideal for kicking off initial data loading, would you recommend that?

Yes

😉


btw, if the class is instantiated "from a scope" as it would happen from a Backstack, then onServiceRegistered and co. is invoked by Backstack normally. All unit tests in simple-stack are unit tests, so all scoping logic and "scoped service lifecycle management" is unit-testable.

@angusholder
Copy link
Author

Okay, that's helpful thank you. Want me to make a PR to add that info onto onServiceRegistered/onServiceUnregistered?

@Zhuinden
Copy link
Owner

Hmm, there is already a comment like so:

    /**
     * When a service implements {@link Registered}, then it will receive a callback when the service has been registered to at least one scope.
     */
    public static interface Registered {
        /**
         * Called when the service has been registered to any scopes, and this is the first scope it was registered to.
         */
        void onServiceRegistered();

        /**
         * Called when the service is no longer registered in any scopes.
         */
        void onServiceUnregistered();
    }

Although if it's not actually lcear, then it can be useful. It also doesn't really mention how onServiceRegisterd runs after fromBundle.

@Zhuinden
Copy link
Owner

Zhuinden commented Jan 2, 2023

I will consider this solved.

@Zhuinden Zhuinden closed this as completed Jan 2, 2023
@Zhuinden Zhuinden added the done label Jan 2, 2023
@angusholder
Copy link
Author

Sorry I didn't get back to you, yeah I think it's fine

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants