关于java:Java应用结构规范

简介：在Java程序开发中，命名和利用分层无疑是宽广后端同胞的两大“痛点”，本文提供一种基于畛域模型的轻量级利用分层结构设计，供大家参考。上面按分层构造、分层明细、调用关系、各层标准和通用代码工具开展介绍。

作者 | 阿卓
起源 | 阿里技术公众号

序言

在Java程序开发中，命名和利用分层无疑是宽广后端同胞的两大“痛点”，本文提供一种基于畛域模型的轻量级利用分层结构设计，供大家参考。上面按分层构造、分层明细、调用关系、各层标准和通用代码工具开展介绍。

一 分层构造

• web（前端申请层）

通过调用业务层服务，解决前端的申请。

• biz（业务层）

提供封装好的能力，并通过对能力进行组装、编排，进行业务逻辑解决。

• dal（数据层）

对底层数据源进行增删改查操作。

• client（内部申请层）

定义裸露给其余利用的接口。

• common（内部公共层）

定义裸露给内部的公共类。

• facade（外观层）

通过调用业务层服务，解决内部利用的申请。

二 分层明细

web（前端申请层）

biz（业务层）

dal（数据层）

client（内部申请层）

common（内部公共层）

facade（外观层）

start（启动类）

qatest（测试类）

三 调用关系

留神点：

• 服务和服务间接能够相互调用；
• 服务能够调用多个域的域能力；
• 域能力是封装好的最小颗粒度的能力，不可相互调用；
• 查问服务间接调用manager，不调用域能力；

四 各层标准

web（前端申请层）

• 定义对立的异样解决切面：解决业务异样和其余运行时异样；

biz（业务层）

• 外部服务不做异样解决和返回result封装类，异样都抛给web层和facade层解决。
• 查问服务和其余服务区离开，独自放在一个包中；
• 能力惟一对应一个域，且是封装好的最小颗粒度的能力。
• 内部服务要在remote中做好异样解决和封装；
• 业务层中的common类为仅在利用外部应用的公共类；

dal（数据层）

• mapper要按不同类型的数据源离开寄存，如adb和xdb。

common（内部公共层）

• common只寄存裸露给内部的实体类、常量和枚举；
• 裸露给内部的dto只保留内部必要的字段，其余字段如feature等不可存在。

facade（外观层）

• 定义对立的异样解决切面：解决业务异样和其余运行时异样；
• facade层的hsf实现类只做简略的参数校验和转化，不要写业务逻辑。

五 通用代码和工具

web（前端申请层）

• 对立异样解决切面

@RestControllerAdvicepublic class RestExceptionHandler {    @ResponseStatus(HttpStatus.OK)    @ExceptionHandler(Exception.class)    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);    }    @ResponseStatus(HttpStatus.OK)    @ExceptionHandler(BusinessException.class)    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());    }}

biz（业务层）

• 对立日志打印工具类

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");}

< ?xml version="1.0" encoding="UTF-8"?>< configuration>    < !-- https://github.com/spring-projects/spring-boot/blob/v1.5.13.RELEASE/spring-boot/src/main/resources/org/springframework/boot/logging/logback/defaults.xml -->    < 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.log< /file>        < encoder>            < pattern>< ![CDATA[%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%level] [traceId:%X{EAGLEEYE_TRACE_ID}] [%class:%line] - %m %n ]]> < /pattern>            < charset>UTF-8< /charset>        < /encoder>        < rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">            < fileNamePattern>${LOG_PATH}/logs_saved/toms-root.%d{yyyy-MM-dd}.%i.log< /fileNamePattern>            < maxHistory>5< /maxHistory>            < maxFileSize>1GB< /maxFileSize>            < totalSizeCap>20GB< /totalSizeCap>        < /rollingPolicy>    < /appender>    < appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">        < encoder>            < pattern>${CONSOLE_LOG_PATTERN}< /pattern>            < charset>utf8< /charset>        < /encoder>    < /appender>    < !--业务日志-->    < appender name="TOMS-BIZ-APPENDER"              class="ch.qos.logback.core.rolling.RollingFileAppender">        < File>${LOG_PATH}/toms-biz.log< /File>        < rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">            < FileNamePattern>${LOG_PATH}/logs_saved/toms-biz.%d{yyyy-MM-dd}.%i.log< /FileNamePattern>            < maxHistory>5< /maxHistory>            < maxFileSize>2GB< /maxFileSize>            < totalSizeCap>20GB< /totalSizeCap>        < /rollingPolicy>        < encoder>            < pattern>< ![CDATA[%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%level] [traceId:%X{EAGLEEYE_TRACE_ID}] [%class:%line] - %m %n ]]> < /pattern>            < charset>UTF-8< /charset>        < /encoder>    < /appender>    < !--hsf日志-->    < appender name="TOMS-HSF-APPENDER"              class="ch.qos.logback.core.rolling.RollingFileAppender">        < File>${LOG_PATH}/toms-hsf.log< /File>        < rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">            < FileNamePattern>${LOG_PATH}/logs_saved/toms-hsf.%d{yyyy-MM-dd}.%i.log< /FileNamePattern>            < maxHistory>5< /maxHistory>            < maxFileSize>2GB< /maxFileSize>            < totalSizeCap>20GB< /totalSizeCap>        < /rollingPolicy>        < encoder>            < pattern>< ![CDATA[%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%level] [traceId:%X{EAGLEEYE_TRACE_ID}] [%class:%line] - %m %n ]]> </pattern>            < charset>UTF-8< /charset>        < /encoder>    < /appender>    < !-- 通用谬误日志 -->    < appender name="TOMS-ERROR-APPENDER"              class="ch.qos.logback.core.rolling.RollingFileAppender">        < File>${LOG_PATH}/toms-error.log< /File>        < filter class="ch.qos.logback.classic.filter.LevelFilter">            < level>ERROR< /level>            < onMatch>ACCEPT</onMatch>            < onMismatch>DENY</onMismatch>        < /filter>        < rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">            < FileNamePattern>${LOG_PATH}/logs_saved/toms-error.%d{yyyy-MM-dd}.%i.log< /FileNamePattern>            < maxHistory>5< /maxHistory>            < maxFileSize>2GB< /maxFileSize>            < totalSizeCap>10GB< /totalSizeCap>        < /rollingPolicy>        < encoder>            < pattern>< ![CDATA[%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%level] [traceId:%X{EAGLEEYE_TRACE_ID}] [%class:%line] - %m %n ]]> < /pattern>            < charset>UTF-8< /charset>        < /encoder>    < /appender>    < !-- 异样日志 -->    < appender name="TOMS-EXCEPTION-APPENDER"              class="ch.qos.logback.core.rolling.RollingFileAppender">        < File>${LOG_PATH}/toms-exception.log< /File>        < rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">            < FileNamePattern>${LOG_PATH}/logs_saved/toms-exception.%d{yyyy-MM-dd}.log< /FileNamePattern>            < maxHistory>5< /maxHistory>        < /rollingPolicy>        < encoder>            < pattern><![CDATA[%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%level] [traceId:%X{EAGLEEYE_TRACE_ID}] [%class:%line] - %m %n ]]> < /pattern>            < charset>UTF-8< /charset>        < /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();    }}

原文链接
本文为阿里云原创内容，未经容许不得转载。