1.MASA Framework源码解读-01 MASAFacotry工厂设计（一个接口多个实现的源码最佳姿势）
2.HUSTOJ出现RuntimeError,正确姿势。
3.Jenkins集成GitLab的正确姿势正确姿势，实现Git代码提交触发CI/CD
4..NET Dapper的源码正确使用姿势
5.何为SourceMap？讲讲SourceMap食用姿势
6.玩转SpringBoot配置文件yml的正确打开姿势

MASA Framework源码解读-01 MASAFacotry工厂设计（一个接口多个实现的最佳姿势）

       闲来无事，偶然接触到了MASA Framework，正确姿势此框架是源码MASA Stack系列中专门用于构建web系统的开源框架。通过在几个小型项目中的正确姿势应用内测平台源码应用，我发现它确实拥有诸多优点。源码为深入理解其内部结构和设计思路，正确姿势我决定详细阅读MASA Framework的源码源代码，并记录整个阅读过程。正确姿势如有任何错误或疑问，源码还请各位指正。正确姿势

       MASA Framework是源码一个功能全面且易于扩展的框架，主要由三个部分组成：BuildingBlocks（抽象层）、正确姿势Contrib（BuildingBlocks的源码实现）以及Utils（工具库）。官方将BuildingBlocks称为构建块，实际上，这个层将日常开发中频繁使用到的功能抽象出来，如多租户、多语言、仓储、配置中心等，形成易于替换的接口，大大提高了框架的灵活性和可扩展性。

       MASA Framework包含个主要模块，几乎涵盖了日常开发所需的所有组件，从基础服务到高级功能应有尽有。这些模块协同工作，共同构建了一个强大且功能丰富的框架。

       让我们从MASA Framework的核心设计——构建工厂（MasaFactory）开始探讨。构建工厂在框架中起着至关重要的作用，它负责通过配置选项来创建不同实现的实例。在实际项目中，orbslam2 源码分析构建工厂设计用于解决接口具有多种实现时的依赖注入问题，比如在面对多实现的场景时，如何优雅地注入并使用特定的实现类。以下是构建工厂解决多实现问题的具体步骤：

       首先，通过下载MASA Framework的源码（地址：github.com/masastack/MA...）进行研究。我们首先关注的是Masa.BuildingBlocks.Data.Contracts类库的设计。MASA Framework的构建工厂通过选项配置，允许为接口的每个实现类指定一个简短的名称。根据传入的不同名称，构建工厂类的Create方法能够创建对应的实例。

       通过使用MASA Framework的构建工厂，我们能够轻松地创建与特定名称对应的面单消息转换类，而无需依赖于IEnumerable集合进行复杂的筛选。这种方法在实现多实现场景时明显更加直观且高效。

       以物流面单申请为例，不同销售订单对应不同的商家店铺，而每个商家店铺可能选择不同的物流商。利用MASA Framework构建工厂实现不同物流商的面单申请，不仅简化了开发过程，而且在使用层面保持了无感的效果。

       总结而言，MASA Framework提供了强大的构建工厂设计，以解决多实现接口的依赖注入问题，简化了开发流程。这个设计不仅限于构建工厂模块，其他模块同样采用了类似的设计理念，允许用户根据需要替换官方实现或结合自定义实现，以适应不同场景和需求。

       MASA Framework的其他模块同样采用了构建工厂的设计，用户既可以替换官方实现，也可以在程序内同时共存官方实现和自定义实现。例如，快3投注平台 源码Service Caller模块不仅支持使用dapr的服务调用，还提供了HTTP服务调用等选项。

HUSTOJ出现RuntimeError,正确姿势。

       在遇到HUSTOJ的RuntimeError时，特别是在位Linux环境中安装Java或类似情况下，可能会遇到系统调用不允许的报错，如"Runtime Error: [ERROR] A Not allowed system call: runid: CALLID:"。解决此类问题的关键在于管理员级别的操作。

       首先，需要查看对应系统的judge_client源代码。在core/judge_client目录下，查找okcall.h（如果是位系统则找okcall.h）。在这个文件中，找到一个以J（代表Java）开始的数组，如`int LANG_JV[] = { 0, ..., 0}`。将报错信息中的CALLID（例如）插入到数组的首尾两个0之间，变成`int LANG_JV[] = { 0, , ..., 0}`。

       然后，重新编译并覆盖judge_client到`/usr/bin/judge_client`，通过在core目录下执行`sudo bash make.sh`。如果仍有新的错误，继续此过程，直到错误消失。

       若嫌逐个查找麻烦，可以尝试使用debug模式和采样模式运行，如`sudo judge_client 0 /home/judge debug J`，这将输出一个包含LANG_JV数组的值。将这些值整合到okcalls.h或okcalls.h中即可。

       务必使用openjdk-7-jdk作为Java编译器，通过`sudo apt-get install openjdk-7-jdk`安装。Pascal编译器则使用`sudo apt-get install fp-compiler`。注意，android ui模板源码下载HUSTOJ只支持`.in`和`.out`文件，不支持`.ans`文件。

       以上步骤提供了修复RuntimeError的解决方案，如果想了解背后的原理，请查阅相关文档。

Jenkins集成GitLab的正确姿势，实现Git代码提交触发CI/CD

       为了实现Jenkins与GitLab之间的集成，以便在Git代码提交时触发CI/CD流程，我们需遵循以下步骤。首先，安装GitLab插件。

       在配置Jenkins服务器时，创建GitLab凭证，并将其填充到“Manage Jenkins->System->enable authentication for '/project' end-point”中。此配置为Jenkins job提供了访问GitLab的凭证，在Jenkinsfile中使用该凭证。

       创建Jenkins job，选择源代码管理为Git，填写GitLab上源码仓库地址。设置构建触发器为“Build when a change is pushed to GitLab”，并获取GitLab webhook URL。在高级设置中，允许特定分支的构建，并生成用于防止他人触发Jenkins的回调URL的token。

       当遇到高版本Jenkins的错误时，可修改配置以关闭防跨站点请求伪造（CSRF）保护。在容器中，编辑Jenkins.sh脚本，在执行java命令前添加参数-Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION=true。

       配置GitLab webhook以接收代码提交通知。在GitLab repo的Settings-Integrations中，填写生成的android 各版本源码URL和Secret Token，点击“Add webhook”。检查Jenkins是否有自动构建记录。

       为了在GitLab上查看Jenkins job的执行状态，需要在上述步骤的基础上进行额外配置。确保Jenkins与GitLab之间的集成完全运行并正常接收代码提交事件。参考文档以获取详细说明。

.NET Dapper的正确使用姿势

       高性能、易排查、易运维、灵活可控是.NET Dapper的显著优点。

       与Entity Framework相比，Dapper依赖手动编写SQL语句，这在修改数据库结构时可能不易发现错误。但通过单元测试和细心操作可以避免这类问题。

       数据库连接的管理需视情况而定：主动管理需手动控制连接打开与关闭，而自动管理则由Dapper自行负责。GitHub上的源码提供具体实现细节。

       ADO.NET默认配置了连接池，但使用Dapper时可能出现连接池超出最大限制的情况。解决方案是确保连接的正确打开和关闭。

       批量操作如新增、修改、删除数据时，可利用参数化和IN语法优化。

       在Dapper中，通过C#语法优势，可以简化IF条件语句的编写。例如，可以使用字符串拼接方式进行操作，提升代码可读性。

       事务处理在Dapper中不如EF便捷。通过标记特性，实现方法自动开启和提交事务，简化代码结构。需要借助Nuget包Autofac实现。

       SQL监控是Dapper的一个关键功能，MiniProfiler是一个强大的工具，可用于检测和性能监控，支持多种数据库。通过Nuget包MiniProfiler.AspNetCore实现监控。

       完整源码示例可从GitHub链接获取，具体实现细节在文末提供。

何为SourceMap？讲讲SourceMap食用姿势

       在前端开发中，我们经常面临代码错误定位的问题。尽管打包后的代码难以直接阅读，但神奇的是，我们仍能在控制台找到问题的根源。这一切得益于幕后英雄——source map。它是一种机制，帮助我们在编译和压缩后的代码中追溯到原始代码的位置。

       source map的工作原理是通过生成一份映射文件，将编译后的代码与原始代码建立起对应关系。举个例子，当你使用babel编译代码时，会同时生成一份包含原始信息的.sourcemap文件。这个文件中，如names数组、mappings字段等属性记录了代码转换过程中的详细映射，包括原始代码的行号和字符位置。

       生成source map的过程涉及对原始代码和编译后的代码进行一一对应，记录下每个编译后的代码片段在原始代码中的位置。通过一系列的优化，如省去行号、使用分隔符和VLQ编码等技术，使得这个映射文件尽可能地紧凑。

       在webpack等打包工具中，devtool属性决定如何生成和处理source map。常见的模式有source-map、inline-source-map、eval-source-map等，各有优缺点。开发环境中推荐使用eval-source-map，它提供了原始代码的可见性；生产环境则倾向于hidden-source-map，以保护源代码隐私。

       source map的精度有时可能会受到影响，这可能是由于打包过程中的配置问题或者在某些模式下牺牲了一些信息。一旦遇到定位不准，尝试调整devtool模式或检查打包过程中的代码转换设置通常能解决问题。

玩转SpringBoot配置文件yml的正确打开姿势

       标题：配置文件yml的正确打开姿势

       在SpringBoot时代，配置文件的管理发生了根本性变革，yml文件因其独特的优势成为配置管理的首选。从XML到注解，再到yml，配置方式经历了从复杂到简洁的转变。

       首先，yml文件以其二维结构化、层次分明、清晰直观的特点，相比传统的properties文件在配置管理上更加高效。其格式支持多种配置样式，包括List、Map、List套List、List套Map、Map套Map以及Map套List等，满足了不同场景下的配置需求。

       其次，yml配置文件的存储方式与SpringBoot的Environment概念紧密相连。yml文件的多维结构需要被转换为简单的key-value形式，以适应Environment的存储需求，这个过程被称为“扁平化”。扁平化规则简单，通过点号（.）表示父子关系，中括号（[]）表示列表索引，使得yml内容能够被轻松整合到Environment中。

       直接从Environment中读取yml配置，或使用@Value注解访问配置值，虽然简单直接，但丢失了yml的结构化特征，且无法方便地获取复杂数据结构。为了充分利用yml的优势，SpringBoot推荐将配置映射为Java Bean，这种优雅的使用方式使得配置项与Bean属性之间能够完美对应，提高了代码可读性和可维护性。

       以游泳比赛的得分和奖品配置为例，yml中的列表和字典结构通过Java Bean中的List和Map类得到映射。在配置类上使用@ConfigurationProperties注解，定义了配置属性的结构，与Java Bean保持一致。通过@EnableConfigurationProperties注解引入配置属性，实现配置的自动绑定和注入，提高了开发效率和代码的可扩展性。

       使用SpringBoot推荐的方式，不仅简化了配置管理，还为开发人员提供了更好的IDE支持，比如智能提示等功能，使得开发过程更加顺畅。这种方式在SpringBoot框架内部源码中也得到了广泛应用，为开发者提供了可靠且高效的应用配置解决方案。

如何用正确的姿势监听Android屏幕旋转

       背景

       个人在忙碌的工作中，未能抽出时间进行深入思考和总结。然而，团队内成员都在自己的业务领域内进行深入思考和总结，这种氛围驱使个人在周末开始撰写文章，旨在沉淀知识并促进个人成长。

       问题

       在开发应用内悬浮球功能时，需要监听屏幕旋转事件以调整悬浮球的位置。然而，在横屏状态下，由于刘海屏设计的存在，悬浮球在贴边时会遇到刘海部分，导致无法正确触达。此时，需要计算刘海的宽度，并以此作为调整悬浮球起始位置的依据。

       解决思路

       当监听屏幕旋转的onConfigurationChanged生命周期回调不生效时，考虑通过监听屏幕方向的角度来判断刘海的位置。通过判断角度与屏幕方向的关系，实现正确的悬浮球位置调整。

       在接收onOrientationChanged回调时，通过代码判断屏幕显示方向是否与接收到的角度相符。当角度处于度范围时，同时判断屏幕显示方向，以确保在正确的方向下进行判断。

       代码示例

       实现判断屏幕方向的代码如下，通过onOrientationChanged回调处理屏幕旋转事件，确保悬浮球的位置调整准确。

       使用技巧

       在处理屏幕旋转事件时，需注意区分横屏状态和旋转角度的变化。通过比较角度与屏幕旋转角度的关系，实现对旋转事件的准确监听。

       其他问题

       在实际测试中，虽然onOrientationChanged回调较为灵敏，但仍存在屏幕方向旋转而角度不变的情况，这可能导致屏幕旋转事件的遗漏。在日常开发中，这种情况较为罕见，因此对实际应用影响较小。

       小结

       监听屏幕旋转事件对于调整应用内的悬浮球位置至关重要。正确处理屏幕方向与旋转角度的关系，可以实现对悬浮球位置的精准调整。在开发过程中，需关注Android设备的碎片化特性，以及不同系统设置下导航栏的显示状态，以确保适应不同设备和使用场景。

       Android 学习资源

       提供一系列Android开发学习资源，涵盖性能优化、车载应用、逆向安全、框架底层原理、音视频开发、Jetpack全家桶、Kotlin编程、Gradle构建、OkHttp源码解析、Flutter开发等领域，满足不同层次的学习需求。