{"id":15294791,"url":"https://github.com/v2hoping/flymock","last_synced_at":"2026-02-08T02:05:34.370Z","repository":{"id":37166923,"uuid":"174465072","full_name":"v2hoping/flymock","owner":"v2hoping","description":"flymock is a convenient Java library that can generate mock data directly from class","archived":false,"fork":false,"pushed_at":"2022-06-17T02:11:50.000Z","size":151,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-29T22:52:08.442Z","etag":null,"topics":["java","json","mock","object","springboot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/v2hoping.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-03-08T03:48:55.000Z","updated_at":"2020-04-03T08:29:40.000Z","dependencies_parsed_at":"2022-09-10T21:51:28.942Z","dependency_job_id":null,"html_url":"https://github.com/v2hoping/flymock","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/v2hoping/flymock","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v2hoping%2Fflymock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v2hoping%2Fflymock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v2hoping%2Fflymock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v2hoping%2Fflymock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/v2hoping","download_url":"https://codeload.github.com/v2hoping/flymock/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v2hoping%2Fflymock/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29217763,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-08T00:10:47.190Z","status":"online","status_checked_at":"2026-02-08T02:00:07.642Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["java","json","mock","object","springboot"],"created_at":"2024-09-30T17:06:59.010Z","updated_at":"2026-02-08T02:05:34.345Z","avatar_url":"https://github.com/v2hoping.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[English](https://github.com/v2hoping/flymock/blob/master/doc/english/Readme.md)|[中文](https://github.com/v2hoping/flymock/blob/master/README.md)\n\n# flymock\n\nflymock是一个可以将类直接生成模拟数据对象的java类库。它还可以将类转换为模拟数据模板，再由模拟数据模板生成JSON数据。flymock可以支持广泛的java类型，包含基本类型、复杂对象、泛型、枚举、嵌套泛型等。同时支持字段生成策略和多种占位符。\n\n## Flymock目标\n\n* 提供直接由类型生成模拟Java对象，减少单元测试中new对象和设置值\n* 提供简单的template()和mock()方法，由类型转换为模拟数据模板和由类型直接转为模拟Java对象\n* 广泛的支持Java类型，包括Java泛型\n* 支持7种格式生成规则\n* 支持多样的占位符，例如@cparagraph()、@email()、@ip()、@province()，允许自定义占位符，可通过@FiledMock注解快速设置\n* 支持任意复杂的对象(包括深层嵌套和泛型嵌套、数组)\n* 支持字段全局模拟规则，可根据组织情况，定义个性化、真实性高的模拟数据(X)\n\n## Spring-boot-starter-flymock目标\n\n* 提供SpringBoot starter，与SpringBoot快速集成\n* 提供@EnableFlyMock和spring.fly.mock.enable参数来开关Stater\n* 基于SpringBoot Aop提供和@FlyMock注解，支持拦截类、拦截方法返回模拟Java对象\n\n## Maven Setting\n\n```xml\n\u003cdependency\u003e\n   \u003cgroupId\u003ecom.v2hoping\u003c/groupId\u003e\n   \u003cartifactId\u003eflymock\u003c/artifactId\u003e\n   \u003cversion\u003e0.1.1\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n```xml\n\u003cdependency\u003e\n   \u003cgroupId\u003ecom.v2hoping\u003c/groupId\u003e\n   \u003cartifactId\u003espring-boot-starter-flymock\u003c/artifactId\u003e\n   \u003cversion\u003e0.1.1\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## 转换关系\n\nJava类型------\u003eJava模板数据------\u003eJSON数据\u003c------\u003eJava对象\n\n## 用法\n\n**Java类型生成Java对象**\n\n```java\n//基本类型,举例：Integer\nInteger integerValue = TemplateMock.mock(new TypeReference\u003cInteger\u003e() {});\n```\n\n```java\n//嵌套复杂对象,举例：User\nUser userValue = TemplateMock.mock(new TypeReference\u003cUser\u003e() {});\n```\n\n```java\n//泛型对象，举例：List\u003cStirng\u003e\nList\u003cString\u003e listTValues = TemplateMock.mock(new TypeReference\u003cList\u003cString\u003e\u003e() {});\n```\n\n```java\npublic class User {\n    private String name;\n\n    private List\u003cEducation\u003e educations;\n\n    public String getName() {\n        return name;\n    }\n\n    public void setName(String name) {\n        this.name = name;\n    }\n\n    public List\u003cEducation\u003e getEducations() {\n        return educations;\n    }\n\n    public void setEducations(List\u003cEducation\u003e educations) {\n        this.educations = educations;\n    }\n\n    public static class Education {\n        /**\n         * 教育名称\n         */\n        private String name;\n\n        /**\n         * 教育时间\n         */\n        private Date date;\n\n        public String getName() {\n            return name;\n        }\n\n        public void setName(String name) {\n            this.name = name;\n        }\n\n        public Date getDate() {\n            return date;\n        }\n\n        public void setDate(Date date) {\n            this.date = date;\n        }\n    }\n}\n```\n\n**Java类型生成JSON数据**\n\n```java\nString userJson = TemplateMock.json(new TypeReference\u003cUser\u003e() {});\n```\n\n**Java类型生成Java模板**\n\n```java\nTemplate\u003cUser\u003e template = TemplateMock.template(new TypeReference\u003cUser\u003e() {});\n```\n\n**Java模板生成JSON数据**\n\n```java\nString userJson = template.mockToJson();\n```\n\n**Java模板生成Java对象**\n\n```java\nUser user = template.mockType();\n```\n\n**Java模板字符串生成Java对象**\n\n```java\nString infoTemplateJson = \"{\\\"name\\\":\\\"@string()\\\",\\\"educations\\\":[{\\\"date\\\":1557457171390,\\\"name\\\":\\\"vhJ\\\"}]}\";\nTemplate\u003cUser\u003e template = new Template\u003c\u003e(infoTemplateJson, new TypeReference\u003cUser\u003e(){});\nUser user = template.mockType();\n```\n\n**设置生成策略和占位符**\n\n```java\npublic class Room {\n    \n    @FiledMock(strategy = \"2\", value = \"邮箱是:@email()\")\n    private String name;\n\n    public String getName() {\n        return name;\n    }\n\n    public void setName(String name) {\n        this.name = name;\n    }\n}\n\nTemplate\u003cRoom\u003e template = TemplateMock.template(new TypeReference\u003cRoom\u003e() {});\nRoom user = template.mockType();//{\"name\":\"邮箱是:ahu@163.com邮箱是:ahu@163.com\",\"educations\":[{\"date\":1557454313538,\"name\":\"nz8k\"}]}\n```\n\n**自定义占位符**\n\n```java\npublic static class MoviePlaceholderHandle extends AbstractPlaceholderHandle\u003cString\u003e {\n\n    @Override\n    public String invoke(PlaceholderWrap placeholderWrap) {\n        List\u003cString\u003e args = placeholderWrap.getArgs();\n        if(args.size() == 0) {\n            return  \"《钢铁侠》\";\n        }else{\n            return  \"《钢铁侠\" + args.get(0) +\"》\";\n        }\n    }\n\n    @Override\n    public String key() {\n        return \"movie\";\n    }\n}\n\nMock.put(new MoviePlaceholderHandle());\n```\n\n```java\npublic class Info {\n\n    @FiledMock(strategy = \"2\", value = \"电影是:@movie(2)\")\n    private String name;\n\n    public String getName() {\n        return name;\n    }\n\n    public void setName(String name) {\n        this.name = name;\n    }\n}\n\nTemplate\u003cInfo\u003e template = TemplateMock.template(new TypeReference\u003cInfo\u003e() {});\nInfo user = template.mockType();//{\"name\":\"电影是:《钢铁侠2》电影是:《钢铁侠2》\",\"educations\":[{\"date\":1557456720233,\"name\":\"wdDK9\"}]}\n```\n\n## Spring-boot-starter-flymock用法\n\n**开启starter**\n\n```java\n@SpringBootApplication\n@ComponentScan(basePackages = {\"com.hoping\"})\n@EnableFlyMock\npublic class Application {\n    public static void main(String[] args) {\n        SpringApplication.run(Application.class, args);\n    }\n}\n```\n\n**拦截并模拟类的所有方法返回值**\n\n```java\n@Component\n@FlyMock\npublic class SomeMethod {\n\n    public String sayString() {\n        return null;\n    }\n\n    public User sayUser() {\n        return null;\n    }\n}\n\nString str = someMethod.sayString();\nUser user = someMethod.sayUser();\n```\n\n**拦截并模拟单个方法返回值**\n\n```java\n@Component\npublic class SomeMethod {\n\n    public String sayString() {\n        return null;\n    }\n\n    @FlyMock\n    public User sayUser() {\n        return null;\n    }\n}\n\nUser user = someMethod.sayUser();\n```\n\n**SpringBoot自定义占位符**\n\n```java\n@Component\npublic static class MoviePlaceholderHandle extends AbstractPlaceholderHandle\u003cString\u003e {\n\n    @Override\n    public String invoke(PlaceholderWrap placeholderWrap) {\n        List\u003cString\u003e args = placeholderWrap.getArgs();\n        if(args.size() == 0) {\n            return  \"《钢铁侠》\";\n        }else{\n            return  \"《钢铁侠\" + args.get(0) +\"》\";\n        }\n    }\n\n    @Override\n    public String key() {\n        return \"movie\";\n    }\n}\n```\n\n## 更多文档\n\n- [数据模板定义规范](doc/cn/placeholder.md)\n- [默认支持占位符](doc/cn/standard.md)\n- [配置文件](doc/cn/config.md)\n- [更新日志](doc/cn/log.md)\n\n## 感谢 \u0026 贡献者\n\nFlyMock参考了Mock.js，模板JSON规范基本互相支持(不完全相同)，可以看做是java版本的增强和扩展.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv2hoping%2Fflymock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fv2hoping%2Fflymock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv2hoping%2Fflymock/lists"}