mica(雲母)
mica 由如夢技術內部的 lutool(擼禿)演變而來。lutool 誕生於 2017 年,受 jhipster 啓發逐步形成一個微服務的核心集。
因 lutool 名稱與功能不太符合,故在2019年開源時將其改名爲 mica(雲母),寓意爲雲服務的基石。
mica 2.x核心依賴
mica 基於 java 8,沒有歷史包袱,支持傳統 Servlet 和 Reactive(webflux)。採用 mica-auto 自動生成 spring.factories 和 spring-devtools.properties 配置,僅依賴 Spring boot、Spring cloud 全家桶,無第三方依賴。市面上鮮有的微服務核心組件。
依賴 | 版本 |
---|---|
Spring Boot | 2.2.x |
mica 2.0.1 更新說明
- :sparkles: 開源 mica-ip2region 組件。
- :zap: mica-core 優化 R.isNotSuccess 改爲 isFail。
- :bug: mica-redis jackson class info。
- :bug: mica-redis jackson findAndRegisterModules。
- :wrench: travis 替換爲 Github actions,用於構建和 Snapshot 版本自動發佈。
- :arrow_up: update spring boot to 2.2.7.RELEASE。
版本號說明
release
版本號格式爲 x.x.x.發版當然日期
,避免和內部的版本號衝突。
snapshots
版本號格式爲 x.x.x-SNAPSHOT
,snapshots
版每次提交後會自動構建。
引用
mica-bom,可以簡化依賴和依賴版本統一處理,避免jar衝突。
<dependencyManagement>
<dependencies>
<dependency>
<groupId>net.dreamlu</groupId>
<artifactId>mica-bom</artifactId>
<version>2.0.1.20200510</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
注意
:maven 是按先後順序進行依賴的,所以 mica-bom 順序按 mica
、spring boot
、spring cloud
依次添加。
mica-ip2region 最好用的 ip2region spring stater
maven
<dependency>
<groupId>net.dreamlu</groupId>
<artifactId>mica-ip2region</artifactId>
<version>${version}</version>
</dependency>
gradle
compile("net.dreamlu:mica-ip2region:${version}")
配置說明(已經內置,忽略)
配置項 | 默認值 | 說明 |
---|---|---|
mica.ip2region.db-file-location | classpath:ip2region/ip2region.db | ip2region.db 文件的地址,默認內置的文件 |
maven 自定義 ip2region.db 注意事項:
maven resources
拷貝文件是默認會做 filter
,會導致我們的文件發生變化,導致不能讀,pom
中你需要添加下面的配置。
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<configuration>
<nonFilteredFileExtensions>
<nonFilteredFileExtension>db</nonFilteredFileExtension>
</nonFilteredFileExtensions>
</configuration>
</plugin>
關於 ip2region
ip2region Gitee 源碼地址:https://gitee.com/lionsoul/ip2region
我們都會同步更新 ip2region.db
文件,一般不需要手動配置。
使用文檔
注入 bean
@Autowired
private Ip2regionSearcher regionSearcher;
方法說明
/**
* ip 位置 搜索
*
* @param ip ip
* @return 位置
*/
@Nullable
IpInfo memorySearch(long ip);
/**
* ip 位置 搜索
*
* @param ip ip
* @return 位置
*/
@Nullable
IpInfo memorySearch(String ip);
/**
* ip 位置 搜索
*
* @param ptr ptr
* @return 位置
*/
@Nullable
IpInfo getByIndexPtr(long ptr);
/**
* ip 位置 搜索
*
* @param ip ip
* @return 位置
*/
@Nullable
IpInfo btreeSearch(long ip);
/**
* ip 位置 搜索
*
* @param ip ip
* @return 位置
*/
@Nullable
IpInfo btreeSearch(String ip);
/**
* ip 位置 搜索
*
* @param ip ip
* @return 位置
*/
@Nullable
IpInfo binarySearch(long ip);
/**
* ip 位置 搜索
*
* @param ip ip
* @return 位置
*/
@Nullable
IpInfo binarySearch(String ip);
文檔
- 文檔地址(語雀-可關注訂閱):https://www.yuque.com/dreamlu
- 示例項目:https://github.com/lets-mica/mica-example
歡迎關注我們的公衆號:JAVA架構日記,精彩內容每日推送。