minminaya
minminaya

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

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

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

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

更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)_第1张图片

Retrofit 对协程的支持

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

更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)_第2张图片

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)
        ...
        省略若干行...大家一起想象下...

更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)_第3张图片

  • 那有同学就说了噢，不就是异常嘛，我catch 下不就好了？？？？
    更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)_第4张图片

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

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

更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)_第5张图片

还是得找办法解决这个问题【网络接口抛出异常需要外部使用 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 接口定义。
    更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)_第6张图片

    • 这里没有定制的情况下，使用的 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 的实现
       更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)_第7张图片
       
      •  
   
    •  
      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 代理类
           
          •  
    
          
   
      •  
        这个时候，又有小伙伴就说了，你呀的啥时候自定义啊，我等不及啦，掏出货来啊，马上安排啦…
         
        •  
   
  
        更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)_第8张图片
         
  
         
  
        自定义 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
             更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)_第9张图片
             
            •  
     
          •  
            最后我们获取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
                        }
                    }
                }

           
          更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)_第10张图片
           
          •  
   
        •  
          6、真的没了，封装就告一段落了
           更优雅的在 Kotlin 中封装 Retrofit (去掉 Catch)_第11张图片
           
          •  
  
         
  
         
  
        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
          •  
  
         
  

                            
                        
                    
                    
                    
        
                    
                    
                    
        
                
                
        
                    
                
        
            
        
    
    
        
        
        你可能感兴趣的:(Android性能优化,Android疑难杂症,android,java)
        
        
        
            
        
                
          
                    
        • 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
          
                    
          • 
                    
        • Long类型前后端数据不一致
                        igotyback
前端
                        
          响应给前端的数据浏览器控制台中response中看到的Long类型的数据是正常的到前端数据不一致前后端数据类型不匹配是一个常见问题，尤其是当后端使用Java的Long类型（64位）与前端JavaScript的Number类型（最大安全整数为2^53-1，即16位）进行数据交互时，很容易出现精度丢失的问题。这是因为JavaScript中的Number类型无法安全地表示超过16位的整数。为了解决这个问
          
                    
          • 
                    
        • LocalDateTime 转 String
                        igotyback
java开发语言
                        
          importjava.time.LocalDateTime;importjava.time.format.DateTimeFormatter;publicclassMain{publicstaticvoidmain(String[]args){//获取当前时间LocalDateTimenow=LocalDateTime.now();//定义日期格式化器DateTimeFormatterformat
          
                    
          • 
                    
        • Linux下QT开发的动态库界面弹出操作（SDL2）
                        13jjyao
QT类qt开发语言sdl2linux
                        
          需求：操作系统为linux，开发框架为qt，做成需带界面的qt动态库，调用方为java等非qt程序难点：调用方为java等非qt程序，也就是说调用方肯定不带QApplication::exec()，缺少了这个，QTimer等事件和QT创建的窗口将不能弹出(包括opencv也是不能弹出)；这与qt调用本身qt库是有本质的区别的思路：1.调用方缺QApplication::exec()，那么我们在接口
          
                    
          • 
                    
        • DIV+CSS+JavaScript技术制作网页（旅游主题网页设计与制作）云南大理
                        STU学生网页设计
网页设计期末网页作业html静态网页html5期末大作业网页设计web大作业
                        
          ️精彩专栏推荐作者主页:【进入主页—获取更多源码】web前端期末大作业：【HTML5网页期末作业(1000套)】程序员有趣的告白方式：【HTML七夕情人节表白网页制作(110套)】文章目录二、网站介绍三、网站效果▶️1.视频演示2.图片演示四、网站代码HTML结构代码CSS样式代码五、更多源码二、网站介绍网站布局方面：计划采用目前主流的、能兼容各大主流浏览器、显示效果稳定的浮动网页布局结构。网站程
          
                    
          • 
                    
        • 【华为OD机试真题2023B卷 JAVA&JS】We Are A Team
                        若博豆
java算法华为javascript
                        
          华为OD2023（B卷）机试题库全覆盖，刷题指南点这里WeAreATeam时间限制：1秒|内存限制：32768K|语言限制：不限题目描述：总共有n个人在机房，每个人有一个标号（1<=标号<=n），他们分成了多个团队，需要你根据收到的m条消息判定指定的两个人是否在一个团队中，具体的：1、消息构成为：abc，整数a、b分别代
          
                    
          • 
                    
        • 关于城市旅游的HTML网页设计——(旅游风景云南 5页)HTML+CSS+JavaScript
                        二挡起步
web前端期末大作业javascripthtmlcss旅游风景
                        
          ⛵源码获取文末联系✈Web前端开发技术描述网页设计题材，DIV+CSS布局制作,HTML+CSS网页设计期末课程大作业|游景点介绍|旅游风景区|家乡介绍|等网站的设计与制作|HTML期末大学生网页设计作业，Web大学生网页HTML：结构CSS：样式在操作方面上运用了html5和css3，采用了div+css结构、表单、超链接、浮动、绝对定位、相对定位、字体样式、引用视频等基础知识JavaScrip
          
                    
          • 
                    
        • HTML网页设计制作大作业（div+css） 云南我的家乡旅游景点 带文字滚动
                        二挡起步
web前端期末大作业web设计网页规划与设计htmlcssjavascriptdreamweaver前端
                        
          Web前端开发技术描述网页设计题材，DIV+CSS布局制作,HTML+CSS网页设计期末课程大作业游景点介绍|旅游风景区|家乡介绍|等网站的设计与制作HTML期末大学生网页设计作业HTML：结构CSS：样式在操作方面上运用了html5和css3，采用了div+css结构、表单、超链接、浮动、绝对定位、相对定位、字体样式、引用视频等基础知识JavaScript：做与用户的交互行为文章目录前端学习路线
          
                    
          • 
                    
        • node.js学习
                        小猿L
node.jsnode.js学习vim
                        
          node.js学习实操及笔记温故node.js，node.js学习实操过程及笔记~node.js学习视频node.js官网node.js中文网实操笔记githubcsdn笔记为什么学node.js可以让别人访问我们编写的网页为后续的框架学习打下基础，三大框架vuereactangular离不开node.jsnode.js是什么官网：node.js是一个开源的、跨平台的运行JavaScript的运行
          
                    
          • 
                    
        • Java 重写(Override)与重载(Overload)
                        叨唧唧的

                        
          Java重写(Override)与重载(Overload)重写(Override)重写是子类对父类的允许访问的方法的实现过程进行重新编写,返回值和形参都不能改变。即外壳不变，核心重写！重写的好处在于子类可以根据需要，定义特定于自己的行为。也就是说子类能够根据需要实现父类的方法。重写方法不能抛出新的检查异常或者比被重写方法申明更加宽泛的异常。例如：父类的一个方法申明了一个检查异常IOExceptio
          
                    
          • 
                    
        • 简单了解 JVM
                        记得开心一点啊
jvm
                        
          目录♫什么是JVM♫JVM的运行流程♫JVM运行时数据区♪虚拟机栈♪本地方法栈♪堆♪程序计数器♪方法区/元数据区♫类加载的过程♫双亲委派模型♫垃圾回收机制♫什么是JVMJVM是JavaVirtualMachine的简称，意为Java虚拟机。虚拟机是指通过软件模拟的具有完整硬件功能的、运行在一个完全隔离的环境中的完整计算机系统（如：JVM、VMwave、VirtualBox）。JVM和其他两个虚拟机
          
                    
          • 
                    
        • 1分钟解决 -bash: mvn: command not found，在Centos 7中安装Maven
                        Energet!c
开发语言
                        
          1分钟解决-bash:mvn:commandnotfound，在Centos7中安装Maven检查Java环境1下载Maven2解压Maven3配置环境变量4验证安装5常见问题与注意事项6总结检查Java环境Maven依赖Java环境，请确保系统已经安装了Java并配置了环境变量。可以通过以下命令检查：java-version如果未安装，请先安装Java。1下载Maven从官网下载：前往Apach
          
                    
          • 
                    
        • 2.2.6 通知类控件 Toast、Menu
                        常思行

                        
          本文例程下载：WillFlow_Toast、WillFlowMenu一、什么是Toast？Toast也被叫做吐司，是Android系统提供的一种非常好的提醒方式，在程序中可以使用它将一些短小的信息通知给用户，它有如下两个特点：Toast是没有焦点的Toast显示的时间有限过一定的时间就会自动消失所以一般来讲Toast的使用并不会影响我们的正常操作，并且它通常不会占用太大的屏幕空间，有着良好的用户体
          
                    
          • 
                    
        • Java企业面试题3
                        马龙强_
java
                        
          1.break和continue的作用(智*图)break：用于完全退出一个循环（如for,while）或一个switch语句。当在循环体内遇到break语句时，程序会立即跳出当前循环体，继续执行循环之后的代码。continue：用于跳过当前循环体中剩余的部分，并开始下一次循环。如果是在for循环中使用continue，则会直接进行条件判断以决定是否执行下一轮循环。2.if分支语句和switch分
          
                    
          • 
                    
        • JVM、JRE和 JDK：理解Java开发的三大核心组件
                        Y雨何时停T
Javajava
                        
          Java是一门跨平台的编程语言，它的成功离不开背后强大的运行环境与开发工具的支持。在Java的生态中，JVM（Java虚拟机）、JRE（Java运行时环境）和JDK（Java开发工具包）是三个至关重要的核心组件。本文将探讨JVM、JDK和JRE的区别，帮助你更好地理解Java的运行机制。1.JVM：Java虚拟机（JavaVirtualMachine）什么是JVM？JVM，即Java虚拟机，是Ja
          
                    
          • 
                    
        • Java面试题精选：消息队列(二)
                        芒果不是芒
Java面试题精选javakafka
                        
          一、Kafka的特性1.消息持久化：消息存储在磁盘，所以消息不会丢失2.高吞吐量：可以轻松实现单机百万级别的并发3.扩展性：扩展性强，还是动态扩展4.多客户端支持：支持多种语言（Java、C、C++、GO、）5.KafkaStreams（一个天生的流处理）:在双十一或者销售大屏就会用到这种流处理。使用KafkaStreams可以快速的把销售额统计出来6.安全机制：Kafka进行生产或者消费的时候会
          
                    
          • 
                    
        • 白骑士的Java教学基础篇 2.5 控制流语句
                        白骑士所长
Java教学java开发语言
                        
          欢迎继续学习Java编程的基础篇！在前面的章节中，我们了解了Java的变量、数据类型和运算符。接下来，我们将探讨Java中的控制流语句。控制流语句用于控制程序的执行顺序，使我们能够根据特定条件执行不同的代码块，或重复执行某段代码。这是编写复杂程序的基础。通过学习这一节内容，你将掌握如何使用条件语句和循环语句来编写更加灵活和高效的代码。条件语句条件语句用于根据条件的真假来执行不同的代码块。if语句‘
          
                    
          • 
                    
        • python语法——三目运算符
                        HappyRocking
pythonpython三目运算符
                        
          在java中，有三目运算符，如：intc=(a>b)?a:b表示c取两者中的较大值。但是在python，不能直接这样使用，估计是因为冒号在python有分行的关键作用。那么在python中，如何实现类似功能呢？可以使用ifelse语句，也是一行可以完成，格式为：aifbelsec表示如果b为True，则表达式等于a，否则等于c。如：c=(aif(a>b)elseb)同样是完成了取最大值的功能。
          
                    
          • 
                    
        • ArrayList 源码解析
                        程序猿进阶
Java基础ArrayListListjava面试性能优化架构设计idea
                        
          ArrayList是Java集合框架中的一个动态数组实现，提供了可变大小的数组功能。它继承自AbstractList并实现了List接口，是顺序容器，即元素存放的数据与放进去的顺序相同，允许放入null元素，底层通过数组实现。除该类未实现同步外，其余跟Vector大致相同。每个ArrayList都有一个容量capacity，表示底层数组的实际大小，容器内存储元素的个数不能多于当前容量。当向容器中添
          
                    
          • 
                    
        • Java爬虫框架（一）--架构设计
                        狼图腾-狼之传说
java框架java任务html解析器存储电子商务
                        
          一、架构图那里搜网络爬虫框架主要针对电子商务网站进行数据爬取，分析，存储，索引。爬虫：爬虫负责爬取，解析，处理电子商务网站的网页的内容数据库：存储商品信息索引：商品的全文搜索索引Task队列：需要爬取的网页列表Visited表：已经爬取过的网页列表爬虫监控平台：web平台可以启动，停止爬虫，管理爬虫，task队列，visited表。二、爬虫1.流程1)Scheduler启动爬虫器，TaskMast
          
                    
          • 
                    
        • Java：爬虫框架
                        dingcho
Javajava爬虫
                        
          一、ApacheNutch2【参考地址】Nutch是一个开源Java实现的搜索引擎。它提供了我们运行自己的搜索引擎所需的全部工具。包括全文搜索和Web爬虫。Nutch致力于让每个人能很容易,同时花费很少就可以配置世界一流的Web搜索引擎.为了完成这一宏伟的目标,Nutch必须能够做到:每个月取几十亿网页为这些网页维护一个索引对索引文件进行每秒上千次的搜索提供高质量的搜索结果简单来说Nutch支持分
          
                    
          • 
                    
        • mac 备份android 手机通讯录导入iphone,iphone如何导出通讯录（轻松教你iPhone备份通讯录的方法）...
                        weixin_39762838
mac备份android手机通讯录导入iphone
                        
          在日新月异的手机更替中，换手机已经成为一个非常稀松平常的事情，但将旧手机上面的通讯录导入到新手机还是让不少小伙伴为难，本篇将给大家详细讲解这方面的知识：“苹果手机通讯录怎么导入到新手机”及“安卓手机通讯录导入到新手机”的方法。一、苹果手机通讯录导入到新手机常用方法(SIM卡导入)在苹果手机主频幕上找到“设置”，单击进入设置菜单，下拉菜单列表，点击“邮件、通讯录、日历”，然后找到“导入SIM卡通讯录
          
                    
          • 
                    
        • python怎么将png转为tif_png转tif
                        weixin_39977276

                        
          发国外的文章要求图片是tif，cmyk色彩空间的。大小尺寸还有要求。比如网上大神多，找到了一段代码，感谢！https://www.jianshu.com/p/ec2af4311f56https://github.com/KevinZc007/image2Tifimportjava.awt.image.BufferedImage;importjava.io.File;importjava.io.Fi
          
                    
          • 
                    
        • android 更改窗口的层次,浮窗开发之窗口层级
                        Ms.Bu
android更改窗口的层次
                        
          最近在项目中遇到了这样的需求：需要在特定的其他应用之上悬浮自己的UI交互(拖动、输入等复杂的UI交互)，和九游的浮窗类似，不过我们的比九游的体验更好，我们越过了很多授权的限制。浮窗效果很多人都知道如何去实现一个简单的浮窗，但是却很少有人去深入的研究背后的流程机制，由于项目中浮窗交互比较复杂，遇到了些坑查看了很多资料，故总结浮窗涉及到的知识点：窗口层级关系(浮窗是如何“浮”的)？浮窗有哪些限制，如何
          
                    
          • 
                    
        • Android应用性能优化
                        轻口味
Android
                        
          Android手机由于其本身的后台机制和硬件特点，性能上一直被诟病，所以软件开发者对软件本身的性能优化就显得尤为重要；本文将对Android开发过程中性能优化的各个方面做一个回顾与总结。Cache优化ListView缓存：ListView中有一个回收器，Item滑出界面的时候View会回收到这里，需要显示新的Item的时候，就尽量重用回收器里面的View；每次在getView函数中inflate新
          
                    
          • 
                    
        • JavaScript 中，深拷贝（Deep Copy）和浅拷贝（Shallow Copy）
                        跳房子的前端
前端面试javascript开发语言ecmascript
                        
          在JavaScript中，深拷贝（DeepCopy）和浅拷贝（ShallowCopy）是用于复制对象或数组的两种不同方法。了解它们的区别和应用场景对于避免潜在的bugs和高效地处理数据非常重要。以下是对深拷贝和浅拷贝的详细解释，包括它们的概念、用途、优缺点以及实现方式。1.浅拷贝（ShallowCopy）概念定义：浅拷贝是指创建一个新的对象或数组，其中包含了原对象或数组的基本数据类型的值和对引用数
          
                    
          • 
                    
        • JAVA·一个简单的登录窗口
                        MortalTom
java开发语言学习
                        
          文章目录概要整体架构流程技术名词解释技术细节资源概要JavaSwing是Java基础类库的一部分，主要用于开发图形用户界面（GUI）程序整体架构流程新建项目，导入sql.jar包（链接放在了文末），编译项目并运行技术名词解释一、特点丰富的组件提供了多种可视化组件，如按钮（JButton）、文本框（JTextField）、标签（JLabel）、下拉列表（JComboBox）等，可以满足不同的界面设计
          
                    
          • 
                    
        • WebMagic：强大的Java爬虫框架解析与实战
                        Aaron_945
Javajava爬虫开发语言
                        
          文章目录引言官网链接WebMagic原理概述基础使用1.添加依赖2.编写PageProcessor高级使用1.自定义Pipeline2.分布式抓取优点结论引言在大数据时代，网络爬虫作为数据收集的重要工具，扮演着不可或缺的角色。Java作为一门广泛使用的编程语言，在爬虫开发领域也有其独特的优势。WebMagic是一个开源的Java爬虫框架，它提供了简单灵活的API，支持多线程、分布式抓取，以及丰富的
          
                    
          • 
                    
        • 博客网站制作教程
                        2401_85194651
javamaven
                        
          首先就是技术框架：后端：Java+SpringBoot数据库：MySQL前端：Vue.js数据库连接：JPA(JavaPersistenceAPI)1.项目结构blog-app/├──backend/│├──src/main/java/com/example/blogapp/││├──BlogApplication.java││├──config/│││└──DatabaseConfig.java
          
                    
          • 
                    
        • 00. 这里整理了最全的爬虫框架（Java + Python）
                        有一只柴犬
爬虫系列爬虫javapython
                        
          目录1、前言2、什么是网络爬虫3、常见的爬虫框架3.1、java框架3.1.1、WebMagic3.1.2、Jsoup3.1.3、HttpClient3.1.4、Crawler4j3.1.5、HtmlUnit3.1.6、Selenium3.2、Python框架3.2.1、Scrapy3.2.2、BeautifulSoup+Requests3.2.3、Selenium3.2.4、PyQuery3.2
          
                    
          • 
                                
        • TOMCAT在POST方法提交参数丢失问题
                                    357029540
javatomcatjsp
                                    
          摘自http://my.oschina.net/luckyi/blog/213209 
昨天在解决一个BUG时发现一个奇怪的问题，一个AJAX提交数据在之前都是木有问题的，突然提交出错影响其他处理流程。 
 
检查时发现页面处理数据较多，起初以为是提交顺序不正确修改后发现不是由此问题引起。于是删除掉一部分数据进行提交，较少数据能够提交成功。 
 
恢复较多数据后跟踪提交FORM DATA ，发现数
          
                                
          • 
                                
        • 在MyEclipse中增加JSP模板 删除-2008-08-18
                                    ljy325
jspxmlMyEclipse
                                    
          在D:\Program Files\MyEclipse 6.0\myeclipse\eclipse\plugins\com.genuitec.eclipse.wizards_6.0.1.zmyeclipse601200710\templates\jsp  目录下找到Jsp.vtl，复制一份，重命名为jsp2.vtl,然后把里面的内容修改为自己想要的格式，保存。 
然后在 D:\Progr
          
                                
          • 
                                
        • JavaScript常用验证脚本总结
                                    eksliang
JavaScriptjavaScript表单验证
                                    
               转载请出自出处：http://eksliang.iteye.com/blog/2098985   
     下面这些验证脚本，是我在这几年开发中的总结，今天把他放出来，也算是一种分享吧，现在在我的项目中也在用！包括日期验证、比较，非空验证、身份证验证、数值验证、Email验证、电话验证等等...! 
&nb
          
                                
          • 
                                
        • 微软BI（4）
                                    18289753290
微软BI SSIS
                                    
          1） 
Q:查看ssis里面某个控件输出的结果：  
A MessageBox.Show(Dts.Variables["v_lastTimestamp"].Value.ToString()); 
这是我们在包里面定义的变量 
2):在关联目的端表的时候如果是一对多的关系，一定要选择唯一的那个键作为关联字段。 
3) 
Q：ssis里面如果将多个数据源的数据插入目的端一
          
                                
          • 
                                
        • 定时对大数据量的表进行分表对数据备份
                                    酷的飞上天空
大数据量
                                    
          工作中遇到数据库中一个表的数据量比较大，属于日志表。正常情况下是不会有查询操作的，但如果不进行分表数据太多，执行一条简单sql语句要等好几分钟。。 
  
分表工具：linux的shell + mysql自身提供的管理命令 
原理：使用一个和原表数据结构一样的表，替换原表。 
  
linux shell内容如下： 
=======================开始 
          
                                
          • 
                                
        • 本质的描述与因材施教
                                    永夜-极光
感想随笔
                                    
            
       不管碰到什么事,我都下意识的想去探索本质,找寻一个最形象的描述方式。 
       我坚信,世界上对一件事物的描述和解释,肯定有一种最形象,最贴近本质,最容易让人理解 
  
     &
          
                                
          • 
                                
        • 很迷茫。。。
                                    随便小屋
随笔
                                    
          小弟我今年研一，也是从事的咱们现在最流行的专业（计算机）。本科三流学校，为了能有个更好的跳板，进入了考研大军，非常有幸能进入研究生的行业（具体学校就不说了，怕把学校的名誉给损了）。 
  
先说一下自身的条件，本科专业软件工程。主要学习就是软件开发，几乎和计算机没有什么区别。因为学校本身三流，也就是让老师带着学生学点东西，然后让学生毕业就行了。对专业性的东西了解的非常浅。就那学的语言来说
          
                                
          • 
                                
        • 23种设计模式的意图和适用范围
                                    aijuans
设计模式
                                    
          Factory Method  意图 定义一个用于创建对象的接口，让子类决定实例化哪一个类。Factory Method 使一个类的实例化延迟到其子类。  　　适用性 当一个类不知道它所必须创建的对象的类的时候。  　　当一个类希望由它的子类来指定它所创建的对象的时候。  　　当类将创建对象的职责委托给多个帮助子类中的某一个，并且你希望将哪一个帮助子类是代理者这一信息局部化的时候。  
Abstr
          
                                
          • 
                                
        • Java中的synchronized和volatile
                                    aoyouzi
javavolatilesynchronized
                                    
          说到Java的线程同步问题肯定要说到两个关键字synchronized和volatile。说到这两个关键字，又要说道JVM的内存模型。JVM里内存分为main memory和working memory。 Main memory是所有线程共享的，working memory则是线程的工作内存，它保存有部分main memory变量的拷贝，对这些变量的更新直接发生在working memo
          
                                
          • 
                                
        • js数组的操作和this关键字
                                    百合不是茶
js数组操作this关键字
                                    
          js数组的操作; 
  
一:数组的创建: 
1、数组的创建

var array = new Array();　//创建一个数组

var array = new Array([size]);　//创建一个数组并指定长度，注意不是上限，是长度

var arrayObj = new Array([element0[, element1[, ...[, elementN]]]
          
                                
          • 
                                
        • 别人的阿里面试感悟
                                    bijian1013
面试分享工作感悟阿里面试
                                    
          原文如下：http://greemranqq.iteye.com/blog/2007170 
        一直做企业系统，虽然也自己一直学习技术，但是感觉还是有所欠缺，准备花几个月的时间，把互联网的东西，以及一些基础更加的深入透析，结果这次比较意外，有点突然，下面分享一下感受吧！ 
   &nb
          
                                
          • 
                                
        • 淘宝的测试框架Itest
                                    Bill_chen
springmaven框架单元测试JUnit
                                    
          Itest测试框架是TaoBao测试部门开发的一套单元测试框架，以Junit4为核心， 
集合DbUnit、Unitils等主流测试框架，应该算是比较好用的了。 
近期项目中用了下，有关itest的具体使用如下： 
1.在Maven中引入itest框架： 
<dependency> 
  <groupId>com.taobao.test</groupId&g
          
                                
          • 
                                
        • 【Java多线程二】多路条件解决生产者消费者问题
                                    bit1129
java多线程
                                    
          package com.tom;

import java.util.LinkedList;
import java.util.Queue;
import java.util.concurrent.ThreadLocalRandom;
import java.util.concurrent.locks.Condition;
import java.util.concurrent.loc
          
                                
          • 
                                
        • 汉字转拼音pinyin4j
                                    白糖_
pinyin4j
                                    
           以前在项目中遇到汉字转拼音的情况，于是在网上找到了pinyin4j这个工具包，非常有用，别的不说了，直接下代码： 
  
  

import java.util.HashSet;
import java.util.Set;

import net.sourceforge.pinyin4j.PinyinHelper;
import net.sourceforge.pinyin
          
                                
          • 
                                
        • org.hibernate.TransactionException: JDBC begin failed解决方案
                                    bozch
ssh数据库异常DBCP
                                    
          org.hibernate.TransactionException: JDBC begin failed:     at org.hibernate.transaction.JDBCTransaction.begin(JDBCTransaction.java:68)    at org.hibernate.impl.SessionImp
          
                                
          • 
                                
        • java-并查集（Disjoint-set）-将多个集合合并成没有交集的集合
                                    bylijinnan
java
                                    
          
import java.util.ArrayList;
import java.util.Arrays;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.ut
          
                                
          • 
                                
        • Java PrintWriter打印乱码
                                    chenbowen00
java
                                    
          一个小程序读写文件，发现PrintWriter输出后文件存在乱码，解决办法主要统一输入输出流编码格式。 
读文件： 
BufferedReader 
从字符输入流中读取文本，缓冲各个字符，从而提供字符、数组和行的高效读取。 
 
可以指定缓冲区的大小，或者可使用默认的大小。大多数情况下，默认值就足够大了。 
 
通常，Reader 所作的每个读取请求都会导致对基础字符或字节流进行相应的读取请求。因
          
                                
          • 
                                
        • [天气与气候]极端气候环境
                                    comsci
环境
                                    
           
 
      如果空间环境出现异变...外星文明并未出现,而只是用某种气象武器对地球的气候系统进行攻击,并挑唆地球国家间的战争,经过一段时间的准备...最大限度的削弱地球文明的整体力量,然后再进行入侵...... 
 
 
     那么地球上的国家应该做什么样的防备工作呢? 
 
 
 &n
          
                                
          • 
                                
        • oracle order by与union一起使用的用法
                                    daizj
UNIONoracleorder by
                                    
          当使用union操作时，排序语句必须放在最后面才正确，如下： 
 
 
只能在union的最后一个子查询中使用order by，而这个order by是针对整个unioning后的结果集的。So： 
如果unoin的几个子查询列名不同，如 
Sql代码  
select supplier_id, supplier_name  
from suppliers  
UNI
          
                                
          • 
                                
        • zeus持久层读写分离单元测试
                                    deng520159
单元测试
                                    
          本文是zeus读写分离单元测试,距离分库分表,只有一步了.上代码: 
1.ZeusMasterSlaveTest.java 
package com.dengliang.zeus.webdemo.test;

import java.util.ArrayList;
import java.util.List;

import org.junit.Assert;
import org.j
          
                                
          • 
                                
        • Yii 截取字符串(UTF-8) 使用组件
                                    dcj3sjt126com
yii
                                    
          1.将Helper.php放进protected\components文件夹下。 
2.调用方法： 
  Helper::truncate_utf8_string($content,20,false);   //不显示省略号  Helper::truncate_utf8_string($content,20);  //显示省略号  
&n
          
                                
          • 
                                
        • 安装memcache及php扩展
                                    dcj3sjt126com
PHP
                                    
          安装memcache    tar zxvf memcache-2.2.5.tgz     cd memcache-2.2.5/     /usr/local/php/bin/phpize (?)    ./configure --with-php-confi
          
                                
          • 
                                
        • JsonObject 处理日期
                                    feifeilinlin521
javajsonJsonOjbectJsonArrayJSONException
                                    
              写这边文章的初衷就是遇到了json在转换日期格式出现了异常 net.sf.json.JSONException: java.lang.reflect.InvocationTargetException  原因是当你用Map接收数据库返回了java.sql.Date 日期的数据进行json转换出的问题话不多说  直接上代码 
 &n
          
                                
          • 
                                
        • Ehcache（06）——监听器
                                    234390216
监听器listenerehcache
                                    
          监听器 
  
       Ehcache中监听器有两种，监听CacheManager的CacheManagerEventListener和监听Cache的CacheEventListener。在Ehcache中，Listener是通过对应的监听器工厂来生产和发生作用的。下面我们将来介绍一下这两种类型的监听器。 
 
          
                                
          • 
                                
        • activiti 自带设计器中chrome 34版本不能打开bug的解决
                                    jackyrong
Activiti
                                    
            在acitivti modeler中，如果是chrome 34，则不能打开该设计器，其他浏览器可以， 
经证实为bug，参考 
http://forums.activiti.org/content/activiti-modeler-doesnt-work-chrome-v34 
 
修改为，找到 
oryx.debug.js 
 
在最头部增加 
 

if (!Document.
          
                                
          • 
                                
        • 微信收货地址共享接口-终极解决
                                    laotu5i0
微信开发
                                    
             最近要接入微信的收货地址共享接口，总是不成功，折腾了好几天，实在没办法网上搜到的帖子也是骂声一片。我把我碰到并解决问题的过程分享出来，希望能给微信的接口文档起到一个辅助作用，让后面进来的开发者能快速的接入，而不需要像我们一样苦逼的浪费好几天，甚至一周的青春。各种羞辱、谩骂的话就不说了，本人还算文明。 
   如果你能搜到本贴，说明你已经碰到了各种 ed
          
                                
          • 
                                
        • 关于人才
                                    netkiller.github.com
工作面试招聘netkiller人才
                                    
          关于人才 
每个月我都会接到许多猎头的电话，有些猎头比较专业，但绝大多数在我看来与猎头二字还是有很大差距的。 与猎头接触多了，自然也了解了他们的工作，包括操作手法，总体上国内的猎头行业还处在初级阶段。 
总结就是“盲目推荐，以量取胜”。  
目前现状 
许多从事人力资源工作的人，根本不懂得怎么找人才。处在人才找不到企业，企业找不到人才的尴尬处境。 
企业招聘，通常是需要用人的部门提出招聘条件，由人
          
                                
          • 
                                
        • 搭建 CentOS 6 服务器 - 目录
                                    rensanning
centos
                                    
          (1) 安装CentOS 
ISO（desktop/minimal）、Cloud（AWS/阿里云）、Virtualization（VMWare、VirtualBox） 
详细内容 
 
 
(2) Linux常用命令 
cd、ls、rm、chmod...... 
详细内容 
 
 
(3) 初始环境设置 
用户管理、网络设置、安全设置...... 
详细内容 
 
 
(4) 常驻服务Daemon
          
                                
          • 
                                
        • 【求助】mongoDB无法更新主键
                                    toknowme
mongodb
                                    
                 Query query = new Query();            query.addCriteria(new Criteria("_id").is(o.getId()));                    &n
          
                                
          • 
                                
        • jquery 页面滚动到底部自动加载插件集合
                                    xp9802
jquery
                                    
          很多社交网站都使用无限滚动的翻页技术来提高用户体验，当你页面滑到列表底部时候无需点击就自动加载更多的内容。下面为你推荐 10 个 jQuery 的无限滚动的插件： 
1. jQuery ScrollPagination 
jQuery ScrollPagination plugin 是一个 jQuery 实现的支持无限滚动加载数据的插件。 
2. jQuery Screw 
S
          
                                
          •