隔壁老李头
隔壁老李头

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

整体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之感谢

由于简述篇幅的限制，接上一篇文章继续

3.2.8、 Builder的方法parseParameter解析

看名字这个方法我们理解为解析参数的方法

    private ParameterHandler parseParameter(
        int p, Type parameterType, Annotation[] annotations) {
      // 定义一个ParameterHandler 变量
      ParameterHandler result = null;
      //parseParameterAnnotation方法来获取对应的ParameterHandler对象
      for (Annotation annotation : annotations) {
        ParameterHandler annotationAction = parseParameterAnnotation(
            p, parameterType, annotations, annotation);
        if (annotationAction == null) {
          continue;
        }
        if (result != null) {
          throw parameterError(p, "Multiple Retrofit annotations found, only one allowed.");
        }
       //对之前定义的变量赋值
        result = annotationAction;
      }
      //非空检查
      if (result == null) {
        throw parameterError(p, "No Retrofit annotation found.");
      }
      return result;
    }

这个方法内部很简单，主要就是通过遍历annotations，内部调用parseParameterAnnotation来获取ParameterHandler对象并返回。
那让我们来看看parseParameterAnnotation()方法里面是怎么调用的

3.2.9、 Builder的方法parseParameterAnnotation解析
private ParameterHandler parseParameterAnnotation(
        int p, Type type, Annotation[] annotations, Annotation annotation) {
        //如果注解是 @Url
      if (annotation instanceof Url) {
         //默认是在这里给gotUrl赋值的，且只能赋值一次，如果gotUrl==true，则说明之前赋值过，抛异常
        if (gotUrl) {
          throw parameterError(p, "Multiple @Url method annotations found.");
        }
        //@Url 注解和@Path 是互斥的，所以不能并存，发现并存则抛异常
        if (gotPath) {
          throw parameterError(p, "@Path parameters may not be used with @Url.");
        }
        //如果已经使用了@Query、@QueryMap或者@QueryName，会出问题，因为应该先使用@Url 后才能配置Query等的注解
        if (gotQuery) {
          throw parameterError(p, "A @Url parameter must not come after a @Query");
        }
         //如果设置了relativeUrl，说明已经动态配置过url，所以这时候不能再使用@Url 注解
        if (relativeUrl != null) {
          throw parameterError(p, "@Url cannot be used with @%s URL", httpMethod);
        }
        //给gotUrl赋值为true
        gotUrl = true;
        //类型判断
        if (type == HttpUrl.class
            || type == String.class
            || type == URI.class
            || (type instanceof Class && "android.net.Uri".equals(((Class) type).getName()))) {
          //返回ParameterHandler的静态内部类RelativeUrl
          return new ParameterHandler.RelativeUrl();
           //至此解析@Url 完毕
        } else {
          throw parameterError(p,
              "@Url must be okhttp3.HttpUrl, String, java.net.URI, or android.net.Uri type.");
        }
        //如果是@ Path 注解
      } else if (annotation instanceof Path) {
         //如果已经设置了gotQuery,说明之前解析过@Query、@QueryMap或者@QueryName，这会导致动态配置的异常，所以抛异常
        if (gotQuery) {
          throw parameterError(p, "A @Path parameter must not come after a @Query.");
        }
        //上面解释过，@Path和@Url是互斥的
        if (gotUrl) {
          throw parameterError(p, "@Path parameters may not be used with @Url.");
        }
        //如果设置了relativeUrl为null，无法进行动态配置，所以会抛异常
        if (relativeUrl == null) {
          throw parameterError(p, "@Path can only be used with relative url on @%s", httpMethod);
        }
         //给gotPath赋值
        gotPath = true;
        //获取Path对象
        Path path = (Path) annotation;
        String name = path.value();
         //通过正则表达式检查是否符合要求
        validatePathName(p, name);
        //调用retrofit的stringConverter来获取一个转换器，通过泛型我们知道这个转化器的输出是String
        Converter converter = retrofit.stringConverter(type, annotations);
        //返回ParameterHandler的静态内部类Path对象
        return new ParameterHandler.Path<>(name, converter, path.encoded());
        //至此解析@Path结束
        //如果是@Query   注解
      } else if (annotation instanceof Query) {
         //类型转化，获取对应的值
        Query query = (Query) annotation;
        String name = query.value();
        boolean encoded = query.encoded();
        //获取真实的类型
        Class rawParameterType = Utils.getRawType(type);
        //给gotQuery赋值，说明已经使用了 注解
        gotQuery = true;
         //如果rawParameterType是Iterable接口的子类
        if (Iterable.class.isAssignableFrom(rawParameterType)) {
           //如果不是参数化的类型，则抛出异常
          if (!(type instanceof ParameterizedType)) {
            throw parameterError(p, rawParameterType.getSimpleName()
                + " must include generic type (e.g., "
                + rawParameterType.getSimpleName()
                + ")");
          }
          //如果是参数化的类型，则进行强制类型转化
          ParameterizedType parameterizedType = (ParameterizedType) type;
          //获取第一个入参的参数类型
          Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);
         //获取输出类型是String的转化器
          Converter converter =
              retrofit.stringConverter(iterableType, annotations);
          //构建ParameterHandler的内部静态类Query，然后调用iterable()方法 获取一个新的ParameterHandler对象
          return new ParameterHandler.Query<>(name, converter, encoded).iterable();
            //如果类型是数组类型的
        } else if (rawParameterType.isArray()) {
          //如果是基本基本类型则需要装箱操作
          Class arrayComponentType = boxIfPrimitive(rawParameterType.getComponentType());
          //获取输出类型是String的转化器
          Converter converter =
              retrofit.stringConverter(arrayComponentType, annotations);
           //构建ParameterHandler的内部静态类Query，然后调用array()方法 获取一个新的ParameterHandler对象。
          return new ParameterHandler.Query<>(name, converter, encoded).array();
        } else {
          //如果既不是集合也不是数组类型，则是普通类型
          //获取输出类型的是String的类型转化器
          Converter converter =
              retrofit.stringConverter(type, annotations);
          //构建ParameterHandler的内部静态类Query
          return new ParameterHandler.Query<>(name, converter, encoded);
        }
        //自此 解析@Query 完毕
        //如果是 @QueryName 注解
      } else if (annotation instanceof QueryName) {
        //获取QueryName 注解的值
        QueryName query = (QueryName) annotation;
        boolean encoded = query.encoded();
        //获取原始类型
        Class rawParameterType = Utils.getRawType(type);
        gotQuery = true;
         //如果rawParameterType是Iterable接口的子类
        if (Iterable.class.isAssignableFrom(rawParameterType)) {
          if (!(type instanceof ParameterizedType)) {
            throw parameterError(p, rawParameterType.getSimpleName()
                + " must include generic type (e.g., "
                + rawParameterType.getSimpleName()
                + ")");
          }
          //如果是参数化的类型，则进行强制类型转化
          ParameterizedType parameterizedType = (ParameterizedType) type;
            //获取第一个入参的参数类型
          Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);
          //获取输出类型是String的转化器
          Converter converter =
              retrofit.stringConverter(iterableType, annotations);
           //构建ParameterHandler的内部静态类QueryName，然后调用iterable()方法 获取一个新的ParameterHandler对象。
          return new ParameterHandler.QueryName<>(converter, encoded).iterable();
             //如果类型是数组类型的
        } else if (rawParameterType.isArray()) {
            //如果是基本基本类型则需要装箱操作
          Class arrayComponentType = boxIfPrimitive(rawParameterType.getComponentType());
          //获取输出类型是String的转化器
          Converter converter =
              retrofit.stringConverter(arrayComponentType, annotations);
            //构建ParameterHandler的内部静态类QueryName，然后调用array()方法 获取一个新的ParameterHandler对象。
          return new ParameterHandler.QueryName<>(converter, encoded).array();
        } else {
          //如果既不是集合也不是数组类型，则是普通类型
          //获取输出类型的是String的类型转化器
          Converter converter =
              retrofit.stringConverter(type, annotations);
             //构建ParameterHandler的内部静态类QueryName
          return new ParameterHandler.QueryName<>(converter, encoded);
        }
       //如果是 @QueryMap 注解，
      } else if (annotation instanceof QueryMap) {
          //获取原始的类型 
        Class rawParameterType = Utils.getRawType(type);
         //如果不是Map的接口的子类，抛异常
        if (!Map.class.isAssignableFrom(rawParameterType)) {
          throw parameterError(p, "@QueryMap parameter type must be Map.");
        }
         //获取类型的超类
        Type mapType = Utils.getSupertype(type, rawParameterType, Map.class);
        //如果不是参数类型，则抛异常
        if (!(mapType instanceof ParameterizedType)) {
          throw parameterError(p, "Map must include generic types (e.g., Map)");
        }
        //强制类型转化
        ParameterizedType parameterizedType = (ParameterizedType) mapType;
        //获取第一个入参的参数类型，其实就是map中key的类型，一般是String
        Type keyType = Utils.getParameterUpperBound(0, parameterizedType);
         //如果不是String 类型，则抛异常
        if (String.class != keyType) {
          throw parameterError(p, "@QueryMap keys must be of type String: " + keyType);
        }
         //获取第二个参数的类型,也就是value的值
        Type valueType = Utils.getParameterUpperBound(1, parameterizedType);
        //获取输出是String的转化器
        Converter valueConverter =
            retrofit.stringConverter(valueType, annotations);
         //构建ParameterHandler的内部静态类QueryMap，并返回
        return new ParameterHandler.QueryMap<>(valueConverter, ((QueryMap) annotation).encoded());
        //如果是@Header 注解
      } else if (annotation instanceof Header) {
        //获取header的值
        Header header = (Header) annotation;
        String name = header.value();
         //获取原始类型
        Class rawParameterType = Utils.getRawType(type);
          //如果是Iterable的子类
        if (Iterable.class.isAssignableFrom(rawParameterType)) {
           //参数类型判断
          if (!(type instanceof ParameterizedType)) {
            throw parameterError(p, rawParameterType.getSimpleName()
                + " must include generic type (e.g., "
                + rawParameterType.getSimpleName()
                + ")");
          }
          ParameterizedType parameterizedType = (ParameterizedType) type;
          //获取第一个参数的类型
          Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);
          //获取输出是String 类型的转化器
          Converter converter =
              retrofit.stringConverter(iterableType, annotations);
             //构建ParameterHandler的内部静态类Header，然后调用iterable()方法 获取一个新的ParameterHandler对象
          return new ParameterHandler.Header<>(name, converter).iterable();
           //如果是数组类型
        } else if (rawParameterType.isArray()) {
           //装箱操作
          Class arrayComponentType = boxIfPrimitive(rawParameterType.getComponentType());
          //获取输出为String 类型的 转换器
          Converter converter =
              retrofit.stringConverter(arrayComponentType, annotations);
                 //构建ParameterHandler的内部静态类Header，然后调用array()方法 获取一个新的ParameterHandler对象。
          return new ParameterHandler.Header<>(name, converter).array();
        } else {
           //如果既不是迭代器也不是数组，则是普通类型
          //获取输出为String 类型的 转换器
          Converter converter =
              retrofit.stringConverter(type, annotations);
           //构建ParameterHandler的内部静态类Header
          return new ParameterHandler.Header<>(name, converter);
        }
        //如果是@HeaderMap 注解
      } else if (annotation instanceof HeaderMap) {
         //获取参数的原始类型
        Class rawParameterType = Utils.getRawType(type);
        //如果不是Map接口类型的子类，则抛异常
        if (!Map.class.isAssignableFrom(rawParameterType)) {
          throw parameterError(p, "@HeaderMap parameter type must be Map.");
        }
         //获取类型的超类
        Type mapType = Utils.getSupertype(type, rawParameterType, Map.class);
          //参数类型判断
        if (!(mapType instanceof ParameterizedType)) {
          throw parameterError(p, "Map must include generic types (e.g., Map)");
        }
        ParameterizedType parameterizedType = (ParameterizedType) mapType;
         //获取第一个参数的类型，是key的类型
        Type keyType = Utils.getParameterUpperBound(0, parameterizedType);
        //key值 一定是String的，不是String 则抛异常
        if (String.class != keyType) {
          throw parameterError(p, "@HeaderMap keys must be of type String: " + keyType);
        }
         //获取value的类型
        Type valueType = Utils.getParameterUpperBound(1, parameterizedType);
        //获取输出是 String的转化器
        Converter valueConverter =
            retrofit.stringConverter(valueType, annotations);
        //构建ParameterHandler的内部静态类HeaderMap
        return new ParameterHandler.HeaderMap<>(valueConverter);
         // 如果是 @Field 
      } else if (annotation instanceof Field) {
         // 如果没有使用方法注解 @isFormEncoded，却使用参数注解@Field，则抛出异常
        if (!isFormEncoded) {
          throw parameterError(p, "@Field parameters can only be used with form encoding.");
        }  
        // 获取 注解的内容
        Field field = (Field) annotation;
        String name = field.value();
        boolean encoded = field.encoded();
        // 给gotField赋值
        gotField = true;
         //获取原始类型
        Class rawParameterType = Utils.getRawType(type);
         // 如果是Iterable类的子类
        if (Iterable.class.isAssignableFrom(rawParameterType)) {
          // 参数类型判断
          if (!(type instanceof ParameterizedType)) {
            throw parameterError(p, rawParameterType.getSimpleName()
                + " must include generic type (e.g., "
                + rawParameterType.getSimpleName()
                + ")");
          }
          ParameterizedType parameterizedType = (ParameterizedType) type;
           // 获取第一个参数的类型
          Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);
           //获取 输出是String类型的 转化器
          Converter converter =
              retrofit.stringConverter(iterableType, annotations);
             //构建ParameterHandler的内部静态类Field，然后调用iterable()方法 获取一个新的ParameterHandler对象
          return new ParameterHandler.Field<>(name, converter, encoded).iterable();
          //如果是 数组类型
        } else if (rawParameterType.isArray()) {
           //装箱操作
          Class arrayComponentType = boxIfPrimitive(rawParameterType.getComponentType());
          //获取输出是String的 转化器
          Converter converter =
              retrofit.stringConverter(arrayComponentType, annotations);
               //构建ParameterHandler的内部静态类Field，然后调用array()方法 获取一个新的ParameterHandler对象。
          return new ParameterHandler.Field<>(name, converter, encoded).array();
        } else {
          // 如果既不是集合也不是数组类型，则是普通类型
          //获取 输出是String类型转化器
          Converter converter =
              retrofit.stringConverter(type, annotations);
           //构建ParameterHandler的内部静态类Field
          return new ParameterHandler.Field<>(name, converter, encoded);
        }
         //如果@注解 是FieldMap
      } else if (annotation instanceof FieldMap) {
          //如果不是表单提交则抛异常
        if (!isFormEncoded) {
          throw parameterError(p, "@FieldMap parameters can only be used with form encoding.");
        }
         //获取原始类型
        Class rawParameterType = Utils.getRawType(type);
         // 如果不是Map接口 ，抛 异常
        if (!Map.class.isAssignableFrom(rawParameterType)) {
          throw parameterError(p, "@FieldMap parameter type must be Map.");
        }
         // 获取 类型的 超类
        Type mapType = Utils.getSupertype(type, rawParameterType, Map.class);
         // 参数类型判断
        if (!(mapType instanceof ParameterizedType)) {
          throw parameterError(p,
              "Map must include generic types (e.g., Map)");
        }
        ParameterizedType parameterizedType = (ParameterizedType) mapType;
         // 获取key的 类型
        Type keyType = Utils.getParameterUpperBound(0, parameterizedType);
         // key值一定是String
        if (String.class != keyType) {
          throw parameterError(p, "@FieldMap keys must be of type String: " + keyType);
        }
         // 获取value的 类型
        Type valueType = Utils.getParameterUpperBound(1, parameterizedType);
        // 获取 输出类型是String的转化器
        Converter valueConverter =
            retrofit.stringConverter(valueType, annotations);
         //给 gotField 赋值
        gotField = true;
        //构建ParameterHandler的内部静态类FieldMap。
        return new ParameterHandler.FieldMap<>(valueConverter, ((FieldMap) annotation).encoded());
       // 如果 是@ Part 注解
      } else if (annotation instanceof Part) {
        //如果没有使用@isMultipart 注解则抛异常
        if (!isMultipart) {
          throw parameterError(p, "@Part parameters can only be used with multipart encoding.");
        }
        //获取 @Part 注解的值
        Part part = (Part) annotation;
        gotPart = true;
        String partName = part.value();
         //获取原始类型
        Class rawParameterType = Utils.getRawType(type);
         //如果 partName 是空的
        if (partName.isEmpty()) {
           // 类型是Iterable接口的子类
          if (Iterable.class.isAssignableFrom(rawParameterType)) {
             // 如果不是参数类型，则抛异常
            if (!(type instanceof ParameterizedType)) {
              throw parameterError(p, rawParameterType.getSimpleName()
                  + " must include generic type (e.g., "
                  + rawParameterType.getSimpleName()
                  + ")");
            }
            ParameterizedType parameterizedType = (ParameterizedType) type;
            // 获取第一个参数的类型
            Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);
            //如果原始类型不是MultipartBody.Part的子类，则抛异常
            if (!MultipartBody.Part.class.isAssignableFrom(Utils.getRawType(iterableType))) {
              throw parameterError(p,
                  "@Part annotation must supply a name or use MultipartBody.Part parameter type.");
            }
            // 返回ParameterHandler内部类RawPart.INSTANCE的iterable()方法
            return ParameterHandler.RawPart.INSTANCE.iterable();
            //如果是数组类型
          } else if (rawParameterType.isArray()) {
             // 获取类的组件类型的数组
            Class arrayComponentType = rawParameterType.getComponentType();
            //如果不是Part类子类，则抛异常
            if (!MultipartBody.Part.class.isAssignableFrom(arrayComponentType)) {
              throw parameterError(p,
                  "@Part annotation must supply a name or use MultipartBody.Part parameter type.");
            }
           // 返回ParameterHandler内部类RawPart.INSTANCE的array()方法
            return ParameterHandler.RawPart.INSTANCE.array();
            //如果是MultipartBody.Part的子类
          } else if 
(MultipartBody.Part.class.isAssignableFrom(rawParameterType)) {
            return ParameterHandler.RawPart.INSTANCE;
          } else {
            throw parameterError(p,
                "@Part annotation must supply a name or use MultipartBody.Part parameter type.");
          }
          //partName不为空
        } else {
          //定义Header
          Headers headers =
              Headers.of("Content-Disposition", "form-data; name=\"" + partName + "\"",
                  "Content-Transfer-Encoding", part.encoding());
           //如果类型是Iterable的子类
          if (Iterable.class.isAssignableFrom(rawParameterType)) {
            //参数类型判断
            if (!(type instanceof ParameterizedType)) {
              throw parameterError(p, rawParameterType.getSimpleName()
                  + " must include generic type (e.g., "
                  + rawParameterType.getSimpleName()
                  + ")");
            }
            ParameterizedType parameterizedType = (ParameterizedType) type;
            //获取 第一个参数的类型
            Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);
              //使用@Part 注解且注解内部有值，则不能和MultipartBody.Part一起使用，例如：@Part("description") RequestBody description是可以的，@Part MultipartBody.Part file也是可以的，但是@Partt("file")  MultipartBody.Part file 是不可以的。
            if (MultipartBody.Part.class.isAssignableFrom(Utils.getRawType(iterableType))) {
              throw parameterError(p, "@Part parameters using the MultipartBody.Part must not "
                  + "include a part name in the annotation.");
            }
            //获取输出是RequestBody的转化器
            Converter converter =
                retrofit.requestBodyConverter(iterableType, annotations, methodAnnotations);
             // 返回ParameterHandler内部类Part的实例，然后调用的iterable()方法返回一个ParameterHandler对象
            return new ParameterHandler.Part<>(headers, converter).iterable();
             //如果类型是数组类型
          } else if (rawParameterType.isArray()) {
            //获取数组类型的类型
            Class arrayComponentType = boxIfPrimitive(rawParameterType.getComponentType());
           //同理不能使用MultipartBody.Part.和有值的@Part 注解
            if (MultipartBody.Part.class.isAssignableFrom(arrayComponentType)) {
              throw parameterError(p, "@Part parameters using the MultipartBody.Part must not "
                  + "include a part name in the annotation.");
            }
            //获取输出是RequestBody的转化器
            Converter converter =
                retrofit.requestBodyConverter(arrayComponentType, annotations, methodAnnotations);
             // 返回ParameterHandler内部类Part的实例，然后调用的array()方法返回一个ParameterHandler对象
            return new ParameterHandler.Part<>(headers, converter).array();
            //如果既不是数组也是Iterable,但是普通类型也不能让@Part的值有值且同时使用MultipartBody.Part
          } else if (MultipartBody.Part.class.isAssignableFrom(rawParameterType)) {
            throw parameterError(p, "@Part parameters using the MultipartBody.Part must not "
                + "include a part name in the annotation.");
          } else {
            //不是MultipartBody.Par类型，则获取输出是RequestBody的转化器
            Converter converter =
                retrofit.requestBodyConverter(type, annotations, methodAnnotations);
            //构建ParameterHandler的静态内部类Part
            return new ParameterHandler.Part<>(headers, converter);
          }
        }
      //如果是@PartMap 注解
      } else if (annotation instanceof PartMap) {
        //没有使用@isMultipart 抛异常。
        if (!isMultipart) {
          throw parameterError(p, "@PartMap parameters can only be used with multipart encoding.");
        }
        //给gotPart赋值
        gotPart = true;
         //获取原始类型
        Class rawParameterType = Utils.getRawType(type);
         //如果不是Map的类型，则抛异常
        if (!Map.class.isAssignableFrom(rawParameterType)) {
          throw parameterError(p, "@PartMap parameter type must be Map.");
        }
        //获取类型的超类
        Type mapType = Utils.getSupertype(type, rawParameterType, Map.class);
         //参数类型判断
        if (!(mapType instanceof ParameterizedType)) {
          throw parameterError(p, "Map must include generic types (e.g., Map)");
        }
        ParameterizedType parameterizedType = (ParameterizedType) mapType;
         //获取key的类型
        Type keyType = Utils.getParameterUpperBound(0, parameterizedType);
         //排除key不是String的类型
        if (String.class != keyType) {
          throw parameterError(p, "@PartMap keys must be of type String: " + keyType);
        }
        //获取value的类型
        Type valueType = Utils.getParameterUpperBound(1, parameterizedType);
        //@PartMap 不能和 @MultipartBody.Part 一起使用
        if (MultipartBody.Part.class.isAssignableFrom(Utils.getRawType(valueType))) {
          throw parameterError(p, "@PartMap values cannot be MultipartBody.Part. "
              + "Use @Part List or a different value type instead.");
        }
         //获取输出是RequestBody的 转换器
        Converter valueConverter =
            retrofit.requestBodyConverter(valueType, annotations, methodAnnotations);
        PartMap partMap = (PartMap) annotation;
         //构建ParameterHandler的内部静态类PartMap。
        return new ParameterHandler.PartMap<>(valueConverter, partMap.encoding());
        // 如果注解是 @Body
      } else if (annotation instanceof Body) {
         //@Body 注解是不能和 @FormEncoded @Multipart 注解一起使用，如果一起使用抛异常
        if (isFormEncoded || isMultipart) {
          throw parameterError(p,
              "@Body parameters cannot be used with form or multi-part encoding.");
        }
         //@Body 只能使用一次
        if (gotBody) {
          throw parameterError(p, "Multiple @Body method annotations found.");
        }
        // 输出是RequestBody的 转化器
        Converter converter;
        try {
          converter = retrofit.requestBodyConverter(type, annotations, methodAnnotations);
        } catch (RuntimeException e) {
          // Wide exception range because factories are user code.
          throw parameterError(e, p, "Unable to create @Body converter for %s", type);
        }
         //给gotBody赋值为true
        gotBody = true;
         //构建ParameterHandler的内部静态类Body。
        return new ParameterHandler.Body<>(converter);
      }
      //如果上面都处理，则说明使用了一个非Retrofit的的注解，返回null
      return null; // Not a Retrofit annotation.
    }

内容如下：

主要是根据具体的参数注解类型，然后具体处理。
补充一个问题：
Path注解与Url注解不能同时使用，否则会抛出paramterError错误，其实原因有很好理解，Path注解用于替换url路径中参数，这就要求在使用path注解时，必须赢存在请求路径，不然没法替换路径中指定的参数，而Url注解是在参数中指定的请求路径的，这个时候指定请求路径已经晚了，path注解找不到请求路径，更别提更换请求路径中的参数了。

3.2.10、 Builder的方法validatePathName解析

看方法名字 是检验路径名字

    private void validatePathName(int p, String name) {
      if (!PARAM_NAME_REGEX.matcher(name).matches()) {
        throw parameterError(p, "@Path parameter name must match %s. Found: %s",
            PARAM_URL_REGEX.pattern(), name);
      }
      // Verify URL replacement name is actually present in the URL path.
      if (!relativeUrlParamNames.contains(name)) {
        throw parameterError(p, "URL \"%s\" does not contain \"{%s}\".", relativeUrl, name);
      }
    }

根据正则表达式，来判断url是否正确

3.2.11、 Builder的方法createResponseConverter解析

通过方法名，我们猜是创建响应转化器

    private Converter createResponseConverter() {
       //获取方法的注解
      Annotation[] annotations = method.getAnnotations();
      try {
        //调用retrofit的responseBodyConverter()方法来获取一个输入是ResponseBody的转化器
        return retrofit.responseBodyConverter(responseType, annotations);
      } catch (RuntimeException e) { // Wide exception range because factories are user code.
        throw methodError(e, "Unable to create converter for %s", responseType);
      }
    }

主要是调用Retrofit的responseBodyConverter()来获取输入是ResponseBody的转化器，关于Retrofit我下面再介绍

3.2.12、 Builder的方法methodError解析

主要就是输出错误信息

    private RuntimeException methodError(String message, Object... args) {
      return methodError(null, message, args);
    }

    private RuntimeException methodError(Throwable cause, String message, Object... args) {
      message = String.format(message, args);
      return new IllegalArgumentException(message
          + "\n    for method "
          + method.getDeclaringClass().getSimpleName()
          + "."
          + method.getName(), cause);
    }
3.2.13、 Builder的方法parameterError解析

输出参数错误

    private RuntimeException parameterError(
        Throwable cause, int p, String message, Object... args) {
      return methodError(cause, message + " (parameter #" + (p + 1) + ")", args);
    }

    private RuntimeException parameterError(int p, String message, Object... args) {
      return methodError(message + " (parameter #" + (p + 1) + ")", args);
    }

至此，ServiceMethod类已经讲解完毕了，大家对这个类熟悉了吗？
ok，我们来看最后一个类Retrofit类

三、Retrofit

(一) 类注释

老规矩先来认识下这个类，首先看这个类的注释

Retrofit adapts a Java interface to HTTP calls by using annotations on the declared methods to define how requests are made. Create instances using {@linkplain Builder the builder} and pass your interface to {@link #create} to generate an implementation.

翻译一下：
Retroft把一个java接口的抽象方法 适配/转化 成一个HTTP的请求，它内部是使用解析接口内部的抽象方法上的注解来定义如何去发起请求。通过Builder可以创建Retroft的实例，通过调用create()方法来创建一个接口的具体实现类。

(二) 类代码解析

由于这个类的代码比价长，我就不全部粘贴，等用到时候再一一粘贴

1、变量解析

那我们来看下他对应的变量,内容不多也比较简单，比较复杂的，我直接在上注释了。

  //serviceMethod对象集合的缓存，用于重用，由于里面用到了反射，大家知道反射比较消耗性能，所以为了避免重复反射，节约性能，使用缓存，保证只反射一次。
  private final Map> serviceMethodCache = new ConcurrentHashMap<>();
  final okhttp3.Call.Factory callFactory;
  final HttpUrl baseUrl;
  //转化工厂  集合
  final List converterFactories;
  // 请求适配工厂  集合
  final List adapterFactories;
  // 回调的线程池
  final Executor callbackExecutor;
  //如果为true，程序是在做一个预处理的操作，只是提前创建了一些MethodHandler对象在缓存中。
  final boolean validateEagerly;
  • 以上所有变量都是final的，所以构造的时候赋值了，不会二次赋值
  • 这里提一下validateEagerly变量，他是和eagerlyValidateMethods对应的，后面再详细讲解。
2、构造函数解析
  Retrofit(okhttp3.Call.Factory callFactory, HttpUrl baseUrl,
      List converterFactories, List adapterFactories,
      Executor callbackExecutor, boolean validateEagerly) {
    this.callFactory = callFactory;
    this.baseUrl = baseUrl;
    this.converterFactories = unmodifiableList(converterFactories); // Defensive copy at call site.
    this.adapterFactories = unmodifiableList(adapterFactories); // Defensive copy at call site.
    this.callbackExecutor = callbackExecutor;
    this.validateEagerly = validateEagerly;
  }
  • 构造函数很简单，就是赋值
  • 里面调用了Collections.unmodifiableList的方法检查是否是List，注意他的导包"import static java.util.Collections.unmodifiableList",值得我们学习。
  • 构造既不是public也不是private，所以不能在包外直接new，所以我们要通过Builder来创建Retrofit对象
3、相关方法解析

由于create比较关键，我们最后解析

3.1、eagerlyValidateMethods方法解析
  private void eagerlyValidateMethods(Class service) {
     //获取平台对象，安卓对象是Platform.Android
    Platform platform = Platform.get();
    //获取service类的所有方法，然后遍历它的所有方法
    for (Method method : service.getDeclaredMethods()) {
      //由于Platform.Android没有实现isDefaultMethod方法，所以默认返回false
      if (!platform.isDefaultMethod(method)) {
        //调用loadServiceMethod()方法导入方法
        loadServiceMethod(method);
      }
    }
  }

具体流程如下：

  • 1、收取平台对象
  • 2、获取所有类的所有方法，这里补充一个知识点：getDeclaredMethods()方法返回的是类或接口声明的所有方法，包括public、protect、private、默认的方法，但不包括它继承的方法。当然也包括它所有实现接口的方法。getMethods()返回的是某个类的所有public的方法，包括其继承类的public方法，也包括实现接口的方法。
  • 3、遍历这类的所有方法
  • 4、由于Platform.Android没有重写isDefaultMethod()，所以platform.isDefaultMethod(method)默认返回false，Platform.Java8是重写了这个方法的，大家有兴趣的话可以去研究下。
  • 5、调用loadServiceMethod()方法

那么就让我们研究下loadServiceMethod这个方法

3.2、loadServiceMethod方法解析
  ServiceMethod loadServiceMethod(Method method) {
    //从缓冲中取出
    ServiceMethod result = serviceMethodCache.get(method);
    //如果缓存中有，直接取出
    if (result != null) return result;
    //如果缓存中没有，加上同步锁
    synchronized (serviceMethodCache) {
       //加上锁后，为了保证实时性，再去一次
      result = serviceMethodCache.get(method);
      //如果还没有
      if (result == null) {
        //直接构建一个ServiceMethod.Builder对象，然后调用ServiceMethod.Builder的builer方法构建一个ServiceMethod对象关于build方法刚刚讲过哦
        result = new ServiceMethod.Builder<>(this, method).build();
        把这个ServiceMethod 对象放入缓存中
        serviceMethodCache.put(method, result);
      }
    }
    //返回这个ServiceMethod 对象
    return result;
  }

其实看上面方法，其实就是一个一级缓存。先判断缓存中有没有，如果缓存中有，则直接返回，如果缓存没有，则获取一个，并添加到缓存中。

3.3、callFactory()、baseUrl()、callAdapterFactories() 、converterFactories()方法解析由于这四个方法比较简单，其实就是get方法获对应的属性，没什么好说的，就简单贴下代码，大家看下就好。
  /**
   * The factory used to create {@linkplain okhttp3.Call OkHttp calls} for sending a HTTP requests.
   * Typically an instance of {@link OkHttpClient}.
   */
  public okhttp3.Call.Factory callFactory() {
    return callFactory;
  }

  /** The API base URL. */
  public HttpUrl baseUrl() {
    return baseUrl;
  }

  /**
   * Returns a list of the factories tried when creating a
   * {@linkplain #callAdapter(Type, Annotation[])} call adapter}.
   */
  public List callAdapterFactories() {
    return adapterFactories;
  }

  /**
   * Returns a list of the factories tried when creating a
   * {@linkplain #requestBodyConverter(Type, Annotation[], Annotation[]) request body converter}, a
   * {@linkplain #responseBodyConverter(Type, Annotation[]) response body converter}, or a
   * {@linkplain #stringConverter(Type, Annotation[]) string converter}.
   */
  public List converterFactories() {
    return converterFactories;
  }
3.4、callAdapter() 方法解析

在上面ServiceMethod类中可是调用过这个方法的，大家还记得在哪里调用吗?是在ServiceMethod类中createCallAdapter()方法里面最后return的时候调用了，那我们来看下源码

  /**
   * Returns the {@link CallAdapter} for {@code returnType} from the available {@linkplain
   * #callAdapterFactories() factories}.
   *
   * @throws IllegalArgumentException if no call adapter available for {@code type}.
   */
  public CallAdapter callAdapter(Type returnType, Annotation[] annotations) {
    return nextCallAdapter(null, returnType, annotations);
  }

通过方法注释我们知道

从callAdapterFactories里面找到合适的CallAdapter，这个CallAdapter的返回值类型是returnType

大家看代码，其实内部调用的是nextCallAdapter()方法，那我们就来看下nextCallAdapter()方法

3.5、nextCallAdapter()方法解析
  /**
   * Returns the {@link CallAdapter} for {@code returnType} from the available {@linkplain
   * #callAdapterFactories() factories} except {@code skipPast}.
   *
   * @throws IllegalArgumentException if no call adapter available for {@code type}.
   */
  public CallAdapter nextCallAdapter(CallAdapter.Factory skipPast, Type returnType,
      Annotation[] annotations) {
     //非空判断
    checkNotNull(returnType, "returnType == null");
    checkNotNull(annotations, "annotations == null");
   //获取skipPast的位置，skpiPost属于被抛弃的一方
    int start = adapterFactories.indexOf(skipPast) + 1;
    //如果skipPast是null，则start=-1,如果skipPast存在则从skipPast的下一个位置开始遍历
    for (int i = start, count = adapterFactories.size(); i < count; i++) {
      //通过CallAdapter.Factory的get方法来获取对应的CallAdapter
      CallAdapter adapter = adapterFactories.get(i).get(returnType, annotations, this);
      if (adapter != null) {
        //如果adapter不为null，则返回adapter
        return adapter;
      }
    }
    // 如果遍历了，还是没有合适的，则抛异常，下面只不过在拼接错误信息
    StringBuilder builder = new StringBuilder("Could not locate call adapter for ")
        .append(returnType)
        .append(".\n");
    if (skipPast != null) {
      builder.append("  Skipped:");
      for (int i = 0; i < start; i++) {
        builder.append("\n   * ").append(adapterFactories.get(i).getClass().getName());
      }
      builder.append('\n');
    }
    builder.append("  Tried:");
    for (int i = start, count = adapterFactories.size(); i < count; i++) {
      builder.append("\n   * ").append(adapterFactories.get(i).getClass().getName());
    }
    throw new IllegalArgumentException(builder.toString());
  }

先来看下方法的注释：

除了skipPast(这个对象外)，从callAdapterFactories里面再找一个返回类型是returnType的CallAdapter 对象

内容很简单，主要是遍历callAdapterFactories里面，找到合适的CallAdapter，如果没有则抛出异常。

3.6、requestBodyConverter()方法解析
  /**
   * Returns a {@link Converter} for {@code type} to {@link RequestBody} from the available
   * {@linkplain #converterFactories() factories}.
   *
   * @throws IllegalArgumentException if no converter available for {@code type}.
   */
  public  Converter requestBodyConverter(Type type,
      Annotation[] parameterAnnotations, Annotation[] methodAnnotations) {
    return nextRequestBodyConverter(null, type, parameterAnnotations, methodAnnotations);
  }

从converterFactories里面找到一个合适的Converter，这个Converter的输出类型是RequestBody。

其实内部调用的是nextRequestBodyConverter，那我们看下这个nextRequestBodyConverter接口

3.7、nextRequestBodyConverter()方法解析
  /**
   * Returns a {@link Converter} for {@code type} to {@link RequestBody} from the available
   * {@linkplain #converterFactories() factories} except {@code skipPast}.
   *
   * @throws IllegalArgumentException if no converter available for {@code type}.
   */
  public  Converter nextRequestBodyConverter(Converter.Factory skipPast,
      Type type, Annotation[] parameterAnnotations, Annotation[] methodAnnotations) {
    //非空检查
    checkNotNull(type, "type == null");
    checkNotNull(parameterAnnotations, "parameterAnnotations == null");
    checkNotNull(methodAnnotations, "methodAnnotations == null");
    //获取被放弃的skipPast对象的位置，然后加1
    int start = converterFactories.indexOf(skipPast) + 1;
     //遍历converterFactories
    for (int i = start, count = converterFactories.size(); i < count; i++) {
      //获取对应的 Converter.Factory对象，然后调用requestBodyConverter()方法，
      Converter.Factory factory = converterFactories.get(i);
      Converter converter =
          factory.requestBodyConverter(type, parameterAnnotations, methodAnnotations, this);
      //由于requestBodyConverter()默认是返回null，所以只有重写过才会不为null
      if (converter != null) {
        //noinspection unchecked
        return (Converter) converter;
      }
    }
   // 如果遍历了，还是没有合适的，则抛异常，下面只不过在拼接错误信息
    StringBuilder builder = new StringBuilder("Could not locate RequestBody converter for ")
        .append(type)
        .append(".\n");
    if (skipPast != null) {
      builder.append("  Skipped:");
      for (int i = 0; i < start; i++) {
        builder.append("\n   * ").append(converterFactories.get(i).getClass().getName());
      }
      builder.append('\n');
    }
    builder.append("  Tried:");
    for (int i = start, count = converterFactories.size(); i < count; i++) {
      builder.append("\n   * ").append(converterFactories.get(i).getClass().getName());
    }
    throw new IllegalArgumentException(builder.toString());
  }

先来说下方法的注释

除了skipPast(这个对象外)，从converterFactories里面再找输出类型是RequestBody的converter 对象

内容很简单

有点类似于nextCallAdapter()，主要是遍历converterFactories，找到合适的converter，如果没有则抛出异常。

3.8、responseBodyConverter()方法解析
  /**
   * Returns a {@link Converter} for {@link ResponseBody} to {@code type} from the available
   * {@linkplain #converterFactories() factories}.
   *
   * @throws IllegalArgumentException if no converter available for {@code type}.
   */
  public  Converter responseBodyConverter(Type type, Annotation[] annotations) {
    return nextResponseBodyConverter(null, type, annotations);
  }

先看下方法的注释

从converterFactories里面找到一个合适的Converter，这个Converter的输如类型是ResponseBody。

其实内部调用时的nextResponseBodyConverter()，那我们来看下nextResponseBodyConverter()的具体实现。

3.9、nextResponseBodyConverter()方法解析
  /**
   * Returns a {@link Converter} for {@link ResponseBody} to {@code type} from the available
   * {@linkplain #converterFactories() factories} except {@code skipPast}.
   *
   * @throws IllegalArgumentException if no converter available for {@code type}.
   */
  public  Converter nextResponseBodyConverter(Converter.Factory skipPast,
      Type type, Annotation[] annotations) {
     //非空判断
    checkNotNull(type, "type == null");
    checkNotNull(annotations, "annotations == null");
    //获取被放弃的skipPast的位置，如果是null则是-1
    int start = converterFactories.indexOf(skipPast) + 1;
    //遍历converterFactories
    for (int i = start, count = converterFactories.size(); i < count; i++) {
      //通过responseBodyConverter()来获取一个输入是ResponseBody的Converter
      Converter converter =
          converterFactories.get(i).responseBodyConverter(type, annotations, this);
       //如果Converter不为null，则说明找到了
      if (converter != null) {
        //noinspection unchecked
        return (Converter) converter;
      }
    }
 // 如果遍历了，还是没有合适的，则抛异常，下面只不过在拼接错误信息
    StringBuilder builder = new StringBuilder("Could not locate ResponseBody converter for ")
        .append(type)
        .append(".\n");
    if (skipPast != null) {
      builder.append("  Skipped:");
      for (int i = 0; i < start; i++) {
        builder.append("\n   * ").append(converterFactories.get(i).getClass().getName());
      }
      builder.append('\n');
    }
    builder.append("  Tried:");
    for (int i = start, count = converterFactories.size(); i < count; i++) {
      builder.append("\n   * ").append(converterFactories.get(i).getClass().getName());
    }
    throw new IllegalArgumentException(builder.toString());
  }

先看下注释

除了skipPast(这个对象外)，从converterFactories里面再找一个输入类型是ResponseBody的Converter 对象

通过阅读源码，我们发现：

有点类似于nextRequestBodyConverter()，主要是遍历converterFactories，找到合适的converter，如果没有则抛出异常。

3.10、stringConverter()方法解析
  /**
   * Returns a {@link Converter} for {@code type} to {@link String} from the available
   * {@linkplain #converterFactories() factories}.
   */
  public  Converter stringConverter(Type type, Annotation[] annotations) {
     //非空判断
    checkNotNull(type, "type == null");
    checkNotNull(annotations, "annotations == null");
    //获取对应的 Converter.Factory对象
    for (int i = 0, count = converterFactories.size(); i < count; i++) {
       //然后调用stringConverter()方法获取对应的Converter对象
      Converter converter =
          converterFactories.get(i).stringConverter(type, annotations, this);
       //非空判断，因为如果找不到，则返回null
      if (converter != null) {
        //noinspection unchecked
        return (Converter) converter;
      }
    }
 // 如果遍历了，还是没有合适的，调用默认的转换器的toString()方法，默认的转换器是BuiltInConverters
    // Nothing matched. Resort to default converter which just calls toString().
    //noinspection unchecked
    return (Converter) BuiltInConverters.ToStringConverter.INSTANCE;
  }

先来看下方法的注释，翻译一下：

从converterFactories里面找到一个合适的Converter，这个Converter的输出类型是RequestBody。

实际内容也很简单，遍历converterFactories。获取Converter.Factory对象，调用这个对象的stringConverter()来获取Converter对象，如果Converter不为空，则证明取到了，如果没有取到，则调用默认的转化器来转化。

3.11、callbackExecutor()方法解析
  /**
   * The executor used for {@link Callback} methods on a {@link Call}. This may be {@code null},
   * in which case callbacks should be made synchronously on the background thread.
   */
  public Executor callbackExecutor() {
    return callbackExecutor;
  }

先翻译一下

这个线程池被用来执行一个请求的回调，在这种情况下，回调应该在后台线程上同步进行。

其实就会返回回调的线程池

3.12、newBuilder()方法解析

代码很简单，就是new一个Builder对象并返回

  public Builder newBuilder() {
    return new Builder(this);
  }

(三) 静态内部类Builder解析

1、老规矩先来看下类的注释
  /**
   * Build a new {@link Retrofit}.
   * 

   * Calling {@link #baseUrl} is required before calling {@link #build()}. All other methods
   * are optional.
   */

翻译一下:

通过调用一个build()方法来构建一个Retrofit对象，在build()之前需要调用baseUrl()方法，所有其他方法都是可选的。

2、看下变量

变量不多，我直接上注释了

    //平台
    private final Platform platform;
    //okhttp3的callFactory
    private okhttp3.Call.Factory callFactory;
     //HttpUrl
    private HttpUrl baseUrl;
    //converterFactories集合
    private final List converterFactories = new ArrayList<>();
    //adapterFactories 集合
    private final List adapterFactories = new ArrayList<>();
    //回调线程池
    private Executor callbackExecutor;
     //是否需要提前检查的布尔变量
    private boolean validateEagerly;

通过上述代码我们可以得出以下信息

  • 1、converterFactories和adapterFactories一定是不为null的
  • 2、platform是final的，初始化的时候一定要赋值的
3、构造函数

Builder有三个构造函数，一个是无参的public，两个是包内的，所以，外部调用一定是new无参的构造函数

    Builder(Platform platform) {
      this.platform = platform;
      // Add the built-in converter factory first. This prevents overriding its behavior but also
      // ensures correct behavior when using converters that consume all types.
      converterFactories.add(new BuiltInConverters());
    }
    public Builder() {
      this(Platform.get());
    }

    Builder(Retrofit retrofit) {
      platform = Platform.get();
      callFactory = retrofit.callFactory;
      baseUrl = retrofit.baseUrl;
      converterFactories.addAll(retrofit.converterFactories);
      adapterFactories.addAll(retrofit.adapterFactories);
      // Remove the default, platform-aware call adapter added by build().
      adapterFactories.remove(adapterFactories.size() - 1);
      callbackExecutor = retrofit.callbackExecutor;
      validateEagerly = retrofit.validateEagerly;
    }
  • 1、无参数的构造函数其实内部调用的是入参是Platform的构造函数，Platform.get()方法我们前面已经说过了，返回的是Android对象
  • 2、入参是platform的构造函数，内部add了一个BuiltInConverters对象，可见converterFactories至少是一个转化器的。
  • 3、入参的是Retrofit的构造函数，其实就是把Retrofit的属性赋值给Builder
4、相关方法解析
4.1、client方法和callFactory
    /**
     * The HTTP client used for requests.
     * 

     * This is a convenience method for calling {@link #callFactory}.
     * 通过callFactory作为客户端，来发起HTTP请求是非常便捷的。
     */
    public Builder client(OkHttpClient client) {
      return callFactory(checkNotNull(client, "client == null"));
    }

    /**
     * Specify a custom call factory for creating {@link Call} instances.
     * 

     * Note: Calling {@link #client} automatically sets this value.
     * 通过自定义的call factory  来创建一个请求(Call)的实例，调用client会自动设置
     */
    public Builder callFactory(okhttp3.Call.Factory factory) {
      this.callFactory = checkNotNull(factory, "factory == null");
      return this;
    }

通过上面我们可知

  • client内部调用的callFactory方法
  • 这两个方法表明，Retrofit底层是使用okHttp，而且是强关联。
  • PS:第一次看代码的哥们可能会有疑惑，这里补充下OkHttpClient是okhttp3.Call.Factory的实现类。
4.2、baseUrl方法

Builder有两个baseUrl，只不过是入参不同而已，让我们来看下源码

 /**
     * Set the API base URL.
     *
     * @see #baseUrl(HttpUrl)
     */
    public Builder baseUrl(String baseUrl) {
      checkNotNull(baseUrl, "baseUrl == null");
      HttpUrl httpUrl = HttpUrl.parse(baseUrl);
      if (httpUrl == null) {
        throw new IllegalArgumentException("Illegal URL: " + baseUrl);
      }
      return baseUrl(httpUrl);
    }

    //收到篇幅限制，注释太长我直接省略
    public Builder baseUrl(HttpUrl baseUrl) {
      checkNotNull(baseUrl, "baseUrl == null");
      List pathSegments = baseUrl.pathSegments();
      if (!"".equals(pathSegments.get(pathSegments.size() - 1))) {
        throw new IllegalArgumentException("baseUrl must end in /: " + baseUrl);
      }
      this.baseUrl = baseUrl;
      return this;
    }
  • 主要是设置基本的url，一般是请求的url的前缀
  • 受篇幅限制，我这边没有粘贴注释，不过注释非常不错，我建议大家还是去看看，里面主要讲解拼接的注意事件。
4.3、addConverterFactory()和addCallAdapterFactory方法
    /** Add converter factory for serialization and deserialization of objects. */
    public Builder addConverterFactory(Converter.Factory factory) {
      converterFactories.add(checkNotNull(factory, "factory == null"));
      return this;
    }

    /**
     * Add a call adapter factory for supporting service method return types other than {@link
     * Call}.
     */
    public Builder addCallAdapterFactory(CallAdapter.Factory factory) {
      adapterFactories.add(checkNotNull(factory, "factory == null"));
      return this;
    }

addConverterFactory()和addCallAdapterFactory方法比较简单，就是向对应的集合添加元素而已

4.4、callbackExecutor()和validateEagerly方法
    /**
     * The executor on which {@link Callback} methods are invoked when returning {@link Call} from
     * your service method.
     * 

     * Note: {@code executor} is not used for {@linkplain #addCallAdapterFactory custom method
     * return types}.
     */
    public Builder callbackExecutor(Executor executor) {
      this.callbackExecutor = checkNotNull(executor, "executor == null");
      return this;
    }

    /**
     * When calling {@link #create} on the resulting {@link Retrofit} instance, eagerly validate
     * the configuration of all methods in the supplied interface.
     */
    public Builder validateEagerly(boolean validateEagerly) {
      this.validateEagerly = validateEagerly;
      return this;
    }

这两个方法也比较简单，就是给两个变量赋值

4.5、build()方法
    /**
     * Create the {@link Retrofit} instance using the configured values.
     * 

     * Note: If neither {@link #client} nor {@link #callFactory} is called a default {@link
     * OkHttpClient} will be created and used.
     */
    public Retrofit build() {
       //如果没有配置过baseUrl，则抛异常
      if (baseUrl == null) {
        throw new IllegalStateException("Base URL required.");
      }
      //获取callFactory
      okhttp3.Call.Factory callFactory = this.callFactory;
      //如果为null,则没有调用过client()和callFactory()方法
      if (callFactory == null) {
        //创建一个OkHttpClient对象，作为默认的callFactory
        callFactory = new OkHttpClient();
      }
      //获取回调的线程池
      Executor callbackExecutor = this.callbackExecutor;
      // 如果callbackExecutor为null,则没有设置过回调线程池，
      if (callbackExecutor == null) {
        //获取平台默认的线程池，其实就是主线程
        callbackExecutor = platform.defaultCallbackExecutor();
      }
      // Make a defensive copy of the adapters and add the default Call adapter.
     // 给adapterFactories赋值
      List adapterFactories = new ArrayList<>(this.adapterFactories);     
      //添加一个默认的callAdapter，其实是DefaultCallAdapterFactory
adapterFactories.add(platform.defaultCallAdapterFactory(callbackExecutor));
      // Make a defensive copy of the converters.
       // 设置converterFactories，它默认是含有BuiltInConverters对象的
      List converterFactories = new ArrayList<>(this.converterFactories);
      //构建一个Retrofit对象
      return new Retrofit(callFactory, baseUrl, converterFactories, adapterFactories,
          callbackExecutor, validateEagerly);
    }

先看下注释

通知使用配置过的值来创建Retrofit对象，如果没有调用client()和callFactory()方法，那么将创建并使用默认的OkHttpClient。

代码很简单，就是初始化属性，这里重点说下，如果没有设置回调线程池，则默认是主线程，如果没有配置转化器，则默认使用BuiltInConverters，如果没配置callAdapter，则默认使用DefaultCallAdapterFactory。

(四) create()方法解析

这个方法很重要，由于受到篇幅限制，我就不粘贴注释的了，我们先来看下源码

  @SuppressWarnings("unchecked") // Single-interface proxy creation guarded by parameter safety.
  public  T create(final Class service) {
    Utils.validateServiceInterface(service);
    if (validateEagerly) {
      eagerlyValidateMethods(service);
    }
    return (T) Proxy.newProxyInstance(service.getClassLoader(), new Class[] { service },
        new InvocationHandler() {
          private final Platform platform = Platform.get();

          @Override public Object invoke(Object proxy, Method method, Object[] args)
              throws Throwable {
            // If the method is a method from Object then defer to normal invocation.
            //如果定义方法的类的类型是Object，或者说，是Object类的方法，则直接执行invoke调用
            if (method.getDeclaringClass() == Object.class) {
              return method.invoke(this, args);
            }
            // Android平台没有重写这个方法，所以默认是false
            if (platform.isDefaultMethod(method)) {
              return platform.invokeDefaultMethod(method, service, proxy, args);
            }
             //调用loadServiceMethod获取一个ServiceMethod对象，其内部是一个一级缓存，内存中有直接取内存中的，内存中没有构建一个ServiceMethod，放入到缓存中。
            ServiceMethod serviceMethod =
                (ServiceMethod) loadServiceMethod(method);
            //使用serviceMethod和args来构建一个OkHttpCall
            OkHttpCall okHttpCall = new OkHttpCall<>(serviceMethod, args);
            //调用serviceMethod对象的callAdapter对象的adapt方法。
            return serviceMethod.callAdapter.adapt(okHttpCall);
          }
        });
  }
 
 
通过源码我们知道，这方法内部的流程如下：
 
 
 
 
 
 
     
  
  • 检查 接口类，判断是否是接口，判断是否继承其他接口
    •  
  
  • 做是否需要预加载
    •  
  
  • 调用动态代理获取一个类的对象
    •  
 
 
 
然后我们看下InvocationHandler里面的invoke()方法里面的实现流程
 
 
 
 
 
 
     
  
  • 先判断这个方法是不是Object的方法，如果是直接接调用invoke
    •  
  
  • 根据平台的特性，决定是否调用invokeDefaultMethod()方法
    •  
  
  • 通过调用loadServiceMethod()方法载入一个ServiceMethod对象。
    •  
  
  • 用ServiceMethod来构建一个OkHttpCall。
    •  
  
  • 最后调用serviceMethod对象的callAdapter对象的adapt方法
    •  
 
 
 
最后翻译了一下这个方法对应的注释，受篇幅限制，我就不粘贴源码了，直接上我们翻译后的内容了
 
 
 
 
 
 
创建一个由服务器定义的API接口的具体实现。如果在抽象接口的方法上通过添加注解来实现设置定义请求方式，而相对路径的url是根据这个请求方式来的。请求方式有@link retrofit2.http.GET 代表GET请求，@link retrofit2.http.PUT 代表PUT请求，@retrofit2.http.POST，代表POST请求，@retrofit2.http.PATCH 代表PATCH请求，@retrofit2.http.HEAD 代表HEAD请求，
 @retrofit2.http.DELETE 代表DELETE请求， @retrofit2.http.OPTIONS 代表OPTIONS请求，通过使用@HTTP，你也可以自定义HTTP请求方式。如果你想动态设置url，第一个入参需要使用@Url 注解来实现。可以在方法参数里面使用@Path注解，是实现替换Url部分内容，被替换的部分需要用大括号“{}”括起来，例如"{foo}"。如果想在URL上添加查询字段，就要使用@Query 注解。用@ Body 来表示一个请求体。一个对象的实例将会被Converter.Factory的实例转化为网络请求。一个RequestBody也可以作为原始数据而直接使用。方法注解和参数注解支持如下的格式：通过@FormUrlEncoded，代表表单提交，由@Field注解 代表表单数据。@multipart 代表多部分，在入参上使用注解@Part表示每一部分的具体数据。通过在方法上添加@Header 和@Header来添加请求头的数据。默认情况下，这个方法返回一个代表HTTP请求的Call对象，里面的泛型是响应体的类型，由 Converter.Factory对象负责转化，也可以用ResponseBody代表原始数据，当然你不关心请求体，也可以设置Void。
 

                            
                        
                    
                    
                    

                    
                    
                    

                
                

                    
                

            
        
    
    

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

        

            

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

                        
    很多人私聊我会问到在哪个人群当中斤斤计较的人最多？我都会回答他，一般婚姻出现问题的斤斤计较的人士会非常多，以我多年经验，在婚姻落的一塌糊涂的人当中，斤斤计较的人数占比在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在生活中只存在两个问题。一个问题是：你知道想要达成的目标是什么，但却不知道如何才能达成；另一个问题是：你不知道你的目标是什么。前一个是行动的问题，后一个是结果的问题。通过制定具体的下一步行动，可以解决不知道如何开始行动的问题。而通过去想象结果，对结果做预估，可以解决找不着目标的问题。对于所有吸引我们注意力，想要完成的任务，你可以先想象一下，预期的结果究竟是什
    
                    
    • 
                    
  • 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.带参
    
                    
    • 
                    
  • 学点心理知识，呵护孩子健康
                        静候花开_7090

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

                        
    感受:1.从陌生到熟悉的过程。游戏环节让我们在轻松的氛围中得到了锻炼，也增长了不少知识。2.游戏过程中，我们贡献的是个人力量，展现的是团队的力量。它磨合的往往不止是工作的熟悉，更是观念上契合度的贴近。3.这和工作是一样的道理。在各自的岗位上，每个人摆正自己的位置、各司其职充分发挥才能，并团结一致劲往一处使，才能实现最大的成功。新知:1.团队精神需要不断地创新。过去，人们把创新看作是冒风险，现在人们
    
                    
    • 
                    
  • 《投行人生》读书笔记
                        小蘑菇的树洞

                        
    《投行人生》----作者詹姆斯-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厚。全书一百多页，均为铅笔绘制，虽然为黑白色调，但并不显得沉闷。全书没有文字，犹如“默片”，但并不影响读者对该作品的理解，反而显得神秘，梦幻，給读者留下想象的空间。作者在前蝴蝶页这样写到：“我更希望父母和孩子一起分享这本书，使他
    
                    
    • 
                    
  • 30天风格练习-DAY2
                        黄希夷

                        
    Day2（重义）在一个周日/一周的最后一天，我来到位于市中心/市区繁华地带的一家购物中心/商场，中心内人很多/熙熙攘攘。我注意到/看见一个独行/孤身一人的年轻女孩/，留着一头引人注目/长过腰际的头发，上身穿一件暗红色/比正红色更深的衣服/穿在身体上的东西。走下扶梯的时候，她摔倒了/跌向地面，在她正要站起来/让身体离开地面的时候，过长/超过一般人长度的头发被支撑身体/躯干的手掌压/按在下面，她赶紧用
    
                    
    • 
                    
  • 店群合一模式下的社区团购新发展——结合链动 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
    
                    
    • 
                    
  • 2018-07-23-催眠日作业-#不一样的31天#-66小鹿
                        小鹿_33

                        
    预言日：人总是在逃避命运的路上，与之不期而遇。心理学上有个著名的名词，叫做自证预言；经济学上也有一个很著名的定律叫做，墨菲定律；在灵修派上，还有一个很著名的法则，叫做吸引力法则。这3个领域的词，虽然看起来不太一样，但是他们都在告诉人们一个现象：你越担心什么，就越有可能会发生什么。同样的道理，你越想得到什么，就应该要积极地去创造什么。无论是自证预言，墨菲定律还是吸引力法则，对人都有正反2个维度的影响
    
                    
    • 
                    
  • 水平垂直居中的几种方法（总结）
                        LJ小番茄
CSS_玄学语言htmljavascript前端csscss3
                        
    1.使用flexbox的justify-content和align-items.parent{display:flex;justify-content:center;/*水平居中*/align-items:center;/*垂直居中*/height:100vh;/*需要指定高度*/}2.使用grid的place-items:center.parent{display:grid;place-item
    
                    
    • 
                    
  • 《大清方方案》| 第二话
                        谁佐清欢

                        
    和珅究竟说了些什么？竟能令堂堂九五之尊龙颜失色！此处暂且按下不表；单说这位乾隆皇帝，果真不愧是康熙从小带过的，一旦决定了要做的事，便杀伐决断毫不含糊。他当即亲自拟旨，着令和珅为钦差大臣，全权负责处理方方事件，并钦赐尚方宝剑，遇急则三品以下官员可先斩后奏。和珅身负皇上重托，岂敢有半点怠慢，当夜即率领相关人等，马不停蹄杀奔江汉。这一路上，和珅的几位幕僚一直在商讨方方事件的处置方案。有位年轻幕僚建议快刀
    
                    
    • 
                    
  • 本周第二次约练
                        2cfbdfe28a51

                        
    中原焦点团队中24初26刘霞2021.12.3约练161次，分享第368天当事人虽然是带着问题来的，但是咨询过程中发现，她是经过自己不断地调整和努力才走到现在的，看到当事人的不容易，找到例外，发现资源，力量感也就随之而来。增强画面感，或者说重温，会给当事人带来更深刻的感受。
    
                    
    • 
                                
  • web报表工具FineReport常见的数据集报错错误代码和解释
                                    老A不折腾
web报表finereport代码可视化工具
                                    
    在使用finereport制作报表，若预览发生错误，很多朋友便手忙脚乱不知所措了，其实没什么，只要看懂报错代码和含义，可以很快的排除错误，这里我就分享一下finereport的数据集报错错误代码和解释，如果有说的不准确的地方，也请各位小伙伴纠正一下。 
  
NS-war-remote=错误代码\:1117 压缩部署不支持远程设计 
NS_LayerReport_MultiDs=错误代码
    
                                
    • 
                                
  • Java的WeakReference与WeakHashMap
                                    bylijinnan
java弱引用
                                    
    首先看看 WeakReference 
 
wiki 上 Weak reference 的一个例子： 
 
 

	public class ReferenceTest {
	public static void main(String[] args) throws InterruptedException {
 
            WeakReference r = new Wea
    
                                
    • 
                                
  • Linux——（hostname）主机名与ip的映射
                                    eksliang
linuxhostname
                                    
    一、 什么是主机名 
无论在局域网还是INTERNET上，每台主机都有一个IP地址，是为了区分此台主机和彼台主机，也就是说IP地址就是主机的门牌号。但IP地址不方便记忆，所以又有了域名。域名只是在公网（INtERNET)中存在，每个域名都对应一个IP地址，但一个IP地址可有对应多个域名。域名类型 linuxsir.org 这样的； 
主机名是用于什么的呢？ 
答：在一个局域网中，每台机器都有一个主
    
                                
    • 
                                
  • oracle 常用技巧
                                    18289753290

                                    
    oracle常用技巧   ①复制表结构和数据     create table  temp_clientloginUser   as     select distinct userid from tbusrtloginlog   ②仅复制数据   如果表结构一样   insert into  mytable  select  * &nb
    
                                
    • 
                                
  • 使用c3p0数据库连接池时出现com.mchange.v2.resourcepool.TimeoutException
                                    酷的飞上天空
exception
                                    
    有一个线上环境使用的是c3p0数据库，为外部提供接口服务。最近访问压力增大后台tomcat的日志里面频繁出现 
com.mchange.v2.resourcepool.TimeoutException: A client timed out while waiting to acquire a resource from com.mchange.v2.resourcepool.BasicResou
    
                                
    • 
                                
  • IT系统分析师如何学习大数据
                                    蓝儿唯美
大数据
                                    
    我是一名从事大数据项目的IT系统分析师。在深入这个项目前需要了解些什么呢？学习大数据的最佳方法就是先从了解信息系统是如何工作着手，尤其是数据库和基础设施。同样在开始前还需要了解大数据工具，如Cloudera、Hadoop、Spark、Hive、Pig、Flume、Sqoop与Mesos。系 统分析师需要明白如何组织、管理和保护数据。在市面上有几十款数据管理产品可以用于管理数据。你的大数据数据库可能
    
                                
    • 
                                
  • spring学习——简介
                                    a-john
spring
                                    
    Spring是一个开源框架，是为了解决企业应用开发的复杂性而创建的。Spring使用基本的JavaBean来完成以前只能由EJB完成的事情。然而Spring的用途不仅限于服务器端的开发，从简单性，可测试性和松耦合的角度而言，任何Java应用都可以从Spring中受益。其主要特征是依赖注入、AOP、持久化、事务、SpringMVC以及Acegi Security 
 
为了降低Java开发的复杂性，
    
                                
    • 
                                
  • 自定义颜色的xml文件
                                    aijuans
xml
                                    
    <?xml version="1.0" encoding="utf-8"?> <resources> <color name="white">#FFFFFF</color> <color name="black">#000000</color> &
    
                                
    • 
                                
  • 运营到底是做什么的？
                                    aoyouzi
运营到底是做什么的？
                                    
    文章来源：夏叔叔（微信号：woshixiashushu），欢迎大家关注！很久没有动笔写点东西，近些日子，由于爱狗团产品上线，不断面试，经常会被问道一个问题。问：爱狗团的运营主要做什么？答：带着用户一起嗨。为什么是带着用户玩起来呢？究竟什么是运营？运营到底是做什么的？那么，我们先来回答一个更简单的问题——互联网公司对运营考核什么？以爱狗团为例，绝大部分的移动互联网公司，对运营部门的考核分为三块——用
    
                                
    • 
                                
  • js面向对象类和对象
                                    百合不是茶
js面向对象函数创建类和对象
                                    
    接触js已经有几个月了,但是对js的面向对象的一些概念根本就是模糊的,js是一种面向对象的语言 但又不像java一样有class,js不是严格的面向对象语言 ,js在java web开发的地位和java不相上下  ,其中web的数据的反馈现在主流的使用json,json的语法和js的类和属性的创建相似 
  
下面介绍一些js的类和对象的创建的技术 
  
一:类和对
    
                                
    • 
                                
  • web.xml之资源管理对象配置 resource-env-ref
                                    bijian1013
javaweb.xmlservlet
                                    
    resource-env-ref元素来指定对管理对象的servlet引用的声明，该对象与servlet环境中的资源相关联 
<resource-env-ref>
    <resource-env-ref-name>资源名</resource-env-ref-name>
    <resource-env-ref-type>查找资源时返回的资源类
    
                                
    • 
                                
  • Create a composite component with a custom namespace
                                    sunjing

                                    
    https://weblogs.java.net/blog/mriem/archive/2013/11/22/jsf-tip-45-create-composite-component-custom-namespace 
  
When you developed a composite component the namespace you would be seeing would 
    
                                
    • 
                                
  • 【MongoDB学习笔记十二】Mongo副本集服务器角色之Arbiter
                                    bit1129
mongodb
                                    
     一、复本集为什么要加入Arbiter这个角色   回答这个问题，要从复本集的存活条件和Aribter服务器的特性两方面来说。   什么是Artiber？   An arbiter does 
not have a copy of data set and 
cannot become a primary. Replica sets may have arbiters to add a 
    
                                
    • 
                                
  • Javascript开发笔记
                                    白糖_
JavaScript
                                    
     
 获取iframe内的元素 
 
通常我们使用window.frames["frameId"].document.getElementById("divId").innerHTML这样的形式来获取iframe内的元素，这种写法在IE、safari、chrome下都是通过的，唯独在fireforx下不通过。其实jquery的contents方法提供了对if
    
                                
    • 
                                
  • Web浏览器Chrome打开一段时间后，运行alert无效
                                    bozch
Webchormealert无效
                                    
    今天在开发的时候，突然间发现alert在chrome浏览器就没法弹出了，很是怪异。 
试了试其他浏览器，发现都是没有问题的。 
开始想以为是chorme浏览器有啥机制导致的，就开始尝试各种代码让alert出来。尝试结果是仍然没有显示出来。 
这样开发的结果，如果客户在使用的时候没有提示，那会带来致命的体验。哎，没啥办法了 就关闭浏览器重启。 
  
结果就好了，这也太怪异了。难道是cho
    
                                
    • 
                                
  • 编程之美-高效地安排会议 图着色问题 贪心算法
                                    bylijinnan
编程之美
                                    
    

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.Random;

public class GraphColoringProblem {

	/**编程之美 高效地安排会议 图着色问题 贪心算法
	 * 假设要用很多个教室对一组
    
                                
    • 
                                
  • 机器学习相关概念和开发工具
                                    chenbowen00
算法matlab机器学习
                                    
    基本概念： 
机器学习(Machine Learning, ML)是一门多领域交叉学科，涉及概率论、统计学、逼近论、凸分析、算法复杂度理论等多门学科。专门研究计算机怎样模拟或实现人类的学习行为，以获取新的知识或技能，重新组织已有的知识结构使之不断改善自身的性能。 
它是人工智能的核心，是使计算机具有智能的根本途径，其应用遍及人工智能的各个领域，它主要使用归纳、综合而不是演绎。 
 
开发工具 
M
    
                                
    • 
                                
  • [宇宙经济学]关于在太空建立永久定居点的可能性
                                    comsci
经济
                                    
     
       大家都知道,地球上的房地产都比较昂贵,而且土地证经常会因为新的政府的意志而变幻文本格式........ 
 
       所以,在地球议会尚不具有在太空行使法律和权力的力量之前,我们外太阳系统的友好联盟可以考虑在地月系的某些引力平衡点上面,修建规模较大的定居点
    
                                
    • 
                                
  • oracle 11g database control 证书错误
                                    daizj
oracle证书错误oracle 11G 安装
                                    
    oracle 11g database control 证书错误  
 
win7 安装完oracle11后打开 Database control 后，会打开em管理页面，提示证书错误，点“继续浏览此网站”，还是会继续停留在证书错误页面 
 
解决办法： 
 
是 KB2661254 这个更新补丁引起的，它限制了 RSA 密钥位长度少于 1024 位的证书的使用。具体可以看微软官方公告：
    
                                
    • 
                                
  • Java I/O之用FilenameFilter实现根据文件扩展名删除文件
                                    游其是你
FilenameFilter
                                    
    在Java中，你可以通过实现FilenameFilter类并重写accept(File dir, String name) 方法实现文件过滤功能。 
在这个例子中，我们向你展示在“c:\\folder”路径下列出所有“.txt”格式的文件并删除。        1   2   3   4   5   6   7   8   9   10   11   12   13   14   15   16 
    
                                
    • 
                                
  • C语言数组的简单以及一维数组的简单排序算法示例，二维数组简单示例
                                    dcj3sjt126com
carray
                                    
    # include <stdio.h>

int main(void)
{
	
	int a[5] = {1, 2, 3, 4, 5};
		//a 是数组的名字 5是表示数组元素的个数，并且这五个元素分别用a[0], a[1]...a[4]
	
	int i;

	for (i=0; i<5; ++i)
		printf("%d\n",
    
                                
    • 
                                
  • PRIMARY, INDEX, UNIQUE 这3种是一类 PRIMARY 主键。 就是 唯一 且 不能为空。 INDEX 索引，普通的 UNIQUE 唯一索引
                                    dcj3sjt126com
primary
                                    
    PRIMARY, INDEX, UNIQUE 这3种是一类PRIMARY 主键。 就是 唯一 且 不能为空。INDEX 索引，普通的UNIQUE 唯一索引。 不允许有重复。FULLTEXT 是全文索引，用于在一篇文章中，检索文本信息的。举个例子来说，比如你在为某商场做一个会员卡的系统。这个系统有一个会员表有下列字段：会员编号   INT会员姓名  
    
                                
    • 
                                
  • java集合辅助类 Collections、Arrays
                                    shuizhaosi888
CollectionsArraysHashCode
                                    
      
Arrays、Collections 
  
1 ）数组集合之间转换 
    public static <T> List<T> asList(T... a) {
        return new ArrayList<>(a);
    } 
     a）Arrays.asL
    
                                
    • 
                                
  • Spring Security（10）——退出登录logout
                                    234390216
logoutSpring Security退出登录logout-urlLogoutFilter
                                    
           要实现退出登录的功能我们需要在http元素下定义logout元素，这样Spring Security将自动为我们添加用于处理退出登录的过滤器LogoutFilter到FilterChain。当我们指定了http元素的auto-config属性为true时logout定义是会自动配置的，此时我们默认退出登录的URL为“/j_spring_secu
    
                                
    • 
                                
  • 透过源码学前端 之 Backbone 三 Model
                                    逐行分析JS源代码
backbone源码分析js学习
                                    
    Backbone 分析第三部分  Model 
概述： Model 提供了数据存储，将数据以JSON的形式保存在 Model的 attributes里， 
但重点功能在于其提供了一套功能强大，使用简单的存、取、删、改数据方法，并在不同的操作里加了相应的监听事件， 
如每次修改添加里都会触发 change，这在据模型变动来修改视图时很常用，并且与collection建立了关联。 
    
                                
    • 
                                
  • SpringMVC源码总结（七）mvc:annotation-driven中的HttpMessageConverter
                                    乒乓狂魔
springMVC
                                    
    这一篇文章主要介绍下HttpMessageConverter整个注册过程包含自定义的HttpMessageConverter，然后对一些HttpMessageConverter进行具体介绍。 
 
HttpMessageConverter接口介绍： 
 

public interface HttpMessageConverter<T> {

	/**
	 * Indicate
    
                                
    • 
                                
  • 分布式基础知识和算法理论
                                    bluky999
算法zookeeper分布式一致性哈希paxos
                                    
       
分布式基础知识和算法理论 
BY [email protected] 
本文永久链接：http://nodex.iteye.com/blog/2103218 
  
在大数据的背景下，不管是做存储，做搜索，做数据分析，或者做产品或服务本身，面向互联网和移动互联网用户，已经不可避免地要面对分布式环境。笔者在此收录一些分布式相关的基础知识和算法理论介绍，在完善自我知识体系的同
    
                                
    • 
                                
  • Android Studio的.gitignore以及gitignore无效的解决
                                    bell0901
androidgitignore
                                    
    　　github上.gitignore模板合集，里面有各种.gitignore ： https://github.com/github/gitignore 
　　自己用的Android Studio下项目的.gitignore文件，对github上的android.gitignore添加了 
　　　　　　# OSX files　　　　　　//mac os下　　　　　　.DS_Store 
    
                                
    • 
                                
  • 成为高级程序员的10个步骤
                                    tomcat_oracle
编程
                                    
    What 
软件工程师的职业生涯要历经以下几个阶段：初级、中级，最后才是高级。这篇文章主要是讲如何通过 10 个步骤助你成为一名高级软件工程师。 
  
Why 
 
  得到更多的报酬！因为你的薪水会随着你水平的提高而增加  
  提升你的职业生涯。成为了高级软件工程师之后，就可以朝着架构师、团队负责人、CTO 等职位前进  
  历经更大的挑战。随着你的成长，各种影响力也会提高。  
    
                                
    • 
                                
  • mongdb在linux下的安装
                                    xtuhcy
mongodblinux
                                    
    一、查询linux版本号： 
lsb_release -a  
LSB Version:    :base-4.0-amd64:base-4.0-noarch:core-4.0-amd64:core-4.0-noarch:graphics-4.0-amd64:graphics-4.0-noarch:printing-4.0-amd64:printing-4.0-noa
    
                                
    •