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 全家桶，无第三方依赖。市面上鲜有的微服务核心组件。

mica 2.0.1 更新说明

• ✨ 开源 mica-ip2region 组件。

• ⚡️ mica-core 优化 R.isNotSuccess 改为 isFail。

• 🐛 mica-redis jackson class info。

• 🐛 mica-redis jackson findAndRegisterModules。

• 🔧 travis 替换为 Github actions，用于构建和 Snapshot 版本自动发布。

• ⬆️ 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}")

配置说明（已经内置，忽略）

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