flyzy博客
本文目录
一 分层结构
-
web（前端请求层）
-
biz（业务层）
-
dal（数据层）
-
client（外部请求层）
-
common（外部公共层）
-
facade（外观层）
二 分层明细
三 调用关系
-
服务和服务直接可以互相调用；
-
服务可以调用多个域的域能力；
-
域能力是封装好的最小颗粒度的能力，不可互相调用；
-
查询服务直接调用manager，不调用域能力；
四 各层规范
-
定义统一的异常处理切面：处理业务异常和其他运行时异常；
-
内部服务不做异常处理和返回result封装类，异常都抛给web层和facade层处理。
-
查询服务和其他服务区分开，单独放在一个包中；
-
能力唯一对应一个域，且是封装好的最小颗粒度的能力。
-
外部服务要在remote中做好异常处理和封装；
-
业务层中的common类为仅在应用内部使用的公共类；
-
mapper要按不同类型的数据源分开存放，如adb和xdb。
-
common只存放暴露给外部的实体类、常量和枚举；
-
暴露给外部的dto只保留外部必要的字段，其他字段如feature等不可存在。
-
定义统一的异常处理切面：处理业务异常和其他运行时异常；
-
facade层的hsf实现类只做简单的参数校验和转化，不要写业务逻辑。
五 通用代码和工具
-
统一异常处理切面
public class RestExceptionHandler {public Result system(HttpServletRequest req, Exception e) {AllLoggers.EXCEPTION.error("RestExceptionHandler.system|servlet:{}|method:{}|code:{}|msg:{}",req.getServletPath(),req.getMethod(), e.getMessage(), e);return Result.error(ResultCode.BASE.SYSTEM_ERROR);}public Result business(HttpServletRequest req, BusinessException e) {AllLoggers.EXCEPTION.error("RestExceptionHandler.business|servlet:{}|method:{}|code:{}|msg:{}",req.getServletPath(),req.getMethod(), e.getMessage(), e);return Result.error(e.getErrorCode(), e.getErrorMessage());}}
-
统一日志打印工具类
import org.slf4j.Logger;import org.slf4j.LoggerFactory;public interface AllLoggers {/*** 应用日志*/Logger APPLICATION = LoggerFactory.getLogger("APPLICATION");/*** 异常日志*/Logger EXCEPTION = LoggerFactory.getLogger("EXCEPTION");/*** 业务日志*/Logger BIZ = LoggerFactory.getLogger("BIZ");/*** hsf日志*/Logger HSF = LoggerFactory.getLogger("HSF");/*** 入口日志*/Logger MTOP = LoggerFactory.getLogger("MTOP");}
configuration>include resource="org/springframework/boot/logging/logback/defaults.xml" />property resource="application.properties">property>property name="APP_NAME" value="toms" />property name="LOG_PATH" value="${user.home}/${APP_NAME}/logs" />property name="LOG_FILE" value="${LOG_PATH}/toms-root.log" />appender name="APPLICATION"class="ch.qos.logback.core.rolling.RollingFileAppender">file>${LOG_FILE}/toms-root.logfile>encoder>pattern> pattern>charset>UTF-8charset>encoder>rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">fileNamePattern>${LOG_PATH}/logs_saved/toms-root.%d{yyyy-MM-dd}.%i.logfileNamePattern>maxHistory>5maxHistory>maxFileSize>1GBmaxFileSize>totalSizeCap>20GBtotalSizeCap>rollingPolicy>appender>appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">encoder>pattern>${CONSOLE_LOG_PATTERN}pattern>charset>utf8charset>encoder>appender>appender name="TOMS-BIZ-APPENDER"class="ch.qos.logback.core.rolling.RollingFileAppender">File>${LOG_PATH}/toms-biz.logFile>rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">FileNamePattern>${LOG_PATH}/logs_saved/toms-biz.%d{yyyy-MM-dd}.%i.logFileNamePattern>maxHistory>5maxHistory>maxFileSize>2GBmaxFileSize>totalSizeCap>20GBtotalSizeCap>rollingPolicy>encoder>pattern> pattern>charset>UTF-8charset>encoder>appender>appender name="TOMS-HSF-APPENDER"class="ch.qos.logback.core.rolling.RollingFileAppender">File>${LOG_PATH}/toms-hsf.logFile>rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">FileNamePattern>${LOG_PATH}/logs_saved/toms-hsf.%d{yyyy-MM-dd}.%i.logFileNamePattern>maxHistory>5maxHistory>maxFileSize>2GBmaxFileSize>totalSizeCap>20GBtotalSizeCap>rollingPolicy>encoder>pattern> pattern>charset>UTF-8charset>encoder>appender>appender name="TOMS-ERROR-APPENDER"class="ch.qos.logback.core.rolling.RollingFileAppender">File>${LOG_PATH}/toms-error.logFile>filter class="ch.qos.logback.classic.filter.LevelFilter">level>ERRORlevel>onMatch>ACCEPTonMatch>onMismatch>DENYonMismatch>filter>rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">FileNamePattern>${LOG_PATH}/logs_saved/toms-error.%d{yyyy-MM-dd}.%i.logFileNamePattern>maxHistory>5maxHistory>maxFileSize>2GBmaxFileSize>totalSizeCap>10GBtotalSizeCap>rollingPolicy>encoder>pattern> pattern>charset>UTF-8charset>encoder>appender>appender name="TOMS-EXCEPTION-APPENDER"class="ch.qos.logback.core.rolling.RollingFileAppender">File>${LOG_PATH}/toms-exception.logFile>rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">FileNamePattern>${LOG_PATH}/logs_saved/toms-exception.%d{yyyy-MM-dd}.logFileNamePattern>maxHistory>5maxHistory>rollingPolicy>encoder>pattern> pattern>charset>UTF-8charset>encoder>appender>logger name="HSF" level="${logback.info.level}" additivity="false">appender-ref ref="TOMS-HSF-APPENDER"/>logger>logger name="BIZ" level="${logback.info.level}" additivity="false">appender-ref ref="TOMS-BIZ-APPENDER"/>appender-ref ref="TOMS-ERROR-APPENDER"/>logger>logger name="EXCEPTION" level="${logback.info.level}" additivity="false">appender-ref ref="TOMS-EXCEPTION-APPENDER"/>appender-ref ref="TOMS-ERROR-APPENDER"/>logger>root level="INFO">appender-ref ref="CONSOLE" />root>configuration>
-
单位转化工具类
public class UnitConvertUtils {/*** 米和千米的进率*/public static final double RATE_OF_METRE_AND_KILOMETRE = 1000d;public static final int INT_RATE_OF_METRE_AND_KILOMETRE = 1000;/*** 分和元的进率*/public static final double RATE_OF_FEN_AND_YUAN = 100d;/*** 立方厘米和立方米的进率*/public static final double INT_RATE_OF_CM3_AND_M3 = 1000000d;/*** 米转千米** @param toConvert* @return 异常返回null*/public static Double convertMetre2Kilometre(Long toConvert) {if (toConvert == null) {return null;}return toConvert / RATE_OF_METRE_AND_KILOMETRE;}/*** 千米转米** @param toConvert* @return 异常返回null*/public static Long convertKilometre2Metre(Double toConvert) {if (toConvert == null) {return null;}BigDecimal bigDecimal = BigDecimal.valueOf(toConvert);BigDecimal factorBigDecimal = BigDecimal.valueOf(RATE_OF_METRE_AND_KILOMETRE);return bigDecimal.multiply(factorBigDecimal).longValue();}/*** 元转分** @param toConvert* @return 异常返回null*/public static Long convertYuan2Fen(Double toConvert) {if (toConvert == null) {return null;}BigDecimal bigDecimal = BigDecimal.valueOf(toConvert);BigDecimal factorBigDecimal = BigDecimal.valueOf(RATE_OF_FEN_AND_YUAN);return bigDecimal.multiply(factorBigDecimal).longValue();}/*** 元转分** @param toConvert* @return 异常返回null*/public static Long convertYuan2Fen(String toConvert) {if (toConvert == null) {return null;}BigDecimal bigDecimal = BigDecimal.valueOf(ConvertUtils.convertString2Double(toConvert));BigDecimal factorBigDecimal = BigDecimal.valueOf(RATE_OF_FEN_AND_YUAN);return bigDecimal.multiply(factorBigDecimal).longValue();}/*** 分转元** @param price* @return*/public static String convertFen2Yuan(Long price) {if (price == null) {return null;}return BigDecimal.valueOf(price).divide(new BigDecimal(RATE_OF_FEN_AND_YUAN)).toString();}/*** 里程米转换为千米** @param distance* @return*/public static Double meter2Kilometer(Long distance) {if (distance == null) {return null;}BigDecimal meter = BigDecimal.valueOf(distance);BigDecimal kilometer = meter.divide(new BigDecimal(INT_RATE_OF_METRE_AND_KILOMETRE));return kilometer.doubleValue();}/*** 立方厘米转立方米** @param volume* @return*/public static String convertCm32M3(Long volume) {if (volume == null) {return null;}return BigDecimal.valueOf(volume).divide(new BigDecimal(INT_RATE_OF_CM3_AND_M3)).toString();}}
