{"id":19146510,"url":"https://github.com/kahsolt/akasha","last_synced_at":"2026-05-02T20:38:08.987Z","repository":{"id":113306677,"uuid":"116498519","full_name":"Kahsolt/Akasha","owner":"Kahsolt","description":"Hyperlight-weight pseudo-ORM framework for SQLite3, aimed to handle simple player data in Minecraft plugins.","archived":false,"fork":false,"pushed_at":"2020-08-14T03:14:04.000Z","size":15946,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-28T12:46:10.518Z","etag":null,"topics":["hypnos","lightweight","mysql","orm","sqlite","toy-project"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kahsolt.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-06T16:38:20.000Z","updated_at":"2020-08-14T03:14:06.000Z","dependencies_parsed_at":"2023-04-05T18:48:18.072Z","dependency_job_id":null,"html_url":"https://github.com/Kahsolt/Akasha","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Kahsolt/Akasha","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kahsolt%2FAkasha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kahsolt%2FAkasha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kahsolt%2FAkasha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kahsolt%2FAkasha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kahsolt","download_url":"https://codeload.github.com/Kahsolt/Akasha/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kahsolt%2FAkasha/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32549384,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T19:18:06.202Z","status":"ssl_error","status_checked_at":"2026-05-02T19:16:21.335Z","response_time":132,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["hypnos","lightweight","mysql","orm","sqlite","toy-project"],"created_at":"2024-11-09T07:44:22.767Z","updated_at":"2026-05-02T20:38:03.957Z","avatar_url":"https://github.com/Kahsolt.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Akasha\r\n---\r\n\r\n    Hyperlight-weight pseudo-ORM framework for SQLite3\r\n    Aimed to handle simple player data in Minecraft plugins\r\n\r\n## General\r\n  Akasha is a simplified and targeted version of [Hypnos](https://github.com/Kahsolt/Hypnos)\r\n  - Differences from Hypnos\r\n    - Support less data types, but faster when modelizing\r\n    - No foreign key support\r\n    - Only work in cached mode, so you can delay DB write\r\n  - Dependencies\r\n      - [SQLBuilder](https://github.com/Kahsolt/SQLBuilder)\r\n      - jdbc driver(sqlite/mysql)\r\n      - log4j\r\n  - Examples\r\n    - Code: tk/kahsolt/akasha/example/Player.java\r\n    - Output: run `java -jar Akasha.jar`\r\n  - IDE Builds\r\n    - Intellij artifact - JAR\r\n\r\n## Changelog\r\n  - v0.3\r\n```java\r\n/* 1.删除Cache注解及相关字段要求，只能通过objects.all()来取\r\n * 2.分离Manager和Model，Manger注解改名为ManagerEntry\r\n *   且如不显式定义Manager字段，也可通过模型类的实例来获取\r\n *     Manager objects = new User().objects();\r\n * 3.增加内部缓存，结果集ArrayList换为HasSet，优化了查询的速度\r\n * 4.增加一个事件钩子即onModelized()，用户可重载此方法\r\n *   以实现一些初始化工作\r\n */\r\n\r\npublic static HashMap\u003cUUID, Player\u003e players;\r\n\r\n@Override\r\npublic void onModelized() {\r\n    // 建一个Hash表方便按键查找\r\n    players = new HashMap\u003c\u003e();\r\n    for (Model player : Player.objects.all()) {\r\n        players.put(((Player)player).uuid, (Player) player);\r\n    }\r\n}\r\n```\r\n\r\n  - v0.2\r\n```java\r\n/* 1.支持启动时自动检测模型类字段的更改，自动向数据表增加新列。\r\n *   考虑安全性及向Sqlite兼容，不提供自动删除列和修改列数据类型的操作\r\n *   例如example.AutoColumn，每次增加一个字段后重启程序\r\n *   启动时Model.sqlize()会感应到字段增加，自动ALTER TABLE\r\n * 2.example.Pressure中进行了一些性能测试，看起来还不算太糟糕\r\n *   (毕竟没有LINQ操作集合就是很麻烦)\r\n */\r\n@FieldEntry\r\npublic Integer first;\r\n@FieldEntry(defaultValue = \"666\")\r\npublic Double then;\r\n@FieldEntry(length = -50)\r\npublic String yetAnother;\r\n@FieldEntry\r\npublic Timestamp lastone;\r\n```\r\n日志中可见如下记录：\r\n\r\n    2018-01-07 23:12:59 \u003cmain:0\u003e [INFO] Fresh start, sqlizing for model 'AutoColumn'.\r\n    2018-01-07 23:13:00 \u003cmain:780\u003e [INFO] Modelizing from table 'AutoColumn'.\r\n    2018-01-07 23:13:06 \u003cmain:0\u003e [INFO] Changes detected, add field 'then' to model 'AutoColumn'.\r\n    2018-01-07 23:13:06 \u003cmain:349\u003e [INFO] Modelizing from table 'AutoColumn'.\r\n    2018-01-07 23:13:12 \u003cmain:0\u003e [INFO] Changes detected, add field 'yetAnother' to model 'AutoColumn'.\r\n    2018-01-07 23:13:13 \u003cmain:332\u003e [INFO] Changes detected, add field 'lastone' to model 'AutoColumn'.\r\n\r\n  - v0.1\r\n    基本功能OK，参考下文Exmaple\r\n\r\n## Exmaple\r\n```java\r\n/*\r\n* 写法基本与Hypnos模型相同，但所有的filter方法都是操作本地的cache集合\r\n*/\r\npublic class Player extends Model {\r\n\r\n    @ManagerEntry\r\n    public static Player objects;\r\n\r\n    @FieldEntry(unique = true)\r\n    public UUID uuid;\r\n    @FieldEntry(length = 32)\r\n    public String nickname;\r\n    @FieldEntry(length = 64)\r\n    public String password;\r\n    @FieldEntry\r\n    public Integer level;\r\n    @FieldEntry\r\n    public Double money;\r\n    @FieldEntry\r\n    public Timestamp online_time;  // stands for a time period in seconds (getTime() makes sense)\r\n    @FieldEntry\r\n    public Timestamp birthday;     // stands for real datetime (toString() makes sense)\r\n    @FieldEntry(length = 0)\r\n    public String info_struct;     // a structured info string, parse it by yourself!\r\n\r\n    public Player() { }\r\n    public Player(String nickname, String password) { this.nickname = nickname; this.password = password; }\r\n\r\n    private void addItem(String item, int count) {\r\n        this.info_struct += String.format(\"%s:%d;\", item, count);\r\n    }\r\n\r\n    public static void main(String[] args) {\r\n        Akasha akasha = new Akasha();\r\n        akasha.register(Player.class);\r\n        akasha.start();\r\n\r\n        new Player(\"kahsolt\", \"meow-pass\").save();\r\n        new Player(\"luper\", \"A-ha?\").save();\r\n\r\n        // 更多filter请参考example.Pressure\r\n        ArrayList\u003cModel\u003e res = Player.objects.filterLike(\"password\", \"-\").getResults();\r\n        for (Model model : res) {\r\n            System.out.println(model);\r\n        }\r\n\r\n        Player me = (Player)Player.objects.get(\"nickname\", \"kahsolt\");\r\n        if(me!=null) System.out.println(\"我找到你啦！\");\r\n        // 处理简单标量\r\n        me.uuid = UUID.randomUUID();\r\n        me.level = 666;\r\n        me.money = 2.3333;\r\n        me.online_time = new Timestamp(123456789L);\r\n        // 处理日期\r\n        Calendar cal = Calendar.getInstance();\r\n        cal.set(2007, Calendar.APRIL,1);\r\n        me.birthday = new Timestamp(cal.getTime().getTime());\r\n        // 处理结构化字符串\r\n        me.info_struct = \"bread:5;stone:20;\";\r\n        me.addItem(\"coal\", 10); // me.removeItem(\"gold\", 5); 自己解析字符串我懒得写了:)\r\n        me.save();\r\n        System.out.println(me);\r\n\r\n        me.remove();\r\n\r\n        akasha.stop();\r\n    }\r\n}\r\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkahsolt%2Fakasha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkahsolt%2Fakasha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkahsolt%2Fakasha/lists"}