隔壁老李头
隔壁老李头

Retrofit解析8之核心解析——ServiceMethod及注解1

整体Retrofit内容如下：

  • 1、Retrofit解析1之前哨站——理解RESTful
  • 2、Retrofit解析2之使用简介
  • 3、Retrofit解析3之反射
  • 4、Retrofit解析4之注解
  • 5、Retrofit解析5之代理设计模式
  • 6、Retrofit解析6之面向接口编程
  • 7、Retrofit解析7之相关类解析
  • 8、Retrofit解析8之核心解析——ServiceMethod及注解1
  • 9、Retrofit解析8之核心解析——ServiceMethod及注解2
  • 10、Retrofit解析9之流程解析
  • 11、Retrofit解析10之感谢

上篇文章已经介绍了Retrofit里面的大多数类，今天就重点介绍ServiceMethod，本片文章主要内容如下：

  • 1、ParameterHandler类
  • 2、ServiceMethod类
  • 3、Retrofit类

为了方便后面学习ServiceMethod，我们先来看下ParameterHandler类

一、ParameterHandler类

(一)、ParameterHandler类是什么？

从字面意思我们猜到 他是参数处理类。具体是不是那？用源码说话，看源码

abstract class ParameterHandler {
  abstract void apply(RequestBuilder builder, T value) throws IOException;
  final ParameterHandler> iterable() {
    return new ParameterHandler>() {
      @Override void apply(RequestBuilder builder, Iterable values) throws IOException {
        if (values == null) return; // Skip null values.
        for (T value : values) {
          ParameterHandler.this.apply(builder, value);
        }
      }
    };
  }
  final ParameterHandler array() {
    return new ParameterHandler() {
      @Override void apply(RequestBuilder builder, @Nullable Object values) throws IOException {
        if (values == null) return; // Skip null values.

        for (int i = 0, size = Array.getLength(values); i < size; i++) {
          //noinspection unchecked
          ParameterHandler.this.apply(builder, (T) Array.get(values, i));
        }
      }
    };
  }
  //由于篇幅的限制，我没有粘贴静态内部类
}
 
 
通过简单阅读源代码，我们得知:
 
 
 
 
 
 
     
  
  • ParameterHandler 是一个抽象类
    •  
  
  • 一共有3个方法，其中一个是抽象方法
    •  
  
  • apply(RequestBuilder builder, T value)方法是抽象的，需要子类去实现
    •  
  
  • iterable()方法返回的是new的一个ParameterHandler，不过的他的泛型是Iterable，所以它的抽象方法的具体实现是遍历这个迭代器Iterable，调用这个对象的apply()方法，注意这个方法是final。
    •  
  
  • array()方法 返回的是一个new的一个ParameterHandler，它的泛型是Object，而他的抽象方法是通过遍历数组的方式来分别调用对应的apply()方法，这个方法也是final的
    •  
 
 
 
这里说下iterable()方法和array()方法，说明ParameterHandler是支持两种数据类型的处理方式。一个是对应迭代器(iterable)的类型;一个是对应的是数组类型的。所以我们继续往下看
 
 
(二)、静态内部类RelativeUrl
 
 
看下源码：
 
 
  static final class RelativeUrl extends ParameterHandler {
    @Override void apply(RequestBuilder builder, Object value) {
      builder.setRelativeUrl(value);
    }
  }
 
 
 
 
 
 
     
  
  • 首先，这个类是final的
    •  
  
  • 其次，貌似很简单，RelativeUrl类内部就是调用RequestBuilder的setRelativeUrl方法来设置RequestBuilder的relativeUrl的值
    •  
 
 
 
(三)、静态内部类Header
 
 
看下源码：
 
 
  static final class Header extends ParameterHandler {
    private final String name;
    private final Converter valueConverter;
    Header(String name, Converter valueConverter) {
      this.name = checkNotNull(name, "name == null");
      this.valueConverter = valueConverter;
    }
    @Override void apply(RequestBuilder builder, T value) throws IOException {
      if (value == null) return; // Skip null values.
      builder.addHeader(name, valueConverter.convert(value));
    }
  }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类有两个final的变量，在构造的时候赋值
    •  
  
  • apply抽象方法也是调用RequestBuilder的addHeader方法给RequestBuilder的header赋值
    •  
  
  • apply里面有调用Converter的convert的方法把value进行转化，其实是序列化。
    •  
 
 
 
(四)、静态内部类Path
 
 
看下源码：
 
 
    private final String name;
    private final Converter valueConverter;
    private final boolean encoded;

    Path(String name, Converter valueConverter, boolean encoded) {
      this.name = checkNotNull(name, "name == null");
      this.valueConverter = valueConverter;
      this.encoded = encoded;
    }

    @Override void apply(RequestBuilder builder, T value) throws IOException {
      if (value == null) {
        throw new IllegalArgumentException(
            "Path parameter \"" + name + "\" value must not be null.");
      }
      builder.addPathParam(name, valueConverter.convert(value), encoded);
    }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类有三个final的变量，在构造的时候赋值
    •  
  
  • apply抽象方法也是调用RequestBuilder的addPathParam方法进行设置
    •  
  
  • apply里面有调用Converter的convert的方法把value进行转化，其实是序列化。
    •  
 
 
 
(五)、静态内部类Query
 
 
看下源码：
 
 
  static final class Query extends ParameterHandler {
    private final String name;
    private final Converter valueConverter;
    private final boolean encoded;

    Query(String name, Converter valueConverter, boolean encoded) {
      this.name = checkNotNull(name, "name == null");
      this.valueConverter = valueConverter;
      this.encoded = encoded;
    }

    @Override void apply(RequestBuilder builder, T value) throws IOException {
      if (value == null) return; // Skip null values.
      builder.addQueryParam(name, valueConverter.convert(value), encoded);
    }
  }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类有三个final的变量，在构造的时候赋值
    •  
  
  • apply抽象方法也是调用RequestBuilder的addQueryParam方法进行设置
    •  
  
  • apply里面有调用Converter的convert的方法把value进行转化，其实是序列化。
    •  
 
 
 
(六)、静态内部类QueryName
 
 
看下源码：
 
 
  static final class QueryName extends ParameterHandler {
    private final Converter nameConverter;
    private final boolean encoded;
    QueryName(Converter nameConverter, boolean encoded) {
      this.nameConverter = nameConverter;
      this.encoded = encoded;
    }
    @Override void apply(RequestBuilder builder, T value) throws IOException {
      if (value == null) return; // Skip null values.
      builder.addQueryParam(nameConverter.convert(value), null, encoded);
    }
  }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类有二个final的变量，在构造的时候赋值
    •  
  
  • apply抽象方法也是调用RequestBuilder的addQueryParam方法进行设置
    •  
  
  • apply里面有调用Converter的convert的方法把value进行转化，其实是序列化。
    •  
 
 
 
(七)、静态内部类QueryMap
 
 
看下源码：
 
 
static final class QueryMap extends ParameterHandler> {
    private final Converter valueConverter;
    private final boolean encoded;

    QueryMap(Converter valueConverter, boolean encoded) {
      this.valueConverter = valueConverter;
      this.encoded = encoded;
    }

    @Override void apply(RequestBuilder builder, Map value) throws IOException {
      if (value == null) {
        throw new IllegalArgumentException("Query map was null.");
      }

      for (Map.Entry entry : value.entrySet()) {
        String entryKey = entry.getKey();
        if (entryKey == null) {
          throw new IllegalArgumentException("Query map contained null key.");
        }
        T entryValue = entry.getValue();
        if (entryValue == null) {
          throw new IllegalArgumentException(
              "Query map contained null value for key '" + entryKey + "'.");
        }
        builder.addQueryParam(entryKey, valueConverter.convert(entryValue), encoded);
      }
    }
  }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类有二个final的变量，在构造的时候赋值
    •  
  
  • apply抽象方法内部首先遍历Map,获取对应的key 和value，然后调用RequestBuilder的addQueryParam方法进行设置
    •  
  
  • apply里面有调用Converter的convert的方法把value进行转化，其实是序列化。
    •  
 
 
 
(八)、静态内部类HeaderMap
 
 
看下源码：
 
 
 static final class HeaderMap extends ParameterHandler> {
    private final Converter valueConverter;

    HeaderMap(Converter valueConverter) {
      this.valueConverter = valueConverter;
    }

    @Override void apply(RequestBuilder builder, Map value) throws IOException {
      if (value == null) {
        throw new IllegalArgumentException("Header map was null.");
      }

      for (Map.Entry entry : value.entrySet()) {
        String headerName = entry.getKey();
        if (headerName == null) {
          throw new IllegalArgumentException("Header map contained null key.");
        }
        T headerValue = entry.getValue();
        if (headerValue == null) {
          throw new IllegalArgumentException(
              "Header map contained null value for key '" + headerName + "'.");
        }
        builder.addHeader(headerName, valueConverter.convert(headerValue));
      }
    }
  }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类有一个final的变量，在构造的时候赋值
    •  
  
  • apply抽象方法内部首先遍历Map,获取对应的key 和value，然后调用RequestBuilder的addHeader方法进行设置
    •  
  
  • apply里面有调用Converter的convert的方法把value进行转化，其实是序列化。
    •  
 
 
 
(九)、静态内部类Field
 
 
看下源码：
 
 
static final class Field extends ParameterHandler {
    private final String name;
    private final Converter valueConverter;
    private final boolean encoded;

    Field(String name, Converter valueConverter, boolean encoded) {
      this.name = checkNotNull(name, "name == null");
      this.valueConverter = valueConverter;
      this.encoded = encoded;
    }

    @Override void apply(RequestBuilder builder, T value) throws IOException {
      if (value == null) return; // Skip null values.
      builder.addFormField(name, valueConverter.convert(value), encoded);
    }
  }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类有三个final的变量，在构造的时候赋值
    •  
  
  • apply抽象方法内部调用RequestBuilder的addFormField方法进行设置
    •  
  
  • apply里面有调用Converter的convert的方法把value进行转化，其实是序列化。
    •  
 
 
 
(十)、静态内部类FieldMap
 
 
看下源码：
 
 
static final class FieldMap extends ParameterHandler> {
    private final Converter valueConverter;
    private final boolean encoded;

    FieldMap(Converter valueConverter, boolean encoded) {
      this.valueConverter = valueConverter;
      this.encoded = encoded;
    }

    @Override void apply(RequestBuilder builder, Map value) throws IOException {
      if (value == null) {
        throw new IllegalArgumentException("Field map was null.");
      }

      for (Map.Entry entry : value.entrySet()) {
        String entryKey = entry.getKey();
        if (entryKey == null) {
          throw new IllegalArgumentException("Field map contained null key.");
        }
        T entryValue = entry.getValue();
        if (entryValue == null) {
          throw new IllegalArgumentException(
              "Field map contained null value for key '" + entryKey + "'.");
        }
        builder.addFormField(entryKey, valueConverter.convert(entryValue), encoded);
      }
    }
  }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类有二个final的变量，在构造的时候赋值
    •  
  
  • apply抽象方法内部首先遍历Map,获取对应的key 和value，然后调用RequestBuilder的addFormField方法进行设置
    •  
  
  • apply里面有调用Converter的convert的方法把value进行转化，其实是序列化。
    •  
 
 
 
(十一)、静态内部类Part
 
 
看下源码：
 
 
static final class Part extends ParameterHandler {
    private final Headers headers;
    private final Converter converter;

    Part(Headers headers, Converter converter) {
      this.headers = headers;
      this.converter = converter;
    }

    @Override void apply(RequestBuilder builder, T value) {
      if (value == null) return; // Skip null values.

      RequestBody body;
      try {
        body = converter.convert(value);
      } catch (IOException e) {
        throw new RuntimeException("Unable to convert " + value + " to RequestBody", e);
      }
      builder.addPart(headers, body);
    }
  }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类有二个final的变量，在构造的时候赋值
    •  
  
  • apply抽象方法内部首先通过convert的方法把value进行转化(其实是序列化)，然后调用RequestBuilder的addPart方法进行设置。
    •  
 
 
 
(十二)、静态内部类RawPart
 
 
看下源码：
 
 
static final RawPart INSTANCE = new RawPart();

    private RawPart() {
    }

    @Override void apply(RequestBuilder builder, MultipartBody.Part value) throws IOException {
      if (value != null) { // Skip null values.
        builder.addPart(value);
      }
    }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类构造函数是私有的，并且定义了一个静态的常量对象，所以这个是类的对象是单例模式。
    •  
  
  • apply抽象方法调用RequestBuilder的addPart方法进行设置。
    •  
 
 
 
(十三)、静态内部类PartMap
 
 
看下源码：
 
 
  static final class PartMap extends ParameterHandler> {
    private final Converter valueConverter;
    private final String transferEncoding;

    PartMap(Converter valueConverter, String transferEncoding) {
      this.valueConverter = valueConverter;
      this.transferEncoding = transferEncoding;
    }

    @Override void apply(RequestBuilder builder, Map value) throws IOException {
      if (value == null) {
        throw new IllegalArgumentException("Part map was null.");
      }

      for (Map.Entry entry : value.entrySet()) {
        String entryKey = entry.getKey();
        if (entryKey == null) {
          throw new IllegalArgumentException("Part map contained null key.");
        }
        T entryValue = entry.getValue();
        if (entryValue == null) {
          throw new IllegalArgumentException(
              "Part map contained null value for key '" + entryKey + "'.");
        }

        Headers headers = Headers.of(
            "Content-Disposition", "form-data; name=\"" + entryKey + "\"",
            "Content-Transfer-Encoding", transferEncoding);

        builder.addPart(headers, valueConverter.convert(entryValue));
      }
    }
  }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类有二个final的变量，在构造的时候赋值
    •  
  
  • apply抽象方法内部首先遍历Map,获取对应的key 和value，然后调用okhttp3的Headers.of()方法添加headers，最后调用RequestBuilder的addPart方法进行设置
    •  
  
  • apply里面有调用Converter的convert的方法把value进行转化，其实是序列化。
    •  
 
 
 
(十四)、静态内部类Body
 
 
看下源码：
 
 
   static final class Body extends ParameterHandler {
    private final Converter converter;

    Body(Converter converter) {
      this.converter = converter;
    }

    @Override void apply(RequestBuilder builder, T value) {
      if (value == null) {
        throw new IllegalArgumentException("Body parameter value must not be null.");
      }
      RequestBody body;
      try {
        body = converter.convert(value);
      } catch (IOException e) {
        throw new RuntimeException("Unable to convert " + value + " to RequestBody", e);
      }
      builder.setBody(body);
    }
  }

 
 
 
 
 
 
     
  
  • 首先这个类是final的
    •  
  
  • 其次这个类有一个final的变量，在构造的时候赋值
    •  
  
  • apply抽象方法内部首先调用Converter的convert的方法把value进行转化，其实就是序列化。然后调用RequestBuilder的setBody方法进行设置
    •  
 
 
 
(十五)、总结
 
 
本来这篇内容应该放到上一篇文章中，但是由于受到篇幅限制的原由，所以放到这里了，看完ParameterHandler类的源码在回想下ParameterHandler的源码，大家有没有想到一些东西?
 
 
 
 
 
 
其实Retrofit团队是这样分工的，RequestBuilder仅仅是一个包装类，但是具体的赋值操作等其实是通过ParameterHandler对应的静态内部类来实现的，这样实现了包装和操作分离，实现了解耦。多么"优雅"的设计。
 
 
二、ServiceMethod类
 
 
(一)、ServiceMethod类是什么？
 
 
首先用类注解解释下ServiceMethod是什么？
 
 
/** Adapts an invocation of an interface method into an HTTP call. */

 
 
我翻译一下:
 
 
 
 
 
 
将一个接口的方方法的调用适配成一个HTTP的Call。
 
 
我的理解是:
 
 
 
 
 
 
ServiceMethod是一个负责转化(适配)的类，负责把一个接口的抽象方法的执行过程的结果转化(适配)成一个网络请求(HTTP call)。
 
 
ok 那我们来看下他的源码
 
 
(二)、ServiceMethod类源码
 
 
由于这个类略大，一直在纠结要不要把全部代码粘贴上，但是考虑到大家的情况，还是粘贴了，不过省略了Buidler内部静态类的代码，希望大家理解。
 
 
1、ServiceMethod源码：
 
 
/** Adapts an invocation of an interface method into an HTTP call. */
final class ServiceMethod {
  // Upper and lower characters, digits, underscores, and hyphens, starting with a character.
  static final String PARAM = "[a-zA-Z][a-zA-Z0-9_-]*";
  static final Pattern PARAM_URL_REGEX = Pattern.compile("\\{(" + PARAM + ")\\}");
  static final Pattern PARAM_NAME_REGEX = Pattern.compile(PARAM);

  final okhttp3.Call.Factory callFactory;
  final CallAdapter callAdapter;

  private final HttpUrl baseUrl;
  private final Converter responseConverter;
  private final String httpMethod;
  private final String relativeUrl;
  private final Headers headers;
  private final MediaType contentType;
  private final boolean hasBody;
  private final boolean isFormEncoded;
  private final boolean isMultipart;
  private final ParameterHandler[] parameterHandlers;

  ServiceMethod(Builder builder) {
    this.callFactory = builder.retrofit.callFactory();
    this.callAdapter = builder.callAdapter;
    this.baseUrl = builder.retrofit.baseUrl();
    this.responseConverter = builder.responseConverter;
    this.httpMethod = builder.httpMethod;
    this.relativeUrl = builder.relativeUrl;
    this.headers = builder.headers;
    this.contentType = builder.contentType;
    this.hasBody = builder.hasBody;
    this.isFormEncoded = builder.isFormEncoded;
    this.isMultipart = builder.isMultipart;
    this.parameterHandlers = builder.parameterHandlers;
  }

  /** Builds an HTTP request from method arguments. */
  Request toRequest(Object... args) throws IOException {
    RequestBuilder requestBuilder = new RequestBuilder(httpMethod, baseUrl, relativeUrl, headers,
        contentType, hasBody, isFormEncoded, isMultipart);

    @SuppressWarnings("unchecked") // It is an error to invoke a method with the wrong arg types.
    ParameterHandler[] handlers = (ParameterHandler[]) parameterHandlers;

    int argumentCount = args != null ? args.length : 0;
    if (argumentCount != handlers.length) {
      throw new IllegalArgumentException("Argument count (" + argumentCount
          + ") doesn't match expected count (" + handlers.length + ")");
    }

    for (int p = 0; p < argumentCount; p++) {
      handlers[p].apply(requestBuilder, args[p]);
    }

    return requestBuilder.build();
  }

  /** Builds a method return value from an HTTP response body. */
  R toResponse(ResponseBody body) throws IOException {
    return responseConverter.convert(body);
  }
  //省略了Builder内部类
}
 
 
通过错略看过源代码可以获取如下信息：
 
 
 
 
 
 
     
  
  • ServiceMethod是final的，不能被继承
    •  
  
  • ServiceMethod的构造函数既不是public，也是private的，所以只能在包内创建ServiceMethod对象。
    •  
  
  • ServiceMethod有一个静态内部类Builder。是final的，同样不能被继承，看到Builder，大家一定知道了ServiceMethod是Builder模式，所以 ServiceMethod构造函数就一个入参是Builder
    •  
  
  • 所有的变量均是final的
    •  
  
  • 一共有4个方法，两个静态的两个非静态的
    •  
  
  • boxIfPrimitive (Class type) 静态方法：明显就是获取8个基本类型对应的装箱类
    •  
  
  • parsePathParameters (String path) 静态方法： 保证url中的路径参数(PathParameters)有且仅使用一次，不会出现重复的路径参数(PathParameters)。
    •  
 
 
 
2、源码详解：
 
 
2.1、变量解析：
 
 
大家先来看下变量，由于变量不多，我直接上注释了。
 
 
 //用来校验的常量
static final String PARAM = "[a-zA-Z][a-zA-Z0-9_-]*";
  static final Pattern PARAM_URL_REGEX = Pattern.compile("\\{(" + PARAM + ")\\}");
  static final Pattern PARAM_NAME_REGEX = Pattern.compile(PARAM);
  //网络请求call的工厂，注释是okhttp3的
  final okhttp3.Call.Factory callFactory;
  // 网络请求适配器
  final CallAdapter callAdapter;
  //基础HttpUrl
  private final HttpUrl baseUrl;
  //响应转化器
  private final Converter responseConverter;
   //网络请求的方法
  private final String httpMethod;
  //网络请求url的相对路径
  private final String relativeUrl;
  // 请求头
  private final Headers headers;
   //请求类型
  private final MediaType contentType;
  //是否有请求体
  private final boolean hasBody;
  //是否是表单提交
  private final boolean isFormEncoded;
  //以二进制流的方式提交
  private final boolean isMultipart;
  //参数处理器。具体在后面讲解
  private final ParameterHandler[] parameterHandlers;

 
 
2.2、ServiceMethod的两个非静态方法：
 
 
2.2.1首先来看下toRequest方法
 
 
  /** Builds an HTTP request from method arguments. */
  Request toRequest(Object... args) throws IOException {
    //new 了一个RequestBuilder对象
    RequestBuilder requestBuilder = new RequestBuilder(httpMethod, baseUrl, relativeUrl, headers,
        contentType, hasBody, isFormEncoded, isMultipart);
    @SuppressWarnings("unchecked") // It is an error to invoke a method with the wrong arg types.
    ParameterHandler[] handlers = (ParameterHandler[]) parameterHandlers;
    //获取入参的个数
    int argumentCount = args != null ? args.length : 0;
    if (argumentCount != handlers.length) {
      throw new IllegalArgumentException("Argument count (" + argumentCount
          + ") doesn't match expected count (" + handlers.length + ")");
    }
    //遍历入参
    for (int p = 0; p < argumentCount; p++) {
      //配置对应的requestBuilder属性
      handlers[p].apply(requestBuilder, args[p]);
    }
    //调用requestBuilder的build()方法获取一个okhttp3.request对象
    return requestBuilder.build();
  }
 
 
通过注释我们发现，其实这个方法是：
 
 
 
 
 
 
通过方法的入参来够将一个HTTP的请求。
 
 
方法内的大体流程如下：
 
 
 
 
 
 
     
  
  • 1、new 了一个RequestBuilder对象
    •  
  
  • 2、 获取入参的个数，并与自身对应的入参处理类的个数进行对比，不一致抛异常，理论上应该是一致的，因为你的每个“方法”的每一个入参都对应一个注解。
    •  
  
  • 3、遍历这些入参处理类，开始配置requestBuilder属性
    •  
  
  • 4、配置完毕，调用requestBuilder的.build()方法获取一个okhttp3.Request对象
    •  
 
 
 
2.2.2 让我们来看下toResponse方法
 
 
  /** Builds a method return value from an HTTP response body. */
  R toResponse(ResponseBody body) throws IOException {
    return responseConverter.convert(body);
  }

 
 
通过方法注释我们得知:
 
 
 
 
 
 
通过一个HTTP的响应体(response body)来构建一个方法的返回值。
 
 
方法很简单就一行，就是调用响应解析/处理器(responseConverter)的convert方法来解析/反序列化响应体。
 
 
3、静态内部类 ServiceMethod.Builder
 
 
3.1、先看下类的注释
 
 
  /**
   * Inspects the annotations on an interface method to construct a reusable service method. This
   * requires potentially-expensive reflection so it is best to build each service method only once
   * and reuse it. Builders cannot be reused.
   */

 
 
翻译一下就是
 
 
 
 
 
 
通过检查接口方法上的注解来构建一个可以重用的 "服务方法"，由于用到高性能消耗的反射，所以最好一个 "服务方法" 只构建一次，并且可以重复使用。Builders不能被重用
 
 
我的理解是:
 
 
 
 
 
 
其实Retrofit内部是通过动态代理，内部是通过反射实现的，大家都知道反射其实是很消耗性能的，为了避免这种高性能的消耗，反射成功以后就缓存起来，下次如果有用到就重用，如果不能重用则用反射构建出来，但是Builder是不能重用的。
 
 
3.2、 ServiceMethod.Builder源码解析
 
 
由于Builder源码太多了，我就不上源码了
 我们来看下Builder类的变量，我直接标注释了
 
 
3.2.1、ServiceMethod.Builder变量解析
 
 
    //Retrofit
    final Retrofit retrofit;
    //定义接口的抽象方法
    final Method method;
    //定义接口的抽象方法上面的注解数组
    final Annotation[] methodAnnotations;
     //注解二维数组：第一维对应参数序列，第二维对应注解序列；
    final Annotation[][] parameterAnnotationsArray;
     // 参数类型数组
    final Type[] parameterTypes;
    // 响应的类型
    Type responseType;
    //是否有用 @Field 或者FieldMap 注解
    boolean gotField;
     //是否 有用@Part 或者 @PartMap注解
    boolean gotPart;
    //是否有用 @body注解
    boolean gotBody;
     // 是否 有用@Path 注解
    boolean gotPath;
     //是否 有用@Query 或者@QueryName 注解
    boolean gotQuery;
     // 是否具有url
    boolean gotUrl;
     //http 请求的方法
    String httpMethod;
     //是否  需要请求体
    boolean hasBody;
    //是否 使用@FormUrlEncoded  注解
    boolean isFormEncoded;
    // 是否 使用了@Multipart  注解
    boolean isMultipart;
    // 相对路径
    String relativeUrl;
     //请求头
    Headers headers;
    //类型
    MediaType contentType;
     //相对路径的url参数
    Set relativeUrlParamNames;
     //参数处理数组
    ParameterHandler[] parameterHandlers;
     //响应转化器
    Converter responseConverter;
     //请求转化器
    CallAdapter callAdapter;

 
 
3.2.2、 Builder构造函数解析
 
 
    Builder(Retrofit retrofit, Method method) {
      this.retrofit = retrofit;
      this.method = method;
      this.methodAnnotations = method.getAnnotations();
      this.parameterTypes = method.getGenericParameterTypes();
      this.parameterAnnotationsArray = method.getParameterAnnotations();
    }

 
 
 
 
 
 
     
  
  • 我们知道Builder的构造函数有两个入参，一个是Retrofit对象本身，一个是Method 对象。
    •  
  
  • methodAnnotations、parameterTypes、parameterAnnotationsArray这三个变量的值都是通过method的三个方法获取的
    •  
 
 
 
PS:通过之前反射的学习我们知道Method.getAnnotations(); 是获取方法上面对应的注解。method.getGenericParameterTypes();获取的是方法参数的类型，里面带有实际的参数类型。method.getParameterAnnotations()；获取的是方法参数上面的注解，是一个二维数组，第一个维度代表的是方法参数对应的下标，比如，一个方法有3个参数，那0代表第一个参数，1代表第二个参数，2代表第三个参数。
 
 
通过构造函数我们知道Builder类里面的5个变量已经被初始化了
 
 
3.2.3、 Builder的方法build()方法解析
 
 
public ServiceMethod build() {
      //通过调用createCallAdapter()方法获取callAdapter
      callAdapter = createCallAdapter();
      //通过调用callAdapter的responseType方法获取响应体类型
      responseType = callAdapter.responseType();
      if (responseType == Response.class || responseType == okhttp3.Response.class) {
        throw methodError("'"
            + Utils.getRawType(responseType).getName()
            + "' is not a valid response body type. Did you mean ResponseBody?");
      }
      //通过createResponseConverter()方法获取响应转化器
      responseConverter = createResponseConverter();
      //遍历方法的注解
      for (Annotation annotation : methodAnnotations) {
        //解析方法注解
        parseMethodAnnotation(annotation);
      }
      //如果没有HTTP请求的方法，则抛异常
      if (httpMethod == null) {
        throw methodError("HTTP method annotation is required (e.g., @GET, @POST, etc.).");
      }
      //在上面遍历方法注解并解析方法注解的时候，hasBody，isMultipart，isFormEncoded等已经完成赋值
      //如果没有请求体
      if (!hasBody) {
         //但是 还是使用了@Multipart注解，使用了@Multipart 是一定有消息体的
        if (isMultipart) {
          throw methodError(
              "Multipart can only be specified on HTTP methods with request body (e.g., @POST).");
        }
         //但是 还是使用了 @FormEncoded，使用了@FormEncoded 是一定有消息体的
        if (isFormEncoded) {
          throw methodError("FormUrlEncoded can only be specified on HTTP methods with "
              + "request body (e.g., @POST).");
        }
      }
      //如果方法 入参的注解，它的长度也就是有多少个入参，遍历每个入参对应的注解
      int parameterCount = parameterAnnotationsArray.length;
      //创建对应的数量的参数处理类数组，这时候开始处理入参对应的注解了
      parameterHandlers = new ParameterHandler[parameterCount];
      //遍历入参的数量
      for (int p = 0; p < parameterCount; p++) {
         //首先获取入参的类型
        Type parameterType = parameterTypes[p];
         //如果是不能处理的类型，则抛异常
        if (Utils.hasUnresolvableType(parameterType)) {
          throw parameterError(p, "Parameter type must not include a type variable or wildcard: %s",
              parameterType);
        }
        //如果是可以处理的类型获取对应位置入参的注解
        Annotation[] parameterAnnotations = parameterAnnotationsArray[p];
        //如果对应入参的注解为null，则抛异常
        if (parameterAnnotations == null) {
          throw parameterError(p, "No Retrofit annotation found.");
        }
         //如果对应的入参注解不为null,则调用parseParameter方法获取ParameterHandler，cancel在这里方法里面创建ParameterHandler里面的静态内部类，后面咱们再仔细看下。
        parameterHandlers[p] = parseParameter(p, parameterType, parameterAnnotations);
      }
       //for循环遍历以后，如果relativeUrl还为null，同时没有使用！@url注解，这样的话我们就无法获取url地址了，所以要抛异常。
      if (relativeUrl == null && !gotUrl) {
        throw methodError("Missing either @%s URL or @Url parameter.", httpMethod);
      }
      //如果没有使用@FormEncoded注解、@Multipart和，同时HTTP请求方式也不需要响应提，但是却使用了@Body 注解，这不是自相矛盾，所以抛异常。
      if (!isFormEncoded && !isMultipart && !hasBody && gotBody) {
        throw methodError("Non-body HTTP method cannot contain @Body.");
      }
      //如果使用@FormEncoded注解，却没使用@Field注解，不符合规范，则抛异常
      if (isFormEncoded && !gotField) {
        throw methodError("Form-encoded method must contain at least one @Field.");
      }
      //如果使用 @Multipart 注解，却没有使用@Part 注解，抛异常
      if (isMultipart && !gotPart) {
        throw methodError("Multipart method must contain at least one @Part.");
      }
      //走到这里说明没有问题，则new一个ServiceMethod对象，入参是Builder自己，然后return这个ServiceMethod对象。
      return new ServiceMethod<>(this);
    }

 
 
大体流程如下：
 
 
 
 
 
 
     
  
  • 1、通过createCallAdapter()方法取得callAdapter对象
    •  
  
  • 2、通过callAdapter的responseType()方法获取响应对应的类型
    •  
  
  • 3、通过createResponseConverter()来获取响应转化/解析器
    •  
  
  • 4、遍历方法上的注解，并解析注解
    •  
  
  • 5、判断是GET还是POST或者其他HTTP请求方式
    •  
  
  • 6、异常逻辑判断，如果HTTP请求方式不需要消息体，但是却使用@FormEncoded注解、@Multipart，自相矛盾。
    •  
  
  • 7、获取这个方法入参的个数
    •  
  
  • 8、遍历这个方法的各个入参，首先判断是不是能处理的类型，如果是能处理的类型；然后获取这个入参对应的注解；最后调用parseParameter()来获取对应的parameterHandlers。
    •  
  
  • 9、异常逻辑判断，比如如果没有相对路径还没有使用@Url，我们会无法得到具体的地址。
    •  
  
  • 10、异常逻辑处理，既没有使用@FormUrlEncode 注解也没有使用@Multipart注解，且HTTP请求方式也需要使用请求，却使用@Body 注解，违反规范，抛异常
    •  
  
  • 11、异常逻辑处理，使用@FormUrlEncoded注解，但是却没有使用@Field注解，这是违背Retrofit的规定的。
    •  
  
  • 12、异常逻辑处理，使用了@Multipart 注解，却没有使用@Part注解，同样是违背Retrofit的规定的。
    •  
  
  • 13、最后new了一个ServiceMethod对象，并return
    •  
 
 
 
自此整个build流程已经全部解析完毕，那我们在看来里面设计的其它方法
 
 
3.2.4、 Builder的方法createCallAdapter解析
 
 
通过方法字面的含义我们理解为这个方法创建CallAdatper，具体我们看下源码：
 
 
    private CallAdapter createCallAdapter() {
       //获取方法的返回值类型
      Type returnType = method.getGenericReturnType();
       //如果方法的返回值类型我们无法处理，则抛出异常
      if (Utils.hasUnresolvableType(returnType)) {
        throw methodError(
            "Method return type must not include a type variable or wildcard: %s", returnType);
      }
      //如果方法是void的，则没有返回值
      if (returnType == void.class) {
        throw methodError("Service methods cannot return void.");
      }
      //获取方法的注解
      Annotation[] annotations = method.getAnnotations();
      try {
        //调用retrofit的callAdapter来获取一个CallAdapter对象
        //noinspection unchecked
        return (CallAdapter) retrofit.callAdapter(returnType, annotations);
      } catch (RuntimeException e) { // Wide exception range because factories are user code.
        throw methodError(e, "Unable to create call adapter for %s", returnType);
      }
    }

 
 
大体流程如下：
 
 
 
 
 
 
     
  
  • 1、通过method.getGenericReturnType()获取返回值类型
    •  
  
  • 2、排除我们不能处理的类型
    •  
  
  • 3、排除无返回值(void)的情况
    •  
  
  • 4、调用 retrofit的callAdapter的方法来获取一个CallAdapter对象，这个里面的内部调用，我们一会再说。
    •  
 
 
 
3.2.5、 Builder的方法parseMethodAnnotation解析
 
 
这个方法看字面的意思就知道是一个处理方法的注解,具体以源码为准。
 
 
 private void parseMethodAnnotation(Annotation annotation) {
      //如果是DELETE注解 代表DELETE请求
      if (annotation instanceof DELETE) {
         //调用parseHttpMethodAndPath()
        parseHttpMethodAndPath("DELETE", ((DELETE) annotation).value(), false);
        //如果是GET 注解，则代表是get请求
      } else if (annotation instanceof GET) {
       //调用parseHttpMethodAndPath()
        parseHttpMethodAndPath("GET", ((GET) annotation).value(), false);
        //如果是 HEAD注解，则代表HEAD请求，这里不是请求头,HEAD方法跟GET方法相同，只不过服务器响应时不会返回消息体。
      } else if (annotation instanceof HEAD) {
          //调用parseHttpMethodAndPath()
        parseHttpMethodAndPath("HEAD", ((HEAD) annotation).value(), false);
        if (!Void.class.equals(responseType)) {
           //HEAD请求是没有响应体的
          throw methodError("HEAD method must use Void as response type.");
        }
        //如果是PATCH请求
      } else if (annotation instanceof PATCH) {
          //调用parseHttpMethodAndPath()
        parseHttpMethodAndPath("PATCH", ((PATCH) annotation).value(), true);
      } else if (annotation instanceof POST) {
        //调用parseHttpMethodAndPath()
        parseHttpMethodAndPath("POST", ((POST) annotation).value(), true);
       //如果是PUT请求
      } else if (annotation instanceof PUT) {
        //调用parseHttpMethodAndPath()
        parseHttpMethodAndPath("PUT", ((PUT) annotation).value(), true);
         //如果是 OPTIONS注解，代表OPTIONS请求
      } else if (annotation instanceof OPTIONS) {
          //调用parseHttpMethodAndPath()
        parseHttpMethodAndPath("OPTIONS", ((OPTIONS) annotation).value(), false);
          //如果是@HTTP 注解，则代表自定义 HTTP请求
      } else if (annotation instanceof HTTP) {
        HTTP http = (HTTP) annotation;
            //调用parseHttpMethodAndPath()
        parseHttpMethodAndPath(http.method(), http.path(), http.hasBody());
         //如果是 注解Headers 则代表请求头
      } else if (annotation instanceof retrofit2.http.Headers) {
        //获取对应的String 数组
        String[] headersToParse = ((retrofit2.http.Headers) annotation).value(); 
         //判断数组长度
        if (headersToParse.length == 0) {
          //这里可见如果一定使用@Headers 注解，则一定要有内容，否则会报错。
          throw methodError("@Headers annotation is empty.");
        }
         //调用parseHeaders()方法来解析headersToParse
        headers = parseHeaders(headersToParse);
         //如果 是Multipart注解，则代表用文件提交
      } else if (annotation instanceof Multipart) {
         //如果是文件提交，则不能使用表单提交，这是互斥的
        if (isFormEncoded) {
          throw methodError("Only one encoding annotation is allowed.");
        }
         //给isMultipart赋值为true
        isMultipart = true;
         //如果 是 FormUrlEncoded注解，则代表表单提交
      } else if (annotation instanceof FormUrlEncoded) {
         由于和文件提交互斥，要判断
        if (isMultipart) {
          throw methodError("Only one encoding annotation is allowed.");
        }
        //给isFormEncoded赋值
        isFormEncoded = true;
      }
    }

 
 
这个没什么流程，就是不断if else的过程，其中先是判断注解的类型，根据不同的类型来调用parseHttpMethodAndPath方法，这里主要指的是DELETE、GET、HEAD、PATCH、POST、PUT、OPTIONS请求，当然也包括自定义的HTTP请求。然后判断如果Headers，则说明要向请求头里面添加数据。最后做了表单提交和二进制流提交的互斥。那我们接来下就来看下对应的parseHttpMethodAndPath()方法。
 
 
3.2.6、 Builder的方法parseHttpMethodAndPath解析
 
 
通过方法名，我们理解这个方法主要是"解析HTTP的请求方法和路径"，我们一起来看下源码
 
 
 private void parseHttpMethodAndPath(String httpMethod, String value, boolean hasBody) {
      //因为Http请求只能设置一种请求方式，所以先做判断是否已经设置过请求方式，如果设置过则不能重复设置
      if (this.httpMethod != null) {
        throw methodError("Only one HTTP method is allowed. Found: %s and %s.",
            this.httpMethod, httpMethod);
      }
      //设置请求方式
      this.httpMethod = httpMethod;
      //根据不同的请求方式来设置是否需要请求体
      this.hasBody = hasBody;
       //如果注解中没有内容，则返回，因为不需要处理
      if (value.isEmpty()) {
        return;
      }
      //如果在注解的值中存在查询字段，则
      // Get the relative URL path and existing query string, if present.
       //获取注解的值中存在'?'字符的位置
      int question = value.indexOf('?');
         //如果存在，且不是在最后面
      if (question != -1 && question < value.length() - 1) {
        // Ensure the query string does not have any named parameters.
        //确保这个查询字符没有对应的参数
        //获取'?'字符后面的字符串
        String queryParams = value.substring(question + 1);
         //根据正则表达来匹配
        Matcher queryParamMatcher = PARAM_URL_REGEX.matcher(queryParams);
        if (queryParamMatcher.find()) {
          throw methodError("URL query string \"%s\" must not have replace block. "
              + "For dynamic query parameters use @Query.", queryParams);
        }
      }
      //把value设置为相对路径的值
      this.relativeUrl = value;
       //最后调用parsePathParameters方法来放置出现重复参数
      this.relativeUrlParamNames = parsePathParameters(value);
    }

 
 
大体流程如下：
 
 
 
 
 
 
     
  
  • 1、保证请求方式只设置一次
    •  
  
  • 2、设置请求方式和是否需要请求体
    •  
  
  • 3、如果value值为空则return
    •  
  
  • 4、判断value是否有 '?' 查询字段，有的则根据正则表达来判断，如果是符合PARAM_URL_REGEX规则则抛异常。
    •  
 
 
 
3.2.7、 Builder的方法parseHeaders解析
 
 
这个方法看方法名，可以理解解析请求头
 
 
    private Headers parseHeaders(String[] headers) {
      //new 了一个Headers.Builder()对象
      Headers.Builder builder = new Headers.Builder();
       //遍历 字符串数组
      for (String header : headers) {
        获取':'的position下标
        int colon = header.indexOf(':');
        //如果不存在字符':',或者在最前面，或者在最后面 这是不符合header标准，所以抛异常
        if (colon == -1 || colon == 0 || colon == header.length() - 1) {
          throw methodError(
              "@Headers value must be in the form \"Name: Value\". Found: \"%s\"", header);
        }
        //按照':'分类，在':'前面为name，在':'后面为value
        String headerName = header.substring(0, colon);
        String headerValue = header.substring(colon + 1).trim();
         //按照忽略大小写的方法来判断是否是"Content-Type"。
        if ("Content-Type".equalsIgnoreCase(headerName)) {
          如果是"Content-Type"，则来获取类型
          MediaType type = MediaType.parse(headerValue);
           //类型不能为null
          if (type == null) {
            throw methodError("Malformed content type: %s", headerValue);
          }
          把类型赋给contentType
          contentType = type;
        } else {
          //如果不是"Content-Type"，则添加到 Headers.Builder 里面
          builder.add(headerName, headerValue);
        }
      }
      //调用Headers.Builder的build()方法来返回一个okhttp3.Headers对象
      return builder.build();
    }

 
 
 
 
 
 
     
  
  • 1、new 一个Headers.Builder()对象
    •  
  
  • 2、for each遍历headersString数组
    •  
  
  • 3、以':'为分界线前面为key，后面是value
    •  
  
  • 4、如果key是"Content-Type"，则获取响应的类型
    •  
  
  • 5、把key和value作为一对，添加到builder中
    •  
  
  • 6、调用builder的build()来获取一个okhttp3.Headers对象，并把它返回。
    •  
 
 
 
由于受到的篇幅限制，剩下的内容我们将在下一篇文章中解读
 

                            
                        
                    
                    
                    

                    
                    
                    

                
                

                    
                

            
        
    
    

        
你可能感兴趣的:(Retrofit解析8之核心解析——ServiceMethod及注解1)

        

            

                
    
                    
  • 斤斤计较的婚姻到底有多难？
                        白心之岂必有为

                        
    很多人私聊我会问到在哪个人群当中斤斤计较的人最多？我都会回答他，一般婚姻出现问题的斤斤计较的人士会非常多，以我多年经验，在婚姻落的一塌糊涂的人当中，斤斤计较的人数占比在20～30%以上，也就是说10个婚姻出现问题的斤斤计较的人有2-3个有多不减。在婚姻出问题当中，有大量的心理不平衡的、尖酸刻薄的怨妇。在婚姻中仅斤斤计较有两种类型：第一种是物质上的，另一种是精神上的。在物质与精神上抠门已经严重的影响
    
                    
    • 
                    
  • 机器学习与深度学习间关系与区别
                        ℒℴѵℯ心·动ꦿ໊ོ꫞
人工智能学习深度学习python
                        
    一、机器学习概述定义机器学习（MachineLearning,ML）是一种通过数据驱动的方法，利用统计学和计算算法来训练模型，使计算机能够从数据中学习并自动进行预测或决策。机器学习通过分析大量数据样本，识别其中的模式和规律，从而对新的数据进行判断。其核心在于通过训练过程，让模型不断优化和提升其预测准确性。主要类型1.监督学习（SupervisedLearning）监督学习是指在训练数据集中包含输入
    
                    
    • 
                    
  • android系统selinux中添加新属性property
                        辉色投像

                        
    1.定位/android/system/sepolicy/private/property_contexts声明属性开头：persist.charge声明属性类型：u:object_r:system_prop:s0图12.定位到android/system/sepolicy/public/domain.te删除neverallow{domain-init}default_prop:property
    
                    
    • 
                    
  • 底层逆袭到底有多难，不甘平凡的你准备好了吗？让吴起给你说说
                        造命者说

                        
    底层逆袭到底有多难，不甘平凡的你准备好了吗？让吴起给你说说我叫吴起，生于公元前440年的战国初期，正是群雄并起、天下纷争不断的时候。后人说我是军事家、政治家、改革家，是兵家代表人物。评价我一生历仕鲁、魏、楚三国，通晓兵家、法家、儒家三家思想，在内政军事上都有极高的成就。周安王二十一年（公元前381年），因变法得罪守旧贵族，被人乱箭射死。我出生在卫国一个“家累万金”的富有家庭，从年轻时候起就不甘平凡
    
                    
    • 
                    
  • 2020-01-25
                        晴岚85

                        
    郑海燕坚持分享590天2020.1.24在生活中只存在两个问题。一个问题是：你知道想要达成的目标是什么，但却不知道如何才能达成；另一个问题是：你不知道你的目标是什么。前一个是行动的问题，后一个是结果的问题。通过制定具体的下一步行动，可以解决不知道如何开始行动的问题。而通过去想象结果，对结果做预估，可以解决找不着目标的问题。对于所有吸引我们注意力，想要完成的任务，你可以先想象一下，预期的结果究竟是什
    
                    
    • 
                    
  • 10月|愿你的青春不负梦想-读书笔记-01
                        Tracy的小书斋

                        
    本书的作者是俞敏洪，大家都很熟悉他了吧。俞敏洪老师是我行业的领头羊吧，也是我事业上的偶像。本日摘录他书中第一章中的金句：『一个人如果什么目标都没有，就会浑浑噩噩，感觉生命中缺少能量。能给我们能量的，是对未来的期待。第一件事，我始终为了进步而努力。与其追寻全世界的骏马，不如种植丰美的草原，到时骏马自然会来。第二件事，我始终有阶段性的目标。什么东西能给我能量？答案是对未来的期待。』读到这里的时候，我便
    
                    
    • 
                    
  • C语言宏函数
                        南林yan
C语言c语言
                        
    一、什么是宏函数？通过宏定义的函数是宏函数。如下，编译器在预处理阶段会将Add(x,y)替换为((x)*(y))#defineAdd(x,y)((x)*(y))#defineAdd(x,y)((x)*(y))intmain(){inta=10;intb=20;intd=10;intc=Add(a+d,b)*2;cout<
                    
    • 
                    
  • 谢谢你们，爱你们！
                        鹿游儿

                        
    昨天家人去泡温泉，二个孩子也带着去，出发前一晚，匆匆下班，赶回家和孩子一起收拾。饭后，我拿出笔和本子（上次去澳门时做手帐的本子）写下了1\2\3\4\5\6\7\8\9,让后让小壹去思考，带什么出发去旅游呢？她在对应的数字旁边画上了，泳衣、泳圈、肖恩、内衣内裤、tapuy、拖鞋……画完后，就让她自己对着这个本子，将要带的，一一带上，没想到这次带的书还是这本《便便工厂》(晚上姑婆发照片过来，妹妹累得
    
                    
    • 
                    
  • C语言如何定义宏函数？
                        小九格物
c语言
                        
    在C语言中，宏函数是通过预处理器定义的，它在编译之前替换代码中的宏调用。宏函数可以模拟函数的行为，但它们不是真正的函数，因为它们在编译时不会进行类型检查，也不会分配存储空间。宏函数的定义通常使用#define指令，后面跟着宏的名称和参数列表，以及宏展开后的代码。宏函数的定义方式：1.基本宏函数：这是最简单的宏函数形式，它直接定义一个表达式。#defineSQUARE(x)((x)*(x))2.带参
    
                    
    • 
                    
  • 微服务下功能权限与数据权限的设计与实现
                        nbsaas-boot
微服务java架构
                        
    在微服务架构下，系统的功能权限和数据权限控制显得尤为重要。随着系统规模的扩大和微服务数量的增加，如何保证不同用户和服务之间的访问权限准确、细粒度地控制，成为设计安全策略的关键。本文将讨论如何在微服务体系中设计和实现功能权限与数据权限控制。1.功能权限与数据权限的定义功能权限：指用户或系统角色对特定功能的访问权限。通常是某个用户角色能否执行某个操作，比如查看订单、创建订单、修改用户资料等。数据权限：
    
                    
    • 
                    
  • 理解Gunicorn：Python WSGI服务器的基石
                        范范0825
ipythonlinux运维
                        
    理解Gunicorn：PythonWSGI服务器的基石介绍Gunicorn，全称GreenUnicorn，是一个为PythonWSGI（WebServerGatewayInterface）应用设计的高效、轻量级HTTP服务器。作为PythonWeb应用部署的常用工具，Gunicorn以其高性能和易用性著称。本文将介绍Gunicorn的基本概念、安装和配置，帮助初学者快速上手。1.什么是Gunico
    
                    
    • 
                    
  • 学点心理知识，呵护孩子健康
                        静候花开_7090

                        
    昨天听了华中师范大学教育管理学系副教授张玲老师的《哪里才是学生心理健康的最后庇护所，超越教育与技术的思考》的讲座。今天又重新学习了一遍，收获匪浅。张玲博士也注意到了当今社会上的孩子由于心理问题导致的自残、自杀及伤害他人等恶性事件。她向我们普及了一个重要的命题，她说心理健康的一些基本命题，我们与我们通常的一些教育命题是不同的，她还举了几个例子，让我们明白我们原来以为的健康并非心理学上的健康。比如如果
    
                    
    • 
                    
  • 2021年12月19日，春蕾教育集团团建活动感受——黄晓丹
                        黄错错加油

                        
    感受:1.从陌生到熟悉的过程。游戏环节让我们在轻松的氛围中得到了锻炼，也增长了不少知识。2.游戏过程中，我们贡献的是个人力量，展现的是团队的力量。它磨合的往往不止是工作的熟悉，更是观念上契合度的贴近。3.这和工作是一样的道理。在各自的岗位上，每个人摆正自己的位置、各司其职充分发挥才能，并团结一致劲往一处使，才能实现最大的成功。新知:1.团队精神需要不断地创新。过去，人们把创新看作是冒风险，现在人们
    
                    
    • 
                    
  • Cell Insight | 单细胞测序技术又一新发现，可用于HIV-1和Mtb共感染个体诊断
                        尐尐呅

                        
    结核病是艾滋病合并其他疾病中导致患者死亡的主要原因。其中结核病由结核分枝杆菌（Mycobacteriumtuberculosis,Mtb）感染引起，获得性免疫缺陷综合症（艾滋病）由人免疫缺陷病毒（Humanimmunodeficiencyvirustype1,HIV-1）感染引起。国家感染性疾病临床医学研究中心/深圳市第三人民医院张国良团队携手深圳华大生命科学研究院吴靓团队，共同研究得出单细胞测序
    
                    
    • 
                    
  • c++ 的iostream 和 c++的stdio的区别和联系
                        黄卷青灯77
c++算法开发语言iostreamstdio
                        
    在C++中，iostream和C语言的stdio.h都是用于处理输入输出的库，但它们在设计、用法和功能上有许多不同。以下是两者的区别和联系：区别1.编程风格iostream（C++风格）：C++标准库中的输入输出流类库，支持面向对象的输入输出操作。典型用法是cin（输入）和cout（输出），使用>操作符来处理数据。更加类型安全，支持用户自定义类型的输入输出。#includeintmain(){in
    
                    
    • 
                    
  • 《投行人生》读书笔记
                        小蘑菇的树洞

                        
    《投行人生》----作者詹姆斯-A-朗德摩根斯坦利副主席40年的职业洞见-很短小精悍的篇幅，比较适合初入职场的新人。第一部分成功的职业生涯需要规划1.情商归为适应能力分享与协作同理心适应能力，更多的是自我意识，你有能力识别自己的情并分辨这些情绪如何影响你的思想和行为。2.对于初入职场的人的建议，细节，截止日期和数据很重要截止日期，一种有效的方法是请老板为你所有的任务进行优先级排序。和老板喝咖啡的好
    
                    
    • 
                    
  • 《策划经理回忆录之二》
                        路基雅虎

                        
    话说三年变六年，飘了，飘了……眨眼，2013年5月，老吴回到了他的家乡——油城从新开启他的工作幻想症生涯。很庆幸，这是一家很有追求，同时敢于尝试的，且实力不容低调的新星房企——金源置业(前身泰源置业)更值得庆幸的是第一个盘就是油城十路的标杆之一:金源盛世。2013年5月，到2015年11月，两年的陪伴，迎来了一场大爆发。2000个筹，5万/筹，直接回笼1个亿！！！这……让我开始认真审视这座看似五线
    
                    
    • 
                    
  • Long类型前后端数据不一致
                        igotyback
前端
                        
    响应给前端的数据浏览器控制台中response中看到的Long类型的数据是正常的到前端数据不一致前后端数据类型不匹配是一个常见问题，尤其是当后端使用Java的Long类型（64位）与前端JavaScript的Number类型（最大安全整数为2^53-1，即16位）进行数据交互时，很容易出现精度丢失的问题。这是因为JavaScript中的Number类型无法安全地表示超过16位的整数。为了解决这个问
    
                    
    • 
                    
  • swagger访问路径
                        igotyback
swagger
                        
    Swagger2.x版本访问地址：http://{ip}:{port}/{context-path}/swagger-ui.html{ip}是你的服务器IP地址。{port}是你的应用服务端口，通常为8080。{context-path}是你的应用上下文路径，如果应用部署在根路径下，则为空。Swagger3.x版本对于Swagger3.x版本（也称为OpenAPI3）访问地址：http://{ip
    
                    
    • 
                    
  • 扫地机类清洁产品之直流无刷电机控制
                        悟空胆好小
清洁服务机器人单片机人工智能
                        
    扫地机类清洁产品之直流无刷电机控制1.1前言扫地机产品有很多的电机控制，滚刷电机1个，边刷电机1-2个，清水泵电机，风机一个，部分中高端产品支持抹布功能，也就是存在抹布盘电机，还有追觅科沃斯石头等边刷抬升电机，滚刷抬升电机等的，这些电机有直流有刷电机，直接无刷电机，步进电机，电磁阀，挪动泵等不同类型。电机的原理，驱动控制方式也不行。接下来一段时间的几个文章会作个专题分析分享。直流有刷电机会自动持续
    
                    
    • 
                    
  • Linux下QT开发的动态库界面弹出操作（SDL2）
                        13jjyao
QT类qt开发语言sdl2linux
                        
    需求：操作系统为linux，开发框架为qt，做成需带界面的qt动态库，调用方为java等非qt程序难点：调用方为java等非qt程序，也就是说调用方肯定不带QApplication::exec()，缺少了这个，QTimer等事件和QT创建的窗口将不能弹出(包括opencv也是不能弹出)；这与qt调用本身qt库是有本质的区别的思路：1.调用方缺QApplication::exec()，那么我们在接口
    
                    
    • 
                    
  • 绘本讲师训练营【24期】8/21阅读原创《独生小孩》
                        1784e22615e0

                        
    24016-孟娟《独生小孩》图片发自App今天我想分享一个蛮特别的绘本，讲的是一个特殊的群体，我也是属于这个群体，80后的独生小孩。这是一本中国绘本，作者郭婧，也是一个80厚。全书一百多页，均为铅笔绘制，虽然为黑白色调，但并不显得沉闷。全书没有文字，犹如“默片”，但并不影响读者对该作品的理解，反而显得神秘，梦幻，給读者留下想象的空间。作者在前蝴蝶页这样写到：“我更希望父母和孩子一起分享这本书，使他
    
                    
    • 
                    
  • 店群合一模式下的社区团购新发展——结合链动 2+1 模式、AI 智能名片与 S2B2C 商城小程序源码
                        说私域
人工智能小程序
                        
    摘要：本文探讨了店群合一的社区团购平台在当今商业环境中的重要性和优势。通过分析店群合一模式如何将互联网社群与线下终端紧密结合，阐述了链动2+1模式、AI智能名片和S2B2C商城小程序源码在这一模式中的应用价值。这些创新元素的结合为社区团购带来了新的机遇，提升了用户信任感、拓展了营销渠道，并实现了线上线下的完美融合。一、引言随着互联网技术的不断发展，社区团购作为一种新兴的商业模式，在满足消费者日常需
    
                    
    • 
                    
  • 我校举行新老教师师徒结对仪式暨名师专业工作室工作交流活动
                        李蕾1229

                        
    为促进我校教师专业发展，发挥骨干教师的引领带头作用，11月6日下午，我校举行新老教师师徒结对仪式暨名师专业工作室工作交流活动。图片发自App会议由教师发展处李蕾主任主持，首先，由范校长宣读新老教师结对名单及双方承担职责。随后，两位新调入教师陈玉萍、莫正杰分别和他们的师傅鲍元美、刘召彬老师签订了师徒结对协议书。图片发自App图片发自App师徒拥抱、握手。有了师傅就有了目标有了方向，相信两位新教师在师
    
                    
    • 
                    
  • 向内而求
                        陈陈_19b4

                        
    10月27日，阴。阅读书目:《次第花开》。作者:希阿荣博堪布，是当今藏传佛家宁玛派最伟大的上师法王，如意宝晋美彭措仁波切颇具影响力的弟子之一。多年以来，赴海内外各地弘扬佛法，以正式授课、现场开示、发表文章等多种方法指导佛学弟子修行佛法。代表作《寂静之道》、《生命这出戏》、《透过佛法看世界》自出版以来一直是佛教类书籍中的畅销书。图片发自App金句:1.佛陀说，一切痛苦的根源在于我们长期以来对自身及外
    
                    
    • 
                    
  • 2021-08-26
                        影幽

                        
    在生活中，女人与男人的感悟往往有所不同。人生最大的舞台就是生活，大幕随时都可能拉开，关键是你愿不愿意表演都无法躲避。在生活中，遇事不要急躁，不要急于下结论，尤其生气时不要做决断，要学会换位思考，大事化小小事化了，把复杂的事情尽量简单处理，千万不要把简单的事情复杂化。永远不要扭曲，别人善意，无药可救。昨天是张过期的支票，明天是张信用卡，只有今天才是现金，要善加利用！执着的攀登者不必去与别人比较自己的
    
                    
    • 
                    
  • ArcGIS栅格计算器常见公式（赋值、0和空值的转换、补充栅格空值）
                        研学随笔
arcgis经验分享
                        
    我们在使用ArcGIS时通常经常用到栅格计算器，今天主要给大家介绍我日常中经常用到的几个公式，供大家参考学习。将特定值（-9999）赋值为0，例如-9999.Con("raster"==-9999,0,"raster")2.给空值赋予特定的值（如0）Con(IsNull("raster"),0,"raster")3.将特定的栅格值(如1)赋值为空值，其他保留原值SetNull("raster"==
    
                    
    • 
                    
  • 高级编程--XML+socket练习题
                        masa010
java开发语言
                        
    1.北京华北2114.8万人上海华东2,500万人广州华南1292.68万人成都华西1417万人（1）使用dom4j将信息存入xml中（2）读取信息，并打印控制台（3）添加一个city节点与子节点（4）使用socketTCP协议编写服务端与客户端，客户端输入城市ID，服务器响应相应城市信息（5）使用socketTCP协议编写服务端与客户端，客户端要求用户输入city对象，服务端接收并使用dom4j
    
                    
    • 
                    
  • 抖音乐买买怎么加入赚钱?赚钱方法是什么
                        测评君高省

                        
    你会在抖音买东西吗?如果会，那么一定要免费注册一个乐买买，抖音直播间，橱窗，小视频里的小黄车买东西都可以返佣金!省下来都是自己的，分享还可以赚钱乐买买是好省旗下的抖音返佣平台，乐买买分析社交电商的价值，乐买买属于今年难得的副业项目风口机会，2019年错过做好省的搞钱的黄金时期，那么2022年千万别再错过乐买买至于我为何转到高省呢？当然是高省APP佣金更高，模式更好，终端用户不流失。【高省】是一个自
    
                    
    • 
                    
  • 开心
                        蒋泳频

                        
    从无比抗拒来上课到接受，感动，收获～看着波哥成长，晶晶幸福笑容满面。感觉自己做的事情很有意义，很开心！还有3个感召目标就是还有三个有缘人，哈哈。明天感召去明日计划：8：30-11：00小公益11：00-21点上班，感召图片发自App图片发自App图片发自App
    
                    
    • 
                                
  • Linux的Initrd机制
                                    被触发
linux
                                    
    Linux 的 initrd 技术是一个非常普遍使用的机制，linux2.6 内核的 initrd 的文件格式由原来的文件系统镜像文件转变成了 cpio 格式，变化不仅反映在文件格式上， linux 内核对这两种格式的 initrd 的处理有着截然的不同。本文首先介绍了什么是 initrd 技术，然后分别介绍了 Linux2.4 内核和 2.6 内核的 initrd 的处理流程。最后通过对 Lin
    
                                
    • 
                                
  • maven本地仓库路径修改
                                    bitcarter
maven
                                    
    默认maven本地仓库路径：C:\Users\Administrator\.m2 
 
修改maven本地仓库路径方法： 
    
1.打开E:\maven\apache-maven-2.2.1\conf\settings.xml 
    
2.找到 
       
    
                                
    • 
                                
  • XSD和XML中的命名空间
                                    darrenzhu
xmlxsdschemanamespace命名空间
                                    
    http://www.360doc.com/content/12/0418/10/9437165_204585479.shtml 

http://blog.csdn.net/wanghuan203/article/details/9203621 

http://blog.csdn.net/wanghuan203/article/details/9204337 
 

http://www.cn
    
                                
    • 
                                
  • Java 求素数运算
                                    周凡杨
java算法素数
                                    
    网络上对求素数之解数不胜数，我在此总结归纳一下，同时对一些编码，加以改进，效率有成倍热提高。   
第一种：    
  
原理: 6N(+-)1法              任何一个自然数，总可以表示成为如下的形式之一： 6N，6N+1，6N+2，6N+3，6N+4，6N+5 (N=0，1，2，…)    
    
                                
    • 
                                
  • java 单例模式
                                    g21121
java
                                    
    想必单例模式大家都不会陌生，有如下两种方式来实现单例模式： 
  
class Singleton {
  private static Singleton instance=new Singleton();
  private Singleton(){}
  static Singleton getInstance() {
      return instance;
  }
    
                                
    • 
                                
  • Linux下Mysql源码安装
                                    510888780
mysql
                                    
    1.假设已经有mysql-5.6.23-linux-glibc2.5-x86_64.tar.gz 
 
(1)创建mysql的安装目录及数据库存放目录       
解压缩下载的源码包，目录结构，特殊指定的目录除外： 
          
    
                                
    • 
                                
  • 32位和64位操作系统
                                    墙头上一根草
32位和64位操作系统
                                    
    32位和64位操作系统是指：CPU一次处理数据的能力是32位还是64位。现在市场上的CPU一般都是64位的，但是这些CPU并不是真正意义上的64 位CPU，里面依然保留了大部分32位的技术，只是进行了部分64位的改进。32位和64位的区别还涉及了内存的寻址方面，32位系统的最大寻址空间是2 的32次方= 4294967296（bit）= 4（GB）左右，而64位系统的最大寻址空间的寻址空间则达到了
    
                                
    • 
                                
  • 我的spring学习笔记10-轻量级_Spring框架
                                    aijuans
Spring 3
                                    
    一、问题提问： 
 
    → 请简单介绍一下什么是轻量级？ 
 
    轻量级（Leightweight）是相对于一些重量级的容器来说的，比如Spring的核心是一个轻量级的容器，Spring的核心包在文件容量上只有不到1M大小，使用Spring核心包所需要的资源也是很少的，您甚至可以在小型设备中使用Spring。 
 
 
    
                                
    • 
                                
  • mongodb 环境搭建及简单CURD
                                    antlove
WebInstallcurdNoSQLmongo
                                    
    一 搭建mongodb环境 
1. 在mongo官网下载mongodb 
2. 在本地创建目录 "D:\Program Files\mongodb-win32-i386-2.6.4\data\db" 
3. 运行mongodb服务 [mongod.exe --dbpath "D:\Program Files\mongodb-win32-i386-2.6.4\data\
    
                                
    • 
                                
  • 数据字典和动态视图
                                    百合不是茶
oracle数据字典动态视图系统和对象权限
                                    
    数据字典（data dictionary）是 Oracle 数据库的一个重要组成部分，这是一组用于记录数据库信息的只读（read-only）表。随着数据库的启动而启动,数据库关闭时数据字典也关闭   数据字典中包含 
  
 
 数据库中所有方案对象（schema object）的定义(包括表，视图，索引，簇，同义词，序列，过程，函数，包，触发器等等) 
 数据库为一
    
                                
    • 
                                
  • 多线程编程一般规则
                                    bijian1013
javathread多线程java多线程
                                    
           如果两个工两个以上的线程都修改一个对象，那么把执行修改的方法定义为被同步的，如果对象更新影响到只读方法，那么只读方法也要定义成同步的。 
       不要滥用同步。如果在一个对象内的不同的方法访问的不是同一个数据，就不要将方法设置为synchronized的。 

    
                                
    • 
                                
  • 将文件或目录拷贝到另一个Linux系统的命令scp
                                    bijian1013
linuxunixscp
                                    
    一.功能说明        scp就是security copy，用于将文件或者目录从一个Linux系统拷贝到另一个Linux系统下。scp传输数据用的是SSH协议，保证了数据传输的安全，其格式如下：        scp 远程用户名@IP地址：文件的绝对路径
    
                                
    • 
                                
  • 【持久化框架MyBatis3五】MyBatis3一对多关联查询
                                    bit1129
Mybatis3
                                    
    以教员和课程为例介绍一对多关联关系，在这里认为一个教员可以叫多门课程，而一门课程只有1个教员教，这种关系在实际中不太常见，通过教员和课程是多对多的关系。 
  示例数据：
  
  
地址表： 
  
CREATE TABLE ADDRESSES 
(
  ADDR_ID INT(11) NOT NULL AUTO_INCREMENT,
  STREET VAR
    
                                
    • 
                                
  • cookie状态判断引发的查找问题
                                    bitcarter
formcgi
                                    
    先说一下我们的业务背景： 
1.前台将图片和文本通过form表单提交到后台，图片我们都做了base64的编码，并且前台图片进行了压缩 
2.form中action是一个cgi服务 
3.后台cgi服务同时供PC，H5，APP 
4.后台cgi中调用公共的cookie状态判断方法（公共的，大家都用，几年了没有问题） 
 
问题：（折腾两天。。。。） 
1.PC端cgi服务正常调用，cookie判断没
    
                                
    • 
                                
  • 通过Nginx,Tomcat访问日志(access log)记录请求耗时
                                    ronin47

                                    
    一、Nginx通过$upstream_response_time $request_time统计请求和后台服务响应时间 
nginx.conf使用配置方式： 
log_format main '$remote_addr - $remote_user [$time_local] "$request" ''$status $body_bytes_sent "$http_r
    
                                
    • 
                                
  • java-67- n个骰子的点数。 把n个骰子扔在地上，所有骰子朝上一面的点数之和为S。输入n，打印出S的所有可能的值出现的概率。
                                    bylijinnan
java
                                    
    

public class ProbabilityOfDice {

	/**
	 * Q67 n个骰子的点数
	 * 把n个骰子扔在地上，所有骰子朝上一面的点数之和为S。输入n，打印出S的所有可能的值出现的概率。
	 * 在以下求解过程中，我们把骰子看作是有序的。
	 * 例如当n=2时，我们认为（1，2）和（2，1）是两种不同的情况
	 */
	private stati
    
                                
    • 
                                
  • 看别人的博客，觉得心情很好
                                    Cb123456
博客心情
                                    
       以为写博客，就是总结，就和日记一样吧，同时也在督促自己。今天看了好长时间博客: 
   职业规划: 
   http://www.iteye.com/blogs/subjects/zhiyeguihua 
  
   android学习: 
   1.http://byandby.i
    
                                
    • 
                                
  • [JWFD开源工作流]尝试用原生代码引擎实现循环反馈拓扑分析
                                    comsci
工作流
                                    
     
    我们已经不满足于仅仅跳跃一次，通过对引擎的升级，今天我测试了一下循环反馈模式，大概跑了200圈，引擎报一个溢出错误 
 
     在一个流程图的结束节点中嵌入一段方程，每次引擎运行到这个节点的时候，通过实时编译器GM模块，计算这个方程，计算结果与预设值进行比较，符合条件则跳跃到开始节点，继续新一轮拓扑分析，直到遇到
    
                                
    • 
                                
  • JS常用的事件及方法
                                    cwqcwqmax9
js
                                    
    事件 描述 
onactivate 当对象设置为活动元素时触发。 
onafterupdate 当成功更新数据源对象中的关联对象后在数据绑定对象上触发。 
onbeforeactivate 对象要被设置为当前元素前立即触发。 
onbeforecut 当选中区从文档中删除之前在源对象触发。 
onbeforedeactivate 在 activeElement 从当前对象变为父文档其它对象之前立即
    
                                
    • 
                                
  • 正则表达式验证日期格式
                                    dashuaifu
正则表达式IT其它java其它
                                    
                     正则表达式验证日期格式

function isDate(d){
 var v = d.match(/^(\d{4})-(\d{1,2})-(\d{1,2})$/i);
 if(!v) {
  this.focus();
  return false;
 }
}
<input value="2000-8-8" onblu
    
                                
    • 
                                
  • Yii CModel.rules() 方法 、validate预定义完整列表、以及说说验证
                                    dcj3sjt126com
yii
                                    
    public array rules () {return} array 要调用 validate() 时应用的有效性规则。 返回属性的有效性规则。声明验证规则，应重写此方法。 每个规则是数组具有以下结构：array('attribute list', 'validator name', 'on'=>'scenario name', ...validation 
    
                                
    • 
                                
  • UITextAttributeTextColor = deprecated in iOS 7.0
                                    dcj3sjt126com
ios
                                    
    In this lesson we used the key "UITextAttributeTextColor" to change the color of the UINavigationBar appearance to white. This prompts a warning "first deprecated in iOS 7.0." 
Ins
    
                                
    • 
                                
  • 判断一个数是质数的几种方法
                                    EmmaZhao
Mathpython
                                    
    质数也叫素数，是只能被1和它本身整除的正整数，最小的质数是2，目前发现的最大的质数是p=2^57885161-1【注1】。 
判断一个数是质数的最简单的方法如下： 
 

def isPrime1(n):
	for i in range(2, n):
		if n % i == 0:
			return False
	return True
 
但是在上面的方法中有一些冗余的计算，所以
    
                                
    • 
                                
  • SpringSecurity工作原理小解读
                                    坏我一锅粥
SpringSecurity
                                    
     
   SecurityContextPersistenceFilter 
   ConcurrentSessionFilter 
   WebAsyncManagerIntegrationFilter 
   HeaderWriterFilter 
   CsrfFilter 
   LogoutFilter 
   Use
    
                                
    • 
                                
  • JS实现自适应宽度的Tag切换
                                    ini
JavaScripthtmlWebcsshtml5
                                    
    效果体验：http://hovertree.com/texiao/js/3.htm 
  
该效果使用纯JavaScript代码，实现TAB页切换效果，TAB标签根据内容自适应宽度，点击TAB标签切换内容页。 
HTML文件代码： 
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"
    
                                
    • 
                                
  • Hbase Rest API : 数据查询
                                    kane_xie
RESThbase
                                    
    hbase（hadoop）是用java编写的，有些语言（例如python）能够对它提供良好的支持，但也有很多语言使用起来并不是那么方便，比如c#只能通过thrift访问。Rest就能很好的解决这个问题。Hbase的org.apache.hadoop.hbase.rest包提供了rest接口，它内嵌了jetty作为servlet容器。 
  
启动命令：./bin/hbase rest s
    
                                
    • 
                                
  • JQuery实现鼠标拖动元素移动位置（源码+注释）
                                    明子健
jqueryjs源码拖动鼠标
                                    
    欢迎讨论指正！ 
  
print.html代码： 
<!DOCTYPE html>
<html>
<head>
<meta http-equiv=Content-Type content="text/html;charset=utf-8">
<title>发票打印</title>
&l
    
                                
    • 
                                
  • Postgresql 连表更新字段语法 update
                                    qifeifei
PostgreSQL
                                    
    下面这段sql本来目的是想更新条件下的数据，可是这段sql却更新了整个表的数据。sql如下： 
UPDATE tops_visa.visa_order
SET op_audit_abort_pass_date = now()
FROM
	tops_visa.visa_order as  t1
INNER JOIN tops_visa.visa_visitor as t2 
ON t1. 
    
                                
    • 
                                
  • 将redis,memcache结合使用的方案?
                                    tcrct
rediscache
                                    
    公司架构上使用了阿里云的服务，由于阿里的kvstore收费相当高，打算自建，自建后就需要自己维护，所以就有了一个想法，针对kvstore(redis)及ocs(memcache)的特点，想自己开发一个cache层，将需要用到list，set，map等redis方法的继续使用redis来完成，将整条记录放在memcache下，即findbyid，save等时就memcache，其它就对应使用redi
    
                                
    • 
                                
  • 开发中遇到的诡异的bug
                                    wudixiaotie
bug
                                    
    今天我们服务器组遇到个问题： 
我们的服务是从Kafka里面取出数据，然后把offset存储到ssdb中，每个topic和partition都对应ssdb中不同的key，服务启动之后，每次kafka数据更新我们这边收到消息，然后存储之后就发现ssdb的值偶尔是-2,这就奇怪了，最开始我们是在代码中打印存储的日志，发现没什么问题，后来去查看ssdb的日志，才发现里面每次set的时候都会对同一个key
    
                                
    •