minminaya
minminaya

更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)

如果可以我想改名成《看完不会在 Kotlin 中封装 Retrofit就砍我》，嘿嘿........

Retrofit 是一个设计相当精良的框架，特别是其可扩展性上。官方提供的协程的使用方式和 API 实现在一些情况下不大优雅，本文主要是 bb 对其的相关扩展，让项目代码变得更傻瓜式和对 Retrofit 协程方式编写代码方式更加优雅。

基于下述思路封装的网络框架已经在线上持续稳定使用 1 年多了，适合各种牛(qi)逼(pa)的场景，本篇各个环节会涉及到奇奇怪怪的想法.....

Retrofit 对协程的支持

Retrofit 从 2.4 版本开始对协程的使用正式做了支持，可以让我们顺序式的编写代码，减少回调。巴拉巴拉一大堆，但是这里最重要的一点是让我们可以不用回调式的写代码，记住这一点，后面会重新提到。

Retrofit 协程的基本用法

下面省略 Retrofit.Builder 类相关的各种初始化操作（适配器，转换器等，默认认为有 Gson/Moshi 适配器做数据转换）

用法一

  • 1、定义 suspend 方法，返回值声明为 Response，可以清楚知道响应情况

                    @GET("xxxx/get-notification-settings")
                suspend fun loadSettings(): Response>

  • 2、使用

                    lifecycleScope.launch {
                    val repoResponse: Response> =
                        AcRetrofit.get().notificationApi.loadSettings()
                    Log.d("okHttp", "data:" + repoResponse.body())
                }

用法二

  • 1、定义 suspend 方法，返回值声明为 DataObject，只获取必要的数据

                    @GET("xxxx/get-notification-settings")
                suspend fun loadSettings(): Repo

  • 2、使用

                    lifecycleScope.launch {
                    val repo: Repo =
                        AcRetrofit.get().notificationApi.loadSettings()
                    Log.d("okHttp", "data:$repo")
                }

这样使用正常情况下是可以正常拿到数据的，log 也是正常输出的，程序也不会崩溃

制造一个异常

  • 正常情况下上述用法都是没问题的，接下来我把手机网络断了，会发现程序闪退并且闪退栈的起始位置是 loadSettings() 这一行
java.net.ConnectException: Failed to connect to /192.168.1.108:8888
        at okhttp3.internal.connection.RealConnection.connectSocket(RealConnection.kt:297)
        at okhttp3.internal.connection.RealConnection.connectTunnel(RealConnection.kt:261)
        at okhttp3.internal.connection.RealConnection.connect(RealConnection.kt:201)
        at okhttp3.internal.connection.ExchangeFinder.findConnection(ExchangeFinder.kt:226)
        at okhttp3.internal.connection.ExchangeFinder.findHealthyConnection(ExchangeFinder.kt:106)
        at okhttp3.internal.connection.ExchangeFinder.find(ExchangeFinder.kt:74)
        at okhttp3.internal.connection.RealCall.initExchange$okhttp(RealCall.kt:255)
        at okhttp3.internal.connection.ConnectInterceptor.intercept(ConnectInterceptor.kt:32)
        at okhttp3.internal.http.RealInterceptorChain.proceed(RealInterceptorChain.kt:109)
        at okhttp3.internal.cache.CacheInterceptor.intercept(CacheInterceptor.kt:95)
        at okhttp3.internal.http.RealInterceptorChain.proceed(RealInterceptorChain.kt:109)
        at okhttp3.internal.http.BridgeInterceptor.intercept(BridgeInterceptor.kt:83)
        at okhttp3.internal.http.RealInterceptorChain.proceed(RealInterceptorChain.kt:109)
        at okhttp3.internal.http.RetryAndFollowUpInterceptor.intercept(RetryAndFollowUpInterceptor.kt:76)
        at okhttp3.internal.http.RealInterceptorChain.proceed(RealInterceptorChain.kt:109)
        ...
        省略若干行...大家一起想象下...

  • 那有同学就说了噢，不就是异常嘛，我catch 下不就好了？？？？


                    lifecycleScope.launch {
                    try {
                        val repoResponse: Response> =
                            AcRetrofit.get().notificationApi.loadSettings()
                        ALog.d("okHttp", "data:" + repoResponse.body())
                    } catch (e: Exception) {
                        ALog.e("okHttp", e)
                    }
                }

这样确实好了，但是我们一开始的目的不是想非回调式的写代码，并且尽量减少闭包，内部类的出现麽，如果每个接口都要用 catch 包住，那基本上算是没有解决根本问题。

还是得找办法解决这个问题【网络接口抛出异常需要外部使用 try catch 包裹】，那么 Retrofit 挂起式使用要怎么样操作才能真正的“优雅”呢，下面会一步一步的揭开谜题....

Retrofit 是怎么支持协程的

异常怎么产生的

不难思考，想解决异常抛出到业务代码的问题其实本质上是看这个异常从哪里来的，废话不多说，其实就是接口请求的某个环节产生的异常嘛

对 Retrofit 异步回调式使用熟悉的朋友肯定会想到这个用法：

                    AcRetrofit.get().notificationApi.loadSettings()
                        .enqueue(object : Callback {
                            override fun onResponse(
                                call: Call,
                                response: Response
                            ) {
                               //数据回调
                            }

                            override fun onFailure(call: Call, throwable: Throwable) {
                               //异常回调
                            }

                        })

onFailure 回调出来的 throwable 也就是同步式 【Retrofit 调用 execute()请求接口】 或者协程挂起式用法获取数据时抛出来的异常。

怎么支持的协程

  • 面对上面的问题，一开始应该是没有思路的，至于为什么要先看 Retrofit 对协程的支持怎么实现的，无非也是因为真的是没有太大的思路解决这个问题（如果不熟悉 Retrofit 源码实现的情况下），只能先去源码里面找解决方案

  • 相信大家应该清楚 Retrofit 的核心实现思路【动态代理反射 API 定义方法，将相关方法表示提取为参数塞给 okHttp 去请求】，如果不熟悉的话，2022 年了，Google 下 Retrofit 相关的流程源码分析，也会有很多优秀的文章可以浏览

  • 1、首先写一个接口请求

    • 定义 suspend 方法，返回值声明为 DataObject，只获取必要的数据，并且在协程里使用【这里只是一个简单的例子，不建议大家在 View 层使用lifecycleScope 来做接口请求】 
                      @GET("xxxx/get-notification-settings")
                suspend fun loadSettings(): Repo
                
                lifecycleScope.launch {
                    val repo: Repo =
                        AcRetrofit.get().notificationApi.loadSettings()
                    Log.d("okHttp", "data:$repo")
                }

  • 2、直接来到 Retrofit 动态代理的函数入口，InvocationHandler 类的 invoke 方法中打上断点

      public  T create(final Class service) {
    validateServiceInterface(service);
    return (T)
        Proxy.newProxyInstance(
            service.getClassLoader(),
            new Class[] {service},
            new InvocationHandler() {
              private final Platform platform = Platform.get();
              private final Object[] emptyArgs = new Object[0];

              @Override
              public @Nullable Object invoke(Object proxy, Method method, @Nullable Object[] args)
                  throws Throwable {
                // If the method is a method from Object then defer to normal invocation.
                if (method.getDeclaringClass() == Object.class) {
                  return method.invoke(this, args);
                }
                args = args != null ? args : emptyArgs;
                return platform.isDefaultMethod(method)
                    ? platform.invokeDefaultMethod(method, service, proxy, args)
                    : loadServiceMethod(method).invoke(args);
              }
            });
  }

  • 3、loadServiceMethod(method) 会被调用，可以看到是一个按需调用 ServiceMethod.parseAnnotations(this, method) 的逻辑

      ServiceMethod loadServiceMethod(Method method) {
    ServiceMethod result = serviceMethodCache.get(method);
    if (result != null) return result;

    synchronized (serviceMethodCache) {
      result = serviceMethodCache.get(method);
      if (result == null) {
        result = ServiceMethod.parseAnnotations(this, method);
        serviceMethodCache.put(method, result);
      }
    }
    return result;
  }

  • 4、兜兜转转，最终 HttpServiceMethod.parseAnnotations(retrofit, method, requestFactory) 会被调用，这个方法本质上是解析 API 定义方法的相关参数来构造 HTTP 服务使用的，这里会选取各种适配器，转换器来操作当前使用的 API 接口定义。

    • 这里没有定制的情况下，使用的 CallAdapter 是 DefaultCallAdapterFactory ，DefaultCallAdapterFactory 对协程的实现没有什么特别的帮助，内部主要实现是看API 接口方法定义有没有含有 SkipCallbackExecutor 注解，如果含有该注解就将回调返回使用定义的CallbackExecutor 线程池执行。可以展开折叠块看下具体定义，省略 n 多无关实现。 
      final class DefaultCallAdapterFactory extends CallAdapter.Factory {
   ...

  @Override
  public @Nullable CallAdapter get(
      Type returnType, Annotation[] annotations, Retrofit retrofit) {
      ...
     
      final Executor executor =
      Utils.isAnnotationPresent(annotations, SkipCallbackExecutor.class)
            ? null
            : callbackExecutor;

    return new CallAdapter>() {
      @Override
      public Type responseType() {
        return responseType;
      }

      @Override
      public Call adapt(Call call) {
        return executor == null ? call : new ExecutorCallbackCall<>(executor, call);
      }
    };
  }

  static final class ExecutorCallbackCall implements Call {
    final Executor callbackExecutor;
    final Call delegate;

    ExecutorCallbackCall(Executor callbackExecutor, Call delegate) {
      this.callbackExecutor = callbackExecutor;
      this.delegate = delegate;
    }

    @Override
    public void enqueue(final Callback callback) {
      Objects.requireNonNull(callback, "callback == null");

      delegate.enqueue(
          new Callback() {
            @Override
            public void onResponse(Call call, final Response response) {
              callbackExecutor.execute(
                  () -> {
                    if (delegate.isCanceled()) {
                      // Emulate OkHttp's behavior of throwing/delivering an IOException on
                      // cancellation.
                      callback.onFailure(ExecutorCallbackCall.this, new IOException("Canceled"));
                    } else {
                      callback.onResponse(ExecutorCallbackCall.this, response);
                    }
                  });
            }

            @Override
            public void onFailure(Call call, final Throwable t) {
              callbackExecutor.execute(() -> callback.onFailure(ExecutorCallbackCall.this, t));
            }
          });
    }
  
     
  
 
         
  
      •  
        5、来到最关键的地方，Retrofit 内部要选中最终的 HttpServiceMethod，因为 API 方法定义，这里直接是 DataObject 返回值的，后面会返回 SuspendForBody 的实现
         
         
   
         
    
         
     
          
     
         
    
         
    
         
   
         
         
        •  
  
      •  
        6、SuspendForBody 的 adapt 方法，最终会看到 KotlinExtensions 的相关方法，这里我定义的 API 方法返回值是非空的，所以最终回调用 KotlinExtensions.await(call, continuation) 方法
         
            @Override
    protected Object adapt(Call call, Object[] args) {
      call = callAdapter.adapt(call);

      //noinspection unchecked Checked by reflection inside RequestFactory.
      Continuation continuation = (Continuation) args[args.length - 1];

      // Calls to OkHttp Call.enqueue() like those inside await and awaitNullable can sometimes
      // invoke the supplied callback with an exception before the invoking stack frame can return.
      // Coroutines will intercept the subsequent invocation of the Continuation and throw the
      // exception synchronously. A Java Proxy cannot throw checked exceptions without them being
      // declared on the interface method. To avoid the synchronous checked exception being wrapped
      // in an UndeclaredThrowableException, it is intercepted and supplied to a helper which will
      // force suspension to occur so that it can be instead delivered to the continuation to
      // bypass this restriction.
      try {
        return isNullable
            ? KotlinExtensions.awaitNullable(call, continuation)
            : KotlinExtensions.await(call, continuation);
      } catch (Exception e) {
        return KotlinExtensions.suspendAndThrow(e, continuation);
      }
    }

         
        •  
  
      •  
        7、await() 中，会直接调用 Call.enqueue() 方法发起请求，最终通过协程挂起恢复的操作 resumeWithException(e) 和 resume(body) 将结果分发到协程发起端，也就是业务方使用端会受到结果（成功或者失败）
         
        suspend fun  Call.await(): T {
  return suspendCancellableCoroutine { continuation ->
    continuation.invokeOnCancellation {
      cancel()
    }
    enqueue(object : Callback {
      override fun onResponse(call: Call, response: Response) {
        if (response.isSuccessful) {
          val body = response.body()
          if (body == null) {
            val invocation = call.request().tag(Invocation::class.java)!!
            val method = invocation.method()
            val e = KotlinNullPointerException("Response from " +
                method.declaringClass.name +
                '.' +
                method.name +
                " was null but response body type was declared as non-null")
            continuation.resumeWithException(e)
          } else {
            continuation.resume(body)
          }
        } else {
          continuation.resumeWithException(HttpException(response))
        }
      }

      override fun onFailure(call: Call, t: Throwable) {
        continuation.resumeWithException(t)
      }
    })
  }
}




业务方调用======

val repo: Repo = AcRetrofit.get().notificationApi.loadSettings()


         
        这里抛出异常其实就是因为 resumeWithException 被调用的原因
         
        •  
 
       
 
      解决问题
       
 
      基本思路
       
 
      从上面的流程分析来看，最终发现原因是因为网络请求执行遇到异常时，将异常通过 resumeWithException(e)恢复挂起导致，那能不能让它不执行 resumeWithException 呢，从源码上看只需要屏蔽 Retrofit Call 类的 void enqueue(Callback callback) 的 callback 实现或者避免其调用 resumeWithException方法，将所有的数据通过 onResponse 返回，并且对 response.body()= null的时候做容错即可。
       
 
      刚好 Retrofit 的设计里面有一个实现可以自定义 CallAdapterFactory 来定制请求行为。这里我们可以通过自定义 CallAdapterFactory ，从而代理 Retrofit Call 类，进而控制 Callback 的接口调用来达到我们的最终目的。
       
 
      关于网络层的一些封装分析
       
 
      从网络层封装的角度来看，网络层单纯给业务方一个响应数据是不够的，因为业务方有时候想要知道更详细的详情数据来决定交互行为，这里列举一些业务层想要的数据：
       
 
         
  
      • Header 的数据
        •  
  
      • 响应码：有时候会通过响应码来区分界面的错误弹窗、业务类型
        •  
  
      • 具体错误类型
        •  
  
      • 接口数据
        •  
 
       
 
      数据包装类定义
       
 
      Kotlin 里面try catch 的扩展函数 runCatching()如下
       
 
      public inline fun  T.runCatching(block: T.() -> R): Result {
    return try {
        Result.success(block())
    } catch (e: Throwable) {
        Result.failure(e)
    }
}

       
 
         
  
      • 以看到它是将闭包函数 try catch 后包装成 Result 密封类返回
        •  
  
      •  
        kotlin.Result 类是一个设计和扩展方法很全面的类，在 kotlin 里面各种特性的 API 之间起了至关重要的作用，其实现如下
         
        @JvmInline
public value class Result @PublishedApi internal constructor(
    @PublishedApi
    internal val value: Any?
) : Serializable {
    // discovery

    /**
     * Returns `true` if this instance represents a successful outcome.
     * In this case [isFailure] returns `false`.
     */
    public val isSuccess: Boolean get() = value !is Failure

    /**
     * Returns `true` if this instance represents a failed outcome.
     * In this case [isSuccess] returns `false`.
     */
    public val isFailure: Boolean get() = value is Failure

    // value & exception retrieval

    /**
     * Returns the encapsulated value if this instance represents [success][Result.isSuccess] or `null`
     * if it is [failure][Result.isFailure].
     *
     * This function is a shorthand for `getOrElse { null }` (see [getOrElse]) or
     * `fold(onSuccess = { it }, onFailure = { null })` (see [fold]).
     */
    @InlineOnly
    public inline fun getOrNull(): T? =
        when {
            isFailure -> null
            else -> value as T
        }

    /**
     * Returns the encapsulated [Throwable] exception if this instance represents [failure][isFailure] or `null`
     * if it is [success][isSuccess].
     *
     * This function is a shorthand for `fold(onSuccess = { null }, onFailure = { it })` (see [fold]).
     */
    public fun exceptionOrNull(): Throwable? =
        when (value) {
            is Failure -> value.exception
            else -> null
        }

    /**
     * Returns a string `Success(v)` if this instance represents [success][Result.isSuccess]
     * where `v` is a string representation of the value or a string `Failure(x)` if
     * it is [failure][isFailure] where `x` is a string representation of the exception.
     */
    public override fun toString(): String =
        when (value) {
            is Failure -> value.toString() // "Failure($exception)"
            else -> "Success($value)"
        }

    // companion with constructors

    /**
     * Companion object for [Result] class that contains its constructor functions
     * [success] and [failure].
     */
    public companion object {
        /**
         * Returns an instance that encapsulates the given [value] as successful value.
         */
        @Suppress("INAPPLICABLE_JVM_NAME")
        @InlineOnly
        @JvmName("success")
        public inline fun  success(value: T): Result =
            Result(value)

        /**
         * Returns an instance that encapsulates the given [Throwable] [exception] as failure.
         */
        @Suppress("INAPPLICABLE_JVM_NAME")
        @InlineOnly
        @JvmName("failure")
        public inline fun  failure(exception: Throwable): Result =
            Result(createFailure(exception))
    }

    internal class Failure(
        @JvmField
        val exception: Throwable
    ) : Serializable {
        override fun equals(other: Any?): Boolean = other is Failure && exception == other.exception
        override fun hashCode(): Int = exception.hashCode()
        override fun toString(): String = "Failure($exception)"
    }
}

         
        •  
  
      •  
        这里模仿 kotlin.Result，针对上述的封装需求分析，按需定义一个针对 Http 请求结果的 HttpResult 密封类，用于保存 Retrofit + OKHTTP处理过后的各种数据
         主要实现是 HttpResult 的四个密封子类 Success ApiError NetworkError UnknownError
         
   
           
    
        •  HttpResult ：密封类，保存了基础数据 Headers，T 是 API 方法定义的请求返回值类型
          •  
   
         
        sealed class HttpResult(open val responseHeader: Headers?) : Serializable {
...
}

         
   
           
    
        •  Success：接口请求成功，保存接口请求的 Header 原始数据和适配器解析后的接口 body 数据，T 是 API 方法定义的请求返回值类型
          •  
   
         
            /**
     * Success response with body
     */
    data class Success(val value: T, override val responseHeader: Headers?) :
        HttpResult(responseHeader) {
        override fun toString(): String {
            return "Success($value)"
        }

        override fun exceptionOrNull(): Throwable? = null
    }

         
   
           
    
        •  ApiError ：通常是接口返回错误，其中 message 是我们接口定义通用结构中含有的固定类型，大家可以根据具体业务来定义
          •  
   
         
            /**
     * Failure response with body，通常是接口返回错误
     * @property code Int 错误码，默认是-1
     * @property message message 接口错误信息
     * @property throwable 原始错误类型
     * @constructor
     */
    data class ApiError(
        val code: Int = -1,
        val message: String? = null,
        val throwable: Throwable,
        override val responseHeader: Headers? = null,
    ) :
        HttpResult(responseHeader) {
        override fun toString(): String {
            return "ApiError(message:$message,code:$code)"
        }

        override fun exceptionOrNull(): Throwable = throwable
    }

         
   
           
    
        •  NetworkError：通常是断网了
          •  
   
         
            /**
     * For example, json parsing error
     */
    data class UnknownError(
        val throwable: Throwable?,
        override val responseHeader: Headers? = null,
    ) : HttpResult(responseHeader) {
        override fun toString(): String {
            super.toString()
            return "UnknownError(throwable:${throwable?.message})"
        }

        override fun exceptionOrNull(): Throwable? = throwable
    }

         
   
           
    
        •  UnknownError ：除上述错误外的其他错误，比如解析错误等，具体错误会通过 throwable 给出，并且按照接口请求的行为，可能 throwable 会为 null
          •  
   
         
            /**
     * For example, json parsing error
     */
    data class UnknownError(
        val throwable: Throwable?,
        override val responseHeader: Headers? = null,
    ) : HttpResult(responseHeader) {
        override fun toString(): String {
            super.toString()
            return "UnknownError(throwable:${throwable?.message})"
        }

        override fun exceptionOrNull(): Throwable? = throwable
    }

         
   
           
    
        • 综上所述，HttpResult整体实现如下 
          sealed class HttpResult(open val responseHeader: Headers?) : Serializable {
    // discovery

    /**
     * Returns `true` if this instance represents a successful outcome.
     * In this case [isFailure] returns `false`.
     */
    val isSuccess: Boolean get() = this is Success

    /**
     * Returns `true` if this instance represents a failed outcome.
     * In this case [isSuccess] returns `false`.
     */
    val isFailure: Boolean get() = this !is Success


    /**
     * Success response with body
     */
    data class Success(val value: T, override val responseHeader: Headers?) :
        HttpResult(responseHeader) {
        override fun toString(): String {
            return "Success($value)"
        }

        override fun exceptionOrNull(): Throwable? = null
    }

    /**
     * Failure response with body，通常是接口返回错误
     * @property code Int 错误码，默认是-1
     * @property message message 接口错误信息
     * @property throwable 原始错误类型
     * @constructor
     */
    data class ApiError(
        val code: Int = -1,
        val message: String? = null,
        val throwable: Throwable,
        override val responseHeader: Headers? = null,
    ) :
        HttpResult(responseHeader) {
        override fun toString(): String {
            return "ApiError(message:$message,code:$code)"
        }

        override fun exceptionOrNull(): Throwable = throwable
    }

    /**
     * Network error 通常是断网了
     */
    data class NetworkError(
        val error: Throwable,
        override val responseHeader: Headers? = null,
    ) : HttpResult(responseHeader) {
        override fun toString(): String {
            return "NetworkError(error:${error.message})"
        }

        override fun exceptionOrNull(): Throwable = error
    }

    /**
     * For example, json parsing error
     */
    data class UnknownError(
        val throwable: Throwable?,
        override val responseHeader: Headers? = null,
    ) : HttpResult(responseHeader) {
        override fun toString(): String {
            super.toString()
            return "UnknownError(throwable:${throwable?.message})"
        }

        override fun exceptionOrNull(): Throwable? = throwable
    }

    fun getOrNull(): T? = (this as? Success)?.value

    /**
     * Returns the encapsulated [Throwable] exception if this instance represents [failure][isFailure] or `null`
     * if it is [success][isSuccess].
     *
     * This function is a shorthand for `fold(onSuccess = { null }, onFailure = { it })` (see [fold]).
     */
    open fun exceptionOrNull(): Throwable? = null

    companion object {
        fun  success(result: T, responseHeader: Headers?): HttpResult =
            Success(result, responseHeader)

        fun apiError(
            code: Int = -1,
            message: String? = null,
            throwable: Throwable,
            responseHeader: Headers?
        ): HttpResult =
            ApiError(code, message, throwable, responseHeader)

        fun  networkError(
            error: Throwable, responseHeader: Headers?
        ): HttpResult =
            NetworkError(error, responseHeader)

        fun  unknownError(
            throwable: Throwable?, responseHeader: Headers?
        ): HttpResult =
            UnknownError(throwable, responseHeader)
    }

}

           
          •  
   
         
        •  
 
       
 
      自定义 CallAdapterFactory 来定制请求行为
       
 
      从上面分析我们知道，我们只要代理 retrofit2.KotlinExtensions#await 中 Callback 接口被回调的方法始终为 onResponse() 和容错response.body() 为 null 的情况即可解决程序闪退和 try catch 的问题，当然因为我们上面重新定义了数据封装类为 HttpResult ，导致我们这里必须得自定义 CallAdapterFactory 才能干扰 Retrofit.Call 实现类的行为。
       
 
         
  
      • 自定义数据封装类为 HttpResult 后 API 方法定义会变为
        •  
 
       
 
          @GET("xxxx/get-notification-settings")
    suspend fun loadSettings(): HttpResult>
    
    /**
     * Repo 为统一的数据包装格式
     */
    public class Repo {

          @Nullable
          @SerializedName("meta")
          private Meta meta;

          @Nullable
          @SerializedName("data")
          private T data;
          
          ...
    }

       
 
         
  
      •  
        参考 DefaultCallAdapterFactory 和 RxJava2CallAdapterFactory的实现思路，我们定义一个 SuspendCallAdapterFactory 实现 CallAdapter.Factory 接口，如果对不熟悉 Factory 的自定义流程，还是可以打断点调试下 DefaultCallAdapterFactory 和 RxJava2CallAdapterFactory ，另外配合 SuspendCallAdapterFactory 的实现，我们还要实现一个 CallAdapter 用于 Call 和实际数据的转换。
         
        class SuspendCallAdapterFactory : CallAdapter.Factory() {

    override fun get(
        returnType: Type,
        annotations: Array,
        retrofit: Retrofit
    ): CallAdapter<*, *>? {

        // 返回一个 CallAdapter
    }
    
    
class SuspendCallAdapter, R : Any>(
    private val successType: Type
  ) : CallAdapter>> {

    override fun responseType(): Type = successType

    override fun adapt(call: Call): Call> {
        return SuspendHttpCall(call, needCloseGeneralExceptionHandler)
    }
}

         
        •  
  
      • 基本思路：重写 SuspendCallAdapterFactory ，在某个适合的条件下返回 SuspendCallAdapter 【代表使用该适配器来处理数据和 retrofit2.Call 类的转换】，下面看下 Retrofit 默认适配器是如何工作的【Rx 适配器有兴趣的小伙伴自己调试下，原理其实差不多的】
        •  
  
      •  
        DefaultCallAdapterFactory 的流程分析
         
   
           
    
        • 首先看下 DefaultCallAdapterFactory 和其主要方法 get(Type returnType, Annotation[] annotations, Retrofit retrofit) 的实现【省略部分实现】
          •  
   
         
        final class DefaultCallAdapterFactory extends CallAdapter.Factory {
  private final @Nullable Executor callbackExecutor;

  DefaultCallAdapterFactory(@Nullable Executor callbackExecutor) {
    this.callbackExecutor = callbackExecutor;
  }

  @Override
  public @Nullable CallAdapter get(
      Type returnType, Annotation[] annotations, Retrofit retrofit) {
    //返回值如果不是 Call 类，那么返回 null，表示不选择该 Factory 对应的 CallAdapter
    if (getRawType(returnType) != Call.class) {
      return null;
    }
    //方法返回值是否为参数化类型，如果不为参数化类型，那么会抛出一个异常，这里有固定的含义：也就是 Call 类必须包含范型
    if (!(returnType instanceof ParameterizedType)) {
      throw new IllegalArgumentException(
          "Call return type must be parameterized as Call or Call");
    }
    //获取返回值类包含的第一个范型类型
    final Type responseType = Utils.getParameterUpperBound(0, (ParameterizedType) returnType);

    final Executor executor =
        Utils.isAnnotationPresent(annotations, SkipCallbackExecutor.class)
            ? null
            : callbackExecutor;

    return new CallAdapter>() {
      @Override
      public Type responseType() {
        //将 Call 类包含的第一个范型类型返回，代表当前这个 CallAdapter 需要转换为目标数据的类型，也就是说 Retrofit 最终会将数据解析为这个类型
        return responseType;
      }

      @Override
      public Call adapt(Call call) {
        // callbackExecutor 为 null 则不代理原始 Call，直接返回，否则将 callbackExecutor 和 原始 call 传递给 ExecutorCallbackCall 让其代理原始 call 的功能。
        return executor == null ? call : new ExecutorCallbackCall<>(executor, call);
      }
    };
  }
 
   
           
    
        • DefaultCallAdapterFactory 构造函数接受一个 callbackExecutor ，其主要用于给后续判断 API 方法定义是否含有 SkipCallbackExecutor 注解，如果有 SkipCallbackExecutor 注解那么 callbackExecutor 为 null ，其会传递给 CallAdapter 返回原始的 Call 对象（相当于未代理 Call 类）
          •  
    
        • 其他情况上面的代码注释应该比较清楚了，另外这里和后面我们自定义的实现里面需要用到的比较关键的 ParameterizedType 类，它代表的是参数化类型，简单的说就是包含范型（包含<>括号）的类声明，比如 Dog
          •  
    
        •  
          有的小伙伴就说了，我有些时候并没有定义 API 的方法返回值是 Call 啊，为何这里还要判断 returnType 为 Call 呢？
           
     
             
      
          • 还是最原始的方法，如果不知道发生什么事（对源码不熟），那么直接在 DefaultCallAdapterFactory 的 get 函数里面打断点，看看是从哪里传递过来的，一直向前看，总会发现发生了什么（小声 bb）
            •  
      
          • 我们来到 retrofit2.HttpServiceMethod#parseAnnotations 的方法
            •  
     
           
            static  HttpServiceMethod parseAnnotations(
      Retrofit retrofit, Method method, RequestFactory requestFactory) {
    boolean isKotlinSuspendFunction = requestFactory.isKotlinSuspendFunction;
    boolean continuationWantsResponse = false;
    boolean continuationBodyNullable = false;

    Annotation[] annotations = method.getAnnotations();
    Type adapterType;
    if (isKotlinSuspendFunction) {
      Type[] parameterTypes = method.getGenericParameterTypes();
      Type responseType =
          Utils.getParameterLowerBound(
              0, (ParameterizedType) parameterTypes[parameterTypes.length - 1]);
      if (getRawType(responseType) == Response.class && responseType instanceof ParameterizedType) {
        // Unwrap the actual body type from Response.
        responseType = Utils.getParameterUpperBound(0, (ParameterizedType) responseType);
        continuationWantsResponse = true;
      } else {
        // TODO figure out if type is nullable or not
        // Metadata metadata = method.getDeclaringClass().getAnnotation(Metadata.class)
        // Find the entry for method
        // Determine if return type is nullable or not
      }

      adapterType = new Utils.ParameterizedTypeImpl(null, Call.class, responseType);
      annotations = SkipCallbackExecutorImpl.ensurePresent(annotations);
    } else {
      adapterType = method.getGenericReturnType();
    }

    CallAdapter callAdapter =
        createCallAdapter(retrofit, method, adapterType, annotations);

           
          关键就是这一行 adapterType = new Utils.ParameterizedTypeImpl(null, Call.class, responseType);
           responseType 本来为 API 方法定义的返回值类型，被 Call 包了一下，变成了新的参数化类型，这一招是相当的骚，具体实现在 Utils.ParameterizedTypeImpl 类中，有兴趣的朋友可以看看它是怎么做到包装范型的，大致思路是将实现了 ParameterizedType 接口，实现相关方法，重定义类型和范型的关系。
           
          •  
    
        •  
          ExecutorCallbackCall 实现
           
            static final class ExecutorCallbackCall implements Call {
    final Executor callbackExecutor;
    final Call delegate;

    ExecutorCallbackCall(Executor callbackExecutor, Call delegate) {
      //接受线程池和待代理的 Call 对象
      this.callbackExecutor = callbackExecutor;
      this.delegate = delegate;
    }

    @Override
    public void enqueue(final Callback callback) {
      Objects.requireNonNull(callback, "callback == null");

      //代理发起异步 API 请求
      delegate.enqueue(
          new Callback() {
            @Override
            public void onResponse(Call call, final Response response) {
              //使用 callbackExecutor 回调结果
              callbackExecutor.execute(
                  () -> {
                    if (delegate.isCanceled()) {
                      // Emulate OkHttp's behavior of throwing/delivering an IOException on
                      // cancellation.
                      callback.onFailure(ExecutorCallbackCall.this, new IOException("Canceled"));
                    } else {
                      callback.onResponse(ExecutorCallbackCall.this, response);
                    }
                  });
            }

            @Override
            public void onFailure(Call call, final Throwable t) {
              callbackExecutor.execute(() -> callback.onFailure(ExecutorCallbackCall.this, t));
            }
          });
    }

           
          总体来说 ExecutorCallbackCall 只做了使用 callbackExecutor 回调结果的操作。我们可以模仿它实现自己的 Call 代理类
           
          •  
   
          
  
      • 这个时候，又有小伙伴就说了，你呀的啥时候自定义啊，我等不及啦，掏出货来啊，马上安排啦....
        •  
  
 
         
  
         
   
          
   
         
  
         
  
         
 
         
 
         
 
        自定义 CallAdapterFactory 来定制请求行为(真的上货了)
         
 
           
  
        •  
          1、上面说了那么多，总结下现在 API 定义变成什么样了，如下，原来的 Repo 被 HttpResult 接管了
           
              @GET("xxx/get-notification-settings")
    suspend fun loadSettings(): HttpResult>
    
    /**
     * Repo 为统一的数据包装格式
     */
    public class Repo {

          @Nullable
          @SerializedName("meta")
          private Meta meta;

          @Nullable
          @SerializedName("data")
          private T data;
          
          ...
    }

           
          •  
  
        •  
          2、自定义 SuspendCallAdapterFactory 和 SupendCallAdatper，SuspendHttpCall 暂时不列出
           
          class SuspendCallAdapterFactory : CallAdapter.Factory() {

    override fun get(
        returnType: Type,
        annotations: Array,
        retrofit: Retrofit
    ): CallAdapter<*, *>? {

        //第一个泛型就是HttpResult类，这种情况可能是api接口没有声明协程suspend符号，抛出异常提醒 
        if (getRawType(returnType) == HttpResult::class.java) {
            throw IllegalArgumentException("Method must be declare suspend, please check function declaration at API interface")
        }

        //协程挂起函数默认返回值是Call<*>，如果不满足该条件，那么返回null让retrofit选择其他家伙来Py
        if (Call::class.java != getRawType(returnType)) {
            return null
        }

        //检查Call内部的泛型是否包含了其他泛型
        check(returnType is ParameterizedType) {
            "return type must be HttpResult<*> or HttpResult for Call<*> check"
        }

        //获取Call类包裹的第一个泛型
        val responseType = getParameterUpperBound(0, returnType)

        //Call类包裹的第一个泛型不是HttpResult类，那么返回null，让retrofit选择其他 CallAdapter.Factory
        if (getRawType(responseType) != HttpResult::class.java) {
            return null
        }

        //确保HttpResult内部包的泛型其还包裹另外一层泛型，比如 HttpResult<*>
        check(responseType is ParameterizedType) { "return type must be HttpResult<*> or HttpResult for HttpResult<*> check" }

        //获取HttpResult类包裹的第一个泛型
        val successBodyType = getParameterUpperBound(0, responseType)

        return SuspendCallAdapter, Any>(
            successBodyType
        )
    }
    
    companion object {

        @JvmStatic
        fun create(): SuspendCallAdapterFactory {
            return SuspendCallAdapterFactory()
        }
    }
}
    
    
class SuspendCallAdapter, R : Any>(
    private val successType: Type,
) : CallAdapter>> {

    override fun responseType(): Type = successType

    override fun adapt(call: Call): Call> {
    
        return SuspendHttpCall(call)
    }
}

           
   
             
    
          • 上面注释已经很清晰了，下面提下比较重要的几点
            •  
    
          •  
            第一个就是判断泛型是否为HttpResult类，这种情况可能是api接口没有声明协程suspend符号，抛出异常提醒，至于为何有这个结论，大家可以看下 retrofit2.HttpServiceMethod#parseAnnotations 中 isKotlinSuspendFunction 为 false 的声明，returnType 直接取值为 API Method 定义的值，这种情况是不符合我们目前定义的协程这一套逻辑的，我们直接排除，返回 null 让 Retrofit 选择其它 Factory
             
             
     
             
      
             
       
              
       
             
      
             
      
             
     
             
             
            •  
    
          • 最后我们获取HttpResult类包裹的第一个泛型类型传递给了SupendCallAdatper 作为 responseType() 的返回值，不清楚这个环节的可以看看上面 DefaultCallAdapterFactory 的流程分析中有提到，responseType() 的返回值决定 Retrofit 最终解析的数据类型（反序列化）
            •  
    
          •  
            应该大家还记得 parseAnnotations 方法中，API Method 定义的返回值类型被 Call 包裹的操作，因为接口有一个通用的包装格式，也就是数据类型永远为 Repo 类似的情况，这里也用包裹范型的操作将 HttpResult> 换为 HttpResult 减少业务方要声明的范型层级
             
     
               
      
            • API 方法实现变为
              •  
     
             
                @GET("xxx/get-notification-settings")
    suspend fun loadSettings(): HttpResult>
    
    变为
    
    @GET("xxx/get-notification-settings")
    suspend fun loadSettings(): HttpResult

             
     
               
      
            • 修改 SuspendCallAdapterFactory 的get 方法，主要就是将HttpResult<>中的泛型<>包裹为Repo<*>，具体变化如下
              •  
     
             
            class SuspendCallAdapterFactory : CallAdapter.Factory() {

    override fun get(
        returnType: Type,
        annotations: Array,
        retrofit: Retrofit
    ): CallAdapter<*, *>? {

        //第一个泛型就是HttpResult类，这种情况可能是api接口没有声明协程suspend符号，抛出异常提醒
        if (getRawType(returnType) == HttpResult::class.java) {
            throw IllegalArgumentException("Method must be declare suspend, please check function declaration at API interface")
        }

        //协程挂起函数默认返回值是Call<*>，如果不满足该条件，那么返回null让retrofit选择其他家伙来Py
        if (Call::class.java != getRawType(returnType)) {
            return null
        }

        //检查Call内部的泛型是否包含了其他泛型
        check(returnType is ParameterizedType) {
            "return type must be HttpResult<*> or HttpResult for Call<*> check"
        }

        //获取Call类包裹的第一个泛型
        val responseType = getParameterUpperBound(0, returnType)

        //Call类包裹的第一个泛型不是HttpResult类，那么返回null，让retrofit选择其他 CallAdapter.Factory
        if (getRawType(responseType) != HttpResult::class.java) {
            return null
        }

        //确保HttpResult内部包的泛型其还包裹另外一层泛型，比如 HttpResult<*>
        check(responseType is ParameterizedType) { "return type must be HttpResult<*> or HttpResult for HttpResult<*> check" }

        //获取HttpResult类包裹的第一个泛型
        val successBodyType = getParameterUpperBound(0, responseType)

        //整块注释，下面将动态配置泛型变为Repo<*>，不需要再手动声明为Repo<*>泛型================改动点
//        check(Repo::class.java == getRawType(successBodyType)) {
        //如果待处理的类型不是Repo类，那么报异常
//            "return type must be HttpResult> or HttpResult>> for Repo<*> check"
//        }

        //将HttpResult<*>中的泛型<*>包裹为Repo<*>，方便解析
        val repoParameterizedType =
            Utils.ParameterizedTypeImpl(null, Repo::class.java, successBodyType)

        return SuspendCallAdapter, Any>(
            repoParameterizedType
        )
    }

             
            •  
   
           
          •  
  
        •  
          3、自定义 SuspendHttpCall
           
          internal class SuspendHttpCall, R : Any>(
    private val delegate: Call,
) : Call> {

    override fun enqueue(callback: Callback>) {

        return delegate.enqueue(object : Callback {
            override fun onResponse(call: Call, response: Response) {
                val body = response.body()
                var httpResult: HttpResult? = null

                //================================================
                //================================================
                //===================1、响应成功===================
                //================================================
                //================================================
                if (response.isSuccessful) {
                    body?.data?.apply {
                        //Repo.data不为空
                        httpResult = HttpResult.Success(this, response.headers())
                    } ?: run {
                        //响应body是null或者Repo的data为空的时候
                        httpResult = HttpResult.UnknownError(
                            IllegalArgumentException("response data is invalid"),
                            null
                        )
                    }

                    callback.onResponse(
                        this@SuspendHttpCall,
                        Response.success(httpResult)
                    )
                    return
                }

                //================================================
                //================================================
                //===================2、响应失败===================
                //================================================
                //================================================
                onFailure(call, HttpException(response))
            }

            override fun onFailure(call: Call, throwable: Throwable) {

                var meta: Meta? = null
                var statusCode = -1
                if (isHttpException(throwable)) {
                    val exception = throwable as HttpException
                    //从 exception 中解析 Repo.Meta 数据
                    meta = parseMetaData(exception)
                    statusCode = exception.code()
                }

                val result: HttpResult = generateHttpResult(throwable, meta, statusCode)
                callback.onRespo nse(this@SuspendHttpCall, Response.success(result))
            }
        })
    }

    override fun isExecuted() = delegate.isExecuted

    override fun clone() = SuspendHttpCall(
        delegate.clone(),
    )

    override fun isCanceled() = delegate.isCanceled

    override fun cancel() = delegate.cancel()

    override fun execute(): Response> {
        throw UnsupportedOperationException("NetworkResponseCall doesn't support execute")
    }

    override fun request(): Request = delegate.request()

    override fun timeout(): Timeout = delegate.timeout()

}

fun generateHttpResult(
        t: Throwable,
        meta: Meta?,
        statusCode: Int
    ): HttpResult {
        if (isApiError(t, meta, statusCode)) {
            return HttpResult.ApiError(
                meta?.code ?: statusCode,
                meta?.message,
                t,
                parseHeader(t),
            )
        }
        if (isNonNetwork(t)) {
            return HttpResult.NetworkError(t, parseHeader(t))
        }
        return HttpResult.UnknownError(t, parseHeader(t))
    }
    
fun generateHttpResult(
        t: Throwable,
        meta: Meta?,
        statusCode: Int
    ): HttpResult {
        if (isApiError(t, meta, statusCode)) {
            return HttpResult.ApiError(
                meta?.code ?: statusCode,
                meta?.message,
                t,
                parseHeader(t),
            )
        }
        if (isNonNetwork(t)) {
            return HttpResult.NetworkError(t, parseHeader(t))
        }
        return HttpResult.UnknownError(t, parseHeader(t))
    }


           
   
             
    
          • 模仿 ExecutorCallbackCall 的实现，因为我们这里只用到异步请求 API，我们只需要实现 enqueue 方法接口，回到我们最初的目的，我们代理 Retrofit.Call 是为了容错 response.body()=null 和 callback.onFailure，这里实现上我们要做一些处理，结合 HttpResult 的设计，将四种密封类职能分别包装，最后用 callback.onResponse() 将结果返回，防止业务方抛出异常。
            •  
   
           
          •  
  
        •  
          4、最后我们在 Retrofit.Builder 中引入 Factory 即可
           
                          new Retrofit.Builder()
                        .baseUrl(asBase)
                        .addCallAdapterFactory(SuspendCallAdapterFactory.create())

           
          •  
  
        •  
          5、使用方法，由于使用了密封类，用 when 来展开，编译器会帮忙补全，或者可以直接写成 Template 模版，使用代码补全填充
           
                       viewmodelScope.launch {
                    val httpResult =
                        AcRetrofit.get().notificationApi.loadSettings()
                    when (httpResult) {
                        is HttpResult.ApiError -> {
                            //API 异常，比如 403，503，等等
                            //httpResult.code
                            //httpResult.message
                            //httpResult.headers
                        }
                        is HttpResult.NetworkError -> {
                            //网络问题
                        }
                        is HttpResult.Success -> {
                            val notificationData = httpResult.value
                        }
                        is HttpResult.UnknownError -> {
                            //其他异常
                            //httpResult.throwable
                        }
                    }
                }

           
   
           
    
           
     
            
     
           
    
           
    
           
   
           
          •  
  
        •  
          6、真的没了，封装就告一段落了
           
           
   
           
    
           
     
            
     
           
    
           
    
           
   
           
          •  
 
         
 
         
 
        Flow扩展
         
 
        上面讲了 Retrofit 怎么样在协程中去掉 try catch 跟其他代码流式编程，但其实如果结合 Flow 来定义 API Method 调用会更加的优雅，那么怎么样快速切换到 Flow 接口呢
         
 
        转换为 Flow 用法的分析
         
 
        一开始我们转换为 HttpResult 时，我们的做法是在外部再包装一层 HttpResult，让 API 返回值变为 HttpResult，并且自定义 Factory 和 Adapter 与 Call 改变Retrofit 原始的请求行为。
         
 
        现在我们要变为 Flow，就是再包装一层 Flow 咯，还有 Factory 那些也重新给自定义下。【本质上 Flow 的用法和 Rx 的用法差不多】
         
 
           
  
        • 1、就是 API 方法定义会变为如下，要注意 Flow 类型不需要挂起函数声明 ，这里只要将返回值修改即可
          •  
 
         
 
            @GET("setting/get-notification-settings")
    fun loadSettings(): Flow>

         
 
           
  
        •  
          2、定义 FlowCallAdapterFactory，相关解释可以看下注释，主要是判断第一个范型是 Flow 类型
           
          import com.aftership.framework.http.retrofits.Repo
import com.aftership.framework.http.retrofits.suspend.HttpResult
import com.aftership.framework.http.retrofits.suspend.Utils
import kotlinx.coroutines.flow.Flow
import retrofit2.CallAdapter
import retrofit2.Retrofit
import java.lang.reflect.ParameterizedType
import java.lang.reflect.Type

/**
 *
 * Flow 请求方式 Retrofit CallAdapter，主要是将请求转换为 Flow>，并且包裹请求的所有结果填充到 Flow 中返回
 *
 * @author: minminaya
 * @email: [email protected]
 * @date: 2020/8/30 14:59
 */
class FlowCallAdapterFactory : CallAdapter.Factory() {

    /**
     *
     * @param returnType Type Flow>
     * @param annotations Array
     * @param retrofit Retrofit
     * @return CallAdapter<*, *>?
     */
    override fun get(
        returnType: Type,
        annotations: Array,
        retrofit: Retrofit
    ): CallAdapter<*, *>? {

        val firstGenericType = getRawType(returnType)

        //第一个泛型不是 Flow 类，让 retrofit 选择其它 Factory
        if (firstGenericType != Flow::class.java) {
            return null
        }

        //检查 Flow 内部的泛型是否包含了其他泛型
        check(returnType is ParameterizedType) {
            "return type must be Flow> or Flow>"
        }

        //获取 Flow 类包裹的泛型(第二个范型)
        val secondGenericType = getParameterUpperBound(0, returnType)

        //第二个范型不是 HttpResult 类，那么报错
        check(secondGenericType != HttpResult::class.java) {
            "Flow generic type must be HttpResult"
        }

        //确保 HttpResult 内部包的泛型其还包裹另外一层泛型，比如 HttpResult<*> or Flow>
        check(secondGenericType is ParameterizedType) { "HttpResult generic type must be not null" }

        //获取 HttpResult<*> 类包裹的泛型（数据）
        val thirdGenericType = getParameterUpperBound(0, secondGenericType)

        //将 HttpResult<*> 中的泛型 <*> 包裹为 Repo<*>，方便解析
        val repoParameterizedType =
            Utils.ParameterizedTypeImpl(null, Repo::class.java, thirdGenericType)

        return FlowCallAdapter, Any>(
            repoParameterizedType,
        )
    }

    companion object {

        @JvmStatic
        fun create(): FlowCallAdapterFactory {
            return FlowCallAdapterFactory()
        }
    }
}


           
          •  
  
        •  
          3、实现 FlowCallAdapter ，代理 Retrofit.Call 的行为，这里很关键的是 callbackFlow{} 的使用，它是异步回调转同步使用的魔法，类似 suspendCancellableCoroutine{} 的协程挂起操作
           
          class FlowCallAdapter, R : Any>(
    private val successType: Type,
) : CallAdapter>> {

    override fun responseType(): Type = successType

    @OptIn(ExperimentalCoroutinesApi::class)
    override fun adapt(call: Call): Flow> {
        return callbackFlow {
            //异步转同步，为了保证项目内都使用 HttpResult 做响应数据包装类，这里还是复用 SuspendHttpCall
            val suspendHttpCall =
                SuspendHttpCall(call).also {
                    it.enqueue(
                        object : Callback> {
                            override fun onResponse(
                                call: Call>,
                                response: Response>
                            ) {
                                response.body()?.let{ httpResult->
                                    trySend(httpResult)
                                }
                            }

                            override fun onFailure(call: Call>, t: Throwable) {
                                //SuspendHttpCall 不会回调 onFailure(),这里不用做实现
                                //do nothing here
                            }

                        })
                }
            //必须声明关闭 call，类似 suspendCancellableCoroutine 的使用 
            awaitClose {
                suspendHttpCall.cancel()
            }
        }
    }
}


           
          中途代理 SuspendHttpCall 的enqueue 操作后，发射 httpResult 的结果给 callbackFlow 完成 flow 的发射端调用
           
          •  
  
        •  
          4、引入 Factory
           
                          new Retrofit.Builder()
                        .baseUrl(asBase)
                        .addCallAdapterFactory(FlowCallAdapterFactory.create())

           
          •  
  
        •  
          5、使用 Flow API 请求，类似上面协程的调用，这里还是会包装为 HttpResult
           
          val settingsFlow = AcRetrofit.get().notificationAPI.loadSettings()
  settingFlow
          .collect {
                  when (it) {
                        is HttpResult.ApiError -> {
                            //API 异常，比如 403，503，等等
                            //httpResult.code
                            //httpResult.message
                            //httpResult.headers
                        }
                        is HttpResult.NetworkError -> {
                            //网络问题
                        }
                        is HttpResult.Success -> {
                            val notificationData = httpResult.value
                        }
                        is HttpResult.UnknownError -> {
                            //其他异常
                            //httpResult.throwable
                        }
                    }
                  }

           
          •  
 
         
 
        思考
         
 
           
  
        • 不要遇到问题就 Google，更好的做法是先看看框架怎么实现的
          •  
  
        • 源码里面有黄金书，包裹范型的思路就是在 Retrofit 里面发现从而优化 API Method 的调用
          •  
  
        • 不要单纯的看源码和看大佬们的源码分析，要自己写 Demo 断点调试源码，看看数据是怎么流转和产生的
          •  
 
         
 
         
 
        参考
         
 
           
  
        • Retrofit
          •  
  
        • Flow 
          •  
  
        • Channels
          •  
  
        • callbackFlow
          •  
 
         

                            
                        
                    
                    
                    
        
                    
                    
                    
        
                
                
        
                    
                
        
            
        
    
    
        
        
        你可能感兴趣的:(更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch))
        
        
        
            
        
                
          
                    
        • 斤斤计较的婚姻到底有多难？
                        白心之岂必有为

                        
          很多人私聊我会问到在哪个人群当中斤斤计较的人最多？我都会回答他，一般婚姻出现问题的斤斤计较的人士会非常多，以我多年经验，在婚姻落的一塌糊涂的人当中，斤斤计较的人数占比在20～30%以上，也就是说10个婚姻出现问题的斤斤计较的人有2-3个有多不减。在婚姻出问题当中，有大量的心理不平衡的、尖酸刻薄的怨妇。在婚姻中仅斤斤计较有两种类型：第一种是物质上的，另一种是精神上的。在物质与精神上抠门已经严重的影响
          
                    
          • 
                    
        • 情绪觉察日记第37天
                        露露_e800

                        
          今天是家庭关系规划师的第二阶最后一天，慧萍老师帮我做了个案，帮我处理了埋在心底好多年的一份恐惧，并给了我深深的力量！这几天出来学习，爸妈过来婆家帮我带小孩，妈妈出于爱帮我收拾东西，并跟我先生和婆婆产生矛盾，妈妈觉得他们没有照顾好我…。今晚回家见到妈妈，我很欣赏她并赞扬她，妈妈说今晚要跟我睡我说好，当我们俩躺在床上准备睡觉的时候，我握着妈妈的手对她说:妈妈这几天辛苦你了，你看你多利害把我们的家收拾得
          
                    
          • 
                    
        • 芦花鞋一四
                        许叶晗

                        
          又是在一个寒冷的夏日里，青铜和葵花决定今天一起去卖芦花鞋，奶奶亲手给他们做了一碗热乎乎的粥对他们说:“就靠你们两挣生活费了这碗粥赶紧趁热喝了吧！”于是青铜和葵花喝完了奶奶给她们做的粥，就准备去镇上卖卢花鞋，这回青铜和葵花穿着新的芦花鞋来到了镇上。青铜这回看到了很多人都在卖，用手势表达对葵花说:“这回有好多人在抢我们生意呢！我们必须得吆喝起来。”葵花点了点头。可是谁知他们也大声的叫，卖芦花喽！卖芦花
          
                    
          • 
                    
        • QQ群采集助手，精准引流必备神器
                        2401_87347160
其他经验分享
                        
          功能概述微信群查找与筛选工具是一款专为微信用户设计的辅助工具，它通过关键词搜索功能，帮助用户快速找到相关的微信群，并提供筛选是否需要验证的群组的功能。主要功能关键词搜索：用户可以输入关键词，工具将自动查找包含该关键词的微信群。筛选功能：工具提供筛选机制，用户可以选择是否只显示需要验证或不需要验证的群组。精准引流：通过上述功能，用户可以更精准地找到目标群组，进行有效的引流操作。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
          
                    
          • 
                    
        • 铭刻于星（四十二）
                        随风至

                        
          69夜晚，绍敏同学做完功课后，看了眼房外，没听到动静才敢从书包的夹层里拿出那个心形纸团。折痕压得很深，都有些旧了，想来是已经写好很久了。绍敏同学慢慢地、轻轻地捏开折叠处，待到全部拆开后，又反复抚平纸张，然后仔细地一字字默看。只是开头的三个字是第一次看到，让她心漏跳了几拍。“亲爱的绍敏：从四年级的时候，我就喜欢你了，但是我一直不敢说，怕影响你学习。六年级的时候听说有人跟你表白，你接受了，我很难过，但
          
                    
          • 
                    
        • 底层逆袭到底有多难，不甘平凡的你准备好了吗？让吴起给你说说
                        造命者说

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

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

                        
          仙岛今天，我看了你全部，似乎已经进入你的世界我不知道，这是否是梦幻，还是你仙一般的灵气吸引了我也许每一个人都要有一份属于自己的追求，这样才能够符合人生的梦想，生活才能够充满着阳光与快乐我不知道，我为什么会这样的感叹，是在感叹自己的人生，还是感叹自己一直没有孜孜不倦的追求只感觉虚度了光阴，每天活在自己的梦中，活在一个不真实的世界是在逃避自己，还是在逃避周围的一切有时候我嘲笑自己，嘲笑自己如此的虚无，
          
                    
          • 
                    
        • 想家
                        爆米花机

                        
          也许不同于大家对家乡的思念，我对家乡甚至是疯狂的不舍。还未踏出车站就感觉到幸福，我享受这里的夕阳、这里的浓烈柴火味、这里每一口家常菜。我是宅女，我贪恋家的安逸。刚刚踏出大学校门，初出茅庐，无法适应每年只能国庆和春节回家。我焦虑、失眠、无端发脾气，是无法适应工作的节奏，是无法接受我将一步步离开家乡的事实。我不想承认自己胸无大志，选择再次踏上征程。图片发自App
          
                    
          • 
                    
        • 【iOS】MVC设计模式
                        Magnetic_h
iosmvc设计模式objective-c学习ui
                        
          MVC前言如何设计一个程序的结构，这是一门专门的学问，叫做"架构模式"（architecturalpattern），属于编程的方法论。MVC模式就是架构模式的一种。它是Apple官方推荐的App开发架构，也是一般开发者最先遇到、最经典的架构。MVC各层controller层Controller/ViewController/VC（控制器）负责协调Model和View，处理大部分逻辑它将数据从Mod
          
                    
          • 
                    
        • OC语言多界面传值五大方式
                        Magnetic_h
iosui学习objective-c开发语言
                        
          前言在完成暑假仿写项目时，遇到了许多需要用到多界面传值的地方，这篇博客来总结一下比较常用的五种多界面传值的方式。属性传值属性传值一般用前一个界面向后一个界面传值，简单地说就是通过访问后一个视图控制器的属性来为它赋值，通过这个属性来做到从前一个界面向后一个界面传值。首先在后一个界面中定义属性@interfaceBViewController:UIViewController@propertyNSSt
          
                    
          • 
                    
        • 一百九十四章. 自相矛盾
                        巨木擎天

                        
          唉！就这么一夜，林子感觉就像过了很多天似的，先是回了阳间家里，遇到了那么多不可思议的事情儿。特别是小伙伴们，第二次与自己见面时，僵硬的表情和恐怖的气氛，让自己如坐针毡，打从心眼里难受！还有东子，他现在还好吗？有没有被人欺负？护城河里的小鱼小虾们，还都在吗？水不会真的干枯了吧？那对相亲相爱漂亮的太平鸟儿，还好吧！春天了，到了做窝、下蛋、喂养小鸟宝宝的时候了，希望它们都能够平安啊！虽然没有看见家人，也
          
                    
          • 
                    
        • UI学习——cell的复用和自定义cell
                        Magnetic_h
ui学习
                        
          目录cell的复用手动（非注册）自动（注册）自定义cellcell的复用在iOS开发中，单元格复用是一种提高表格（UITableView）和集合视图（UICollectionView）滚动性能的技术。当一个UITableViewCell或UICollectionViewCell首次需要显示时，如果没有可复用的单元格，则视图会创建一个新的单元格。一旦这个单元格滚动出屏幕，它就不会被销毁。相反，它被添
          
                    
          • 
                    
        • element实现动态路由+面包屑
                        软件技术NINI
vue案例vue.js前端
                        
          el-breadcrumb是ElementUI组件库中的一个面包屑导航组件，它用于显示当前页面的路径，帮助用户快速理解和导航到应用的各个部分。在Vue.js项目中，如果你已经安装了ElementUI，就可以很方便地使用el-breadcrumb组件。以下是一个基本的使用示例：安装ElementUI（如果你还没有安装的话）:你可以通过npm或yarn来安装ElementUI。bash复制代码npmi
          
                    
          • 
                    
        • 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
          
                    
          • 
                    
        • 小丽成长记（四十三）
                        玲玲54321

                        
          小丽发现，即使她好不容易调整好自己的心态下一秒总会有不确定的伤脑筋的事出现，一个接一个的问题，人生就没有停下的时候，小问题不断出现。不过她今天看的书，她接受了人生就是不确定的，厉害的人就是不断创造确定性，在Ta的领域比别人多的确定性就能让自己脱颖而出，显示价值从而获得的比别人多的利益。正是这样的原因，因为从前修炼自己太少，使得她现在在人生道路上打怪起来困难重重，她似乎永远摆脱不了那种无力感，有种习
          
                    
          • 
                    
        • 学点心理知识，呵护孩子健康
                        静候花开_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
          
                    
          • 
                    
        • 瑶池防线
                        谜影梦蝶

                        
          冥华虽然逃过了影梦的军队，但他是一个忠臣，他选择上报战况。败给影梦后成逃兵，高层亡尔还活着，七重天失守......随便一条，即可处死冥华。冥华自然是知道以仙界高层的习性此信一发自己必死无疑，但他还选择上报实情，因为责任。同样此信送到仙宫后，知道此事的人，大多数人都认定冥华要完了，所以上到仙界高层，下到扫大街的，包括冥华自己，全都准备好迎接冥华之死。如果仙界现在还属于两方之争的话，冥华必死无疑。然而
          
                    
          • 
                                
        • java责任链模式
                                    3213213333332132
java责任链模式村民告县长
                                    
          责任链模式，通常就是一个请求从最低级开始往上层层的请求，当在某一层满足条件时，请求将被处理，当请求到最高层仍未满足时，则请求不会被处理。 
 
就是一个请求在这个链条的责任范围内，会被相应的处理，如果超出链条的责任范围外，请求不会被相应的处理。 
 
下面代码模拟这样的效果： 
创建一个政府抽象类,方便所有的具体政府部门继承它。 
 

package 责任链模式;

/**
 * 
 
          
                                
          • 
                                
        • linux、mysql、nginx、tomcat 性能参数优化
                                    ronin47

                                    
          一、linux 系统内核参数 
 
  /etc/sysctl.conf文件常用参数     net.core.netdev_max_backlog = 32768 #允许送到队列的数据包的最大数目
net.core.rmem_max  = 8388608        #SOCKET读缓存区大小
net.core.wmem_max  = 8388608        #SOCKET写缓存区大
          
                                
          • 
                                
        • php命令行界面
                                    dcj3sjt126com
PHPcli
                                    
          常用选项
php -v
php -i PHP安装的有关信息
php -h 访问帮助文件
php -m 列出编译到当前PHP安装的所有模块

执行一段代码
php -r 'echo "hello, world!";'
php -r 'echo "Hello, World!\n";'
php -r '$ts = filemtime("
          
                                
          • 
                                
        • Filter&Session
                                    171815164
session
                                    
          Filter 
 
 

HttpServletRequest requ = (HttpServletRequest) req;
HttpSession session = requ.getSession();
if (session.getAttribute("admin") == null) {
           PrintWriter out = res.ge
          
                                
          • 
                                
        • 连接池与Spring,Hibernate结合
                                    g21121
Hibernate
                                    
                  前几篇关于Java连接池的介绍都是基于Java应用的，而我们常用的场景是与Spring和ORM框架结合，下面就利用实例学习一下这方面的配置。 
        1.下载相关内容：     &nb
          
                                
          • 
                                
        • [简单]mybatis判断数字类型
                                    53873039oycg
mybatis
                                    
                 昨天同事反馈mybatis保存不了int类型的属性,一直报错，错误信息如下: 
      
Caused by: java.lang.NumberFormatException: For input string: "null"
	at sun.mis
          
                                
          • 
                                
        • 项目启动时或者启动后ava.lang.OutOfMemoryError: PermGen space
                                    程序员是怎么炼成的
eclipsejvmtomcatcatalina.sheclipse.ini
                                    
             在启动比较大的项目时，因为存在大量的jsp页面，所以在编译的时候会生成很多的.class文件，.class文件是都会被加载到jvm的方法区中，如果要加载的class文件很多，就会出现方法区溢出异常 java.lang.OutOfMemoryError: PermGen space. 
    
解决办法是点击eclipse里的tomcat，在
          
                                
          • 
                                
        • 我的crm小结
                                    aijuans
crm
                                    
          各种原因吧，crm今天才完了。主要是接触了几个新技术： 
Struts2、poi、ibatis这几个都是以前的项目中用过的。 
Jsf、tapestry是这次新接触的，都是界面层的框架，用起来也不难。思路和struts不太一样，传说比较简单方便。不过个人感觉还是struts用着顺手啊，当然springmvc也很顺手，不知道是因为习惯还是什么。jsf和tapestry应用的时候需要知道他们的标签、主
          
                                
          • 
                                
        • spring里配置使用hibernate的二级缓存几步
                                    antonyup_2006
javaspringHibernatexmlcache
                                    
          ．在spring的配置文件中 applicationContent.xml，hibernate部分加入 
xml 代码 
 
<prop key="hibernate.cache.provider_class">org.hibernate.cache.EhCacheProvider</prop>   
    <prop key="hi
          
                                
          • 
                                
        • JAVA基础面试题
                                    百合不是茶
抽象实现接口String类接口继承抽象类继承实体类自定义异常
                                    
          /*   * 栈（stack）：主要保存基本类型（或者叫内置类型）（char、byte、short、   *int、long、 float、double、boolean）和对象的引用，数据可以共享，速度仅次于   * 寄存器（register），快于堆。堆（heap）：用于存储对象。   */  &
          
                                
          • 
                                
        • 让sqlmap文件 "继承" 起来
                                    bijian1013
javaibatissqlmap
                                    
                  多个项目中使用ibatis , 和数据库表对应的 sqlmap文件（增删改查等基本语句)，dao, pojo 都是由工具自动生成的, 现在将这些自动生成的文件放在一个单独的工程中，其它项目工程中通过jar包来引用 ，并通过"继承"为基础的sqlmap文件，dao,pojo 添加新的方法来满足项
          
                                
          • 
                                
        • 精通Oracle10编程SQL(13)开发触发器
                                    bijian1013
oracle数据库plsql
                                    
          /*
 *开发触发器
 */
--得到日期是周几
select to_char(sysdate+4,'DY','nls_date_language=AMERICAN') from dual;

select to_char(sysdate,'DY','nls_date_language=AMERICAN') from dual;

--建立BEFORE语句触发器
CREATE O
          
                                
          • 
                                
        • 【EhCache三】EhCache查询
                                    bit1129
ehcache
                                    
          本文介绍EhCache查询缓存中数据，EhCache提供了类似Hibernate的查询API，可以按照给定的条件进行查询。 
  
要对EhCache进行查询，需要在ehcache.xml中设定要查询的属性 
  数据准备 
    @Before
    public void setUp() {
        //加载EhCache配置文件
        Inpu
          
                                
          • 
                                
        • CXF框架入门实例
                                    白糖_
springWeb框架webserviceservlet
                                    
          CXF是apache旗下的开源框架，由Celtix + XFire这两门经典的框架合成，是一套非常流行的web service框架。 
它提供了JAX-WS的全面支持，并且可以根据实际项目的需要，采用代码优先（Code First）或者 WSDL 优先（WSDL First）来轻松地实现 Web Services 的发布和使用，同时它能与spring进行完美结合。 
在apache cxf官网提供
          
                                
          • 
                                
        • angular.equals
                                    boyitech
AngularJSAngularJS APIAnguarJS 中文APIangular.equals
                                    
          angular.equals 
   描述:  
  比较两个值或者两个对象是不是 相等。还支持值的类型，正则表达式和数组的比较。       两个值或对象被认为是 相等的前提条件是以下的情况至少能满足一项：  
 
 
   
   
   两个值或者对象能通过=== （恒等） 的比较 
   两个值或者对象是同样类型，并且他们的属性都能通过angular
          
                                
          • 
                                
        • java-腾讯暑期实习生-输入一个数组A[1,2,...n]，求输入B，使得数组B中的第i个数字B[i]=A[0]*A[1]*...*A[i-1]*A[i+1]
                                    bylijinnan
java
                                    
          这道题的具体思路请参看 何海涛的微博：http://weibo.com/zhedahht 
 

import java.math.BigInteger;
import java.util.Arrays;

public class CreateBFromATencent {

	/**
	 * 题目：输入一个数组A[1,2,...n]，求输入B，使得数组B中的第i个数字B[i]=A
          
                                
          • 
                                
        • FastDFS 的安装和配置 修订版
                                    Chen.H
linuxfastDFS分布式文件系统
                                    
          FastDFS Home:http://code.google.com/p/fastdfs/ 
1. 安装 
http://code.google.com/p/fastdfs/wiki/Setup http://hi.baidu.com/leolance/blog/item/3c273327978ae55f93580703.html 
安装libevent (对libevent的版本要求为1.4.
          
                                
          • 
                                
        • [强人工智能]拓扑扫描与自适应构造器
                                    comsci
人工智能
                                    
           
 
 
      当我们面对一个有限拓扑网络的时候,在对已知的拓扑结构进行分析之后,发现在连通点之后,还存在若干个子网络,且这些网络的结构是未知的,数据库中并未存在这些网络的拓扑结构数据....这个时候,我们该怎么办呢? 
 
      那么,现在我们必须设计新的模块和代码包来处理上面的问题
          
                                
          • 
                                
        • oracle merge into的用法
                                    daizj
oraclesqlmerget into
                                    
          Oracle中merge into的使用 
http://blog.csdn.net/yuzhic/article/details/1896878 
http://blog.csdn.net/macle2010/article/details/5980965 
该命令使用一条语句从一个或者多个数据源中完成对表的更新和插入数据. ORACLE 9i 中，使用此命令必须同时指定UPDATE 和INSE
          
                                
          • 
                                
        • 不适合使用Hadoop的场景
                                    datamachine
hadoop
                                    
          转自：http://dev.yesky.com/296/35381296.shtml。 
　　Hadoop通常被认定是能够帮助你解决所有问题的唯一方案。 当人们提到“大数据”或是“数据分析”等相关问题的时候，会听到脱口而出的回答：Hadoop!  实际上Hadoop被设计和建造出来，是用来解决一系列特定问题的。对某些问题来说，Hadoop至多算是一个不好的选择，对另一些问题来说，选择Ha
          
                                
          • 
                                
        • YII findAll的用法
                                    dcj3sjt126com
yii
                                    
          看文档比较糊涂，其实挺简单的： 
$predictions=Prediction::model()->findAll("uid=:uid",array(":uid"=>10)); 
  
第一个参数是选择条件：”uid=10″。其中:uid是一个占位符，在后面的array(“:uid”=>10)对齐进行了赋值； 
更完善的查询需要
          
                                
          • 
                                
        • vim 常用 NERDTree 快捷键
                                    dcj3sjt126com
vim
                                    
          下面给大家整理了一些vim NERDTree的常用快捷键了，这里几乎包括了所有的快捷键了，希望文章对各位会带来帮助。 
切换工作台和目录 
ctrl + w + h 光标 focus 左侧树形目录ctrl + w + l 光标 focus 右侧文件显示窗口ctrl + w + w 光标自动在左右侧窗口切换ctrl + w + r 移动当前窗口的布局位置 
o 在已有窗口中打开文件、目录或书签，并跳
          
                                
          • 
                                
        • Java把目录下的文件打印出来
                                    蕃薯耀
列出目录下的文件文件夹下面的文件目录下的文件
                                    
          Java把目录下的文件打印出来 
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
蕃薯耀 2015年7月11日 11:02:
          
                                
          • 
                                
        • linux远程桌面----VNCServer与rdesktop
                                    hanqunfeng
Desktop
                                    
          windows远程桌面到linux，需要在linux上安装vncserver，并开启vnc服务，同时需要在windows下使用vnc-viewer访问Linux。vncserver同时支持linux远程桌面到linux。 
  
linux远程桌面到windows，需要在linux上安装rdesktop，同时开启windows的远程桌面访问。 
  
下面分别介绍，以windo
          
                                
          • 
                                
        • guava中的join和split功能
                                    jackyrong
java
                                    
          guava库中，包含了很好的join和split的功能，例子如下： 
 
1） 将LIST转换为使用字符串连接的字符串 
   

    List<String> names = Lists.newArrayList("John", "Jane", "Adam", "Tom");

          
                                
          • 
                                
        • Web开发技术十年发展历程
                                    lampcy
androidWeb浏览器html5
                                    
          回顾web开发技术这十年发展历程： 
Ajax 
03年的时候我上六年级，那时候网吧刚在小县城的角落萌生。传奇，大话西游第一代网游一时风靡。我抱着试一试的心态给了网吧老板两块钱想申请个号玩玩，然后接下来的一个小时我一直在，注，册，账，号。 
彼时网吧用的512k的带宽，注册的时候，填了一堆信息，提交，页面跳转，嘣，”您填写的信息有误，请重填”。然后跳转回注册页面，以此循环。我现在时常想，如果当时a
          
                                
          • 
                                
        • 架构师之mima-----------------mina的非NIO控制IOBuffer(说得比较好)
                                    nannan408
buffer
                                    
          1.前言。 
  如题。 
2.代码。 
  

IoService

IoService是一个接口，有两种实现：IoAcceptor和IoConnector；其中IoAcceptor是针对Server端的实现，IoConnector是针对Client端的实现；IoService的职责包括：

1、监听器管理

2、IoHandler

3、IoSession
          
                                
          • 
                                
        • ORA-00054:resource busy and acquire with NOWAIT specified
                                    Everyday都不同
oraclesessionLock
                                    
          [Oracle] 
今天对一个数据量很大的表进行操作时，出现如题所示的异常。此时表明数据库的事务处于“忙”的状态，而且被lock了，所以必须先关闭占用的session。 
  
step1，查看被lock的session： 
  
select t2.username, t2.sid, t2.serial#, t2.logon_time
  from v$locked_obj
          
                                
          • 
                                
        • javascript学习笔记
                                    tntxia
JavaScript
                                    
            
javascript里面有6种基本类型的值:number、string、boolean、object、function和undefined。number：就是数字值，包括整数、小数、NaN、正负无穷。string:字符串类型、单双引号引起来的内容。boolean:true、false object:表示所有的javascript对象，不用多说function:我们熟悉的方法，也就是
          
                                
          • 
                                
        • Java enum的用法详解
                                    xieke90
enum枚举
                                    
          Java中枚举实现的分析： 
    示例：  
public static enum SEVERITY{
          INFO,WARN,ERROR
} 
    enum很像特殊的class，实际上enum声明定义的类型就是一个类。 而这些类都是类库中Enum类的子类      (java.l
          
                                
          •