1. 程式人生 > >利用設計模式消除業務程式碼中的 if-else

利用設計模式消除業務程式碼中的 if-else


準備工作:
假設這樣的一個業務場景:有一個自動開票的功能需要實現,在程式裡面需要根據賬單的型別執行對應的處理邏輯。

**以下使用了 Lombok 簡化程式碼!!!**

賬單型別列舉: ```java /** * @author ly-az * @date 12/23/2020 11:34 * 賬單型別 */ public enum BillType { /** * 賬單的型別 */ BT0001, BT0002 } ```
賬單類: ```java /** * @author ly-az * @date 12/23/2020 11:31 * 賬單實體 */ @Data @NoArgsConstructor @AllArgsConstructor public class Bill { /** * 賬單資訊 */ String message; /** * 賬單型別型別(BT0001、BT0002) */ BillType type; } ```
賬單的模擬生成:用於生成一下模擬資料 ```java /** * @author ly-az * @date 12/23/2020 11:42 * 生成用於測試的賬單 */ public class BillBuilder { /** * 生成賬單 * * @return 賬單集合 */ public static List generateBillList() { val billList = new ArrayList(); billList.add(new Bill("我是第一種型別的賬單", BillType.BT0001)); billList.add(new Bill("我是第二種型別的賬單", BillType.BT0002)); return billList; } } ```
使用if-else來實現的話: ```java /** * @author ly-az * @date 12/24/2020 10:31 * if-else */ public class Test01 { public static void main(String[] args) { List billList = BillBuilder.generateBillList(); billList.forEach(bill -> { if (bill.getType().equals(BillType.BT0001)) { // 模擬實現業務處理 System.out.println("開始處理BT0001型別的賬單 > > > " + bill.getMessage() + ". . . "); System.out.println("處理成功!!!"); } else if (bill.getType().equals(BillType.BT0002)) { System.out.println("開始處理BT0002型別的賬單 > > > " + bill.getMessage() + ". . . "); System.out.println("處理成功!!!"); } // 。。。 未來還有數不清的else if分支 。。。 else { System.out.println("賬單型別不匹配!!!"); } }); } } ``` 在遇到if-else的分支業務邏輯比較複雜時,為了程式碼的可讀性我們會將其整理成一個方法或者封裝成一個工具類去呼叫,避免整個if-else的結構就顯得過於臃腫(這裡就模擬了兩種型別,偷懶...ψ(`∇´)ψ)。
但是當賬單型別越來越多時,if-else分支就會越來越多,每增加一種型別,就需要去修改或新增if-else分支,違反了**開閉原則(對擴充套件開放,對修改關閉)**
## 方案一:使用策略模式+Map字典 > **策略模式屬於物件的行為模式。其用意是針對一組演算法,將每一個演算法封裝到具有共同介面的獨立的類中,從而使得它們可以相互替換。策略模式使得演算法可以在不影響到客戶端的情況下發生變化。** > ------《JAVA與模式》
也就是說讓我們自己的程式碼不再依賴於呼叫業務程式碼的時的客戶端,能夠根據不同的客戶端執行不同的程式碼,而客戶端只需要呼叫我們的策略介面即可。

在上述場景中,可以把 if-else 分支的程式碼抽取為各種不同的策略實現,而且我們可以把選擇不同策略的實現的程式碼邏輯抽取到一個工廠類中去,這就是策略模式+簡單工廠模式,為了進一步簡化,我們還可以把策略的實現放到一個Map中封裝成字典

看程式碼:
- **抽象策略:**通常由一個介面或抽象類實現。是所有的具體策略類所需的介面。 ```java /** * @author ly-az * @date 12/23/2020 11:46 * @see BillHandleStrategyFactory 策略工廠 * 賬單處理的策略介面
* 有新的型別的賬單時只需要實現這個介面重寫接口裡的實現方法並新增到策略工廠裡面的字典裡即可 */ public interface BillHandleStrategy { /** * 處理方法 * * @param bill 賬單 */ void handleBill(Bill bill); } ``` - **環境:**持有一個策略介面的引用。 ```java /** * @author ly-az * @date 12/23/2020 11:46 */ public class BillStrategyContext { private BillHandleStrategy billHandleStrategy; /** * 設定策略介面 * * @param billHandleStrategy 策略介面 */ public void setBillHandleStrategy(BillHandleStrategy billHandleStrategy) { this.billHandleStrategy = billHandleStrategy; } public void handleBill(Bill bill) { if (billHandleStrategy != null) { billHandleStrategy.handleBill(bill); } } } ``` - **具體的策略實現:**就是處理賬單的策略介面的具體實現,賬單對應的處理者。 ```java /** * @author ly-az * @date 12/23/2020 13:01 * 處理BT0001賬單的策略介面的實現類 */ public class Bt0001BillHandleStrategy implements BillHandleStrategy { @Override public void handleBill(Bill bill) { // 模擬業務處理 System.out.println("開始處理BT0001型別的賬單 > > > " + bill.getMessage() + ". . ."); System.out.println("處理成功!!!"); } } ``` ```java /** * @author ly-az * @date 12/23/2020 13:02 * 處理BT0002型別的策略實現類 */ public class Bt0002BillHandleStrategy implements BillHandleStrategy { @Override public void handleBill(Bill bill) { // 模擬實現業務處理 System.out.println("開始處理BT0002型別的賬單 > > > " + bill.getMessage() + ". . . "); System.out.println("處理成功!!!"); } } ``` - **策略工廠:**用於獲取具體策略的實現類物件 ```java /** * @author ly-az * @date 12/23/2020 13:05 * 策略工廠 */ public class BillHandleStrategyFactory { private static final Map BILL_HANDLE_STRATEGY_MAP; static { // 初始化, BILL_HANDLE_STRATEGY_MAP = new HashMap<>(); BILL_HANDLE_STRATEGY_MAP.put(BillType.BT0001, new Bt0001BillHandleStrategy()); BILL_HANDLE_STRATEGY_MAP.put(BillType.BT0002, new Bt0002BillHandleStrategy()); } /** * 根據賬單型別直接從Map字典裡獲取對應的處理策略實現類 * * @param billType 賬單型別 * @return 處理策略的實現類 */ public static BillHandleStrategy getBillHandleStrategy(BillType billType) { return BILL_HANDLE_STRATEGY_MAP.get(billType); } } ``` **
**測試程式碼: ```java /** * @author ly-az * @date 12/23/2020 13:12 */ public class Test02 { public static void main(String[] args) { //模擬賬單 List billList = BillBuilder.generateBillList(); //策略上下文 BillStrategyContext billStrategyContext = new BillStrategyContext(); billList.forEach(bill -> { //獲取並設定策略 BillHandleStrategy billHandleStrategy = BillHandleStrategyFactory.getBillHandleStrategy(bill.getType()); billStrategyContext.setBillHandleStrategy(billHandleStrategy); //執行策略 billStrategyContext.handleBill(bill); }); } } ``` **
**測試結果:![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAs8AAAFKCAYAAADi57JBAAAgAElEQVR4Aey9+3dUx5nuP//K+eG7trWPbixJILGQhAEtQAKMQYC4LIQlIyywLGQsCYEBGWNAgLlIGCFACAndEXdjG0fGk4yTc048mcSTTBwnEyeT2JlcHCeZkzmZmTNnnu+q7n67S6Xau3e3hMDS80Ovql2Xt6re+uzeT5Wqt/7qySVrwA99QAbIABkgA2SADJABMkAG4jPwV3RSfCfRR/QRGSADZIAMkAEyQAbIgGKA4pk77/zLAxkgA2SADJABMkAGyEBABv4qK/dJ8EMfkAEyQAbIABkgA2SADJCB+Az81X/7//471Ec564nUbH7oAzJABsgAGSADZIAMkAEy4MEAxbOHY7iQ4EKKDJABMkAGyAAZIANkwGSA4pnimStLMkAGyAAZIANkgAyQgYAMUDwHdJS56uA1V6Jk4KvBQEpmLlLdrNBDITUzlw8HfueRATJABsjAhBigeCZAEwKIAvKrISBn4jw52WXY1fs9fP9bHVgYEc+VA7/Gh+9cQcXC2eSe331kgAyQATKQFAMTEs9OxlPY0fMj/OMf/wvfvVgxpgN+eV4PcsddiaPf/k989gf5/Bd+9cOrWB558KWtOIjL3/pn/PSLf8OP/uHbOLN9GZ6I5HnZ1NOdrGpc/NEXuLoj/OPIeO3pdYPGQza/A3weHYMay+/QXh7e+QpqZzLLFbf+FJ8M1I6ZH7Hv5DZh4Gd/wFuvrrLmS7nJCv36kmgbjluON370O7RvTM63zuwjeOtPH+Pgolh9t/79CH//D5//CVEWv3tp64T94zV2t/hlXPrgM3zym/8T4rq1uiTU1sr2n4Xb/yPwUVeVtf2HMX9e/Uzmnk50Ts3yyY7PSS3Fvq//Hh+OHMayvJyo75zMYmw89SF++Mlb2DovNu/Sro0JyWPIhSIZIANkgAwoBpIWz45bin1/8wX+9u4J7Bn49Rjx7JcXFDwnfztOffATjBxYjzQ3C467Aa///Z8x2voc5mblo6juHv7uN99B05PjH4C2Nhw3D+su/wIf330ZcyyC22zPZiNIWlg8/xlXtgXrVxCbEy3jJYYmajeZ+pPZl4chnmVMjluLnn/+KY4um7x5tI3dcYvQ9OBf8cGl5zF31lwUbr+JD3/1PnbkxNpd1/VrT/Es/Z3M0N5P7/t9MtueLFs5Dd/AT793GcWpMT+Kbcedh6qRL/E9tSAxvgsonvlgFE4YkgUyQAa8GJiAeC7D9j0VyHazoB7u+s6z43rnSUdStwzie1/8K0Zb1kV3hSTPXXoAA3/7A5yrLo4+3Jyl7fjgt19DVVr4Yei4y/Dah/+F6w2xM4x+NlPX9eDbv/gm6uaPf5ja2pO++NmUMnroJ56dWc/hwo/+N241LQmNOeWpi/jmr/8eB5aGAU1ZvBsX/+Yz/Pg3f8Y//N37aC6bH/VNypKmUF5od/KHH+LsjuWhPMetwZXPfobjK8Qvu9D3m09weEkWUhu+gX/+F4z5/OpPX+LCFrUYeRJ73o/s8P8ReHNfQbQtx63ChU8/R8/ZW/jmL/6Cn376Q3S9uDI6F9kbz+PNH/4Lfvab32L0jV5c/81HeLlgvF91v/j1RZVLXXYAl7/5K/zjb/+CH/3wQ7yh/qoQ+XNSdnkH3vyHP+DTL/8vPv35j9G/fz3c0IJq7M6zM/9V3PnlZ3hj09xoXbFhC52MA7j5J3vfvcSz3xx59dNv7I67A5d/8XOceErmbwWqTrahvDDmT5t49ps/NVavfvrNrX8/49/TVh+v78dHH9xH1w/+jI9uHsf+O1/gpz8eRU3kPvSad7/x+Y1B9cFxZ6Pm7r/j/WMrPDlwnrmOH/2oH0+b4tmHCdv4mMaHKxkgA2Rg5jGQtHjWYTHFc6C81afw5nc+Rk/DU+MecPNe+y4++/Iv+Pijb+DgxsgRiyXt+OA3unhejsPf/jf01WiT5mHTydiIk9/9E97cHxacev9U3NZetIyHzWi+cV7ITzyrOllVd/D3n95DeXYxmh78CV8/WYaUkBBciJe+9i/4evs25M6ah4W73sVHnwxidSSvYfTP+OblFzBv1lwUVN/Ah7/5G7wwW4lgb/HspOYgNWM2lp39KT4ZrAvF1bVqT/rvuHPRMGoTz/8HH1x+CQWz8rFo9wP88NfvYmu6au8pHPnw3/H+G89iTmY+Fu/9a3zsIUClDRX69cVxF6Hx/hd461QFZmfMxYKdb+Ej1V6Gaq8IBz74D7x7bDXSU2dj9sbT6Hm7A2WhvJh4VjZq7/0B3+nejnRtfHofzLjj7kTPrz/AzoyYP6SMTTw7rt8c+fTTZx5s7UgfJLSJZ8mzz59fP9XCyGNuffop7anQ737Xy6m4o8Tzj29h45NNGPrFP+Lkmqfw8vv/gTt78+E372LHPj7vMYTadItx8H/+JwZ3at8N5n1a9Aa+8cUothms+DEhfWLo7Vf6hr4hA2RgJjDw6MSz8TAzne1kzMfyQ/8Dn/x4KCwg07bi/D/+Be+9sQP5s59E8Utv47u/+xAN2g6daUNdO24OSk59jJ98cBoLlBAteB2jf/oGasyHptGezVaQNOuZ5+9cRFGkPbWjVn3zd/jmgw/x0UfdeCoi3Bx3Ozp/8RMcLZYdyFr0/OoHaH5SCUiVp+9OFmFVbT2W5/qLZ+mv7c/wkuctTn6Lc5ukL40Y+uJHeLVItfcCuj//FMdkpzvtZVz/g333VtrQQ7++SDnHfQkDv/sRDoXaW4CmB/+Bbw+8jKeLFiBV+zO8fmxj9gvv4uOf3MZm7biD2EsmtIla/zny7qe0bxu7rR0pL2Hi4tmPJSU87XMr7dn6KXkqTFg8f7sd8911eP37/xO7ZmXhmYE/4f6rRdEFnNjW5z2W5rW48x6D46qF9b+jr2b8oihqd/5pPPjD+9hhfA9IPkMKADJABsgAGfBi4LEVz6rDTloTrn35fRyI/Il3dvkF3PnBl/jJz3+K9z/6I77XsyP6CiqvATqz9mLkd5/i9ZXhHw15iWdbe142/dLj7Tyruimbr+H7f/ovjB6JHU0Ii6jYD9TCP5r8BEdLlGD1Pn/rt/Ms/fQTQ97i+XOcWSPiOXYUJCSeP9PF874Ji2fHLcT6U/8DH372F/wy9ENL9WO98NETNYbUZfvwxjsf47uf/Rt+/otPcf14Vei4UFg8R36c+Ufgg9Nrxgky8UGioc3nfnPk109p2zYPtnakvISJi2fFixdL4SM5trmV9mz9lDwVTpZ4jjfvqq1E+QzXUUe6AojnLx9gO8XzpN0zOiOMU3SQATIwnRl4rMSzU1CP1punoucQw+L5B2g2zykXn8boJ1/DtlzvnSWZtPAPgP4vPv3sT/gk9PkLfhnZeQ7cXpxdcmlLhfHEs5O6Es0f/BFv97+D73z6LrZGxhDe1fwEry0eP6Zw3j/h9ZUiZhdh5fMvYllo51mJoc9wqjSSl9qE4d/HFhyqT35iKFFx4rgrQsLkr9vVDzcLsXTf1wMd2xAf2friFL2Bv/nNh9i7ZG7oXLXj7kL/b2PiWeqqs6xz1l/B13//D2heoBYVsWMb2dvfwj/84gG2zx3vP6mfSGgTtX5zpNs2+yl51rGPO/O8EjvOnkelxnzi4lntPHux9BiJ5wDzniifyteOm4sX3/lPvLk/9psBmQMJnTVX8d2fXsMaimeK5wS+34UfhhSGZGBmM5C0eHbcbKSkzw6do12vfjB4aWso7qYqUeOdFwVu9Vm89fc/QV9j7Ec9TvoOXP757zGyby2yMp/EisP/C5/8sA9P63+qT30azR/8Djcbl47/0rfZTJ2H2fOLMU8+K8/jfRHPAdp7wmIzOgbLl2488fxk87fx47/rREnafDx34/f4aKAWs6Jnnv+Ad0+WIydjNuZsbMf1b/Vhc+hs70KoM8/hNzLkIb9qBN/+zQeoDZ15no+6t/83vtX1AubOysfil7+Oj38SPuoi/cw/8hF++f4pFM4Kz5f+hoFkxEnWxjdw+wd/wD/+4pd4q3UIt78MfmzD1hdHnWf/7Xfx6sr5cDMWYsXue/jw92Hx7Lhr0Xz/I1xoeBqz0rIxa0U7Rr/4CPvmjxXP6jxyzd0v8f2RXaFdaRl7sqFdPKuzxF5z5N1P6YN17PK2jYs7Ym/b+PwBtmvHT5ac/jF+/t5xzLOezbYda/DrZ3zxbO9n/Hs6ZWM3/tfnf8Bbh1ZH783QmWePYxt+8y4+S4ZPVXdZ26f48Z09oXtLbOlh0YmP8dP7hxJixTY+sZlsntRnOLMfxJx/zj8Z+GoxMAHxrH6oNvZNDurNDt9qXRf5EZs9TwBJ3dKHD//5T3j36Ni3bcze3I4bH32Jn33xF/zgb9/FntL82IPYzcai176LH31wCk9adoy8bEqbKjSPbfi1p8oHsTnGvnpXtcd7nkNvg/jsc7RvyguNyZl/CG/+6nOc3zIvdJ2yOPxGjR//9i/45OPv4nzdyuiP+1KW7om8bUO9jeJv8UbNiujbL54oasD5b6i3dPwrfvi9v8YrG8fuuDmF9bj0nS/xT38EfhU5DuHkvIY35V3Uf4y9l/rjvhcgbzPw+9O+jNlx9+F6gB8MRsvb+uI+iY2t3w4d2/j5Z7/Em6e6cO2fYzvP87b34v7H/4J/+vI/8Ok/fYqbLc8iM7TgiO08K/tO4Su49dmvcbEyxoy0m2hoE8/Kht8cefVT2rbNg8pzS9R7nj/HJ6E3jXwbrdvD73mO1duFix9+gU+/DL8dJTRHPvPn188gc2vrZ/h4kP897W7qw9998WeMHo0dn/EVzz7zPlE+nfwDuPnZ5+ipLYndJ5HFbvqqVrz7i89wdmNi/yjFNj6Zo2TzpD7Dr9aDk/PF+SIDM5uBpMUzwZnZ4Mj8p6+6gm/9/q/xvGVXVMowJCuPgoHs9efw9s/+BR8O7sXcyGJ7Zct38P3P/wk9L62M+3uJR9Fntsl7hQyQATLw+DNA8Ww5ekFw/cF1clvwVmTX+uef/Rw3Xtsceu8y/ebvN/pn6v3jzFqOjc9tweyIeF5U/hKWz0tsx5nzNvXzRp/T52SADDzODFA8UzxHj8U8zqCyb/wiJQNkgAyQATJABh4HBiieKZ4pnskAGSADZIAMkAEyQAYCMkDxHNBRj8NKh33gipsMkAEyQAbIABkgA4+WAYpnimeuNMkAGSADZIAMkAEyQAYCMkDxHNBRXOU92lUe/U//kwEyQAbIABkgA48DAxTPFM9caZIBMkAGyAAZIANkgAwEZIDiOaCjHoeVDvvAFTcZIANkgAyQATJABh4tAxTPFM9caZIBMkAGyAAZIANkgAwEZIDiOaCjuMp7tKs8+p/+JwNkgAyQATJABh4HBiieKZ650iQDZIAMkAEyQAbIABkIyADFc0BHPQ4rHfaBK24yQAbIABkgA2SADDxaBiieKZ650iQDZIAMkAEyQAbIABkIyADFc0BHcZX3aFd59D/9TwbIABkgA2SADDwODFA8UzxzpUkGyAAZIANkgAyQATIQkAGK54COehxWOuwDV9xkgAyQATJABsgAGXi0DFA8UzxzpUkGyAAZIANkgAyQATIQkAGK54CO4irv0a7y6H/6nwyQATJABsgAGXgcGKB4pnjmSpMMkAEyQAbIABkgA2QgIAMUzwEd9TisdNgHrrjJABkgA2SADJABMvBoGaB4pnjmSpMMkAEyQAbIABkgA2QgIAMUzwEdxVXeo13l0f/0PxkgA2SADJABMvA4MEDxTPHMlSYZIANkgAyQATJABshAQAYongM66nFY6bAPXHGTATJABsgAGSADZODRMkDxTPHMlSYZIANkgAyQATJABshAQAYongM6iqu8R7vKo//pfzJABsgAGSADZOBxYIDimeKZK00yQAbIABkgA2SADJCBgAxQPAd01OOw0mEfuOImA2SADJABMkAGyMCjZYDimeKZK00yQAbIABkgA2SADJCBgAxQPAd0FFd5j3aVR//T/2SADJABMkAGyMDjwMCUi+eUTa0YvDmKwZvvYej2AwyF4qPoaCxNesXjuCtRd+U2XizJStrG4zAZqg9OdgX2995FS9WS6FgWvDgU9tmtB7jYtCaaHrTPzvLX0Bnx+fDwcaxwv/p+Cjp2luMXLRkgA2SADJABMjCZDCQtnh13NlLSkhdhjrsRe4YHUD0/eRviiOkknmVMtnBx042kxLPYcuY34SzFc8KLD/EfQ375kgEyQAbIABkgAxMQzxXYe6UT9VvXIicJEe0lnlPmV6Gx7Tp6Ru6ju+si6koXRsVO5vLdONL5JnpvjqK3rw/7Kpcjxc2CKZ6d3GocHhhB3bLcaF0/2FNWHMSF6+/gxPaSseULKtBwZgTdI/fRdfkCdq5ZFM1PKdyKxtYR9Iy8g66L51C9oiCU5xS/goutJ7G78y1cOlSLitfuoKfnNNbmqX6uQX3vCPbWHUVr331c7buKpg2L8URoDPnYckrtyI9i6NYDHKnIi7YlffcUz/kVqD+j+vI2Lne0oXLpvHF1lQ1TPHv52iloROvIaaxKDy9sHPdJPHv2Ppo3hP3pVU/6yZBfLGSADJABMkAGyMB0ZWAC4jkbsxZXobZlCF09naivWoeciNgK4iybeHbcAmw+dgcttauQmZaL3PUncOHaKaxMV8KzEJVtozi2YylSU3OQWVKHvS27sSSUFzu2oWyUtdzF+T3rkBr0eEJRHY6c78GeTUVR0ansbDrxNtp2b0BORi5mrz6C9pE3sHaW6ksBNp98B60NZcjOyMPczafR2XcUxalZCInnnqMozqtAc38/ahYX4ZlTozj8TF5EPN9H2+5yzM7IxdxNp9E5fBJPaX5z3FxsOhFcPKu+bDx+D6d3rUGWsrnhFC52H8Qiy9h18Rwag6evi1Fz8R72rM4JLwiyn0fLSDvWZ0XG7lEvyLyzDL9MyQAZIANkgAyQga8yA0mLZxm042Yjs6gKNUf60XmlDevzgx3DsIlnsSmh45Zj/0gvquYp0ZaP8tdH0b5/KxbOy4ebGmtH33nOXHcSXT0tKJkVyxd7iYSOuw6NA0N4fqHsvhZiUdkWzM9WfTHzVD+voio/Ip7PNWCOW4KaS+exISMLK/bfw7Gqwoh4voW6yNlsGd82zWeJi2fVlz5UF0o/N2DPcDcq88aPXxfPpi+kL8rXKm/BS9dweW9ZaFc8bdNZXD1Zg0ybINfmyLTJa345kgEyQAbIABkgA9ONgQmLZ+WQlDmrsLmxHee6L6K8YLxosznNJp4ddy6W1rajffC+9qPCXmyL2HTnb0XdsR50DL6LvoFBHNyxBhnRYxvhHx+qIw+ttcXRHWRb20HSbP2Temaefh3aefYVzyOoXSxCd/y578TFs7IR++Fl+MeYvdaz5Lp4judrNY4LPWoHOwerXr2Hlqonw7vQceZIfMSQX5ZkgAyQATJABsjAdGRgQuI5JW8typsuoONqPw7UPovCWcEh0QWnONaZ9xLOXLuALQW5kXPA5dg3EhPP0XJuDmYV78PpGz14dq7aCY4d28goPYHLA60ozQkm4sWmGYZ3l4dRE915LsCCtZsf053nXui71zKW9NX7cKhmbciXKs1Z9DLa+45gqVpwxPG1k6rOZw+jZlEZdvd3o3JuRPDHqSdtMwx+L9BX9BUZIANkgAyQga8OA0mLZ/Vn/r1X+9G8sxIFCYhmgcMqngsa0DrSiaqF85CSVoAny4+j/UZYPDtuCSqPdaF+02Kkp2YjfUEDTlzvQkXuWPGszvKuOXwXnQfLQ7vS0p5vWPQSWi71Yd/m2A8ClR115rm1sQw5GXOQ8/RhnLvWjjL9zHP9WmSlq7PLp8aeefbdeX4HrY3hM895G08ldOY5v7YPfa/XjvmBZvjM85s4XrMSmek5mFXSgFfPvoKStCw4S/ajY6ADlUX5cDOL8PS+IfQcqQodv3B8fK18pY7jLN93F6cPt+FCeyNyI0c24tXz9TPfqT3hv4jQv1+dL1fOFeeKDJABMjA9GZiAeM5DelbyTrGKZzcfxTs7Qsc2+gav4cgLL6N5OLbznFPajGNd99B/YxS9/YM4tH010qLHNmLveXbmPIdDgzfQsHL8GytsIKeseAXtw/dwvNp820Zl9G0b3Zcvom7tougubvhtG+G3gnRdMt624Suer6Fp51G09t9Hb19v7G0bs7bjSOSd1+roydCt8Js3ul7eEBVczpxy1LffCb1tRB3PiOblV0betqHeUNKJXevlDR55WFh1Eqev3kPfyB2cO74fyyNnodUZcj9fKz+llB5Hz6330LYz5pcg9Ww+Zlry9wp9R9+RATJABsgAGXh8GEhaPHMSE59EeVVdbdHEjpTQ94n7nj6jz8gAGSADZIAMkIHJYIDieQqPEkTFc+QHg5MxgbTBLwIyQAbIABkgA2SADEwdAxTPUyieCfbUgU1f09dkgAyQATJABsjAw2CA4pniOXqm+mEARpv84iIDZIAMkAEyQAamEwMUzxTPFM9kgAyQATJABsgAGSADARmgeA7oqOm0YuJYuANABsgAGSADZIAMkIHkGKB4pnjmSpMMkAEyQAbIABkgA2QgIAMUzwEdxdVZcqsz+o1+IwNkgAyQATJABqYTAxTPFM9caZIBMkAGyAAZIANkgAwEZIDiOaCjptOKiWPhDgAZIANkgAyQATJABpJjgOKZ4pkrTTJABsgAGSADZIAMkIGADEy5eE7Z1IrBm6MYvPkehm4/wFAoPoqOxtKkJ81xV6Luym28WMJ/e62vIsP/0TDm497ePhx4bhXS3ZntJ8ddj6bBB+g7th0ZbhbC173YVhD2S8r8bWhqu46ekfvoutSOHSsLA7GZMr8Kja3X0XP9Prq7OrGrbDGeiPjay2a47SHsWBBu23HLsW8k3Jd485dSuBUNrSPoVv3s7EDt6gWhfjruYlSff4ChW+o+k89t7Fo+s+ddvzcYT263hX6j38gAGSAD2UhaPDvubKSkJf8wdtyN2DM8gOr5yduQCaR4tt/M+r8Dd9wcZC6px/FrN7Cz2F5e/Dndw7BgvYeevg5syB4rnh13PspPvYMzL61FVkYu5m48iUsDLShJ9efUcQtQfvI+ztSvRXb6HOQ8dQhvjLRjfci+t8344nkEtYtVH8fOn+MWovzkO2htLENORi7mlB5F+3ArSmepsko8v4WmVf59nu7zzPHN7Puc88/5JwNk4GExMAHxXIG9VzpRv3UtcpIQ0V7iObR7F9n16+66iLrShdFdv8zlu3Gk80303hxFb18f9lUuR0po53DszrOTW43DAyOoW5YbrevnwJQVB3Hh+js4sb0kWl6E5966o2jtu4+rfVfRtCG2k1jW8gDH9jThSPfb6B0cwZGdZciUXcbCrWhsHUHPyDvoungO1SsKonafKKhAw5nIbuHlC9i5ZlEsL78C9WdUvbdxuaMNlUvnRfO8xq7G5ZUnY1DiS5VTAq+i9QFaKvPDdpNsT+142sbnJwRV+34+exh+8ZrzcD+70Xz4Bo5WFIzZeXbcMjT2D+H5heKz8E5w1Tx/Ieq4K1B7+S7qV0i9Qiwqq8TC2UrMetv085nf/I23uQhP1+zC8jkUz17zznQ+SMkAGSADZGAyGJiAeM7GrMVVqG0ZQldPJ+qr1iEn3V9g6B22iWcl7jYfu4OW2lXITMtF7voTuHDtFFamK0FQiMq2URzbsRSpqTnILKnD3pbdWBLKi4lnZaOs5S7O71mH1KDHE4rqcOR8D/ZsKoqK1bBwuY+23eWYrXYgN51G5/BJPBUZoxKCPa1NKJo9BxkL69AyfAM7l6h+FmCz2hFsKEN2Rh7mbj6Nzr6jKE4N52068Tbadm8I7RbOXn0E7SNvYG1ot7AAG4/fw+lda8I7nhtO4WL3QSwKLQ78xu6Xtwb1vbJzORtZSxtx4toIaovCfUmuPb/xqeMQ9iMIau79fDbZftFZM+NhwXoVVZtew4UztcgKHeOQoxJj/yJi49S0p67VX2KW7buFnvYjKFvyJFyNPdOGfh1UPCv7Y+dvbD/1PnHnmQ8HnQfGyQMZIANkYHIZSFo8y0Q4bjYyi6pQc6QfnVfasD4/mIDWBYTYMkN1/nP/SC/Urp/j5qP89VG079+KhfPy4Wp/RtePbWSuO4munhaUzArWD7NNuQ6L51uoi5yjlr5si4xPCcHXt4d3xR13DsqO3sehLXPhuOvQODB253L/yFVU5asxmHlqd3IL5of+tK/y+lBdKDuXG7BnuBuVefHG7ucXJZ4jZ55vvYfh4UHsrVgRWlSE+5JMe+YY1BzJ+OKL52A+m7hfZB5tYViwKrG8Ci9e6UJFnup3fPHsuBVovi5niCW8hpqiyJxlFGNdYzveGHgXVzvbUVO6IHTm2WRdv44vnr3mL554Ns48n2/CPE3Q2/zCtMn9cqU/6U8yQAbIwPRkYMLiWYGRMmcVNje241z3RZRHfnQVDxhdQEhZx52LpbXtaB+8r/2oMCxqVBl3/lbUHetBx+C76BsYxMEdayI/+FI7z2GRMXTrAVpri6M7yGI70XD8n8zHipXQEYSq8T8kM8elX+txsz/hvNiP+8I/9OqNngn3Gru/X2I7z08saUbHcFvoTKyqk2x75hj0az8hqNoM6jPdN8n2U7dhxmPiOQuL6kdwovo5NA7EF8+mHa9rJy0fCytO4fy1TpSHFj9j2QnqszEMWufP/psB7jxPzy9rL96YzvkmA2SADEwtAxMSzyl5a1HedAEdV/txoPZZFM4K3nldQMikO/NewplrF7ClIDeyYxd784CUUaH68dSs4n04faMHz85VO7OxYxsZpSdweaAVpTkPf+f5mFU8++3Mqrxh1ETP0xZgwdrN2s5zL2RnWx+vHjfH7peniy/HLcK29lG8vn1x5Pyz6kvi7Y3fPdd3nsNi/QU5Y51aieYb3ajMDc+Ft3h+uH7RfaTiunh2Fu9H+7k2HOwR8ex9Ptm0o187mSuwZtsmzI3s7ioB+1z7KPavU3x623TctWjoG4ntXhgQGnAAACAASURBVKc+g+br8heH2OJn/PyZNhejtK4RT4XEOn8wqM8N48G/l+kr+ooMkAEyEJ+BpMWzOsaw92o/mndWoiAB0SyTYhXPBQ1oHelE1cJ5SEkrwJPlx9F+Q0RNCSqPdaF+02Kkp2YjfUEDTlzvQkXuWPGszhyvOXwXnQfLQ7vS0p5vWPQSWi71Yd/m2I/3wsJTvc0gfOY5b+OpcWee7eI5cia4fi2y0tVZ6VPjzjyH35AwBzlPH8a5a+0oi555fhPHa1YiMz0Hs0oa8OrZV1CSpsbnN3a/vJj4UuPP3HIOfT2voShy/nrj8WTa8xvfPKxveQtnQ2e68zDvmbPo6nk1dG5bte8tngugzjxPpl/85nuMeHaXoebSPfQMC2fyZow1ofnL2xDwbRupSgTfRvMzy5CRNhvZxbvx+sgAqheo+fO2GToj//p9tDWWIUudkS9vQ1f/0dDbPfTFz/j5i7xto0F728YQ37bhN+/Mi/9AoI/oIzJABshAfAYmIJ7zkJ4VvwGvSbCKZzcfxTs7Qsc2+gav4cgLL6M5ImqUnZzSZhzruof+G6Po7R/Eoe2rkWZ728ac53Bo8AYaVuYFOr6RsuIVtA/fw/Fq820b19C08yha+++jt693/Ns2LDvPqp/ht1HIe4LNt21URt+20X35IurWLoq+C/iJ/MrI2zYi7wleH3u7h9fY/f0yVjw7GZuwt/9tNG+YG/ZLku35ji//GewKvTHkHXRdaMOzJbE3hniJ5xAjBZPvl5BdywvPdfGsyhTWDmD4dlg8q+vwO5lvJPye58ySXWhuv4mekXdxtacbTc8si/5w0M+mesNM09lIe50dqFk5P/LXAf/5S5m/FQ1t4Te3XLncgVp1xjq0s873PHvNPdOT/86m7+g7MkAGyECYgaTF83R3YHTXL/JjsOk+Xo6PX4pkgAyQATJABsgAGYjPAMWzZWdSgRMVz5Hzu4QpPkz0EX1EBsgAGSADZIAMTHcGKJ49xPN0n3iOj19uZIAMkAEyQAbIABlInAGKZ4rnQOfCeXMlfnPRZ/QZGSADZIAMkIHpxwDFM8UzxTMZIANkgAyQATJABshAQAYongM6iivH6bdy5JxyTskAGSADZIAMkIFEGaB4pnjmSpMMkAEyQAbIABkgA2QgIAMUzwEdleiqhOW5kiUDZIAMkAEyQAbIwPRjgOKZ4pkrTTJABsgAGSADZIAMkIGADFA8B3QUV47Tb+XIOeWckgEyQAbIABkgA4kyQPFM8cyVJhkgA2SADJABMkAGyEBABqZcPKdsasXgzVEM3nwPQ7cfYCgUH0VHY2nSk+a4K1F35TZeLMlK2kYiq44FLw6Fx3DrAS42rZmSNhPpH8tyFU0GyAAZIANkgAyQgYfDQNLi2XFnIyUtebHquBuxZ3gA1fOTtyFQTLV4lnYXN92geA64ShOfMXw4NzL9Sr+SATJABsgAGZgaBiYgniuw90on6reuRU4SItpLPKfMr0Jj23X0jNxHd9dF1JUujO7sZi7fjSOdb6L35ih6+/qwr3I5UtwsmOLZya3G4YER1C3Ljdb1AyplxUFcuP4OTmwvGVu+oAINZ0bQPXIfXZcvYOeaRWPyvcRzMmNQ/fMaX6jv+RWoPzOCnpG3cbmjDZVL50X74luP4jbqJz8GmDc1Xzj0M/1MBsgAGSADX3UGJiCeszFrcRVqW4bQ1dOJ+qp1yEkPvotsE8+OW4DNx+6gpXYVMtNykbv+BC5cO4WV6UogF6KybRTHdixFamoOMkvqsLdlN5aE8mLHNpSNspa7OL9nHVLdgP0pqsOR8z3Ys6koKrSUnU0n3kbb7g3IycjF7NVH0D7yBtbOitm0iefkx+A3vgJsPH4Pp3etQVZGLuZuOIWL3QexKLRw8K73VYeT/ecXLBkgA2SADJABMvC4MZC0eJaBOG42MouqUHOkH51X2rA+PyYupYwttIlns5zjlmP/SC+q5inxnI/y10fRvn8rFs7Lh5saa0ffec5cdxJdPS0o0USuaTfIteOuQ+PAEJ5fGG5HifdFZVswPzvWrk08m7aDj8FvfKovfagulL5swJ7hblTm+fvF7Auv+QVEBsgAGSADZIAMkIGJMTBh8awmIGXOKmxubMe57osoL4iJS7/JsYlnx52LpbXtaB+8r/2osBfbIjbd+VtRd6wHHYPvom9gEAd3rEFG9NhG+MeHQ7ceoLW2OLqD7NcHvzxb/8zyNvGc7BiUbe/xqfPhsR9Xhn9w2Rs9L+5Vz+wvryd2s9B/9B8ZIANkgAyQATIwIfGckrcW5U0X0HG1Hwdqn0XhrOAOtYlTZ95LOHPtArYU5OKJkCgux76RmHgWYB03B7OK9+H0jR48O3fsmeeM0hO4PNCK0pxgIl5smmF453kYNdGd5wIsWLs57s5zsmPQ2x8/PrXz3IttcXb1zXq6TcaDs0lf0VdkgAyQATJABsiAFwNJi2d1HGHv1X4076xEQQKiWTpiFc8FDWgd6UTVwnlISSvAk+XH0X4jLJ4dtwSVx7pQv2kx0lOzkb6gASeud6Eid6x4VmeO1xy+i86D5aFdaWnPNyx6CS2X+rBvc+wHgXLmubWxDDkZc5Dz9GGcu9aOMu04SH5tH/perx3zg0kn6TH4jU+deX4Tx2tWIjM9B7NKGvDq2VdQkqbG7l3Pd8z8IeGE/zpB//KLlQyQATJABsjAzGNgAuI5D+lZyTvMKp7dfBTv7Agd2+gbvIYjL7yM5uHYznNOaTOOdd1D/41R9PYP4tD21UiLHtuIvefZmfMcDg3eQMPKvEACKWXFK2gfvofj1ebbNiqjb9vovnwRdWsXhXbE5UZx5pSjvv1O6O0f6ihF18sbQmezkxmDsuk1vlB7+ZWRt22ot5B0Ytf6xdG++NajSA7EgMwpw+TvafqOviMDZIAMkIGZwEDS4nkmOIdj5JcAGSADZIAMkAEyQAbIgM4AxTN3ZrkzSwbIABkgA2SADJABMhCQAYrngI7SVxyMcwVKBsgAGSADZIAMkIGZyQDFM8UzV5pkgAyQATJABsgAGSADARmgeA7oKK4uZ+bqkvPOeScDZIAMkAEyQAZ0BiieKZ650iQDZIAMkAEyQAbIABkIyADFc0BH6SsOxrkCJQNkgAyQATJABsjAzGSA4pnimStNMkAGyAAZIANkgAyQgYAMUDwHdBRXlzNzdcl557yTATJABsgAGSADOgMUzxTPXGmSATJABsgAGSADZIAMBGSA4jmgo/QVB+NcgZIBMkAGyAAZIANkYGYyQPFM8cyVJhkgA2SADJABMkAGyEBABiieAzqKq8uZubrkvHPeyQAZIANkgAyQAZ0BimeKZ640yQAZIANkgAyQATJABgIyQPEc0FH6ioNxrkDJABkgA2SADJABMjAzGaB4pnjmSpMMkAEyQAbIABkgA2QgIAMUzwEdxdXlzFxdct4572SADJABMkAGyIDOAMUzxTNXmmSADJABMkAGyAAZIAMBGaB4DugofcXBOFegZIAMkAEyQAbIABmYmQxQPFM8c6VJBsgAGSADZIAMkAEyEJABiueAjuLqcmauLjnvnHcyQAbIABkgA2RAZ4DimeKZK00yQAbIABkgA2SADJCBgAxQPAd0lL7iYJwrUDJABsgAGSADZIAMzEwGKJ4pnrnSJANkgAyQATJABsgAGQjIAMVzQEdxdTkzV5ecd847GSADZIAMkAEyoDNA8UzxzJUmGSADZIAMkAEyQAbIQEAGKJ4DOkpfcTDOFSgZIANkgAyQATJABmYmAxTPFM9caZIBMkAGyAAZIANkgAwEZIDiOaCjuLqcmatLzjvnnQyQATJABsgAGdAZoHimeJ45K8302Uhxs0LjddNnz5xxk3HONRkgA2SADJCBSWOA4pkwTRpM+qrscYo7mcuw4eXL6Dy7G3Mj4vmp/TfQ3rIPK+bmTPvxP05zwb5w94YMkAEyQAa+6gxMuXhO2dSKwZujGLz5HoZuP8BQKD6KjsbSpEWM465E3ZXbeLEkvKs4GZPyMPop/SqsHUD3/o3jxptSuBUNrSPoHrmPrs4O1K5eECqz4MWhsM9uPcDFpjXj6im7TnYF9vfeRUvVEmu+tJ1I6NVPJ60IpXt60XPrPXQ0rJq09vz6luz4nNSlqDh9B+0Hd6AwO/aF5aQvQPELF9DVfQIrZ08eN35jYF7M//QFfUEGyAAZIANfVQaSFs+OOxspacmLDsfdiD3DA6ien7wNcfrDEM8x25PXT7FpE6WOW4jyk++gtbEMORm5mFN6FO3DrSidFfPP4qYbnuJZbE9maO/nUlScuYPzh2tRvv/GlInnZMeVufksei7sRWFqzI9iy3Fz8fQrd3FBLUgiO9KSx5Bf6mSADJABMkAGyICNgQmI5wrsvdKJ+q1rkZOEiPYSzynzq9DYdh09I/fR3XURdaULozubmct340jnm+i9OYrevj7sq1weOsNqimcntxqHB0ZQtyw3Wtc2eElLWXEQF66/gxPbS8aV9+rnE/kVqD8zgp6Rt3G5ow2VS+dF63r1M2XzWVy78/6Yz/Dtu6hfkQXHLUNj/xCeXxgWeY67CE/X7MLyOTHRZxPPjpuPLafUTv4ohm49wJGKvGg/QuPz6KfjrkF97wj21B1FW/99XO3twe4Ni0Mi0r+fy1C6ZRUy3Syo/gTdeXaKX8HF1pPY3fkWLh2qRcVrd9DTcxpr88Lj85p3v/H5jUGN3XFzsPbI13Byx6KxPtGO6jgrDqPryitYSPHs6SO5TxjyIUIGyAAZIANkIBsTEM/ZmLW4CrUtQ+jq6UR91TrkpMeEXjzn2kSp4xZg87E7aKldhcy0XOSuP4EL105hZboSl4WobBvFsR1LkZqag8ySOuxt2Y0lobzYsQ1lo6zlLs7vWYfUoIKoqA5Hzvdgz6aicQLCq58bj9/D6V1rkJWRi7kbTuFi90EscuP0MzUbKek5KKwbQPeBTaG4ula7nrZ2TB/axLOUUbuom06MFc/KF979VOL5Plp3l2N2Rh7mlreiS/k6LQuOTz+lPRUmLJ57jqI4rwLN/f2oWVyEZ06N4vAzefCbd2nPPj7vMah6jrsAW98YxYH13l92Tn49zlw/jVVBWdGEt/SNobd/6Rv6hgyQATJABqYbA0mLZ3GE42Yjs6gKNUf60XmlDevzgwnoIGLRccuxf6QXVfOUuMxH+eujaN+/FQvn5cPV/gyv7zxnrjuJrp4WlGjHHaSvyYS2fjruOjQO9KG6MDxWx92APcPdqMzz76e0bz8OEf94SOLi2a+fSnjewovLZAzPoPn6VVRp82frp4xBhQmL53MNmOOWoObSeWzIyMKK/fdwrKrQsmCJzbu05y2evcegdu+3nfsa9q31ZtLJq8PJm20opXgeNw/ie4Z88JEBMkAGyAAZiDEwYfGsnJkyZxU2N7bjXPdFlBd4CxXd8XZROhdLa9vRPnhf+1FhL7ZFbLrzt6LuWA86Bt9F38AgDu5Yg4zQrq3aeQ7/+FAdXWitLZ40IWDvpxK6sR87hn8A2Rs9v+3VTxm/TZTa2pHyEiYunr37KUceaheLeC7HvpGYr1Wbtn5KX1Q4WeLZcf3nXbXlLZ5H4DUGx12Ibe0BxPONVopn7qhP2neGfo8wHnvY0Bf0BRkgA9OFgQmJ55S8tShvuoCOq/04UPssCmcFB8MmFp15L+HMtQvYUpAbOcowXtApx6uzrLOK9+H0jR48O1ft9saObWSUnsDlgVaU5gQT8fEm0trP0M5zL7Zpu7Q2O2Y/pYxNlI4/87wYpXWNeCpyJljVTVw8q51nez8fK/EcYN6TE8+zsb5lFEcrYufRZQ4kdBYfQEfPIRRx55nikQsIMkAGyAAZIAMBGEhaPKsjFXuv9qN5ZyUKEhDNUdFieduGU9CA1pFOVC2ch5S0AjxZfhztN8K7oY5bgspjXajftBjpqdlIX9CAE9e7UJE7Vjyr87NrDt9F58Hy0K60tOcbFr2Elkt92Ld5/A/L7OJZnSV+E8drViIzPQezShrw6tlXUKLOC/v0U/qQU92FgVN1mJOREzr3HD7zHHnbRoP2to2hsW/byK/tQ9/rtdYfaNrFpV8/wz8Y9Nq1VX219zMbT6SF+710943QKwbVue0U7RjNEyX7cG7oLlq2LY3ehKEfDHoc2/Cbd/GZfXzxxzB/5yB6Dlci3UMcz3u+B1ePbQ/9AFLaYhh8EUxf0VdkgAyQATIw0xiYgHjOQ3pW8sDYRWk+ind2hI5t9A1ew5EXXkbzcOwoQU5pM4513UP/jVH09g/i0PbVSIse24i959mZ8xwODd5Aw0rjzRMeq4mUFa+gffgejlcn8raNysjbNtRbQTqxa334TRUKIK9+ClzOnC1oOH8X/bceYPh2bHwp87eioS38nucrlztQWxp+z3OsXjnq2++E3jaijop0vbwBzqztOBJ5V7Y6sjJ0K/zmDZUXqpdv72eQnWdbPx13PZoGH4x5Y4h6g8jZ2pjvUpY1o+P62zhRHTs+4yueXe959xtfoDHMrsKhwRHsXbdg3OvoUhftwrH+Eews4T9KEcYYJv+dRt/Rd2SADJCBmcFA0uKZgMwMQKbDPGcU16Ol9x7aDzyL7MgO9ILtl9A5NIw9GxdH/2X3dBgrx8D7kgyQATJABsjAw2WA4tljN5rgPVzwptq/TsYilKx+Ono8Y+7ycsyfzR3nqZ4Htje97ivOJ+eTDJCBmcgAxTPFc/Rc8ky8AThmfvGTATJABsgAGSADiTBA8UzxTPFMBsgAGSADZIAMkAEyEJABiueAjkpkRcKyXMGSATJABsgAGSADZGB6MkDxTPHMlSYZIANkgAyQATJABshAQAYongM6iqvH6bl65LxyXskAGSADZIAMkIFEGKB4pnjmSpMMkAEyQAbIABkgA2QgIAMUzwEdlciKhGW5giUDZIAMkAEyQAbIwPRkgOKZ4pkrTTJABsgAGSADZIAMkIGADEy5eFb/ytlcidnSpIwtz5Ym5SVUZbw+UuarGgYZf7yxmTbMa1XfluZlN15Zr3yvdK92vmrpanwyRgm9xiBlbaFZx2bLlmbWS/TatGlee9kLWs6rvko3bZjXtjKJ2DPL2uwn2oZpk9fTc9eJ88p5JQMzm4EJiWf1sIn3MQGzPaBsaVLPlueVptIlT0JlxxZ33DWo732AoZujGLx5H12dHahdvSAk7FM2tWIwlP4ehm5LmVF0NJaG8t0F1dhz9jp6Rt5B16V21DwdrqfaSjbPSStC6Z5e9Nx6Dx0Nq3wXGLbxiL9kvKqM+ZE8PTTj6lo+ejt6mp/dROzZ7Es7X/VQ95GMRR+vHrflS5oKvcqabejXEtftBI1LXRWadWxpUkbP84rrZVUZ86Pypa6EeprUl1Avo6f52U3Ens2+tMMw9l1BX9AXZIAMzCQGJiSexVHmA8a8lnIqNPPMa72slFdl5CNpZjkzXbdri4fF8zXULMqCk5qLuRtO4uLwKaxMy4oKBsfdiD3DA6ier6ctxXPtb+FEbSmyMvIwt+wYzg+2ojQrC46bfF7FmTs4f7gW5ftvWMWzPj4Zj4TJ+ELqqtD8iD1butTTy9j6JvmSZ9oyr/XyXnHHnY0UbX68ypnpU11Pb1/3lx5XZWzXpl/kOp5N3ZYe1+slGrfZsaXpdiXfDPUyEpcy6toWlzQVmh/dhp5n2tKvdXtSX0LdhldcyjKkSCADZIAMzGwGpkw8mw8kBZ48zARC89osI/liS+pJKPlST8qZocrXxXP4ehP2jvSiap4ulC3iOX0bDt1qx/qMcDnHLUHNpRuoK86Ck2yeuwylW1Yh083C4qax4tnsu9+1+EHGL9eqjhmXNAm98r3SpZ4eSlzqSGimx7uWembouBXYe6UT9VvXIicBET3V9fR+62PV43oZiXvle6VLvYcVSrsq9Pqotr3ybOl6X1W+XNvikiahWTZeuuTrocTFloRmerxrqcdwZj9AOf+cfzIwMxmYMvGsAJMHkh6quPkRGKWceS3pEpr5eltecV08O2l5yN90EheuvIoiTZRZd56znkfL7bNY64p4Xozq83dRvyILTpJ50n8VmuJZz5PxmqFZRuXbPqqcWVeuxYbUk2sJpVy8UMrrodj0C/XyXnHHzcasxVWobRlCV08n6qvWISc9tth5XOr5jdPM0/ts5unXejkV1/O84madoNc2e1JX5dniZpqUk1DyVWizL2mSbwvFhl5W0mzlpW0z1OtIXGz6hVKW4cx8WHLeOe9kgAwIA49UPEsn9FAedCpNj+vXerrEVSgfvaxXfMyZ51vvYfjWLTRvXBgVBqqev3h+GrXt7diUZxPPieWptuTjJZ5lnF7jkfoSxisv+RImW0/V9/rYbKo0vzaljl+oRHRmURVqjvSj80ob1ufHF9DK3lTXM8dqjttvjInmmbbN60Tt6X3XbXnF9fJ+cb0fXrYk3QylrqR7tSP5eqjito/NpmnXdi31GMa+u+gL+oIMkIGZwkDS4tn2IPJKE2eqfBXXQ7OOX1kzT7dli5u25VqVHbPznDoHOSv24fRgF57RhJi/eJ66nWfxl4zfDM38eNe6r8QneqjbF1uJhqYN3b4trpcPEk+ZswqbG9txrvsiyguCiWdld6rrid9U235xm09saeIbW56ZlkhZqetVR0+PF5d8PVT2E7lWZaWO9E0Pbbb08mZ927VpQ7dvi+vlGadIIANkgAzMXAaSFs86NPLQkjTzWqXraRKXMEg9vawel7pmG/HSdfGsyjpuASrbRnFgfQwGq3hO9lyzTz29r147z3oZr/GrMn55YkOVkXIS6nkS1+1JuaChbsOMiw0zPch1St5alDddQMfVfhyofRaFs2Lz5Vd/qutJX9RYZbxmKGVsoZS15ak0M9+89qoXNF3ZE5sSt4Ve9qSuLd8vT8pLW+raLO91LelBQ2nLFooNWx7Tgt1z9BP9RAbIwHRlYMrEs3KgPJDMUJwr6XItoZluXtvKqTJeH1VeF8/qbQxZxQ04NjyE5xfGdjGt4nkCb9TwfktHNp5Iy0FKeg6W7r4ReiWeiqekZnmOwTY28YMZevlLlTPzzGuxJenxQtOmKh/0I215hY5bjr1X+9G8sxIFAUWzsjXV9aT/Mm65VqH4T0+TuJ4ndfVQyokdPc8rrtcJGle2pA099Ip7tW1L9+qDtGnLN/PMa6kj6fFC2zhUnSAfaSsUluzDuaG7aNm2dMyu+pgy2pGsaPpU17P1gWmJzRn9RX+RATKgMTBh8SwPquiDIUGBEK+e2JdQldfjZn1bni1tzJnnm6PoudqL5m2rkBb5IaCyaxPPKt1duB17zt5Az8j98e95TiLPcdejafDBuIf32dqScbDKWCTUxy9xlRfvo5eVuAq97Jrpftdmnm7frw2znHntuHlIz0p8JT/V9dT4xQcSyrjNa32Mfnl6OT0udSS05elpicSTtSn1JLS1qfLifaSeace8DlpOr6fHpb4exstXZVOWNaPj+ts4UV087j7VbZnxqa5nts/rxL9D6DP6jAyQAZ2BKRXP8kDSQxXXP3rnpJykmdeSrkKxoadJ3K+elHncQ9v4bGm2cfiNX2zoYTwbYk9CVV7qS109T9Ik9MuTMtMllLFKqMYlcQltaXqely/0MnpcytvSJC9IaKtvSxNbKs/Mt6VJeT0065l5YkdCPV/iug2JS6jKmHX1PLEhoV+elGHIhykZIANkYGYyMCHx7PWAsaXraRKXUODTr/W45KtQpZsfPd+rjF7HLP84X0u//fqol5F4kFB8pdtW9cxrPU2P6/XNdN2GGU+krFn3q3Stxuk1Vj3PLCN5tlCNX9J1X+g2bPl62aBx3abU8UqzpUsdFep9kniQUOqatsxrvX09rtc303UbZjyRsmZdXs/MhynnnfNOBmYOAxMSzwRl5oDCueZckwEyQAbIABkgA2QgGxTP2gFwAsEvBTJABsgAGSADZIAMkAE/BiieKZ7HHNPwg4V5/DIhA2SADJABMkAGZjoDFM8UzxTPZIAMkAEyQAbIABkgAwEZoHgO6KiZvsri+LnTQAbIABkgA2SADJABnnnmKouLBzJABsgAGSADZIAMkIHADHDnmbAEhoWrTe44kAEyQAbIABkgAzOdAYpnimeKZzJABsgAGSADZIAMkIGADExYPNv+mYAtzVylqDJeH7Osfi22JdTzbPGg5Wx1mcbVNRkgA2SADJABMkAGyIDOwJSJZ10oqw7ootYrrndU4omUNdsRG3oo/dLT/OIPu7xf28zjzUsGyAAZIANkgAyQgUfLwKSIZxGUImwlNCdXTw8aV+XifVQ7tjKSbvZDv5Z6eppf/GGX92ubeY/2ZqH/6X8yQAbIABkgA2RgUsSzgKSEpYp7CUzJ18tIWT007cm11NOvzXiQNvQ60q6e5hd/2OX92mYeb1gyQAbIABkgA2SADDxaBiYknnWhqiZSrs1QJlnS9bJB4zYbkqaHehumba9rs45uz4yrsg+zvNkerx/tDUL/0/9kgAyQATJABsiAzsBDFc+qIRGaIjr1a+mIpOnlJR60ns2W2JA8r2u9fb2sLS79seXZ0hItb7PBNN60ZIAMkAEyQAbIABl4PBhIWjyL4DRDNbGSFi8uwtIMBQ6bHVualDfbC3Kt12X88YCS88B5IANkgAyQATJABh5XBpIWzzIgEbMSqnQ9LuUmmi42zVC3b2tDyks581rSGfImJQNkgAyQATJABsgAGYjHwITFs2rAFKTmtXRCT1dxr49X+Xjp0hfdrtSRUO+DXl7y44ViO145yU+0vNRjyJuXDJABMkAGyAAZIAOPHwMTFs8iRiVUk6zH9Un3EpJ+5cWelPELJU/aNK/FluTLta2cXkaPq7IPs7zeFuOP3w3DOeGckAEyQAbIABmY2QxMSDybItK81uHyE51e9cx027WZJm0mmi71GM7sG4Lzz/knA2SADJABMkAG/BhIWjz7iVOVp3/MDuh5UtTGNgAAIABJREFUtrgqr9L1eua15NnSvdJs6WKHIW8UMkAGyAAZIANkgAyQgXgMJC2e4xlmPuEjA2SADJABMkAGyAAZmG4MUDynEurpBjXHQ6bJABkgA2SADJCBh8UAxTPF85jjMQ8LNNrllxgZIANkgAyQATIwHRigeKZ4pngmA2SADJABMkAGyAAZCMgAxXNAR02HlRLHwBU/GSADZIAMkAEyQAYmxgDFM8UzV5pkgAyQATJABsgAGSADARmgeA7oKK7SJrZKo//oPzJABsgAGSADZGA6MEDxTPHMlSYZIANkgAyQATJABshAQAamXDzb/lGJLU1WJrY8W5qUl1CV8fpIma9qGGT88cZm2jCvVX1bmpfdeGW98r3Svdr5qqWr8ckYJfQag5S1hWYdmy1bmlkv0WvTpnntZS9oOa/6Kt20YV7byiRizyxrs59oG6ZNXnOXjQyQATIw/RiYkHhWD5t4HxMa2wPKlib1bHleaSpd8iRUdmxxx12D+t4HGLo5isGb99HV2YHa1QtCq66UTa0YDKW/h6HbUmYUHY2loXx3QTX2nL2OnpF30HWpHTVPh+uptpLNS1u0fYzNHSsLx6wAbWMwx6b7TJU3P3p5L3tiQy9rpvnZ9apnS9f7oLcxHeK6j2Q8+nj1uC1f0lToVdZsQ7+WuG4naFzqqtCsY0uTMnqeV1wvq8qYH5UvdSXU06S+hHoZPc3PbiL2bPalHYbT74HIOeWckgEyEISBCYlnacB8wJjXUk6FZp55rZeV8qqMfCTNLGem63Zt8bB4voaaRVlwUnMxd8NJXBw+hZVpWVHB4LgbsWd4ANXz9bSleK79LZyoLUVWRh7mlh3D+cFWlGZlwXGTzVuB2st3cXjbCmQqm5tO4VL/cSxPj7Wrj0/GI2EyvpC6KjQ/Ys+WLvX0Mra+Sb7kmbbMa728V9xxZyNFmx+vcmb6VNfT29f9pcdVGdu16Re5jmdTt6XHpZ7Y8QulrIRediTfFkodM/Qrq/KkvB6XNBWaH7FnS5d6ehmbXcmXPNOWea2XZ5wPWDJABsjAzGVgysSz7UHk9ZDTgdTLSFxs6eVUXPIlLuXMUOXr4jl8vQl7R3pRNS8mWK3iOX0bDt1qx/qMcDnHLUHNpRuoK86Ck2xe1gZUv7ITi1LFpupLH54ryBonGsyx6NdqHPJR6X5xyZfQLBsvXfL1UOJiS0IzPd611DNDx63A3iudqN+6FjkJiOiprqf3Wx+rHtfLSNwr3ytd6j2sUNpVoddHte2VZ0vX+6ry5doWlzQJzbLx0iVfDyUutiQ00+NdSz2Gse8c+oK+IANkYKYwMGXiWTlUHkh6qOLmR5wv5cxrSZfQzNfb8orr4tlJy0P+ppO4cOVVFGmizCqes55Hy+2zWOuK0F2M6vN3Ub8iC06SedL/aLhgD964dgarIwJd0mW8Zij5KlR5Xh/Jt4ViQ+rKtYRmm17XUl4PxaZfqJf3ijtuNmYtrkJtyxC6ejpRX7UOOcbuvK3uVNfzG6eZp/fXzNOv9XIqrud5xc06Qa9t9qSuyrPFzTQpJ6Hkq9BmX9Ik3xaKDb2spNnKS9tmqNeRuNj0C6UsQwoEMkAGyMDMZuCRimcbfPKgU3l6XL/W0yWuQvnoZb3iY84833oPw7duoXnjwqgwUPX8xfPTqG1vx6Y8m3hOLE+1JR8nfTmee+MeztSuQEpEoHuNwUwXG2a6+EhPlzQJpa5+bYtLmh6quO1js6n3wStf0r1CJYYzi6pQc6QfnVfasD4/9tcCrzoqfarrqTbFT2bcr5/J5OntTFZbYlNC066e7pdnlpPx6em2uKRJmGw9Vd/rY7NpjsV2LfUYxr676Av6ggyQgZnCQNLi2ethZEsXZ6o8FddDs7xfWTNPt2WLm7blWpUds/OcOgc5K/bh9GAXntGEmL94nvydZyd1EdYfuYHOlmrkRo5wmONS1+ZH/Cnp8a51m+ITPRQ7ZrlErk0bun1bXC8fJJ4yZxU2N7bjXPdFlBcEE8/K7lTXU2OV8fjFbT6xpem2bPl6mpRNJtTtqLjYCBKXsnqo11Pp8a71Mqqs+bHZFptBQ9OG2YZ5rZdnfPz3EH1Cn5ABMjBTGEhaPOsOkoeVpJnXKl1Pk7iEQerpZfW41DXbiJeui2dV1nELUNk2igPrY/BbxXOy55p96oXbn4+n919D16kXMd84rqGPRcW9xh8vT+yo+mJDQj1P4ro9KRc01G2YcbFhpge5Tslbi/KmC+i42o8Dtc+icFZsvvzqT3U96Ysaq4zXDKWMLZSytjyVZuab1171gqYre2JT4rbQy57UteX75Ul5aUtdm+W9riU9aCht2UKxYctjWrB7jn6in8gAGZiuDEyZeFYOlAeSGYpzJV2uJTTTzWtbOVXG66PK6+JZvY0hq7gBx4aH8PzC2C6mVTwn/UYNvzdx5GFpfR+6zu7GwsxY+6qfXmOwpYsfzFCVNdPk2swzr81yku8VqvKSJ3F1HeQjbXmFjluOvVf70byzEgUBRbOyNdX1pP8yZrlWoe4bPd3Mk7p6qJfX0/3iep2gcWVP749c62l63K99M8+rD3obZhkzz7yW8pIeL9T7LnFVJ8hH2gqFJftwbuguWrYt9by/xpSXvxpNdT1pl2Fi80R/0V9kgAx4MDBh8SwPKv0hYUuTfD1Pj6t881pP0/P0uNiVsrY8W9qYM883R9FztRfN21YhTTtnbBPPqh13oXon8w30jNwf/57nJPKifbml3jktn69h37qxQlrGqIcqbn7UeON9pI7pG/M6aDm9nh6X+noYL18vq8cdNw/pWePHq5exxae6nhqfjFFC1S89Xa71/ppl9TyvuNSRUC9nS9Pz48Vt9W1pph0pI6GZr65VXryP1DPtmNdBy+n19LjU18N4+apsyrJmdFx/Gyeqi8fdg7otMz7V9cz2eZ34dwh9Rp+RATKgMzCl4lkeSHqo4vpH75yUkzTzWtJVKDb0NIn71ZMyj3toG58tzTYOv/GLDT2MZ0PsSajKS32pq+dJmoR+eVJmuoQyVgnVuCQuoS1Nz/PyhV5Gj0t5SVNh0I/U1fsUL03ypQ25FhvSDz3djPuVEbt6aNaXtiRd7Eko+ea1lDdDvZyZx2s+RMkAGSADM5uBCYlnrweMLV1Pk7iEAqF+rcclX4Uq3fzo+V5l9Dpm+cf5Wvrt10e9jMSDhOIr3baqZ17raXpcr2+m6zbMeCJlzbpfpWs1Tq+x6nlmGcmzhWr8kq77Qrdhy9fLBo3rNqWOV5otXeqoUO+TxIOEUte0ZV7r7etxvb6Zrtsw44mUNevyemY/VDn/nH8yMP0ZmJB4JiDTHxDOMeeYDJABMkAGyAAZIAMxBiieLWeGCUgMEPqCviADZIAMkAEyQAbIQIwBimeK5zHHNHhzxG4O+oK+IANkgAyQATJABkwGKJ4pnimeyQAZIANkgAyQATJABgIyQPEc0FHmqoPXXImSATJABsgAGSADZGDmMUDxTPHMlSYZIANkgAyQATJABshAQAYongM6iivLmbey5JxzzskAGSADZIAMkAGTAYpnimeuNMkAGSADZIAMkAEyQAYCMjBh8Wz7ZwK2NFO1qzJeH7Osfi22JdTzbPGg5Wx1mcbVJhkgA2SADJABMkAGyIDOwJSJZ10oqw7ootYrrndU4omUNdsRG3oo/dLT/OIPu7xf28zjzUsGyAAZIANkgAyQgUfLwKSIZxGUImwlNCdXTw8aV+XifVQ7tjKSbvZDv5Z6eppf/GGX92ubeY/2ZqH/6X8yQAbIABkgA2RgUsSzgKSEpYp7CUzJ18tIWT007cm11NOvzXiQNvQ60q6e5hd/2OX92mYeb1gyQAbIABkgA2SADDxaBiYknnWhqiZSrs1QJlnS9bJB4zYbkqaHehumba9rs45uz4yrsg+zvNkerx/tDUL/0/9kgAyQATJABsiAzsBDFc+qIRGaIjr1a+mIpOnlJR60ns2W2JA8r2u9fb2sLS79seXZ0hItb7PBNN60ZIAMkAEyQAbIABl4PBhIWjyL4DRDNbGSFi8uwtIMBQ6bHVualDfbC3Kt12X88YCS88B5IANkgAyQATJABh5XBpIWzzIgEbMSqnQ9LuUmmi42zVC3b2tDyks581rSGfImJQNkgAyQATJABsgAGYjHwITFs2rAFKTmtXRCT1dxr49X+Xjp0hfdrtSRUO+DXl7y44ViO145yU+0vNRjyJuXDJABMkAGyAAZIAOPHwMTFs8iRiVUk6zH9Un3EpJ+5cWelPELJU/aNK/FluTLta2cXkaPq7IPs7zeFuOP3w3DOeGckAEyQAbIABmY2QxMSDybItK81uHyE51e9cx027WZJm0mmi71GM7sG4Lzz/knA2SADJABMkAG/BhIWjz7iVOVp3/MDuh5trgqr9L1eua15NnSvdJs6WKHIW8UMkAGyAAZIANkgAyQgXgMJC2e4xlmPuEjA2SADJABMkAGyAAZmG4MUDynEurpBjXHQ6bJABkgA2SADJCBh8UAxTPF85jjMQ8LNNrllxgZIANkgAyQATIwHRigeKZ4pngmA2SADJABMkAGyAAZCMgAxXNAR02HlRLHwBU/GSADZIAMkAEyQAYmxgDFM8UzV5pkgAyQATJABsgAGSADARmgeA7oKK7SJrZKo//oPzJABsgAGSADZGA6MEDxTPHMlSYZIANkgAyQATJABshAQAYongM6ajqslDgGrvjJABkgA2SADJABMjAxBiieKZ650iQDZIAMkAEyQAbIABkIyADFc0BHcZU2sVUa/Uf/kQEyQAbIABkgA9OBAYpnimeuNMkAGSADZIAMkAEyQAYCMkDxHNBR02GlxDFwxU8GyAAZIANkgAyQgYkxQPFM8cyVJhkgA2SADJABMkAGyEBABiieAzqKq7SJrdLoP/qPDJABMkAGyAAZmA4MUDxTPHOlSQbIABkgA2SADJABMhCQAYrngI6aDisljoErfjJABsgAGSADZIAMTIwBimeKZ640yQAZIANkgAyQATJABgIyQPEc0FFcpU1slUb/0X9kgAyQATJABsjAdGCA4pnimStNMkAGyAAZIANkgAyQgYAMUDwHdNR0WClxDFzxkwEyQAbIABkgA2RgYgxQPFM8c6VJBsgAGSADZIAMkAEyEJABiueAjuIqbWKrNPqP/iMDZIAMkAEyQAamAwMUzxTPXGmSATJABsgAGSADZIAMBGSA4jmgo6bDSolj4IqfDJABMkAGyAAZIAMTY4DimeKZK00yQAbIABkgA2SADJCBgAxQPAd0FFdpE1ul0X/0HxkgA2SADJABMjAdGKB4pnjmSpMMkAEyQAbIABkgA2QgIAMUzwEdNR1WShwDV/xkgAyQATJABsgAGZgYA0mLZ8ddg/reBxi6OYrB62/j4rkT2FyU95VctRTWDqB7/8ak++64FWi+2Y3KvKy4NlIKt6KhdQTdI/fR3dWJ+rLFeMKNXy8o6HpfFrw4hEE1P7ce4GLTmrh9C9qGKufMLkd9+x30Kfs3R3HsuScnbH+i85BI/1k2/heHzlIQfznZFdjfexctVUsmzIK0Z2Mi/N0zgtrF3vfNZPYlSHvSX1to60si92ai82DrQ7JpjrsSdVdu48WSqfF1kH7a/Cn1bLxInl/oZ9Ov3uOU5zd22/j8uE6Ez8n0ga2fYt82Pr8xSD2v8Kv+LHaynkfL7ffCGizyHB669QAnnlsQ9/vXXVCNPWevo2fkHXRdakfN0/HrePlxpqZPUDyHH2BOWgEW7ehAz5WDWJTq/SX7uDrZdlMm0tegDzfHLUT5yXfQ2liGnIw5yHnqINqunceG7Mnzma0vi5tuTLp4Ttl0FkPnmjA3bfL6PtF5SGTOWHbyxfPD8KmNiYk8MJPpY7S9osljXfoR5N603dNS/2GHQcTzw+5DIvZtvCRS/6tcNtGxB+E6CJ9T5TPb+KJj8FlI2/o3HZ7FYfF8AZuywt9LjrsctZfvouGpHF/x7LhL8Vz7WzhRW4qsjDzMLTuG84OtKI3YsfmLaeOfl5MinpVjndQKHLjeg63zIg+Y/ArUnxlBz8jbuNzRhsql80ITKrDvrTuK1r77uNp3FU0bYruvZS0PcGxPE450v43ewREc2VmGTNmZ9bAZmtiCCjScCe/odl2+gJ1rFkUBSplfhcY2tcpSu70XUVe6MJSXsvksrt15f8xn+PZd1K/wH4NqL23JizjUeQ+9IzfQ8vx+HLoRf+fZccvQ2D+E5xcK7AVYsKYchRHx7Dd2rzEE6YvnF6CfPz2Oszirj+FqaDf7PQzfei+8s63vPPvY9BqD3zw47no0DQ5hxwLxWTn2jfRiW0H42s9nT/j0JXP5bhzpfBO9N0fR29eHfZXLkSKceYz9yReHcHL7IjjpW3Hw5gheWJwFZ8kr6DixA2mqrk97yfYzxLalP/H84js+n34mx3U+tpwK/wVC7XwcqYj9BUru9z11R9HWfx9Xe3uwW7vfvcbnz4T6q9cIbDYd17svqi1fv1j8rOqEx3ANTbVH0KrGoH1n+c1DvL4o2173ZjLz4OXL0BiKX8HF1pPY3fkWLh2qRcVrd9DTcxprI38t87o3TfHs5Fbj8MAI6pblwm988eY9o6QRR7ruoW/kFk7UNePgSBeemRP53vWcB++59ePF1y8+vMQbwxN+z5zCrWhsVc+/d9B18RyqVxSEn38+8yDteT0bvebIb+zx58jOtfjMi0+/7zqpa4Z+35+pKfM8v0P8x+f9XWC2r19Pi2dxWhGWrF+D3MgGVsqKw+jsfjXuBqaTvg2HbrVjfYY8U0tQc+kG6or97z/df4xnY/LEs7sRe4YHUD0/C45bgI3H7+H0rjXIysjF3A2ncLH7IBa5Kk/Bfh9tu8sxW+VtOo3O4ZN4Kj0mhnpam1A0ew4yFtahZfgGdi6JZ7MAm068jbbdG5CTkYvZq4+gfeQNrJ0Vrrf52B201K5CZlouctefwIVrp7AyPQtOajZS0nNQWDeA7gObQnF1rY5R+I9hASpb30VrQ1lo5VbwzGlcDCSeYz6ywacEltfYPcfgxu+L7QvQb3y2vplpqVvOYfjkC0jXBKefTZXnOQbfeYgvnr185s1gISrbRnFsx1KkpuYgs6QOe1t2Y0mEQXOscp1a3o7LL5fBmd+EVy71Yf+GHKRsbMX5xtW+vKj6fnPr1U9p1xb6izbv8fnPUXyWbH2RNMfNxaYTNvF8H62h+z0Pc8tb0aXuvzh/sfC/N8PfIX427X3x9ouMwRaGv7Pexpn6zaHvl7mbT+Ny5DvLbx7Elq0vkme/Nyc2D2JbDx0l2nqOojivAs39/ahZXIRnTo3i8DN5IXY9703t2IZip6zlLs7vWYfUMfd9YvPuuEV4rv1dnKxbjVnpeZj3TBu6bscXzzIemz/9eJF6fqHVZuRZZeNM+cL3maP+wthQhmy1s7f5NDr7jqI4NQv+8+D9bEz2+1PG7D0+O9dSz86n9/Nd6tlCv+9PKW/tp+/zIf53gdjWQ0fTK3q6xP2+r73vlfj37WT6U/qqQsedg1Wv3sMbO5dFNw31fD0e3rE+i7WRe9hxF6P6vLZp6LF41W0w/tDE8zo0DvShulBWNhuwZzi8Mxt+EN1CXeQMneOWY7/aScyPiefXt4d3hhUQZUfv49CWuXBcP5sqT9/RLcSisi2YbzkOIe1VyQ55ajbsfw7ya68Mu/X2Qiu5IDvPMfG8+tX7oV3bodux84TqhrWN3QRVH4NaQcfri/2G9R6f2Z7t2i6eg9vUxyD27fMQXzzbfObPSz7KXx9F+/6tWDgvH27Ao0ZO8UFcPFmD9NLj2F9/EAdqi5Ff24ujFfN8+VTj85pbv36KX2yhn2hTu01e4/NrLwhLtr5ImvXBFxIgt/DiMvkueAbN16+iKnK/S12v0M6EemD627T3xdsvXu2r9PB31k3sjOzMCLvqO8tvHsSmrS+SZ78349/TUj9oGBJt5xowx1W7TOexISMLK/bfw7GqwnEPWxmf+o7Ud54z151EV08LSmaF51Lato1Pvudt8+64G7BnaBA7nowwkboVB29NTDxLX2y8SJ5fmPgYvJ854XtMfx6pZ1yYeb95EJ95PRv1/utzJOl+Y/cen51rsWnnM/j3vNhRod/3p5Sz9VPybOMTn9k4k3q2UBfPX/VnsRqfk/UcXrvWg2cDfK/GxPPTqG1vx6Y8imcbI/HSHtLOsxKJkR8TRg6yD97sjexKqwdf7Mc+OsSqs0pk2L/Q/WzGRKk5YMedi6W17WgfDIvVwZvvYeh27M/+qrz9pgzeXtAzieZY9QeT/9i9xzDe5vgfL9q/AL3HZ/rQdm0Xz942k5+H+OI5UV7UeNz5W1F3rAcdg++ib2AQB3esQYa2m2Ybs5NVg5auA3iq+hR2Lq/GgVeewcpXhrBrmRIZ3mNXtpLh2tYHSYsn2rzG59fPICxJ+7bQ9uALP9z0+33ssRubHT3Nfm+a3yHjbdr6oux6+UVv04yPH4Oaa/krmz+fypZXX1Se970Zth+uP/6eNvsY79pftPl9v6gfDIa/y9WRnNbaYovY9tp5ts+7Es9Ng2PF86uPrXj2GkOMAdP34++jWFn/eTC51uol+RyTvtkY9ONa6nnzaX++Sz1b6Pf9KeVt/ZS8ZL8LpL4ejp+jsT+M9f6+9rtXYvOl2rLpgsn0pz6enG2d6DtVi6w4z7BQv0I/NOTOs+6/ZOKTJ55DZ55ld1mtTGO7yXrHZKXotbr2htbPpsobRo1+lnjt5tDOszPvJZy5dgFbCnIjxzHGP2jtN6Vfe8ntDI0/Z7UWDX3XULMotutuFYI+YwiyW2i/Yb3Hp8+XV9wunr1tJj8P4QeKOl+s+uKkVqJZHZHJjeOz0F8q7AzqY3LcHMwq3ofTN3rw7NywTT1fjzvuWjRcbcWufa9jY9Yq7DrcjNq2TpTnKPHsPXZlIxmu9bbNuDz4vPwi5c3x+fUzCEti1xbaHnzST3kzhtox08+s2+zoafZ70xQZ423a+qLbNf2i55nx8BjsO3QyPr958OuL/d5M7vvF7Ld+7SvafL9fYqIio/QELg+0ojRn7H1iG5/4xTbvjrsI29rfxelda5GdORf5FWcnfGxDxmrjRfL8wsTHoO53j2dO6Ltgcneek/3+lDF7j8/OtdSz8+n/XSd1zdDv+1PK2vopeba59eNM6tnC6fQsdtwl2N5xH69uDv+uzDZePY1nnsf/+E/3T9D4pIhnedtG9+VmLIieF34Tx2tWIjM9B7NKGvDq2VdQkqZEhnrwqTdOhM885208Ne7Ms1VAhs5Re9kMnz+LvsXi6cM4d60dZerMc0EDWkc6UbVwHlLSCvBk+XG03xi785xT3YWBU3WYk5ETOvccO/Ps1d4CVLapM8/rImee29B5K8ixjcjbNhrU2zbUWfCTuNh/HCsiB/c9BZbPGBx15jlOX/Jr+9D3ei1ytHOm4bOv9vEFgccuntVZOLvN5OdhHta3vIWzofPs6nzkWXT1vBo6P6/66ekzX15KUHmsC/WbFiM9NRvpCxpw4noXKiKC3Gv8jvsknj07hHMnD2Gxm49njgzgjY6jKI7DfLL99OqHSndcb784rvf4/OY9CEv+fUpsB9LPluTZ783kxLOfX6Q9Wxj+zlLntm1nnr3nQWz5CQL7vRn/nnaK9qPj9lvYty533E6wtKuHvuLZ9/slJp4VO2sO30XnwfIxf6WxjS+eqEkveQmvdb6JnoFraKl9Fa/dnJxjGzZedD94xRMdg/KFOvNsfeao33eoM8/1a5GVrn7Xc2rsmWeP4zN+z8Zkvz9lvN7js3Mt9ex8en/PSz1b6Pf9KeVt/ZQ829zG40zqmmH0bRvT4Fn8hPrR+tBJPB3REWPGWrIP54buomXb0uj3RKC3bVjqjbHLc9ET/cFg5E83I/dw4exxbFoU+5X9E/mVkbdthN9nvGt9+I0aYdivoWnn0dAv13v7ese/bcNyDi80cR42Q3kFldG3bXRfvoi6tYsiO835KN7ZETq20Td4DUdeeBnNw2PFszNnCxrO30X/rQcY1o90+LQX/TX8tZtoqT2Iw0Hf8zx/KxraIm8FudSOHSvnR6H2FoL+Y4jXF2dO+J3M6s0S6p3MXS9vCLfpM754N4pNPPvNkTqHm/w8PINdoTe3/P/tnftXFEmWx/+clDw89ADyOAKCcFAQH6gI6FEBQVCwRF5q+0BFBcUXqLTSSFOCApaCLT6w0Xa2dWZ3Z3b69E6PM7Pb+7d890RmRZFVRERmZVFY6P3Bk0VFZcR9fOLGjcjI8DWG7/Vjf/H8DFtmM5UsrCx1eycuD7/Aw6dzGH04jq6D28wTM2yCwubOF5i84TGSh5JTM5jsb55/VKawp1s5lX7IkttFqZ9CTjuWRPJoqw7ikuWc0Ynpec7cDm68HVHfVNWpksWt33l7J1t6jBNDRi2nbRhySvxgJwu7V9Y37fyQWj+MydFuY0GC20p1VSbPir4ZurVMS6tH1/hTtG/JgEo/bjPRynOonJpei/MOXhhUtcfrFPHCy0RXVZ22OkjGHNYOO0O4o8884Wn4u5DTNpTJs3hsdBs/negn5VrBp2x8F9nY+p0sfqrk5PeLfGvrI0U8j/sCxmL2BK3k1A+4f6pCeFpU3MZO3H3yCr0Nwdut9HUHceLWU+MEMtE5z7L7uC/oGsELg26NF4A9CmemupWJ7lucxxhkR7IjMRB9BjR9NcouvcFA69bAxHs52z0+/yRuPe3HdsuTseWsj1vZaWyMft9x6xu6j3wTyoDrbRuhFTn9OxAgwjzU3Gn99DuCnBggBr5kBoy9o6NjqF8bvPd4OemspTShx/+0Ymx8Al31m4UrZ8tJp0hlpbGR4lakDNH9S8fQkifP5Nylcy7ZmmxNDBADxAAxQAwQA8TA4jJAybNiTxTBtriwkT3JnsQAMUAMEAPEADGw3Bmg5JmS5y9i3+Ry74gkPw2+koYrAAAgAElEQVQmxAAxQAwQA8TA8mCAkmdKnil5JgaIAWKAGCAGiAFigBhwyAAlzw4NRbPB5TEbJD+Rn4gBYoAYIAaIAWIgmgxQ8kzJM800iQFigBggBogBYoAYIAYcMkDJs0NDRXMGQ3XTDJkYIAaIAWKAGCAGiIHlwQAlz5Q800yTGCAGiAFigBggBogBYsAhA5Q8OzQUzQaXx2yQ/ER+IgaIAWKAGCAGiIFoMuA6edb0Chwfn8ChPPN/udL0vTjlG8WB7Oj+r1daciN6nnlRuya67UTT6FpKNU6PPkdP3fplMcvT9Gp0To2gJiM6Ns87OoFx9r+NTb/D4PEdQTZRlXEfuWUix/MII6d3BbXH61zM6+f6n8NE+kVTlki5FnHmtk4n94naC9fvTvh0UudiyOKknWj8RsQZb8eJH/hvl+P1S9dvOfqEZKakeSkYoOSZVp5tk8elGtgLjz9dkDzzTqAqo+RZHCxFSU00k2fuK7fXpeKMy7eY7an45O2prospi6qdaJSJOItGO1SnuJ+TXcguxMDSMxC15HllyTFcGprB6NQcRsfGcKqmBHG6f+UyqxptN33w+l7h/t1+1GxYY5vAcTi0xDp0PRtGVVrkq6C5Rydw7WA+tMRanJvy4XBhMrT1Z3G39xAS9GTEra1DR/8TeH2zGBkeRPP2dQE5y3ve4fKJ47g08gqj4z5cOlKOlXoyeHJyorkb/Q9n8WDUi2OVhVhhlGVh3/U5Y5V1YvodLlVnBOpT3cd0TyruwKXhFxjzTaO3uRPnfPY20IrOYrDvGo4NvcR3XR5UX/gBXu8NlPlXkONyatHRx/zwGsODd9CwKTsgT8L6o+gaeoFR31P0NJ5G11PLyrNL/6nsyXRUJSCqsnCZiNtzC49/+Cno3+Sz52jbZDKlsgvnUHSVMW/nW1l7dnyKZGDfqfSzk2WFC99qunuuZZwp68zuQJ/vBkoTTX9pei7235pFZ2U6VPcx28jbUz9Ji4RdmZ9kshi/l/iB+++b5m70jc3iwdgDHPfHF3afLC6p6jTKsqvRftOHEd8shu/fw5Ed+YFYINNdzZmcCdaejHmunyh+GnJKFjvs+opMB1anzGYqWVScqe5j7aliuSyGqHSnsqVPnMjmZPOoJM+anoOa/jlcPrQB8fGpWFncjG96jmF9Iksus7HrygvcaNmB5KR0ZFZex+DIOeTzxFoSHDmsmr4b3zy+g3L/wMm/d3ON3zuA+yfLoa09jrPfjeF0ZSridvXh245thpx7Lv+AHk8pViakI72iF/ceX8cWf7ss4Hr7jqNgdRqS1jWjZ/IpjqznyfMs+o7txeqkDGTu7cMwuy9hPtnX9HTs7hUlz+L7NL0A9QNvcK15G1YlZmBNVT+GHUwgjOTZ242ijGp0PnyIpsICVF2fw8WqDFO/a6/R116OFCbnnhsYGutGUTzTIQ81fW+MsuSkDGRX3cCgP3l26z92n8qezH+qBFlVFi4TGhu8E1OR0/wII2d2G5/Z3+YEJxt7JHZRMaZmfgfaRmW+lben4lMpi1I/tSyR9c1wuZZzxvUT95UiNA2+wIltqUaCp6U0osc3gIpkuz4mb0+1DS1Sdrku1qvbPmYmZrPoN+JLOjJ338DQ5DVsto1L8rjL9Nvd+wr9xyqRmpSO1dsuYcB3G2WrzHgt67eqfsR1FftPzjzXTxU/ed3Wq6qv2PkvVmK5KoZYdaXPlLgRA5+fgSglz1nYe3UOA6drsW5NFvR466C2Ex2PxtCQw1eNKnFi0rKqaZM8i6AxHnk+MVd0jb2zbP/s1GM0FbDgX41OWVnROQxea0Li9is43XYOZzxFyPKMort64Uo429N92jeKOv9eaxZwrx40V6I1PQ3l3bPo2pfpX3mextGNXL8qdD55gLosqw1kSYb4Pk2vxImJcRzK9dcZX4tz0+bKs1q/sxi80440vRhN332LyqRkbDr9ApfrcqDpzA8TaFzH5WT6mXJqejmOWcsSD6Br2vSReV/k/gu1J/OrKkFWlYmYcPKd6HGzyi6qOtlKlJx5lrDKfKvwQxh8imQT62cni3vfihMlVXtyzrg+ojpZWV7rY9z/ptyY8CTsvoUH15qMJz+q+9Rcq1eeeb3sGi671nv5Z7Us8hhpJpfTaC629ttRHPDHF3lcUtUZymAO8sv3YW3KfMyalzs4DrLvRZzN/14U60Lbs8YeOS+8TtFVC6OvhPpPbjN7WUR8ch+JxgB1LJfHEJHO9N3nT6DIB1+vD6KSPDOg9LW1aL7sxd3xNxh7NI5zh3Ygydi6sAsnJt9hwkhwecI7ioa1CwN1tMHUkpvQM3wGmxuu40hJA86crcKWsxNo2ciS7kxs8AxgYHzWfJlt6i0mns2/EMkCLktCQ2U0A6cPnsL5wS30RUp5wBXfxwLu8fHg5Pm8P3kObd/6t7HyLE2emR8eBeyu6fN/Wz+z+qz7Mc2y8P1nZ0/WjipBVpVZdQ7ns2jQX6j7vF3s6pYzzwZhmW+D67e2r+LTThZWLtbPTpbwfctlCZ/rUN0XvpgqqpO1x9i+52VPrFJRev4Feupyg/qi6D6rbY06LC/Cqlee1bGA1RUun2pZmF3EflgYX4JtKI9LqjqD6+D+NG1kr7uIM16HMz/Mt79QP2cvoqv6il3skdtM3lfU+snvs4vlshjC26Pr15uske9jy/cRJM9laB/zGau7zKlaPFthXbiCrOmpWFV0CjeeerE/kyWlbNVhfqXkcwKh6WVof9CHllNXsSu5FC0XO+HpH8Le1GRoa1px8/E97MtO9z/ODw7iSxtw83Fg4A1utJQhZWUmsqpvOd+2IU2eVas/8hVBt/6zsyfjQJWAqMrcMiQa9N2uPFtlWMi8ajBV+UHOp7U92WexfnayuO+b4kRJ1Z6cM66TqE5WpsWzeifRlF+OYw9HUJMZPPkW3ade7TXlZO89mPXXoJNtVUq3jwXs9+HyqZZFHiP5qqZq5Vk8qVfVycom0RR4CpWNvLI9xsqzk34r4kzlP1Ufc508f2GxPDSGcHvSNbYSKPLH1+uPCJLnbOy5Oov+jnKwfbGZe/sx/LAbxcae2WLUXB5G2+5CJManIDGvHb1PhlHNBiJjz/MMrjRtwcrEVKwqbsf5W2dRbNkTvFRAmi8aTeDOtS4U6lmouvQIt+92o4itkGe3o883hLp1axCXkI3cvVcw8PTzrDwzeyQWt+LC0Ay8jx6jx3MeF6YcvjAoTZ79+w7bypCcyPZOXg/e89zP9jzvNHybXdWPocC2DbZ3Mnz/2dmT6ZjlGcPYVQ9SBSyoytzyktowjEfXm5GWlGrsew7a8yywi6odTVcxr0ogVX5gL8KJ+VTJwsvE+qllceNb3p44YVW1l4caCWeqOlmZpqeg5NRz3LjYj3sDHUgPeWdCLIu8PU1fg4qel7hl7Ptl7xXcwrD3vPEuRqTscl2sV2PPs0R3VYw0k8vX6Otg71SkI2PX9QV7nsXJs7zf8j3PfR3lSE1KQ+rWi7jzeADlbM+zTRxkOok447qK/aBiXs4Lr1N0/RJiuSqGBHQuPoU7E8/Rc2BD0JOWQLmLbY9079ebAJLv3fvedfLMjM7eYD5+66lxGsXw0F00bVkb6NCp2ztxefgFHj6dw+jDcXQd3GacYGE4K6vGf9oGO8ViCC0V5mkUn8ORmztfYPKGx9hSUnJqBpP9zUj2n4xRdOSusW1jbPwxLh0+ic7JyJJnbdVBXPJvV2GnbUxMm9tWhk9WBk7pUG334PbR9Fqcd/rCoCR5NvxnnLZhniYy/J3ktI3HU+jxnMNF6znPLvzH9gSr7Mnk0dL2om3gB+OEFrZ3ndkloLOijP8m3KuWtg/t3z7Hw+l3mLRsyTFPAhDbRdWGjHm71TRVezI+VXLwMpF+drKscOPbCLgOnDgRwpmqr3D94rZfgXf6LfqPFM9zopCF3Sdrz6gzqwotxilArzF8rx/7i813HyJll8sbelXLIo6Rpv8e4/iRbvQ9nMXo2OjC0zYE28lM/cR1GmXZNYHTNkbuD6K5LD9wQpB9v13Yj+z8J2Pelk9FcijrK3b+c/MUUaVfODqExnJZDOHsxG3sxN0nr9DbUBRgnpfR1X0iRLYj24XLQETJc7iN0e8XB9D4/JO49bQf2wUrtGTjxbEx2ZHsGIsMBBKzguBtKrEoK8lk34coltvbiDgiG8UiA5Q8K1YyYslhWkoTevyr1mPjE+iq3zx/bvYy0SGW7EmyUEBejgwEkmf/3uzlqMPXLjPFcoo9X3sf+BL0p+SZEk96/EcMEAPEADFADBADxAAx4JABSp4dGupLmCmRDrTiQQwQA8QAMUAMEAPEQGQMUPJMyTPNNIkBYoAYIAaIAWKAGCAGHDJAybNDQ9EsLbJZGtmP7EcMEAPEADFADBADXwIDlDxT8kwzTWKAGCAGiAFigBggBogBhwxQ8uzQUF/CTIl0oBk/MUAMEAPEADFADBADkTFAyTMlzzTTJAaIAWKAGCAGiAFigBhwyAAlzw4N5XaWpukl2LPlPMpSFv6nBqoyt+3RfZHNJsOx31L7b6nbC8cWn/O3ZJelY/5z+pnaJj8TA8RArDBAyXOUk+cVWbcx0zwk/t8AVWXRlovqj3yGvdT+W+r2lgsjZJfIWV4uviY5ydfEADEQAwxElDzHra1DR98TeJ/MYmR4CC3lhVihL1xhXYyZgqbvxkXPn3A6Q17/uq3v8WNFrRAsVdliyCeqQ9NXY3v5f2GmbO8Cu6jKWF2a3oRb7a9xJFmur6jN5fKdVb8N2/4NH9r/hQ8dv2Nm526h/2JNL5n/ND0dW8o+4sWuBqxy0Be0pGO43/G/pv7MBn47eEsKguwgay/W7CKTR0tqwk3PLxjaWBKkl/X3Vias36s+L3e7cN2c6u6krzixNW93Ma5u24tGTNZW1eNi/X/hvb8vfV+SL+VtMXQX1RHpWCWq04nf129/h/6CNGh6Hjx1r+BZ9WWOHSL7RPrdcu5/keoe7v1u+3u47cT6710nz5qejb3XZnGzrQwpiWlI3dyF274BVAi2JyyGESINSNEI1HZ6afH1uH70j8KEX1XG6nXame1kiNVykX6bdv7H8kmeJb7VM3rh83hRnuRs4DKT52k0+H+v6dtwuumv6M5JDRr07XiJVT+HI5eICbv7vxS7hKv7cuorMh9GIybrhRP4UN+DnHhn/U8mWyTfRzpWqdqW+V3Tc9BU+xrNKcnQ4g+hr/E2NjqYvKva+prKvsb+9zX5Nxq6RpA8b4Ln/nO0bTKDFOu8+eU1WLfaH7SyqtF20wev7xXu3+1HzYY188mAqkyyHM8DUm/pPUw2f8Jbzxv0FBQbK7r6+gn88dj/Bf372PFXXMxOhqqM13m19B4mjnzC2yNzuOKvkxl7VXY3Bht/wU/t/8JPR97iRlEpdEtA0rNv4Xnbb/Bu2jqvm0X+pIKHeHfwCnIt93AnisoSMzsx0Pgrfmr9dwxtvo4By8pz3GoPeur+hLnW3/D6kA/t2bnzbaY2obv2I35s/Ttmm6ZxNm99oMxOBy5P6HVV1iUMNv2K961/hrf0Ju60vsBh/0rG/n2/4/udPRg8/Df8dPQjBrdWIcWvo57W7JfzE940PcPZ3HlZVPqx9mUDw4rURlyq/SPmWv+GVwcfwbMmO6BfqNzWv1U2U+mg0p3XL/If23vbcuBPuJqX40g+VpcWX4TN+XuQ5R/s47IH8PLwwoEvtD1Nr8Hl5n/D8TTe/+pxvXUObanm30q/K+zpxi4qWVhcaNw/v6I+WGSJA/EpUDKhkFPlhxWK/iBjQlvTh5k6L3oa/xszu0/Cs+cveOsZRVVyMlRlTA4Z8zy+iGIWu0+puyWOcF2tV1FfUdnaThY3fcxte6qYbOio8LuMTy13CG+N1eb/xceO/wk8yeErzzIfme3J46c7u5hPSUV+V+luxxmTVej3tB48bv8ffAg8wfLb4EAXMvVk9TimsLWqHzFZpOMf9T/jKao11kWj/xVu+xmjm9ZDS/DgTvtHnMpMhpZ5Ez9UdyBRT5bGJeY7aT/yP+EXseu2v7P2VGOqcqyyiYOs7s/1L4LkeTU2npqGd+ASytfnBiWVbFV615UXuNGyA8lJ6cisvI7BkXPI15OhKlMZwYTv7xgva0BGQiZy1j/E6xYvKuJZnanQE1JRUPoeP1YeMD7rCauNxFpdxoLcJ0zyOgtH8bLFi/IEVid79PVPfL+5BAl6KlKyOnG1qhubE/yTA+a0jDMYbPgRvYVFCxzI9DxQ9Qljm4sdlWl6AY7U/QMTO6qwOmEN1m0YxUybuW1D03NxcP9v/jKm+yheHrmHrYY916Kh5m+YLNuP9IQMZOTexdPWSVQnOtRBAJ+mF6Gt/h8YLa1ESnwmcjeM43VHcPI8V9eDjSvTsSr9DO63/Ds6Wcdlclb9BUNbKpASn4Gs/O/xnPnIsKdcP+534cCgr8WB6l/xcPsepDK/F3gxc/iW7aqKymasPRY8xDqodWf3ynybvsGHN545eA/9J142vcClwpKgfsH1lF3Zlo/du3+Fb2vwZEzUnjphlbOr2djTjV1UsnBdNT0DDTW/I3hAkTNhJ6fMD+w+eX9Q9COWPHvuoTS5Cf3NP+FkRhEO7/8n7m7INJNnWZmSeRZfZDFLrju3meoq6iv892Jbq2Rx18fct6eK12pZZHxyWRLW+/Cx5gRWWhYs1HFJxYtaFt5m6NX1WKVgkLch87uWdALD9RewhumdNwLfjgpj3FGNY6o+pupHXBbR+Ke6TxWTjYmDrI8p7KL2rYr55d//GOuvyquhpfXg9qF3uFGQCr3gEZ6VVSrHYuY/WT9Sscv9Hn58kY+pKj55e7F6dZ08M4W0pCLs7BjA7Udv8GBoAE3b8/wJ6050PBpDQw5fFavEickR1GSwBEtepjKS6dQ/41wWr7MR/W1zOOpfaWP3qh4DisoW1tmAG61zaE1lcubgUM0/8aTCgw0pOWElQYZtVp3A92y1VrBnWROUaXo1epp/xol0v34JzRjo4MnzvuAy3ZST6a7poWV5KM4/iIIk9zqwZKj36B/mVzXj2cw2OHl+sMlcUWYJ3/59f8fAhizBJMGUs4U9SlTox/0uGhhM/d6h3f9EQ9P3o7flNTwCu/J6DPsvsMu8zVg5Cx4iHex0N+oW+m87zjT9hpEtFUhOSMOadUOYbp3BoTC2MWlJLfi25Q2aLUzL25OvPKvYtbOnG7u4T57tmFf7XdyPVP0htGyeCWPwNpKPrfim8SnqEpJRVvErvt+YZybPkjLmH+s/zd83TebZ4C2OWU76g7Xe0M+ivsJ/Ix/cZLIwu6htzesWXcNtj9chjslqWWR88jpFyTMv49dgH4UyYY2fall4faHXheOKs7FKxSBvQ+Z3du/TPU3G+Ltm02sMFa/1J8/ycUwVC1TjCpdFdFXdt7CM+t/8GB5+/9PW9GNm/3Ek5Q7j5o5+9G3djNytc/iuaOGTWSvzzG+yfuSE3XD7u2pMVY1VIr5i6buIkmeuiJaQhXXV1/Ht4yHsNRLkXTgx+Q4TU3MYD/wbRcNalkTJy3h9oqvp1PkXBjU9+DE1u0cUjHldorKFddait+U92v2PwvU0D85V/Ygfmj/hffN73Nm029FLYKzNNSWv8L7mWGA7A5dDVqbpwW1b92AtLJv/bWiZtR322Y0OLEG9EpI8D4QkzyypCG1L07OwZcsTTDV/ws/GI1T2KNHcShAqp1U/Xo9oYDDv+z3wGNZ4oa59LpBM83tDrwvbm7cZ+y0LHmId1Lqze0W+1ZI7MdrqRaV/+4WmF6Kl/l/oy1+9wE6hsvK/0zfO4P3+k1htWTWTtmezbUPmdzt7urGL++Q52CdWJuzklNsluE5uW3ZVMaFKXJRlSuZZ8iyOWQtlCe8FYVFf4brKBzeVLOH3Mbft8fvEMZn5Ty6LjE9epyh5Dicu8XrY1QmD1t/zzwvHFWdjlYozXrfM7/HrJ/G4tNSINdvLP6DHv3DF7nMTC0L55O3bXVX3hZZZ/1bpriz7ivuflnQc95tuYGeJF2ezW9G36xAqdv2MriyWZ8nHYuZDWT9ywm748UU9psr4tGPtc5e7Tp61lZuw48BuY08VU4IlC/UDczi9kzmOrS6P4oB/ldiqpKrM+rvQz06cKgrGvB5RmVmndTXGnAmzlWd+H7uyrR8pa67iYfssjjhYSWR7XzsOfsLtQtFqrLhMtRKlnLEbK6wf8A1fsdZzsSGv3lh5dquDpm9Aa/0/8HD7XqxOzEJe0cSCbRvCxDOlC+Mt02hKzfA/gag3VvLZPlyVflxO0cBg6m4+DeC/c3JV2YzdLw8eat1lvmWPznyto9gVSJ7Xo63+X7hdEPzin0x2Vu+xg58wsD541UDanrE3zdznxupkiWd/++sFb9iHsmtnTzd2MfuRWhZxwLVbeZb7XW4Xtloo7g8qJpQDNHtsLFl51pTMq5Jnue4yRqzfi/oKLxfbWiULs5nc1rxe2TXc9ng94pislkXGJ69TmDwrfWTHS/h2cTtWqRjk+on8Xlr+Z2OPrbmwwE4tMk/vGShMV45jqlhglon7EZdFdFXdR/1PNnlVMy+yM/tO0/ei2/MQFypGUJ9Uga49N3GmbgaHViZDFZfYvbJ+5ITdcPu7XT7B9Qsdq/j3sXp1nzzHl6F97Bk6qzYiKWE1UoqO4arvERryWKLE9jzP4ErTFqxMTMWq4nacv3UWxcbeV3mZykhOnJpe8hI/7z+DzAS2p87c88zrFJWZdf6GibJ6Yx91dsEDvAjsed4CT9VLXCzciKT4FCSlXYC37WXgpTmj3ozzGDr0DtcLNwQHqfReTLWMYpd1f7T/8a4mKWN7nj3Gnud9WJ2QiXUbHuFFYNuGf68mS2bjM5FT+AAvQvY8T+yoRlpCOtLXDuBJiw81xp5nBzpkXcWTo7/gfsgRYiuzuvBt4y+Ya/6A+1tv41snK8+pFzDeOoOj6dmIi1+LwvXDmGrnK89y/biPcre+xfuak0i3vClv7sv7BSNbypCcwPaeX8BA3U1ss/xmhUCHwP46gc1Ye7LgwcpUukv9F1+Bc4d/g3crm3BkYm3+MJ61TuGA9bgogZxc9xXsRY+jXlSGMCNtT89GbdV/43HZfqQlsH3pE3jtuY1iYx+83O929nRjF9bfZbJw/cQBV86EnZxyu5h7WMX9QdGPVAmyqkzJvCphlevObaa6ivoK/73Y1ipZ2N5emz4Wsj2Ft8Wu4bbH7xXHZLUsKj5ZvcLkWekjFS9qWQw9BH3a7VjlJHkW+Z1tnauteo+T6WzsrUJP433s8D+90nR3sYDvXRb1I+6/FYLxT3WfKiardFeWKX2rYn759z9NX4cjdT/jSc0dbNJzcHjve/gO+t+FUtiF+U/Wj5yw66a/y8ZUFZ8BzhSx53P+xnXyzIReWdyCzoEpeH1v8MA7guNVG+f3BmfV+E/b8J8BXWE5A1pVJjGUI6euOojuhr/iDx2/46N/uwA3riYoM+v8gCuldzHe/AnvQk7bSM+7ie+bfsUf2v6Jd81/wMCmSuMtVl6nnn0TUy2/YqQk+AWvkrI/Ybaybt4WFp1UZYG371v+E8Nb+3FXeNrG383TNnKsp20cRnftH/FjKzvh4gecW7fBWPllctrpEJd1E8/a/gZvyeagCQDXkV013YOBkBcGhSvPeg5KS6cxdfQT3h/9gMEtvbjVMn8ChEo/o51V9bhU/xfjdBO2ivK6vMaUKbXJf9rGJ/zYNIML+eYpK1xGmQ7zJysstJksePA6+TVUd6X/Mo6ht/4/8LbtE940TuFkbvBZzTI52VnFOyr+glcVNYgL2bKham9F6iFcME4hYSewjKM5a37VWul3hT3d2kUmi5bYjkH/mbvsHG++OsZ9q2RCIafaLvL+IGNCOUCrkmcF83YxS6m7JWZwFq1Xdp5xaF9R2dpOFnaygnmijbiPWdvmnyNqj8UVQUw26lbIYsenMHlW+MhsT86LnV1EfdrW1hLdVQwGbC7yO3sK1TiCnezl+dXdGK85FvTCpNtYsCJVYRfjtA3x+Ke6j/off2crZCuPgnnue9F1565f8bH2pLGddEfFL/hY12ls+2N7iVVjsawfqdiNtL9z+UPHVCWfNnGQ1/k5rhElz59D4MVs0wRFfA6z23a0+H3o8fwZF7IXPq5XlbltbynuS8joxeP2cey1rvbGMNSLaROr7kvtv6VuLxy7We0Szn2L8dtYtsui6Bc4ds1/xJ9/8jG+dYt0grsY7YrqmD8C7vPLIpKPvgt+YZXsEbk9Yon5WJJlsdj6nGPHYunA6lk2yXPoOc6L8fdHY4WarVL/HnRG9GLUvdzrsNrG+nm56+VEfqu+1s9O7v2Sf2O1hfXzl6wz6RZ8fj7Zg+xBDBAD4TJgHS+sn1X1LGaiG426lk3yHA3lqc7IZ+lkQ7IhMUAMEAPEADFADHxNDFDy/JVsP/iaoCZdKYgTA8QAMUAMEAPEQLQYoOSZkucl30cZLZipXgqUxAAxQAwQA8QAMRBtBih5puSZkmdigBggBogBYoAYIAaIAYcMUPLs0FDRnsVQ/TRTJgaIAWKAGCAGiAFiIPYZoOSZkmeaaRIDxAAxQAwQA8QAMUAMOGSAkmeHhqKZYOzPBMlH5CNigBggBogBYoAYiDYDlDxT8kwzTWKAGCAGiAFigBggBogBhwxQ8uzQUNGexVD9NFMmBogBYoAYIAaIAWIg9hmg5JmSZ5ppEgPEADFADBADxAAxQAw4ZICSZ4eGoplg7M8EyUfkI2KAGCAGiAFigBiINgOUPFPyTDNNYoAYIAaIAWKAGCAGiAGHDFDy7NBQ0Z7FUP00UyYGiAFigBggBogBYiD2GaDkmZJnmmkSA8QAMUAMEAPEADFADDhkgJJnh4aimWDszwTJR+QjYoAYIAaIAWKAGIg2A5Q8U/JMM01igBggBogBYoAYIAaIAYcMUPLs0FDRnsVQ/Y3vdcMAAAIoSURBVDRTJgaIAWKAGCAGiAFiIPYZoOSZkmeaaRIDxAAxQAwQA8QAMUAMOGSAkmeHhqKZYOzPBMlH5CNigBggBogBYoAYiDYDlDxT8kwzTWKAGCAGiAFigBggBogBhwxQ8uzQUNGexVD9NFMmBogBYoAYIAaIAWIg9hmg5JmSZ5ppEgPEADFADBADxAAxQAw4ZICSZ4eGoplg7M8EyUfkI2KAGCAGiAFigBiINgOUPFPyTDNNYoAYIAaIAWKAGCAGiAGHDFDy7NBQ0Z7FUP00UyYGiAFigBggBogBYiD2GaDkmZJnmmkSA8QAMUAMEAPEADFADDhkgJJnh4aimWDszwTJR+QjYoAYIAaIAWKAGIg2A5Q8U/JMM01igBggBogBYoAYIAaIAYcMUPLs0FDRnsVQ/TRTJgaIAWKAGCAGiAFiIPYZcJ08a/oOtI2+w8TUHManZjE8dBeebXnGrEXTK3B8fAKH8pL9f+/FKd8oDmQnQ9OzsO86u+ctJp757x+/jBLd/G3p+VncaCxcMPsJau/JKwze6cWegowFvxNBF7e2Dh19T+B9MouR4SG0lBdihc5kkcvJ6onLqUV7nw8jvmD9VGWaXoiGb99hYprpyP89Q0uJqZ9MFqNOqZxb0Pw9tzWvcxbf7LDXQWZPkZ1Cv9NSqnF69Dl66tY7snPo/aF/awkF2H5iFN7pt7jbXroodYa2QX/HftAhH5GPiAFigBggBpYzA/8P7ftcu9TUic8AAAAASUVORK5CYII=)

**
每當有一種新的賬單型別,只需要新增新的賬單處理策略,並新增到BillHandleStrategyFactory中的Map集合。
如果要使得程式符合開閉原則,則需要調整BillHandleStrategyFactory中處理策略的獲取方式。
(好吧,我攤牌了,其實是我太菜了沒有想到怎麼寫ヾ(•ω•`)o) **改進思路:策略模式+註解,通過自定義註解,使用註解標記具體的策略實現類,我們就可以通過反射獲取到具體的策略實現類的例項,然後放置到容器的Map字典中!**
**
** ## 方案二:使用責任鏈模式 顧名思義,責任鏈模式(Chain of Responsibility Pattern)為呼叫請求建立了一個接收者物件的鏈。讓多個物件都有可能接收請求,並將這些物件連線成一條鏈,並且沿著這條鏈傳遞呼叫請求,直到有物件處理它為止。這種型別的設計模式也屬於行為型模式。
發出這個呼叫請求的客戶端並不知道鏈上的哪一個物件會最終處理這個呼叫請求,這使得我們的程式可以在不影響客戶端的情況下動態地重新組織和分配責任。 - **賬單處理的抽像介面** ```java /** * @author ly-az * @date 12/23/2020 14:51 * 賬單的抽象處理介面 */ public interface IBillHandler { /** * 利用責任鏈處理賬單的抽象方法 * @param bill 賬單 * @param handleChain 處理鏈 */ void handleBill(Bill bill, IBillHandleChain handleChain); } ``` - **賬單處理的的具體實現** ```java /** * @author ly-az * @date 12/23/2020 15:14 * 賬單的具體處理者的實現 */ public class Bt0001BillHandler implements IBillHandler { @Override public void handleBill(Bill bill, IBillHandleChain handleChain) { if (BillType.BT0001.equals(bill.getType())) { // 模擬實現業務處理 System.out.println("開始處理BT0001型別的賬單 > > > " + bill.getMessage() + ". . . "); System.out.println("處理成功!!!"); } //處理不了該回執就往下傳遞 else { handleChain.handleBill(bill); } } } ``` ```java /** * @author ly-az * @date 12/23/2020 15:42 * todo */ public class Bt0002BillHandler implements IBillHandler { @Override public void handleBill(Bill bill, IBillHandleChain handleChain) { if (BillType.BT0002.equals(bill.getType())) { // 模擬實現業務處理 System.out.println("開始處理BT0002型別的賬單 > > > " + bill.getMessage() + ". . . "); System.out.println("處理成功!!!"); } //處理不了該回執就往下傳遞 else { handleChain.handleBill(bill); } } } ```
- **責任連結口** ```java /** * @author ly-az * @date 12/23/2020 14:52 * 責任連結口 */ public interface IBillHandleChain { /** * 處理賬單的抽象方法 * * @param bill 賬單 */ void handleBill(Bill bill); } ```
- **責任連結口的實現** ```java /** * @author ly-az * @date 12/23/2020 15:08 * 處理賬單的責任鏈 */ public class BillHandleChain implements IBillHandleChain { /** * 記錄當前處理者位置 */ private int index = 0; /** * 處理者集合 */ private static final List BILL_HANDLER_LIST; static { //從容器中獲取處理器物件 BILL_HANDLER_LIST = BillHandlerContext.getBillHandlerList(); } @Override public void handleBill(Bill bill) { if (BILL_HANDLER_LIST != null && BILL_HANDLER_LIST.size() > 0) { if (index != BILL_HANDLER_LIST.size()) { IBillHandler billHandler = BILL_HANDLER_LIST.get(index++); billHandler.handleBill(bill, this); } } } } ``` - **責任鏈處理者容器**(如果專案中有Spring的IOC容器 ,則可以直接通過依賴注入的方式獲取到`IBillHandler` 的具體實現) ```java /** * @author ly-az * @date 12/23/2020 15:43 * 處理容器 */ public class BillHandlerContext { private BillHandlerContext() { } public static List getBillHandlerList() { val billHandlerList = new ArrayList(); billHandlerList.add(new Bt0001BillHandler()); billHandlerList.add(new Bt0002BillHandler()); return billHandlerList; } } ``` - **測試用例** ```java /** * @author ly-az * @date 12/23/2020 15:48 * 責任鏈模式下的測試 */ public class TestClient2 { public static void main(String[] args) { List billList = BillBuilder.generateBillList(); billList.forEach(bill -> { //回執處理鏈的例項物件 BillHandleChain billHandleChain = new BillHandleChain(); billHandleChain.handleBill(bill); }); } } ```
結果:
![image.png](https://cdn.nlark.com/yuque/0/2020/png/2148561/1608789347118-3e54b4ce-7e95-446e-9ad2-2d46b0b17b48.png#align=left&display=inline&height=369&margin=%5Bobject%20Object%5D&name=image.png&originHeight=369&originWidth=725&size=37612&status=done&style=none&width=725)

**同樣,如果要使得程式符合開閉原則,則需要調整BillHandlerContext中處理者的獲取方式,通過反射的方式,獲取指定包下的所有IBillHandler的實現類。**
**
o(* ̄▽ ̄*)ブ,我想到了這種解決方案下該如何改造使其符合開閉原則!!!

我們需要引入一個反射用的工具類: ```java /** * @author ly-az * @date 12/23/2020 16:00 * 反射工具類 */ public class ReflectionUtil { /** * 定義類集合(用於存放所有載入的類的映象) */ private static final Set> CLASS_SET; static { //指定載入包路徑 CLASS_SET = getClassSet("com.az"); } /** * 獲取類載入器 * * @return 類載入器 */ public static ClassLoader getClassLoader() { return Thread.currentThread().getContextClassLoader(); } /** * 載入類 * * @param className 類全限定名稱 * @param isInitialized 是否在載入完成後執行靜態程式碼塊 * @return 類的映象 */ public static Class loadClass(String className, boolean isInitialized) { Class cls; try { cls = Class.forName(className, isInitialized, getClassLoader()); } catch (ClassNotFoundException e) { throw new RuntimeException(e); } return cls; } public static Class loadClass(String className) { return loadClass(className, true); } /** * 獲取指定包下所有類 * * @param packageName 全限包名 * @return 映象的Set集合 */ public static Set> getClassSet(String packageName) { Set> classSet = new HashSet<>(); try { Enumeration urls = getClassLoader().getResources(packageName.replace(".", "/")); while (urls.hasMoreElements()) { URL url = urls.nextElement(); if (url != null) { String protocol = url.getProtocol(); if ("file".equals(protocol)) { String packagePath = url.getPath().replace("%20", ""); addClass(classSet, packagePath, packageName); } else if ("jar".equals(protocol)) { JarURLConnection jarUrlConnection = (JarURLConnection) url.openConnection(); if (jarUrlConnection != null) { JarFile jarFile = jarUrlConnection.getJarFile(); if (jarFile != null) { Enumeration jarEntries = jarFile.entries(); while (jarEntries.hasMoreElements()) { JarEntry jarEntry = jarEntries.nextElement(); String jarEntryName = jarEntry.getName(); if (jarEntryName.endsWith(".class")) { String className = jarEntryName.substring(0, jarEntryName.lastIndexOf(".")).replaceAll("/", "."); doAddClass(classSet, className); } } } } } } } } catch (IOException e) { throw new RuntimeException(e); } return classSet; } private static void doAddClass(Set> classSet, String className) { Class cls = loadClass(className, false); classSet.add(cls); } private static void addClass(Set> classSet, String packagePath, String packageName) { final File[] fileList = new File(packagePath).listFiles(file -> (file.isFile() && file.getName().endsWith(".class")) || file.isDirectory()); assert fileList != null; Arrays.asList(fileList).forEach(file -> { String fileName = file.getName(); if (file.isFile()) { String className = fileName.substring(0, fileName.lastIndexOf(".")); if (StringUtils.isNotEmpty(packageName)) { className = packageName + "." + className; } doAddClass(classSet, className); } else { String subPackagePath = fileName; if (StringUtils.isNotEmpty(packagePath)) { subPackagePath = packagePath + "/" + subPackagePath; } String subPackageName = fileName; if (StringUtils.isNotEmpty(packageName)) { subPackageName = packageName + "." + subPackageName; } addClass(classSet, subPackagePath, subPackageName); } }); } public static Set> getClassSet() { return CLASS_SET; } /** * 獲取應用包名下某父類(或介面)的所有子類(或實現類) * * @param superClass 父類(或介面)映象 * @return 所有子類(或實現類)的映象集合 */ public static Set> getClassSetBySuper(Class superClass) { Set> classSet = new HashSet<>(); for (Class cls : CLASS_SET) { if (superClass.isAssignableFrom(cls) && !superClass.equals(cls)) { classSet.add(cls); } } return classSet; } /** * 獲取應用包名下帶有某註解的類 * * @param annotationClass 註解的映象 * @return 映象集合 */ public static Set> getClassSetByAnnotation(Class annotationClass) { Set> classSet = new HashSet<>(); for (Class cls : CLASS_SET) { if (cls.isAnnotationPresent(annotationClass)) { classSet.add(cls); } } return classSet; } } ``` **對責任鏈模式的處理容器修改一下:** ```java /** * @author ly-az * @date 12/23/2020 15:43 * 處理容器 */ public class BillHandlerContext { private BillHandlerContext() { } public static List getBillHandlerList() { val billHandlerList = new ArrayList(); //獲取IBillHandler介面的實現類 Set> classList = ReflectionUtil.getClassSetBySuper(IBillHandler.class); if (classList.size() > 0) { classList.forEach(clazz -> { try { billHandlerList.add((IBillHandler) clazz.getDeclaredConstructor().newInstance()); } catch (InstantiationException | IllegalAccessException | InvocationTargetException | NoSuchMethodException e) { e.printStackTrace(); } }); } return billHandlerList; } } ``` **至此,責任鏈方案就符合開閉原則,如果新增一個賬單型別,只需要新增一個新的賬單處理處理器的實現類即可,無需做其它改動。
**
## 小結 if-else以及switch-case 這種分支判斷的方式對於分支邏輯不多的簡單業務,還是更加直觀高效的。但是對於業務複雜,分支邏輯多的情況下,採用一下適當的設計模式,會讓程式碼更加清晰,容易維護,但同時類或方法數量也是倍增的。**我們需要對業務做好充分分析,避免一上來就設計模式,避免過度設