{"id":21152694,"url":"https://github.com/darjun/event-manager","last_synced_at":"2025-07-09T10:33:01.882Z","repository":{"id":47702538,"uuid":"124390566","full_name":"darjun/event-manager","owner":"darjun","description":"event manager for decoupling systems.","archived":false,"fork":false,"pushed_at":"2018-03-11T03:06:41.000Z","size":6,"stargazers_count":14,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-04T22:11:16.740Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/darjun.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-03-08T12:48:14.000Z","updated_at":"2024-10-31T04:46:57.000Z","dependencies_parsed_at":"2022-09-23T17:12:37.179Z","dependency_job_id":null,"html_url":"https://github.com/darjun/event-manager","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/darjun/event-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darjun%2Fevent-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darjun%2Fevent-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darjun%2Fevent-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darjun%2Fevent-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/darjun","download_url":"https://codeload.github.com/darjun/event-manager/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darjun%2Fevent-manager/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264440370,"owners_count":23608699,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-20T10:45:45.918Z","updated_at":"2025-07-09T10:33:01.604Z","avatar_url":"https://github.com/darjun.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EventManager\n---------\n\n欢迎使用EventManager，一个非常简单易用的事件分发器。\n\n### 背景\n在游戏开发过程中，经常遇到这样一个问题。现在我们有几个系统任务系统，成就系统，这两个系统都需要处理玩家击杀怪物的事件。通常的做法就是在击杀怪物的处理函数中调用这个两个系统的对应接口，如下：\n```\n// Battle.cpp\nvoid KillMonster(Player* player, Monster* monster)\n{\n    ...\n    player-\u003eGetTaskMgr().OnKillMonster(monster);\n    player-\u003eGetAchievementMgr().OnKillMonster(monster);\n}\n```\n\n然后在对应接口中做各自的计数，状态变更等等等等。\n\n某个时刻，来了一个新的需求，策划需要做一个活动，也需要处理这个事件。那么除了活动代码中需要增加接口`OnKillMonster`，`Battle.cpp`还需要做以下修改：\n```\n// Battle.cpp\nvoid KillMonster(Player* player, Monster* monster)\n{\n    ...\n    player-\u003eGetTaskMgr().OnKillMonster(monster);\n    player-\u003eGetAchievementMgr().OnKillMonster(monster);\n    player-\u003eGetActivityMgr().OnKillMonster(monster);\n}\n```\n\n代码耦合度太高！\n\n### 使用EventManager\n\n我使用`C++`编写了这个`EventManager`。我们需要在`Event.h`中定义对应的事件：\n```\nstruct KillMonsterEvent\n{\n    Monster* monster;\n};\n```\n\n然后在`KillMonster`处理中发出这个事件:\n```\n// Battle.cpp\nvoid KillMonster(Player* player, Monster* monster)\n{\n    ...\n    KillMonsterEvent event{monster};\n    FIRE_EVENT(event);\n}\n```\n\n这个函数中的代码编写完成之后，今后不管什么功能需要这个事件，都不需要再来修改这个函数了。新增系统的处理：\n```\n// ActivityMgr.cpp\nclass ActivityMgr\n{\npublic:\n    ActivityMgr()\n    {\n        REGISTER_EVENT(\u0026ActivityMgr::OnKillMonster, this);\n    }\n\n    void OnKillMonster(Monster* monster)\n    {\n        // ...\n    }\n};\n```\n\n功能与功能之间解耦了。随着时间的推移，积累的事件越来越多，编写程序越来越方便。\n\n现在只有在添加新的事件时，需要修改对应位置的代码。\n\n详细用法查看`test.cpp`文件。\n\n### 实现细节\n\n* 非线程安全。\n* 多个相同事件的处理函数调用顺序不定。\n* `Any`类这里是自己实现的。实现参考祁 宇的《深入应用C++11：代码优化与工程级应用》一书。当然也可以使用`Boost`的`Any`库。\n* 实现了一个简单的单例`Singleton`。\n* 定义注册与发出事件的宏`REGISTER_EVENT`和`FIRE_EVENT`，方便使用。\n\n### 要求\n\n* 需要支持`C++11`的编译器。编译器支持情况可以看[这里](http://zh.cppreference.com/w/cpp/compiler_support)。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarjun%2Fevent-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdarjun%2Fevent-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarjun%2Fevent-manager/lists"}