没有十几年的积累，你还真写不出什么好的代码

IT贱男
421 阅读9分钟

如标题所说，我不知道大家怎么看待这句话？

拿一个正常的程序员举个例子，18开始上大学学习写代码，22岁大学毕业，一直干到30岁就需要考虑程序员的中年危机。

小编身边很多程序员都不喜欢写代码，感觉写代码没有意思， 每天围绕着业务写来写去，除了CURD就是CURD，写完DAO层、写Service，写完Service，在创建一个Controller去调一下Service。

小编我不否定，很多中小型公司都是业务来推动技术，技术就是实现服务公司业务，从而给公司带来收益。不是每家公司都像阿里，华为那些大厂一样，有专门研究技术、写中间价、写开源的团队。

久而久之，所以很多公司就开始裁员一些年纪偏大的程序员，用成本小、年纪轻的人来代替。

今天不跑题，我们来聊聊平时在工作中，小编是如何写代码。

小编从2017步入社会开始写代码，对代码质量的要求，是从2019年开始的，19年的时候又重新开始学习软件设计7大原则、设计模式。 

那个时候是有想法去提升，但是学习完之后，根本就不能去理解其中的含义，就感觉学了，但又感觉什么没学到。

再后来就是慢慢开始学习框架源码，看一个开源框架，里面就有很多灵活运用设计模式的例子，这样就会每次加深对某个设计模式的理解和使用方式。

小编最近在写一个业务网关功能，网关有接入、接出的能力。

接入一家新的第三方，需要按照第三方要求来对数据进行加解密，之前公司实现有一点不能让我理解是，我需要一步步找到网关最底层，竟然是一个HttpClientUtils的类，然后在里面doPost方法中，在写一个if判断，如果code=新公司的code，就调用新公司加解密的逻辑。

当然不排除最开始的研发人员，可能要求段时间内完成，所以就这么简单的进行了实现，然后之后的伙伴也是图方便就直接在后面写if判断，就导致的后果，大家都懂得。

我不知道小伙伴们在设计代码的时候，有没有模块化的概念，这个也是小编之前总监对我说的，在写代码的时候，不要把全部的逻辑都写在一个方法里，要学会拆分，把一件事拆成几件事。一个方法里面上百、上千行的代码，相信大家应该都见过吧，不管是写的人，还是后面接手的人，看这代码，谁心里都不好受哇。

很多公司对于Http的请求，可能也只是利用一个HttpClient工具类，里面有post、get静态方法，传递url、data、header等参数，完成http请求就完事了。对于没有负责的业务逻辑来说，确实就行了，一旦有一些特殊化处理的，就不太好扩展了。

小编先是定义了两个接口类，设计功能，底层一定要是抽象的，而绝对不能是具体的代码实现，抽象往往会使系统更加稳定。

/**
 * Http 请求
 *
 * @author IT贱男
 * @version v1.0.0
 * @date 2022/10/08 09:48
 */
public interface HttpClientRequest extends Closeable {

    /**
     * 执行http请求
     *
     * @param uri               请求地址
     * @param httpMethod        请求类型
     * @param requestHttpEntity 包装参数
     * @return
     * @throws Exception
     */
    HttpClientResponse execute(URI uri, String httpMethod, RequestHttpEntity requestHttpEntity) throws Exception;

}


/**
 * HTTP 返回处理
 *
 * @author IT贱男
 * @version v1.0.0
 * @date 2022/9/30 14:00
 */
public interface HttpClientResponse extends Closeable {

    /**
     * 获取请求头
     *
     * @return
     */
    Header getHeaders();

    /**
     * 获取输入流
     *
     * @return
     * @throws IOException
     */
    InputStream getBody() throws IOException;

    /**
     * 设置String 类型的body
     *
     * @param body
     * @throws IOException
     */
    void setBodyString(String body);

    /**
     * 获取String body
     *
     * @param
     * @throws IOException
     */
    String getBodyString();

    /**
     * 获取http请求状态码
     *
     * @return
     * @throws IOException
     */
    int getStatusCode() throws IOException;

    /**
     * 获取http请求状态码 字符串类型
     *
     * @return
     * @throws IOException
     */
    String getStatusText() throws IOException;

    /**
     * 关闭输入流
     */
    @Override
    void close();
}

 HttpClientRequest中定义了一个execute方法，然后交给子类去实现，比如说小编公司固定使用的就是RSA加解密，小编就创建RSAHttpClientRequest的类，去实现对参数进行RSA加解密的操作。DefaultHttpClientRequest就是默认的http请求，CustomHttpClientRequest就是为了满足新的接入方，就自己去创建一个新的HttpClient，去实现自己的业务逻辑。

RSAClient、CustomClient都是在DefaultClient基础之上做一些自己额外的功能，所以继承了DefaultClient，为了代码复用。

Response就不多说了，只是为了响应请求做的一层包装。

这样我们就把请求、响应的模块定义好了，那怎么使用？

在上层只需要传入请求地址、请求头、请求参数，然后调用get、post方法就行，是不需要关心具体代码细节实现，所以肯定还会有一层包装类，包装类里面就是我们很熟悉的使用方式了。

@Slf4j
public class HttpClientRestTemplate extends AbstractHttpRestTemplate {

    private final HttpClientRequest requestClient;

    public HttpClientRestTemplate(HttpClientRequest requestClient) {
        this.requestClient = requestClient;
    }

    public <T> HttpRestResult<T> get(String url, Object query) throws Exception {
        return execute(url, HttpMethodConstants.GET, new RequestHttpEntity(this.buildHead(), conversionObj(query)), String.class);
    }

   public <T> HttpRestResult<T> post(String url, Header header, Object body, Type responseType)
            throws Exception {
        String value = header.getValue(HttpHeaderConstants.CONTENT_TYPE);
        if (StringUtils.isEmpty(value)) {
            header.setContentType(MediaTypeConstants.APPLICATION_JSON);
        }
        return execute(url, HttpMethodConstants.POST, new RequestHttpEntity(header, this.buildQuery(), body), responseType);
    }
    

    private <T> HttpRestResult<T> execute(String url, String httpMethod, RequestHttpEntity requestEntity,
                                          Type responseType) throws Exception {
        URI uri = HttpUtils.buildUri(url, requestEntity.getQuery());

        // 获取response handler 处理类
        ResponseHandler<T> responseHandler = super.selectResponseHandler(responseType);
        HttpClientResponse response = null;

        try {
            response = this.requestClient().execute(uri, httpMethod, requestEntity);
        } catch (Exception e) {
            log.error("HttpClientRestTemplate Http 请求失败", e);
            throw new BusinessException("HttpClientRestTemplate Http 请求失败", ErrorCodeEnum.SERVICE_EXCEPTION_500);
        }

        try {
            return responseHandler.handle(response);
        } catch (Exception e) {
            log.error("HttpClientRestTemplate handler 处理失败", e);
            throw new BusinessException("HttpClientRestTemplate handler 处理失败", ErrorCodeEnum.SERVICE_EXCEPTION_500);
        } finally {
            if (response != null) {
                response.close();
            }
        }
    }

}

包装类有了，怎么灵活去使用，应该是A公司就需要使用A公司的HttpClient、B公司就需要使用B公司的HttpClient，那这个时候工厂模式就派上使用了，交给工厂去生产相对应的HttpClient。

/**
 * HTTP 工厂类
 *
 * @author IT贱男
 * @version v1.0.0
 * @date 2022/10/11 10:01
 */
public interface HttpClientFactory {

    /**
     * 创建HttpClient
     *
     * @return
     */
    HttpClientRestTemplate createHttpClientRestTemplate();

}

小编拿了一个基于Config配置类的工厂为例子，Config配置是可以在Web后台有对应的页面进行配置，根据配置信息创建对应的HttpClient。

/**
 * 基于配置类创建HttpClient工厂
 *
 * @author IT贱男
 * @version v1.0.0
 * @date 2022/10/11 13:19
 */
@Slf4j
public class ConfigHttpClientFactory implements HttpClientFactory {

    // API后台配置信息
    private OpenapiKeyOutConfigDO openapiKeyOutConfigDO;

    public ConfigHttpClientFactory(OpenapiKeyOutConfigDO openapiKeyOutConfigDO) {
        this.openapiKeyOutConfigDO = openapiKeyOutConfigDO;
    }

    @Override
    public HttpClientRestTemplate createHttpClientRestTemplate() {

        // 获取请求客户端
        CloseableHttpClient closeableHttpClient = getCloseableHttpClient();

        // 判断是否加密，不加密走DefaultClient
        if (OpenFlagEnum.CLOSE.getCode().equals(openapiKeyOutConfigDO.getIsEncryption())) {
            // 使用默认的 DefaultHttpClientRequest
            return new HttpClientRestTemplate(new DefaultHttpClientRequest(closeableHttpClient));
        }

        // 判断加密方式是不是RSA
        if (OpenFlagEnum.OPEN.getCode().equals(openapiKeyOutConfigDO.getIsEncryption())
                && EncryptionTypeEnum.RSA.getCode().equals(openapiKeyOutConfigDO.getEncryptionType())) {
            // 使用默认的 RSAHttpClientRequest
            return new HttpClientRestTemplate(new RSAHttpClientRequest(closeableHttpClient, openapiKeyOutConfigDO.getTheirPublicKey(), openapiKeyOutConfigDO.getSelfPrivateKey()));
        }

        // 判断是不是自定义类加密
        if (OpenFlagEnum.OPEN.getCode().equals(openapiKeyOutConfigDO.getIsEncryption())
                && EncryptionTypeEnum.CUSTOM_CLASS.getCode().equals(openapiKeyOutConfigDO.getEncryptionType())) {
            try {
                if (StringUtils.isEmpty(openapiKeyOutConfigDO.getRequestClientImplClassName())) {
                    throw new BusinessException("创建自定义请求类错误，requestClientImplClassName参数为空", ErrorCodeEnum.SERVICE_EXCEPTION_500);
                }
                // 通过反射创建对应的HttpClient，代码省略
                
            } catch (Exception e) {
                log.error(e.getMessage(), e);
            }
        }
        throw new BusinessException("createHttpClientRestTemplate 失败", ErrorCodeEnum.SERVICE_EXCEPTION_500);
    }
   
}

在其他地方想要使用网关的话，只需要把相对应的配置告诉我，工厂就可以创建出你要想的HttpClient对象出来。

这样以后接一家新的第三方，程序员只需要创建一个HttpClient，专注自己的业务逻辑，其他细节可以不用去考虑，这样也不需要去改之前原来的代码，符合开闭原则。

为了扩展，小编设计了，有些第三方请求完成之后，需要做一些额外的特殊处理，最常见的就是字段映射，或者对象类型转换。

/**
 * response 处理结果转换
 *
 * @param <T>
 */
public interface ResponseHandler<T> {

    void setResponseType(Type responseType);

    /**
     * 处理response 转换成对应自己所需要的内容
     *
     * @param response
     * @return
     * @throws Exception
     */
    HttpRestResult<T> handle(HttpClientResponse response) throws Exception;
}

首先会有一个公共处理的对象，比如说请求失败了，可以在这个类中做统一处理，如果没报错就调用convertResult方法，当然这个方法也是交给子类去实现。

这个扩展是放在了HttpClientRestTemplate类中execute方法中去了

/**
 * 公用处理对象
 *
 * @author IT贱男
 * @version v1.0.0
 * @date 2022/10/11 10:08
 */
public abstract class AbstractResponseHandler<T> implements ResponseHandler<T> {

    private Type responseType;

    @Override
    public final void setResponseType(Type responseType) {
        this.responseType = responseType;
    }

    @Override
    public final HttpRestResult<T> handle(HttpClientResponse response) throws Exception {
        // 请求失败就进行错误处理
        if (HttpStatus.SC_OK != response.getStatusCode()) {
            return handleError(response);
        }
        // 结果转换
        return convertResult(response, this.responseType);
    }

    private HttpRestResult<T> handleError(HttpClientResponse response) throws Exception {
        Header headers = response.getHeaders();
        String message = IoUtils.toString(response.getBody(), headers.getCharset());
        return new HttpRestResult<T>(headers, response.getStatusCode(), null, message);
    }

    /**
     * 把请求结果进行转换
     *
     * @param response     http client response
     * @param responseType responseType
     * @return HttpRestResult
     * @throws Exception ex
     */
    public abstract HttpRestResult<T> convertResult(HttpClientResponse response, Type responseType) throws Exception;

}


/**
 * 把结果处理成String类型
 *
 * @author IT贱男
 * @version v1.0.0
 * @date 2022/10/11 10:06
 */
public class StringResponseHandler extends AbstractResponseHandler<String> {

    @Override
    public HttpRestResult<String> convertResult(HttpClientResponse response, Type responseType) throws Exception {
        final Header headers = response.getHeaders();
        if (StringUtils.isNotEmpty(response.getBodyString())) {
            String extractBody = ParameterRequestWrapper.jsonStringTrim(response.getBodyString());
            return new HttpRestResult<>(headers, response.getStatusCode(), extractBody, null);
        }

        String extractBody = ParameterRequestWrapper.jsonStringTrim(IoUtils.toString(response.getBody(), headers.getCharset()));
        return new HttpRestResult<>(headers, response.getStatusCode(), extractBody, null);
    }
}

其实这一套设计下来，代码结构上，小编觉得是很清晰的，在扩展上也是互不影响的，代码维护上也更加直观了，直接定位到类。

小编平时也是在写这些业务代码，但是在写的时候，小编尽量做到可扩展、代码清爽、维护性高的方向去设计。当然不是吹捧小编写代码有多好，只是想提醒大家，写代码就应该去考虑这些问题，而不是一股脑的吧功能实现好了就行了。

只有这样慢慢去锻炼自己，写出来的代码质量才会越来越好，写代码也才会越来越有意思。

文章回到标题，“没有十几年的积累，你还真写不出什么好的代码”

这句话是小编逛BOSS的时候看到的，所以想来说说，其实吧，在中小型公司，技术往上走，多多少少都会带点管理。

标题中的话，小编也是觉得有道理，喜欢写代码的程序员，自然就会去考虑自己的代码该怎么写才是最好，这样累计起来的经验，代码质量才会越来越好。

行吧，有感而发，到这里结束了，对于标题中的话，小伙伴们怎么看？

avatar
文章
阅读
粉丝