（入门篇 NettyNIO开发指南）第四章-TIP黏包/拆包问题解决之道

熟悉TCP编程的读者可能都知道，无论是服务端还是客户端，当我们读取或者发送消息的时候，都需要考虑TCP底层的粘包／拆包机制。木章开始我们先简单介绍TCP粘包／拆包的基础知识，然后模拟一个没有考虑TCP粘包／拆包导致功能异常的案例，最后通过正确例米探讨Netty是如何解决这个问题的。如果你已经熟悉了TCP粘包和拆包的相知识，建议你直接跳到代码讲解小节，看Netty是如何解决这个问题的。本章主要内容包：

TCP粘包／拆包的基础知识

没考虑TCP粘包／拆包的问题案例

使用Netty解决读半包问题

4.1    丁CP粘包／拆包

TCP是个流协议，所谓流，就是没奋界限的一串数据。大家可以想想河里的流水，是连成一片的，其间并没有分界线。TCP底层并不了解上层业务数据的具体含义，它会根据TCP缓冲区的实际情况进行包的划分，所以在业务上认为，一个完整的包可能会被TCP拆分成多个包进行发送，也有可能把多个小的包封装成一个大的数据包发送，这就是所谓的TCP粘包和拆包问题。

4.1.1    TCP粘包／拆包问题说明

我们可以通过图解对TCP粘包和拆包问题进行说明，粘包问题示例如图4-1所示。
aaarticlea/png;base64,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os1me+WVV77zne9873vfW7Ro0a9+9auHH374xRdfLC4urqysLC0tzcjIePLJJ3/4wx/ed999zzzzjMViIVKBqw7pfKWlpfn5+U899dQ999yTlZWFQaFlktbIapnQzHJychCemJ+fLw1jIDXX5XKZzeasrKyMjAz6Njc395lnnvmnf/qnp59++rnnnvv5z3/+7W9/G3cBrwKFhYW//vWvP/GJT6xataqysrK4uJj4m8y8tKFI+qtWq8XmqFarzcnJAZtqNBqHw9HY2DgwMCD+lCp4gGdnZ0dGRlRqTEIljpk/lgJ4fMwi8KSNKjUuXGo8d+6cXq+vra2dmJgQgSeCXATejWKG48OlS5egNULDg3bodrtBDw899NAnP/nJl156KT8//7//+78/+9nP/va3v9VqtSaTKScn54knnvjd73730EMP3XbbbRkZGXDVgW+qxWJxuVzwCjGZTM8+++z999//5z//+Wtf+9rPf/5zk8kUi8UQreHxeMjTJxQKud3uXbt2zVNrBDU2NTXBJwWKV5LttKqqqqCg4Lvf/e53v/vdN998My8v7/e///0//MM/PPzww9nZ2Xq9/k9/+tOiRYtef/31++6771vf+hZrbgUvko5VWlpaWFj4u9/97otf/GJaWlpKgypriYXGRluMJNjbA29BXwR4UF1hYSFOgKV08eLFn/jEJ9LT0y0WS0lJyeLFiz/1qU8999xzGo0G3rZZWVn/8i//AmqkLUN43uJPVmsk7xucANcbiF6vdzgc0Wi0v79f/ClV8ADPzs4ODAxgHi5cuCDyDIv/O/NFsBMRSIoxy6ESx8wfSwE8PmYReNJGlRoXLjX29PSUlZV5vd7JyUkReCLIReApwDwzM9PX1xeNRmEgdTqdCPWDc0dtbe3zzz//xS9+0Wg0ulyu8vLyP/zhD5/4xCfS0tLgVFJSUuL3+61W65e+9KVly5aRS6rT6USyAsTI63S6NWvWmM1mv9//7LPP3nPPPVVVVdBNvV4vfFMhPp+vurp6z54989lrJGpsbm6GEbWqqoolJJAEYjDuv//+H/zgBwhRz83N/clPfvLv//7vy5cvLy0tRZS6zWZ78sknv/zlLyP2HyzIusbA51Or1b7wwgtf/epXs7OzCxNCnqhkwGS3J81mc2ZmZlFREeubI9UaQb3EsrB8ajSav/zlL7fffvurr74K42dO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8/OxNjosUmfkSsAME4gWMqXUwb3wBryq0G2TgiuHJEjxkcka8ViWAZui4MpBPaCK1c1vwTrspAnSoyyRSBISEvbq7MSJEydOnDhy5Ehubu7u3bt3796dm5t7+vTpY8eOHT58+Pjx4ydOnNB7hZ04ceK0zn766acDBw5cunSpsbHxr3RP4MLMRMWdmb0tHnjszFzw6IUmaXxzpbG5ubmysvLJkye1tbV1dXV1dXXV1dU1NTU1NTXV1dX1OqvRGd6tr6/XaDSVlZWVlZVVVVV1dXWNjY1NTU2NjY0NDQ21tbVVVVUvXrzAAa2trS0tLS0tLQ0NDTU1NWiovr6+qqqqoqKiurq6qqqquroa5Q0NDVqttqWlpbm5uYViWq22ubm5qakJ9dfV1Wk0mubm5tbW1qampoKCgiNHjuTl5eH+lZ+ff/To0SNHjhw9evTo0aPHdJafn4/C06dPnzt37vTp07hFHjt2DMfDjh8/jj9OnDhx8uTJ06dPnzlz5vz588eOHTt06NApnZ07d+7s2bNo8fDhw99///2xY8cuXLhw9OjRvXv3ZmdnQ7MzMjIQnmZmZu7fv//gwYMHDx7MycnZu3dvbm5uSkpKampqVlZWdnZ2WloaHhr2799/4MCB/fv37927NycnJycnB1qelZW1Z8+evLy8nJwcjJ5F5XhcwBNGRkbGvn37Dh48uFtnubm5p06dKi8v12q19AuAeBju1Wg0jY2NWq0WXyW+u9bWVnLttbS0vHz5sr6+/tGjR7du3bp9+/adO3eu6Ozy5ctXrly5fv369evXf//994KCgmvXrl27du369es3bty4evUqDrt58+bdu3fv3r1bWFh46dKl33///c6dO6iqsLDw2rVrBQUFBQUFt27dunnz5s2bN+/cufPHH3/cunWroKDg999/v379+tWrV69du1ZYWIiz7ty589tvv505cwbvXr58+caNGzdv3rx169a9e/eKioru37///Plz6s8KH625uZlego+s90qsVWcvX7406NL/3+8JXJiZqLgzs7fFA4+dmQsevdAkjW+uNHJhZuIxxqU8mA3W9urVK9y5GhsbqQrd2NioYTCob7POtFqtVqttamqivzbqDCUajaa2trbRkDXpTKvV4gngxYsX5OGgqqoKf1RUVLx48aKioqKkpKS0tLSkpKSoqOjp06cVFRUVFRWlOntBMXJiRUVFeXl5ZWVlbW1tRUXF8+fPy8vLUfjs2bOSkhI8jpSWluIYUsPjx49LSkrq6+txN/9fXQwvX74kjy/EmU0UI98FeYXbqc5vbGysrq7WExgIc2NjY3NzMx2M1EC+IJwOz5MmqI0SVeN4JRv8+MYb958zu3GspF2Zmai4M7O3xQOPnZkLHr3QJI2mnwEbMxOPMS7lwWywtlevXrW2tmo0GtwEic7pBZ1UI2EB1ahvkVe9ez2TNVOsqamJHmG81EUkRHTr6+sbGhrq6+upN25CQj4IlZN8cHK8njde6Z4S9Iz6Mfl52+A3/pIijaRmahPkg9NfqWqKD0I1dmCqS6mH6b2ScqorOF7JBj++8cb958xuHCtpV2YmKu7M7G3xwGNn5oJHLzRJo+lnwMbMxGOMS3kwG6yN/AtFIekvlnoMiiJOod9emfTVoPbQ68e/dG8wyQb5UMSTpE7yL/V4g37W+4B/1s9Ux7J84/A5mqBqJMtlQH3moGrqn7oYqA831HLEoKQJUjPVFRyvZCbHGmlMLjVY+Kd+X6+fmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSHswGa2Nqrk08Hsw8jKVmHswcK2k/ci6eZGfWw+PNbPAU3i7l6G0jjQmPOzPL8a+ZmYmKOzN7Wzzw2Jm54NELTdJo+hmwMTPxGONSg4VM+zBgtegW3e56LMzUVcLZ8Xgw08H09p2gltOX/8YHeaXbH4O69nebLiUH4++X/70BBd0VhIS8a3CDJz2jfhbSECGnczJ50iCSQcfq0eIr1mq1BldF13Ms+XR6H+3Vn79Kjb8YuJjBmpkKOZKzVNKuzExU3JnZ2+KBx87MBY9eaJJG08+AjZmJxxiXGizUk0aypQPuldgxUe9EvYZaKNvPsuPxYNYzvU0kyF2baDnqwS5Urbrdpl69ekU+Fz4UdhYke+oatNbWVo1Gg+PJZyQ7F9Jd0UrZZquioqKqqorLTvSonNTW2tpaVVVVXFyMDRQBj7ew6bFBT2q12uLi4oaGBoMu1XMsPgv29iIfSqPRAENP8/CJcCS+a7ixvr6+RbcVM7059svgf3UxcDGDNTMVciRnqaRdmZmouDOzt8UDj52ZCx690CSNpp8BGzMTjzEupRdSdxRqampqaGiora0tLy+/evXqoUOHLl68+Pz5cyI5LMyopE08Hsx6RrY6wnZI2DiXHg62/Pc28a8o0Rh1Uyd2aXz58iV8cvLkyYcPH5KPSTby1SNvaWlpaGhobW2tqanx8vJKTExkCsWoBuEhAWJzc3N+fv769esfP36MtxobG48dO3bmzJmqqiqDoXlra2tJSYmLi0tGRoZBl+o5trGxsaSkpLa2lmyNqdFo6urqysrKamtrqcAQS41GU1NT09DQUFRUdOvWLTi8ubm5pqampKSkvLycvgUYl6vU+IuBixmsmamQIzlLJe3KzETFnZm9LR547Mxc8OiFJmk0/QzYmJl4jHEpvbCpqen8+fM5OTnff//9nj17UlJS4uPjVSqVRCLx9vaeNWtWYGBgWVkZO3Nzc3NxcXFVVVWbeDyY9QziXVtbW1VVVaazkpKSysrKuro6ohwNDQ3Pnj27fv36xYsXi4uLUYJYp7S09MGDB0+ePIE2sDNrtdqKigpXV9eUlBTEi4WFhW5ubocPH26hbGtMyKHEBQUFCxcujIqKQtDJ/omKioru3r1LAr7W1tZz584tXLjw6dOnEO9bt24tX758586dkCW6J1tbW3/55ZfZs2cfOXKE6Yqitvj06VM7O7vc3NyqqqozZ87s27cvKirK1dX1q6++CgoKev78OTkS2nnlyhWRSKRWq11dXb/55puCgoJLly5FR0dv27Zt27Zt0dHRJOX+p65S4y8GLmawZqZCjuQslbQrMxMVd2b2tnjgsTNzwaMXmqTR9DNgY2biMcal9MLGxsb4+HihUFhYWPjjjz86Ojrm5+eXlJS8ePGiqalp5cqVMpkMyTR6Pa267Ytv3Lgxf/788+fPG6RqbGxsbW29d+9eQkKCra1tRUWFMZfByZMn586du2nTpq1bt06dOnXOnDnfffedo6OjjY3NpUuX6urqtFrto0ePgoODt2zZ4uvrKxKJRCJRYGCgQqFoaWl5+PBhQEDAqFGjVq9e7eXltWXLFolEcu/evcbGRjo8ySd7eHjk5eU9efKkuLj4yZMnc+fODQsLQ7Cl0WiampqIQ5qbm6urqxUKhZubW3FxcUlJyc8//5ybm3vnzh2omp61tLTs2bMnKysL4Tvst99+c3FxKS0traioOHLkiEwm279//6NHj7RabV1dXU1NDXEUlLi6unrnzp3BwcGI6s6ePZuXl/fgwQNoPwnpkEStrq4uLi5OTk4WiUTFxcXx8fGpqalnz54tKCjYunXrJ5988vjxY4Kn0WgaGxsLCwtXrlx57969w4cPr1ix4v79+wcPHpw3b55MJquurq6rq2vzAuZyJfO4GLiYwZqZCjmSs1TSrsxMVNyZ2dvigcfOzAWPXmiSRtPPgI2ZiccYl9ILm5qasrOzMzMzNRrN999/v2jRIqFQaGNjs3fvXo1Gs23btvj4ePqYl1eUUS1lZWWenp6DBw/Oy8szSIXsZXFxsY+Pz5QpUx4+fEi6JHm4ND8/Pycnp7y8vKSkZNmyZatWrSoqKnr27FlqauqRI0c0Gs2dO3eWLl26c+fOq1evajQarVb79OnT8PBwBwcHrVbb0NCQmZlpbW29e/fuysrK3NzcCRMmLF++/MWLF3T4xsbGn3/+uaioyN/f/+zZsx4eHsnJybW1tTt27FCpVDdu3Lh48WJRURESti9fvkSu9fDhwwsWLPDw8FCpVNHR0QKBYNq0aevWrauoqKB/nOrq6uDg4F9++QWyV1pa+vjx49jY2IULF4aHh//2228zZsw4c+ZMQ0MDDnj48OHz58/xdaBdrVa7b9++pUuXuri4iEQisVgsEAimTp1qa2v7xx9/1NbWEjzYyZMnPTw8ysrKqqurW1tb6+vr6+rqNBpNc3NzcnLyV1999ezZM3IwUsclJSU2NjYCgcDNzc3Pz6+ysvLRo0cuLi6ZmZlqtfrixYumhOrrYWai4s7M3hYPPHZmLnj0QpM0mn4GbMxMPMa4lF7Y0tKyb9++7Ozs+/fvr1u3TiaTBQYGbt68+cqVK01NTX5+fui+oteDiKq6ujo9PR1xWHZ2tkEqBJ2tra1KpfLTTz99+vSpMS59/PhxWVkZgrPZs2fPmTPnxYsXra2tz58/Lykp0Wg0AoFg1KhRFy9exG0dnWS3b9+OiYkByQ8//DBy5Ei1Wt3a2trQ0GBraztx4sTffvuNDt/U1KRUKuPj48PCwlJSUuRy+ePHj+vr6/38/Ozs7Dw8PEQi0Y0bN4gwNDc33717NzIy8sSJE9evXy8sLHzx4kV1dbW/v79UKiXdk1QrKCjw9fWtqal5+fLl06dP1Wr11q1bFy1a9Mknn+Tn51+/fv2rr77avXv3vn37IiIiHBwcVq9evX//ftJDrNVqr1+/npGRUVhY+Ouvv6IHsby8/LvvvpNIJGQQ0Cudcre0tOTl5S1atOjhw4dlZWXPnj0rKys7duzY+fPn6+rqDhw4sGTJEqqE4+mnubnZzc0tOzs7MDAwIyOjoKBg3bp17u7ue/bsmTNnjre3N1HfP3WV8riAeZjBmpkKOZKzVNKuzExU3JnZ2+KBx87MBY9eaJJG08+AjZmJxxiX0gubm5v37NmTnp5+6tSp3NxcFxeXr776KjMzs66urqWlJTIycteuXdSoEZ1PZFjjkSNHlErlpUuXPvzww0OHDpHUK3WsP8HLzMycN2/es2fPjIkaYUhmLliwYM2aNTU1NWQE6YMHDyZNmrRmzRqEQWSwpVarrayshJwcOnTI2tp67969zc3NJSUlX3/99aRJk27fvk08SZ0+cf/+/R9//NHLy0ulUuXn56OPU6FQpKSkVFdXIyol5M3Nzfv37z9w4MClS5diY2O3b99+/fp1dFWqVCpq5E1y0Xl5ecnJyRjt2djYiOjwwoULq1evPnTo0KNHjxYtWhQQEODp6Tlv3ryff/65uLi4rKwMVSEIPnDgQGpq6vHjx+Pi4uzs7H788cfnz5/Pmzfv3LlzGMJDxWtubi4oKHBycrp9+7abm5u3t7dUKl2xYsXQoUPPnTt38uTJTz75pLS0lEBiGFFzc/Pu3btlMplYLA4NDc3Pz0fXY0ZGhkgkCgsLM0WNr4eZiYo7M3tbPPDYmbng0QtN0mj6GbAxM/EY41J6IaKo/Pz8J0+enDx50tbWdvv27Vu2bBGJRP/5z38cHBwSExOp93RII3To6tWrUqn0zp079+/fnzZt2tGjRxEdQrcww6G6uprgZWRkzJ49+8mTJ2QsqzEubWpqmjNnzqpVqxBywS5dujR06FB/f396HPNSJ0hHjhyxsLAICQkpKirKzc39+OOPPT09qWOIMF70wYMHhw8fjo2N9fb2nj17trOzc0RExPPnz2tra11dXffu3as3XQQABw4c2Lx585kzZ0JDQz///PPr16+XlpZu2LBh37591EkROLempiYyMrKgoKCxsREhXVVV1U8//WRnZ7dt27Z79+49ePBg2bJl586di42N/cc//oGwmAz/weDS3NzcTZs2Xbp0KSgo6Ouvv3706NHz58+/+OKLK1euoFoqHnpbN2/eXFJSEhISEhMTU1NTExUVZWdn9+zZs0uXLk2dOpUkVFtaWh48eHD27Fm1Wh0cHLxy5Up3d/esrKzTp097eXmJRCK5XC4UChMTE9u8gLlcycZcDCzG9Pvizsxy/GtmZqLizszeFg88dmYuePRCkzSafgZsV3Nq3wAAD9NJREFUzEw8xriUXtja2rp3797k5OSUlJSgoKDdu3fn5eXt37/fyclp+/btNjY2ERER1KgR4qfVasvLy5VKJUKTmzdvzpo1C119L1++1Gg05eXlFRUVpaWlGKLy6nVJ43/+85/BgwcHBwcbrJlIo6Wl5bZt26Kiory8vKKiooqLi6lDVZuamrRa7b179zIzM7OystatWzd58mSVSlVUVHTz5s2bN2+6u7sHBATI5XJXV9djx45RO/OOHj3q5+d3/vx5X1/foKCgsrKy5OTkr7/++u7du3rS2NLScuXKlejoaAys1Wq1586d2759+7Zt29zd3SMjI5uamn755Ze1a9c+ffo0Kytr5MiR27Zt+/HHHxElv6JIo1wuP336tKurq0wme/LkiVqtXrJkybNnz8hDDMGDNG7atOnp06f79u3z9PT08/ObN29eWFhYbW3tb7/99sEHH5ARqi0tLefOnQsMDExLSzt//rynp+eaNWuSk5N/+OEHNzc3oVB44MABmUyWlZXV5gXM5Uo25mJgMabfF3dmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpfRCrVYrk8n8/f3PnDlz586dx48fy+XyGzduVFRUvHjxwtPTU6FQYIgpjsetVqPR/PjjjzNnzty8ebOzs/OmTZssLS03btx46tSp+vr6zMxMW1tbGxsbR0fHX3/9FSe2trYmJyfPnTv3fyiN//73v1euXFldXU0Kf//9d2tra29vb+gBmezYQrH9+/ePHDkyNTW1oaGhpqYGKUfqCFUSCzY1NR06dGjlypWfffaZo6OjQqGwt7e3tbXdvXv3hQsX0tLS3n777cDAwPr6ekL+/fff29nZZWdnJyQkFBYW/vHHHwsXLnRxcSG9g/X19Yinm5ubDx06dPbsWcwJefTokaOj44YNGx48eHDkyBEvL6/6+vrs7Gxvb++Ghoaffvpp7ty5YrE4PT29uroaWVytVqvVavPy8lxdXUUi0f79+2/evHnq1Kk5c+YEBwcjN1tRUVFeXk6+OK1We/v27S1btlRUVNy+fVsqlZ4/f/7q1avPnz/XaDTXrl375JNP0BkMa2xs1Gg0SqXS3d1dLpfLZLLLly9jWJOjo+PBgwcjIiJOnz5NVi34U1cpjwuYh3H/ObMbx0ralZmJijsze1s88NiZueDRC03SaPoZsDEz8RjjUnqhVqsVCoWHDx9uaGhAiLNx48arV69isrmfn59SqaQuFEc6nwoLC+Pi4uRyeXBwsK2t7ZAhQxYtWpSbm9vQ0HDhwoXc3Nzs7Oz8/PyKigqyQMyuXbtsbW2fPHlivEtbW1urq6ttbW03b95MHTZSVVW1fPnyWbNm3bx5k6BCloqLixHC5uTkvPvuu3v37m3RrYGnZ0QXMZvl1KlT7u7ut27dKikpSU5O/vbbb6urq5ubm3/99dd//OMfv//+e11dHSE/ffp0QkICempbW1tra2vPnj37xx9/tLS0aDSae/fu/fDDD5hTUV5eHhcX9+jRI+LY+/fvl5eXl5eXq1QqLy+vmpoasVh88uRJrVZ78uTJjRs3lpaW1tbWEu+hiTNnzhw6dAhjkTDpMz8/H/F6XV3d0aNHjx8/Thb0aWxs/OmnnzZs2IAHFNRGAO7cuTNp0qSrV68SJ2s0mtLSUl9fX4FAsH79+qioqNra2gsXLsjl8gsXLuTn53/55Ze7d+8mKxv8qauUxwXMw5h+XwYL/9Tv6/UzM1FxZ2ZviwceOzMXPHqhSRpNPwM2ZiYeY1xKL6yvr3dxcTl79ixWWnn48GFERMS+fftu3rxZVlbm7OwcGxtLXSiOzJMjmdXGxsarV69Onz49NzcX8SWZeo+/iTSeOXPGzs7ujz/+IILEz6W4ZZeXl3/zzTcLFiwgw0bwVl5e3uTJk0NCQm7fvo1ew4aGhosXLx44cACTFLOzs0eMGJGZmYmPQPekVqutr6+/dOnSrl27Lly48ODBg+XLlz9+/Fir1Z4+fdrW1vby5ct5eXlbt251cHCorq6mJlT/85//SKVSLPP2Urd6Dj5+fX19aGjo+vXra2pqWltbL168GBMTU1lZiROhWxqNJisr69NPPxUIBHv37lWpVFip4Ny5cwg9yff46tUrZGgvXbq0d+9ezCHBFEM8CuBTCIVChUJBlhBqamo6cuTIpk2bSkpKAEZcV1xc/P3338+cOfPBgwcEqa6uLioqKjMzs6SkpKCgQCKReHl5ubm5/frrr+Xl5Zipsn//fpM0vh5mJiruzOxt8cBjZ+aCRy80SaPpZ8DGzMRjjEvphZWVlfPnz1coFBkZGTExMQKBYMeOHY6Ojt9++61AIJg9e3Z2dnbLfy8+jjsspkYgN3j16tVPPvnk7NmzGPeBoSK4F+POjmkGe/bsmT179okTJyorK41xaXNzc2Vl5eXLlz/++OMFCxacO3eOvIW7+eHDh2fPnv3dd98lJycfP348MTExKyurtLS0ubn54cOHIpHonXfekclkRUVFyIXSPYlFUCsrK7G0zaJFi0pLSxsaGh4/frx69WqpVBoSEpKUlHTixAlEY4QcMVZYWNiNGzc0Gg1WQy0qKvrll18UCsXnn3++ePHisrIyrVa7a9euvLw8agdkfX19U1NTaWlpfHz8wYMHjx49ilxoa2vrjz/+6ObmVldXR0acvnr1CmsI/P7775s2bUIa/MWLF6WlpU+ePHn+/PmVK1e8vLzGjx+/fft26DS+uJycnO3bt0OGqVHj0aNHp06dOm3aNCKNWq32hx9++OGHH+rr62trazUaTUNDw927d+VyuY2NjZOTk1gszsrKOnfu3L1795Ae+FNXKY8LmIcx/b4MFv6p39frZ2ai4s7M3hYPPHZmLnj0QpM0mn4GbMxMPMa4lF5YWVl5/Pjx69ev19fX19TU1NTUIOarqak5d+7cRx99hEkOenPy9BpqaWl59OiRwVnzMCwuevv27cLCwocPH5LhoPxcShJ99+7du3fvHnX1FoJXUlJy6tSpnJycn3766enTp/X19S9fvmxpaXn8+PHJkydPnjx57dq18vJyjGdhMujW9evX09PTKyoq9KYJ0l/xNFBUVCSTyWxtbW1tbdetW7dy5cqFCxd+8803y5cvDwsL+/XXX7G4eVFREXUAEfvF8Ouvv0qlUtLpq8dZVFQUHh6+Zs2a1atXf/nll3Pnzp0zZ87nn3++Zs2a9PT02traVzq9f/nyZUlJCVKmet5ubGyMiYlRKBRVVVVMnsdX2dLScu3aNbFYbGNjM3v27NWrV6tUKqzkYBCP6SpleYv7xdCmMbnUYCFHcpZK2pWZiYo7M3tbPPDYmbng0QtN0mj6GbAxM/EY41J6IdnFApnSVsrOTVDH4uJixHzszC0M22681O2VgWQmmQXI26Utup03tDqjb/z06tUrvNWiW2ScfNiXuokT5F0Wl6KfsqampqysrKGhweBuG9RXhGXopn3x4kVZWVlxcfH9+/exTEFVVRUSvHA1ffk9louhsrISHcBktIuekxsaGsrLy0tLS7H0AZb6Q9RLqgI/hgLRvY0viH3R11eUzbmw5hxZpvzlf++KxeUq5XEB8zAmlxos5EjOUkm7MjNRcWdmb4sHHjszFzx6oUkaTT8DNmYmHmNcSi9EJESkAtZK2bPC4L1Sr6FW3X5PBqkwVFKvEt4uxVYb5AZt8D7+StcV2kzZXQvnwiCo+JgsLiUiqtcQCzlOwdKj5ERIbENDAxLO5PmjxdAKfPTXV7pYjbpBhx7nS11vJVW69AaOUh996N6Go+i7rOjhteg2tMKDDk7B39SauVylPC5gHsbkUoOFHMlZKmlXZiYq7szsbfHAY2fmgkcvNEmj6WfAxszEY4xLWZiJHJIbaItukTDqxDiDzOR4g1Qsd0wuzHqmN3iExaUvdWJAvd2Tt4j2s7tUj9/gx9drkQ5MQnOqq/+UNBLxI4dRTU//8MqExySNxLhIo0FmkzS2NzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF5qk0fQzYGNm4jHGpTyYDdbG1FybeDyYeRhLzTyYOVbSfuRcPMnOrIfHm9ngKbxdytHbRhoTHndmluNfMzMTFXdm9rZ44LEzc8GjF/4/lgOaCfMg4NEAAAAASUVORK5CYII=" alt="" />

假设客户端分别发送了两个数据包D1和D2给服务端，由于服务端一次读取到的字节数是不确定的，故可能存在以下4种情况。
(1）服务端分两次读取到了两个独立的数据包，分别是D1和D2，没有粘包和拆包：
(2）服务端一次接收到了两个数据包，D1和D2粘合在一起，被称为TCP粘包；
(3）服务端分两次读取到了两个数据包，第一次读取到了完整的D1包和D2包的部分内容，第二次读取到了D2包的剩余内容，这被称为TCP拆包：
(4）服务端分两次读取到了两个数据包，第一次读取到了D1包的部分内容D1， 第二次读取到了D1包的剩余内容D1和D2包的整包。
如果此时服务端TCP接收滑窗非常小，而数据包D1和D2 比较大，很有可能会发生第五种可能，即服务端分多次才能将D1和D2包接收完全，期间发生多次拆包。

4.1.2    丁CP粘包／拆包发生的原因

问题产生的原因有三个，分别如下。

（1）应用程序WRITE写入的字节大小大于套接口发送缓冲区大小；
（2）进行MSS大小的TCP分段：
（3）以太网帧的payLoad大于MTU进行IP分片。

4.1.3    粘包问题的解决策略

由于底层的TCP无法理解上层的业务数据，所以在底层是无法保证数据包不被拆分和重组的，这个问题只能通过上层的应用协议核设计来解决，根据业界的主流协议的解决方案，可以归纳如下。
(l）消息定长，例如每个报文的大小为固定长度200字节，如果不够，空位补空格：
(2）在包尾增加回车换行符进行分割，例如FTP协议：
(3）将消息分为消息头和消息休，消息头中包含表示消息总长度（或者消息体长度〉的字段，通常设计思路为消息头的第一个字段使用int32来表示消息的总长度；
(4）更复杂的应用层协议。

介绍完了TCP粘包／拆包的基础知识，下面我们就通过实际例程来看看如何使用Netty提供的半包解码器来解决TCP粘包／拆包问题。

4.2    未考虑TCP粘包导致功能异常案例

在前面的时间服务器例程中，我们多次强调并没有考虑读半包问题，这在功能测试时往往没有问题，但是一旦压力上来，或者发送大报文之后，就会存在粘包／拆包问题。如果代码没有考虑，往往就会出现解码错位或者错误，导致程序不能正常工作。下面我们以3.l节的代码为例，模拟故障场景，然后看看如何正确使用Netty的半包解码器来解决TCP粘包／拆包问题。

4.2.1    TimeServer的改造
4-1    Netty时间服务器服务端

1.TimeServer

package lqy2_nianbao_fault_82;

import io.netty.bootstrap.ServerBootstrap;

import io.netty.channel.ChannelFuture;

import io.netty.channel.ChannelInitializer;

import io.netty.channel.ChannelOption;

import io.netty.channel.EventLoopGroup;

import io.netty.channel.nio.NioEventLoopGroup;

import io.netty.channel.socket.SocketChannel;

import io.netty.channel.socket.nio.NioServerSocketChannel;

/**

 * @author lilinfeng

 * @date 2014年2月14日

 * @version 1.0

 */

public class TimeServer {

    public void bind(int port) throws Exception {

    // 配置服务端的NIO线程组

    EventLoopGroup bossGroup = new NioEventLoopGroup();

    EventLoopGroup workerGroup = new NioEventLoopGroup();

    try {

        ServerBootstrap b = new ServerBootstrap();

        b.group(bossGroup, workerGroup)

            .channel(NioServerSocketChannel.class)

            .option(ChannelOption.SO_BACKLOG, 1024)

            .childHandler(new ChildChannelHandler());

        // 绑定端口，同步等待成功

        ChannelFuture f = b.bind(port).sync();

        // 等待服务端监听端口关闭

        f.channel().closeFuture().sync();

    } finally {

        // 优雅退出，释放线程池资源

        bossGroup.shutdownGracefully();

        workerGroup.shutdownGracefully();

    }

    }

    private class ChildChannelHandler extends ChannelInitializer<SocketChannel> {

    @Override

    protected void initChannel(SocketChannel arg0) throws Exception {

        arg0.pipeline().addLast(new TimeServerHandler());

    }

    }

    /**

     * @param args

     * @throws Exception

     */

    public static void main(String[] args) throws Exception {

    int port = 8080;

    if (args != null && args.length > 0) {

        try {

        port = Integer.valueOf(args[0]);

        } catch (NumberFormatException e) {

        // 采用默认值

        }

    }

    new TimeServer().bind(port);

    }

}

2.TimeServerHandler

 package lqy2_nianbao_fault_82;

 import io.netty.buffer.ByteBuf;

 import io.netty.buffer.Unpooled;

 import io.netty.channel.ChannelHandlerAdapter;

 import io.netty.channel.ChannelHandlerContext;

 /**

  * @author lilinfeng

  * @date 2014年2月14日

  * @version 1.0

  */

 public class TimeServerHandler extends ChannelHandlerAdapter {

     private int counter;

     @Override

     public void channelRead(ChannelHandlerContext ctx, Object msg)

         throws Exception {

     ByteBuf buf = (ByteBuf) msg;

     byte[] req = new byte[buf.readableBytes()];

     buf.readBytes(req);

     String body = new String(req, "UTF-8").substring(0, req.length

         - System.getProperty("line.separator").length());

     System.out.println("The time server receive order : " + body

         + " ; the counter is : " + ++counter);

     String currentTime = "QUERY TIME ORDER".equalsIgnoreCase(body) ? new java.util.Date(

         System.currentTimeMillis()).toString() : "BAD ORDER";

     currentTime = currentTime + System.getProperty("line.separator");

     ByteBuf resp = Unpooled.copiedBuffer(currentTime.getBytes());

     ctx.writeAndFlush(resp);

     }

     @Override

     public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {

     ctx.close();

     }

 }

每读到一条消息后，就计一次数，然后发送应答消息给客户端。按照设计，服务端接收到的消息总数应该跟客户端发送的消息总数相同，而且请求消息删除回车换行符后应该为“QUERYTIMEORDER”。下面我们继续看下客户端的改造。

3.TimeClient

 package lqy2_nianbao_fault_82;

 import io.netty.bootstrap.Bootstrap;

 import io.netty.channel.ChannelFuture;

 import io.netty.channel.ChannelInitializer;

 import io.netty.channel.ChannelOption;

 import io.netty.channel.EventLoopGroup;

 import io.netty.channel.nio.NioEventLoopGroup;

 import io.netty.channel.socket.SocketChannel;

 import io.netty.channel.socket.nio.NioSocketChannel;

 /**

  * @author lilinfeng

  * @date 2014年2月14日

  * @version 1.0

  */

 public class TimeClient {

     public void connect(int port, String host) throws Exception {

     // 配置客户端NIO线程组

     EventLoopGroup group = new NioEventLoopGroup();

     try {

         Bootstrap b = new Bootstrap();

         b.group(group).channel(NioSocketChannel.class)

             .option(ChannelOption.TCP_NODELAY, true)

             .handler(new ChannelInitializer<SocketChannel>() {

             @Override

             public void initChannel(SocketChannel ch)

                 throws Exception {

                 ch.pipeline().addLast(new TimeClientHandler());

             }

             });

         // 发起异步连接操作

         ChannelFuture f = b.connect(host, port).sync();

         // 当代客户端链路关闭

         f.channel().closeFuture().sync();

     } finally {

         // 优雅退出，释放NIO线程组

         group.shutdownGracefully();

     }

     }

     /**

      * @param args

      * @throws Exception

      */

     public static void main(String[] args) throws Exception {

     int port = 8080;

     if (args != null && args.length > 0) {

         try {

         port = Integer.valueOf(args[0]);

         } catch (NumberFormatException e) {

         // 采用默认值

         }

     }

     new TimeClient().connect(port, "127.0.0.1");

     }

 }

4.TimeClientHandler

 package lqy2_nianbao_fault_82;

 import io.netty.buffer.ByteBuf;

 import io.netty.buffer.Unpooled;

 import io.netty.channel.ChannelHandlerAdapter;

 import io.netty.channel.ChannelHandlerContext;

 import java.util.logging.Logger;

 /**

  * @author lilinfeng

  * @date 2014年2月14日

  * @version 1.0

  */

 public class TimeClientHandler extends ChannelHandlerAdapter {

     private static final Logger logger = Logger

         .getLogger(TimeClientHandler.class.getName());

     private int counter;

     private byte[] req;

     /**

      * Creates a client-side handler.

      */

     public TimeClientHandler() {

     req = ("QUERY TIME ORDER" + System.getProperty("line.separator"))

         .getBytes();

     }

     @Override

     public void channelActive(ChannelHandlerContext ctx) {

     ByteBuf message = null;

     for (int i = 0; i < 100; i++) {

         message = Unpooled.buffer(req.length);

         message.writeBytes(req);

         ctx.writeAndFlush(message);

     }

     }

     @Override

     public void channelRead(ChannelHandlerContext ctx, Object msg)

         throws Exception {

     ByteBuf buf = (ByteBuf) msg;

     byte[] req = new byte[buf.readableBytes()];

     buf.readBytes(req);

     String body = new String(req, "UTF-8");

     System.out.println("Now is : " + body + " ; the counter is : "

         + ++counter);

     }

     @Override

     public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {

     // 释放资源

     logger.warning("Unexpected exception from downstream : "

         + cause.getMessage());

     ctx.close();

     }

 }

主要的修改点就是代码33~38行，客户端跟服务端链路建立成功之后，循环发送100条消息，每发送一条就刷新一次，保证每条消息都会被写入Cl1annel中。按照我们的设计，服务端应该接收到100条查询时间指令的请求消息。第48~49行，客户端每接收到服务端一条应答消息之后，就打印一次计数器。按照设计初衷，客户端应该打印100次服务端的系统时间。下面的小节就来看下运行结果是否符合设计初衷。

4.2.3    运行结果

分别执行服务端和客户端，运行结果如下。

服务端

The time server receive order : QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORD ; the counter is : 1

The time server receive order :

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER

QUERY TIME ORDER ; the counter is : 2

服务端运行结果表明它只接收到了两条消息，第一条包含57条“QUERY TIME ORDER”指令，第二条包含了43条“QUERY TIME ORDER”指令，总数正好是100条。我们期待的是收到100条消息，每条包含一条“QUERYTIME ORDER＇指令。这说明发生了TCP粘包。

客户端

Now is : BAD ORDER

BAD ORDER

 ; the counter is : 1

按照设计初衷，客户端应该收到100条当前系统时间的消息，但实际上只收到了一条。这不难理解，因为服务端只收到了2条请求消息，所以实际服务端只发送了2条应答，由于请求消息不满足查询条件，所以返回了2条“BAD ORDER”应答消息。但是实际上客户端只收到了一条包含2BAD ORDER指令的消息，说明服务端返回的应答消息也发生了粘包。
由于上面的例程没有考虑TCP的粘包／拆包，所以当发生TCP粘包时，我们的程序就不能正常工作。

---

下面的章节将演示如何通过N'etty的LineBasedFrameDecoder和StringDecoder来解决TCP粘包问题。

4.3    利用LineBasedFrameDecoder解决TCP粘包问题

为了解决TCP粘包／拆包导致的半包读写问题重Netty默认提供了多种编解码器用于处理半包，只要能熟练掌握这些类库的使用，TCP粘包问题从此会变得非常容易，你甚至不需要关心它们，这也是其他NIO框架和JDK原生的NIOAPI所无法匹敌的。
下面我们就以修正时间服务器为目标进行开发和讲解，通过对实际代码的讲解让大家能够尽快熟悉和掌握半包解码器的使用。

4.3.1    支持TCP粘包的Timeserver
直接看代码，然后对LineBasedFra1neDecoder和StringDecoder的APl进行说明。

4-3    Netty    时间服务器服务端TimeServer

 package lqy3_nianbao_correct_88;

 import io.netty.bootstrap.ServerBootstrap;

 import io.netty.channel.ChannelFuture;

 import io.netty.channel.ChannelInitializer;

 import io.netty.channel.ChannelOption;

 import io.netty.channel.EventLoopGroup;

 import io.netty.channel.nio.NioEventLoopGroup;

 import io.netty.channel.socket.SocketChannel;

 import io.netty.channel.socket.nio.NioServerSocketChannel;

 import io.netty.handler.codec.LineBasedFrameDecoder;

 import io.netty.handler.codec.string.StringDecoder;

 /**

  * @author lilinfeng

  * @date 2014年2月14日

  * @version 1.0

  */

 public class TimeServer {

     public void bind(int port) throws Exception {

     // 配置服务端的NIO线程组

     EventLoopGroup bossGroup = new NioEventLoopGroup();

     EventLoopGroup workerGroup = new NioEventLoopGroup();

     try {

         ServerBootstrap b = new ServerBootstrap();

         b.group(bossGroup, workerGroup)

             .channel(NioServerSocketChannel.class)

             .option(ChannelOption.SO_BACKLOG, 1024)

             .childHandler(new ChildChannelHandler());

         // 绑定端口，同步等待成功

         ChannelFuture f = b.bind(port).sync();

         // 等待服务端监听端口关闭

         f.channel().closeFuture().sync();

     } finally {

         // 优雅退出，释放线程池资源

         bossGroup.shutdownGracefully();

         workerGroup.shutdownGracefully();

     }

     }

     private class ChildChannelHandler extends ChannelInitializer<SocketChannel> {

     @Override

     protected void initChannel(SocketChannel arg0) throws Exception {

         arg0.pipeline().addLast(new LineBasedFrameDecoder(1024));

         arg0.pipeline().addLast(new StringDecoder());

         arg0.pipeline().addLast(new TimeServerHandler());

     }

     }

     /**

      * @param args

      * @throws Exception

      */

     public static void main(String[] args) throws Exception {

     int port = 8080;

     if (args != null && args.length > 0) {

         try {

         port = Integer.valueOf(args[0]);

         } catch (NumberFormatException e) {

         // 采用默认值

         }

     }

     new TimeServer().bind(port);

     }

 }

重点看45~47行，在原来的TimeServerHandler之前新增了两个解码器：第一个是LineBasedFrameDecoder，第二个是StringDecoder。这两个类的功能后续会进行介绍，下面继续看TimeServerHandler的代码修改。

4-4    Netty时间服务器服务端    TimeServerHandler

 package lqy3_nianbao_correct_88;

 import io.netty.buffer.ByteBuf;

 import io.netty.buffer.Unpooled;

 import io.netty.channel.ChannelHandlerAdapter;

 import io.netty.channel.ChannelHandlerContext;

 /**

  * @author lilinfeng

  * @date 2014年2月14日

  * @version 1.0

  */

 public class TimeServerHandler extends ChannelHandlerAdapter {

     private int counter;

     @Override

     public void channelRead(ChannelHandlerContext ctx, Object msg)

         throws Exception {

     String body = (String) msg;

     System.out.println("The time server receive order : " + body

         + " ; the counter is : " + ++counter);

     String currentTime = "QUERY TIME ORDER".equalsIgnoreCase(body) ? new java.util.Date(

         System.currentTimeMillis()).toString() : "BAD ORDER";

     currentTime = currentTime + System.getProperty("line.separator");

     ByteBuf resp = Unpooled.copiedBuffer(currentTime.getBytes());

     ctx.writeAndFlush(resp);

     }

     @Override

     public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {

     ctx.close();

     }

 }

直接看19~21行，可以发现接收到的msg就是删除回车换行符后的请求消息，不需要额外考虑处理读半包问题，也不需要对请求消息进行编码，代码非常简洁。读者可能会质疑这样是否可行，不着急我们先继续看看客户端的类似改造，然后运行程序看执行结果，最后再揭开其中的奥秘。

4.3.2    支持TCP粘包的TimeClient

支持TCP粘包的客户端修改起来也非常简单，代码如下。

Netty时间服务器客户端TimeClient

 package lqy3_nianbao_correct_88;

 import io.netty.bootstrap.Bootstrap;

 import io.netty.channel.ChannelFuture;

 import io.netty.channel.ChannelInitializer;

 import io.netty.channel.ChannelOption;

 import io.netty.channel.EventLoopGroup;

 import io.netty.channel.nio.NioEventLoopGroup;

 import io.netty.channel.socket.SocketChannel;

 import io.netty.channel.socket.nio.NioSocketChannel;

 import io.netty.handler.codec.LineBasedFrameDecoder;

 import io.netty.handler.codec.string.StringDecoder;

 /**

  * @author lilinfeng

  * @date 2014年2月14日

  * @version 1.0

  */

 public class TimeClient {

     public void connect(int port, String host) throws Exception {

     // 配置客户端NIO线程组

     EventLoopGroup group = new NioEventLoopGroup();

     try {

         Bootstrap b = new Bootstrap();

         b.group(group).channel(NioSocketChannel.class)

             .option(ChannelOption.TCP_NODELAY, true)

             .handler(new ChannelInitializer<SocketChannel>() {

             @Override

             public void initChannel(SocketChannel ch)

                 throws Exception {

                 ch.pipeline().addLast(

                     new LineBasedFrameDecoder(1024));

                 ch.pipeline().addLast(new StringDecoder());

                 ch.pipeline().addLast(new TimeClientHandler());

             }

             });

         // 发起异步连接操作

         ChannelFuture f = b.connect(host, port).sync();

         // 当代客户端链路关闭

         f.channel().closeFuture().sync();

     } finally {

         // 优雅退出，释放NIO线程组

         group.shutdownGracefully();

     }

     }

     /**

      * @param args

      * @throws Exception

      */

     public static void main(String[] args) throws Exception {

     int port = 8080;

     if (args != null && args.length > 0) {

         try {

         port = Integer.valueOf(args[0]);

         } catch (NumberFormatException e) {

         // 采用默认值

         }

     }

     new TimeClient().connect(port, "127.0.0.1");

     }

 }

31~34行与服务端类似，直接在TimeClientHandler之前新增LineBasedFrameDecoder
和StringDecoder解码器，下面我们继续看TimeClientHandler的代码修改。

Netty时间服务器客户端TimeClientHandler

 package lqy3_nianbao_correct_88;

 import io.netty.buffer.ByteBuf;

 import io.netty.buffer.Unpooled;

 import io.netty.channel.ChannelHandlerAdapter;

 import io.netty.channel.ChannelHandlerContext;

 import java.util.logging.Logger;

 /**

  * @author lilinfeng

  * @date 2014年2月14日

  * @version 1.0

  */

 public class TimeClientHandler extends ChannelHandlerAdapter {

     private static final Logger logger = Logger

         .getLogger(TimeClientHandler.class.getName());

     private int counter;

     private byte[] req;

     /**

      * Creates a client-side handler.

      */

     public TimeClientHandler() {

     req = ("QUERY TIME ORDER" + System.getProperty("line.separator"))

         .getBytes();

     }

     @Override

     public void channelActive(ChannelHandlerContext ctx) {

     ByteBuf message = null;

     for (int i = 0; i < 100; i++) {

         message = Unpooled.buffer(req.length);

         message.writeBytes(req);

         ctx.writeAndFlush(message);

     }

     }

     @Override

     public void channelRead(ChannelHandlerContext ctx, Object msg)

         throws Exception {

     String body = (String) msg;

     System.out.println("Now is : " + body + " ; the counter is : "

         + ++counter);

     }

     @Override

     public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {

     // 释放资源

     logger.warning("Unexpected exception from downstream : "

         + cause.getMessage());

     ctx.close();

     }

 }

第44~46行拿到的msg    已经是解码成字符串之后的应答消息了，相比于之前的代问简洁了很多。

下个小节我们运行重构后的时间服务器服务端和客户端，看看它能否像设计预期那样正常工作。

4.3.3    运行支持TCP粘包的时间服务器程序

为了尽量模拟TCP粘包和半包场景，采用简单的压力测试，链路建立成功之后，客户端连续发送100条消息给服务端，然后查看服务端和客户端的运行结果。
分别运行TimeServer和TimeClient，执行结果如下。

服务咐执行结果如下。

The time server receive order : QUERY TIME ORDER ; the counter is : 1

The time server receive order : QUERY TIME ORDER ; the counter is : 2

The time server receive order : QUERY TIME ORDER ; the counter is : 3

The time server receive order : QUERY TIME ORDER ; the counter is : 4

The time server receive order : QUERY TIME ORDER ; the counter is : 5

The time server receive order : QUERY TIME ORDER ; the counter is : 6

The time server receive order : QUERY TIME ORDER ; the counter is : 7

The time server receive order : QUERY TIME ORDER ; the counter is : 8

The time server receive order : QUERY TIME ORDER ; the counter is : 9

The time server receive order : QUERY TIME ORDER ; the counter is : 10

The time server receive order : QUERY TIME ORDER ; the counter is : 11

The time server receive order : QUERY TIME ORDER ; the counter is : 12

The time server receive order : QUERY TIME ORDER ; the counter is : 13

The time server receive order : QUERY TIME ORDER ; the counter is : 14

The time server receive order : QUERY TIME ORDER ; the counter is : 15

The time server receive order : QUERY TIME ORDER ; the counter is : 16

The time server receive order : QUERY TIME ORDER ; the counter is : 17

The time server receive order : QUERY TIME ORDER ; the counter is : 18

The time server receive order : QUERY TIME ORDER ; the counter is : 19

The time server receive order : QUERY TIME ORDER ; the counter is : 20

The time server receive order : QUERY TIME ORDER ; the counter is : 21

The time server receive order : QUERY TIME ORDER ; the counter is : 22

The time server receive order : QUERY TIME ORDER ; the counter is : 23

The time server receive order : QUERY TIME ORDER ; the counter is : 24

The time server receive order : QUERY TIME ORDER ; the counter is : 25

The time server receive order : QUERY TIME ORDER ; the counter is : 26

The time server receive order : QUERY TIME ORDER ; the counter is : 27

The time server receive order : QUERY TIME ORDER ; the counter is : 28

The time server receive order : QUERY TIME ORDER ; the counter is : 29

The time server receive order : QUERY TIME ORDER ; the counter is : 30

The time server receive order : QUERY TIME ORDER ; the counter is : 31

The time server receive order : QUERY TIME ORDER ; the counter is : 32

The time server receive order : QUERY TIME ORDER ; the counter is : 33

The time server receive order : QUERY TIME ORDER ; the counter is : 34

The time server receive order : QUERY TIME ORDER ; the counter is : 35

The time server receive order : QUERY TIME ORDER ; the counter is : 36

The time server receive order : QUERY TIME ORDER ; the counter is : 37

The time server receive order : QUERY TIME ORDER ; the counter is : 38

The time server receive order : QUERY TIME ORDER ; the counter is : 39

The time server receive order : QUERY TIME ORDER ; the counter is : 40

The time server receive order : QUERY TIME ORDER ; the counter is : 41

The time server receive order : QUERY TIME ORDER ; the counter is : 42

The time server receive order : QUERY TIME ORDER ; the counter is : 43

The time server receive order : QUERY TIME ORDER ; the counter is : 44

The time server receive order : QUERY TIME ORDER ; the counter is : 45

The time server receive order : QUERY TIME ORDER ; the counter is : 46

The time server receive order : QUERY TIME ORDER ; the counter is : 47

The time server receive order : QUERY TIME ORDER ; the counter is : 48

The time server receive order : QUERY TIME ORDER ; the counter is : 49

The time server receive order : QUERY TIME ORDER ; the counter is : 50

The time server receive order : QUERY TIME ORDER ; the counter is : 51

The time server receive order : QUERY TIME ORDER ; the counter is : 52

The time server receive order : QUERY TIME ORDER ; the counter is : 53

The time server receive order : QUERY TIME ORDER ; the counter is : 54

The time server receive order : QUERY TIME ORDER ; the counter is : 55

The time server receive order : QUERY TIME ORDER ; the counter is : 56

The time server receive order : QUERY TIME ORDER ; the counter is : 57

The time server receive order : QUERY TIME ORDER ; the counter is : 58

The time server receive order : QUERY TIME ORDER ; the counter is : 59

The time server receive order : QUERY TIME ORDER ; the counter is : 60

The time server receive order : QUERY TIME ORDER ; the counter is : 61

The time server receive order : QUERY TIME ORDER ; the counter is : 62

The time server receive order : QUERY TIME ORDER ; the counter is : 63

The time server receive order : QUERY TIME ORDER ; the counter is : 64

The time server receive order : QUERY TIME ORDER ; the counter is : 65

The time server receive order : QUERY TIME ORDER ; the counter is : 66

The time server receive order : QUERY TIME ORDER ; the counter is : 67

The time server receive order : QUERY TIME ORDER ; the counter is : 68

The time server receive order : QUERY TIME ORDER ; the counter is : 69

The time server receive order : QUERY TIME ORDER ; the counter is : 70

The time server receive order : QUERY TIME ORDER ; the counter is : 71

The time server receive order : QUERY TIME ORDER ; the counter is : 72

The time server receive order : QUERY TIME ORDER ; the counter is : 73

The time server receive order : QUERY TIME ORDER ; the counter is : 74

The time server receive order : QUERY TIME ORDER ; the counter is : 75

The time server receive order : QUERY TIME ORDER ; the counter is : 76

The time server receive order : QUERY TIME ORDER ; the counter is : 77

The time server receive order : QUERY TIME ORDER ; the counter is : 78

The time server receive order : QUERY TIME ORDER ; the counter is : 79

The time server receive order : QUERY TIME ORDER ; the counter is : 80

The time server receive order : QUERY TIME ORDER ; the counter is : 81

The time server receive order : QUERY TIME ORDER ; the counter is : 82

The time server receive order : QUERY TIME ORDER ; the counter is : 83

The time server receive order : QUERY TIME ORDER ; the counter is : 84

The time server receive order : QUERY TIME ORDER ; the counter is : 85

The time server receive order : QUERY TIME ORDER ; the counter is : 86

The time server receive order : QUERY TIME ORDER ; the counter is : 87

The time server receive order : QUERY TIME ORDER ; the counter is : 88

The time server receive order : QUERY TIME ORDER ; the counter is : 89

The time server receive order : QUERY TIME ORDER ; the counter is : 90

The time server receive order : QUERY TIME ORDER ; the counter is : 91

The time server receive order : QUERY TIME ORDER ; the counter is : 92

The time server receive order : QUERY TIME ORDER ; the counter is : 93

The time server receive order : QUERY TIME ORDER ; the counter is : 94

The time server receive order : QUERY TIME ORDER ; the counter is : 95

The time server receive order : QUERY TIME ORDER ; the counter is : 96

The time server receive order : QUERY TIME ORDER ; the counter is : 97

The time server receive order : QUERY TIME ORDER ; the counter is : 98

The time server receive order : QUERY TIME ORDER ; the counter is : 99

The time server receive order : QUERY TIME ORDER ; the counter is : 100

客户端运行结果如下。

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 1

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 2

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 3

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 4

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 5

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 6

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 7

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 8

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 9

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 10

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 11

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 12

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 13

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 14

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 15

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 16

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 17

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 18

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 19

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 20

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 21

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 22

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 23

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 24

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 25

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 26

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 27

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 28

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 29

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 30

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 31

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 32

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 33

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 34

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 35

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 36

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 37

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 38

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 39

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 40

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 41

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 42

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 43

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 44

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 45

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 46

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 47

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 48

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 49

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 50

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 51

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 52

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 53

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 54

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 55

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 56

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 57

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 58

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 59

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 60

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 61

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 62

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 63

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 64

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 65

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 66

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 67

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 68

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 69

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 70

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 71

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 72

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 73

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 74

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 75

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 76

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 77

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 78

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 79

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 80

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 81

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 82

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 83

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 84

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 85

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 86

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 87

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 88

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 89

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 90

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 91

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 92

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 93

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 94

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 95

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 96

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 97

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 98

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 99

Now is : Thu Oct 22 11:03:33 CST 2015 ; the counter is : 100

程序的运行结果完全符合预期，说明通过使用LineBasedFrameDecoder和StringDecoder成功解决了TCP粘包导致的读半包问题。对于使用者来说，只要将支持半包解码的handler添加到ChannelPipeline中即可，不需要写额外的代码，用户使用起来非常简单。

下个小节，我们就对添加LineBas巳dFrameDecoder和StringDecoder之后就能解决TCP粘包导致的读半包或者多包问题的原因进行分析。

---

4.3.4    LineBasedFrameDecoder和StringDecoder的原理分析

LineBasedFrameDecoder的工作原理是它依次遍历ByteBuf中的可读字节，判断看是否有＼n或者以\r\n气如果有，就以此位置为结束位置，从可读索引到结束位置区间的字节就组成了一行。它是以换行符为结束标志的解码器，支持携带结束符或者不携带结束符两种解码方式，同时支持配置单行的最大长度。如果连续读取到最大长度后仍然没有发现换行符，就会抛出异常，同时忽略掉之前读到的异常码流。
StringDecoder的功能非常简单，就是将接收到的对象转换成字符串，然后继续调用后面的handler。LineBasedFrameDecoder+StringDecoder组合就是按行切换的文本解码器，它被设计用来支持TCP的粘包和拆包。

可能读者会提出新的疑问：如果发送的消息不是以换行符结束的该怎么办呢？或者没有回车换行符，靠消息头中的长度字段来分包怎么办？是不是需要自己写半包解码器？答案是否定的，Netty提供了多种支持TCP粘包／拆包的解码器，用来满足用户的不同诉求。
第5章我们将学习分隔符解码器，由于它在实际项目中应用非常广泛，所以单独用一章对其用法和原理进行讲解。

4.4    总结

本章首先对TCP的粘包和拆包进行了讲解，给出了解决这个问题的通用做法。然后我们对第3章的时间服务器进行改造和测试，首先验证没有考虑TCP粘包／拆包导致的问题。随后给出了解决方案，即利用LineBasedFrameDecoder+StringDecoder来解决TCP的粘包／拆包问题。