Nesting UseCase

UseCase can be nesting. It means that some UseCase execute other UseCase.

UseCase instance has this.context object that is same with Context instance.

For example, ParentUseCase -> ChildUseCase.

class ChildUseCase extends UseCase {
 execute() {
class ParentUseCase extends UseCase {
 execute() {
     const childUseCase = new ChildUseCase();
     // use `this.context` insteadof the instance of `Context`
     return this.context.useCase(childUseCase).execute();
const parentUseCase = new ParentUseCase();
const childUseCase = new ChildUseCase();
const dispatcher = new Dispatcher();
const context = new Context({
 store: new Store()
context.useCase(parentUseCase).execute().then(() => {
These UseCases are executed following order:  

- ParentUseCase: will execute
- ChildUseCase:  will execute
- ChildUseCase:  did execute
- ParentUseCase: did execute
- ChildUseCase:  complete
- ParentUseCase: complete

It is useful for transaction of application or Toggle UseCase(Play/PauseUseCase) etc...

UseCase of Nesting UseCase

For example, We already have AppUserFetchSearchResultUseCase that fetch the result of search with search word.

import { UseCase } from "almin";
export class AppUserFetchSearchResultUseCase extends UseCase {
        return fetch(`/search/${encodeURIComponent(searchWord)}`)
            .then(res => res.json())
            .then(json => {
               // update domain/repository/store... 

Additional, We want to add AppUserReloadSearchResultUseCase that fetch the result of current search word again and refresh view.

Nesting UseCase help you to reduce duplicated workflow.

import { UseCase } from "almin";
import { AppUserFetchSearchResultUseCase } from "./AppUserFetchSearchResultUseCase";

export class AppUserReloadSearchResultUseCase extends UseCase {
        const currentSearchWord = `<Need Implementation>get current word from repository...`;
        // invoke UseCase from AppUserReloadSearchResultUseCase
        return this.context.useCase(new AppUserFetchSearchResultUseCase())
            .then(() => {
                // do refresh logic

Almin's nesting UseCase represent extended use case in Use case diagram.

Related topics:

  • IncludeAndExtend
  • Error: file not found: /home/travis/build/almin/almin/docs/tips/https:/ "uml - What&#39;s is the difference between include and extend in use case diagram? - Stack Overflow"

FAQ: Should we use Nesting UseCase for reducing duplicated logic?

No. We should write logic to domain model and write workflow to UseCase. You should write the logic to domain model and reuse it in UseCases.

But, If you use transaction script, the answer is Yes.

results matching ""

    No results matching ""